jupiter 1.0.1

A robust, type-safe Dart SDK for interacting with the Jupiter Ultra API. Supports Solana transaction signing, order routing, execution, balances, and token shield info.

Changelog

All notable changes to this project will be documented in this file.

1.0.1 - 2025-08-05

Changed

• Optimized private key handling to leverage native Solana package capabilities
• Enhanced base64/base58 key format support with improved validation
• Improved error messages for key format-specific issues
• Streamlined transaction signing process with better error context

Security

• Improved private key validation and handling
• Enhanced transaction signing security checks
• Added detailed validation for key formats
• Improved error context for security-related issues

1.0.0 - 2025-06-11

Added

• Complete Jupiter Ultra API integration with clean package name jupiter

  • Robust HTTP client with retry mechanisms
  • Smart timeout handling with connection management
  • Comprehensive request/response logging
  • Performance tracking with metrics

• Transaction Signing & Key Management

  • Real Solana transaction signing with versioned transaction support
  • Support for both base58 and base64 private key formats
  • Enhanced validation and error handling
  • Secure keypair management

• Models & Validation

  • UltraOrderRequest with field validation
  • UltraExecuteRequest with transaction validation
  • JSON serialization with error checking
  • Input constraints and type safety

• API Client Features

  • UltraApiClient with all Ultra API endpoints:
    • order: Place trade orders
    • execute: Execute prepared transactions
    • orderAndExecute: One-step trading
    • balances: Token balance fetching
    • shield: Security information
  • Support for both free (lite-api.jup.ag) and paid (api.jup.ag) endpoints
  • Automatic rate limiting and quota management

• Error Handling

  • Specialized exception types for different scenarios
  • Detailed error messages with context
  • Automatic retry for transient failures
  • Comprehensive error propagation

• Testing & Quality

  • Unit tests with high coverage
  • Integration tests for all endpoints
  • Mock testing infrastructure
  • Performance benchmarks

Features

• Order & Execute: Place and execute trades on Jupiter
• Balances: Fetch account token balances
• Shield: Get token information and security warnings
• Transaction Signing: Real Solana transaction signing with keypair
• Environment Support: .env file integration for Flutter apps
• Type Safety: Full TypeScript-like type safety with Dart
• Error Handling: Comprehensive error handling with detailed messages