sol-trade-sdk 0.6.12

📋 Table of Contents

• ✨ Features
• 📦 Installation
• 🛠️ Usage Examples
  • 📋 Important Parameter Description
  • 📊 Usage Examples Summary Table
  • ⚙️ SWQOS Service Configuration
  • 🔧 Middleware System
  • ⚡ Custom Priority Fee Configuration
• 🏪 Supported Trading Platforms
• 🛡️ MEV Protection Services
• 💰 Price Calculation Utilities
• 🧮 Amount Calculation Utilities
• 📁 Project Structure
• 📄 License
• 💬 Contact
• ⚠️ Important Notes

✨ Features

1. PumpFun Trading: Support for buy and sell operations
2. PumpSwap Trading: Support for PumpSwap pool trading operations
3. Bonk Trading: Support for Bonk trading operations
4. Raydium CPMM Trading: Support for Raydium CPMM (Concentrated Pool Market Maker) trading operations
5. Raydium AMM V4 Trading: Support for Raydium AMM V4 (Automated Market Maker) trading operations
6. Event Subscription: Subscribe to PumpFun, PumpSwap, Bonk, Raydium CPMM, and Raydium AMM V4 program trading events
7. Yellowstone gRPC: Subscribe to program events using Yellowstone gRPC
8. ShredStream Support: Subscribe to program events using ShredStream
9. Multiple MEV Protection: Support for Jito, Nextblock, ZeroSlot, Temporal, Bloxroute, FlashBlock, BlockRazor, Node1, Astralane and other services
10. Concurrent Trading: Send transactions using multiple MEV services simultaneously; the fastest succeeds while others fail
11. Unified Trading Interface: Use unified trading protocol enums for trading operations
12. Middleware System: Support for custom instruction middleware to modify, add, or remove instructions before transaction execution

📦 Installation

Direct Clone

Clone this project to your project directory:

cd your_project_root_directory
git clone https://github.com/0xfnzero/sol-trade-sdk

Add the dependency to your Cargo.toml:

# Add to your Cargo.toml
sol-trade-sdk = { path = "./sol-trade-sdk", version = "0.6.12" }

Use crates.io

# Add to your Cargo.toml
sol-trade-sdk = "0.6.12"

🛠️ Usage Examples

📋 Important Parameter Description

🌱 open_seed_optimize Parameter

open_seed_optimize is used to specify whether to use seed optimization to reduce transaction CU consumption.

• Purpose: When open_seed_optimize: true, the SDK uses createAccountWithSeed optimization to create token ata accounts during transactions.
• Note: Transactions created with open_seed_optimize enabled must be sold through this SDK. Using official methods to sell may fail.
• Note: After enabling open_seed_optimize, you need to use the get_associated_token_address_with_program_id_fast_use_seed method to get the token ata address.

💰 create_wsol_ata and close_wsol_ata、 create_mint_ata Parameters

In PumpSwap, Bonk, and Raydium trading, the create_wsol_ata and close_wsol_ata、 create_mint_ata parameters provide fine-grained control over wSOL (Wrapped SOL) account management:

• create_wsol_ata:

  • When create_wsol_ata: true, the SDK automatically creates and wraps SOL to wSOL before trading
  • When buying: automatically wraps SOL to wSOL for trading

• close_wsol_ata:

  • When close_wsol_ata: true, the SDK automatically closes the wSOL account and unwraps to SOL after trading
  • When selling: automatically unwraps the received wSOL to SOL and reclaims rent

• create_mint_ata:

  • When create_mint_ata: true, the SDK automatically creates the token ata account before trading

• Benefits of Separate Parameters:

  • Allows independent control of wSOL account creation and closure
  • Useful for batch operations where you want to create once and close after multiple transactions
  • Provides flexibility for advanced trading strategies

🔍 lookup_table_key Parameter

The lookup_table_key parameter is an optional Pubkey that specifies an address lookup table for transaction optimization. You need to use AddressLookupTableCache to manage the cached address lookup table before using it.

• Purpose: Address lookup tables can reduce transaction size and improve execution speed by storing frequently used addresses
• Usage:
  • Can be overridden per transaction in buy() and sell() methods
  • If not provided, defaults to None
• Benefits:
  • Reduces transaction size by referencing addresses from lookup tables
  • Improves transaction success rate and speed
  • Particularly useful for complex transactions with many account references

⚡ priority_fee Parameter

The priority_fee parameter is an optional PriorityFee that allows you to override the default priority fee settings for individual transactions:

• Purpose: Provides fine-grained control over transaction priority fees on a per-transaction basis
• Usage:
  • Can be passed to buy() and sell() methods to override the global priority fee settings
  • If not provided, defaults to None and uses the priority fee settings from TradeConfig
  • When provided, the buy_tip_fees array will be automatically padded to match the number of SWQOS clients
• Benefits:
  • Allows dynamic adjustment of priority fees based on market conditions
  • Enables different fee strategies for different types of transactions
  • Provides flexibility for high-frequency trading scenarios

About ShredStream

When using shred to subscribe to events, due to the nature of shreds, you cannot get complete information about transaction events. Please ensure that the parameters your trading logic depends on are available in shreds when using them.

📊 Usage Examples Summary Table

⚙️ SWQOS Service Configuration

When configuring SWQOS services, note the different parameter requirements for each service:

• Jito: The first parameter is UUID (if no UUID, pass an empty string "")
• Other MEV services: The first parameter is the API Token

Custom URL Support

Each SWQOS service now supports an optional custom URL parameter:

// Using custom URL (third parameter)
let jito_config = SwqosConfig::Jito(
    "your_uuid".to_string(),
    SwqosRegion::Frankfurt, // This parameter is still required but will be ignored
    Some("https://custom-jito-endpoint.com".to_string()) // Custom URL
);

// Using default regional endpoint (third parameter is None)
let nextblock_config = SwqosConfig::NextBlock(
    "your_api_token".to_string(),
    SwqosRegion::NewYork, // Will use the default endpoint for this region
    None // No custom URL, uses SwqosRegion
);

URL Priority Logic:

• If a custom URL is provided (Some(url)), it will be used instead of the regional endpoint
• If no custom URL is provided (None), the system will use the default endpoint for the specified SwqosRegion
• This allows for maximum flexibility while maintaining backward compatibility

When using multiple MEV services, you need to use Durable Nonce. You need to initialize a NonceCache class (or write your own nonce management class), get the latest nonce value, and use it as the blockhash when trading.

🔧 Middleware System

The SDK provides a powerful middleware system that allows you to modify, add, or remove instructions before transaction execution. Middleware executes in the order they are added:

let middleware_manager = MiddlewareManager::new()
    .add_middleware(Box::new(FirstMiddleware))   // Executes first
    .add_middleware(Box::new(SecondMiddleware))  // Executes second
    .add_middleware(Box::new(ThirdMiddleware));  // Executes last

⚡ Custom Priority Fee Configuration

use sol_trade_sdk::common::PriorityFee;

// Custom priority fee configuration
let priority_fee = PriorityFee {
    tip_unit_limit: 190000,
    tip_unit_price: 1000000,
    rpc_unit_limit: 500000,
    rpc_unit_price: 500000,
    buy_tip_fee: 0.001,
    buy_tip_fees: vec![0.001, 0.002],
    sell_tip_fee: 0.0001,
};

// Use custom priority fee in TradeConfig
let trade_config = TradeConfig {
    rpc_url: rpc_url.clone(),
    commitment: CommitmentConfig::confirmed(),
    priority_fee, // Use custom priority fee
    swqos_configs,
};

🏪 Supported Trading Platforms

• PumpFun: Primary meme coin trading platform
• PumpSwap: PumpFun's swap protocol
• Bonk: Token launch platform (letsbonk.fun)
• Raydium CPMM: Raydium's Concentrated Pool Market Maker protocol
• Raydium AMM V4: Raydium's Automated Market Maker V4 protocol

🛡️ MEV Protection Services

• Jito: High-performance block space
• NextBlock: Fast transaction execution
• ZeroSlot: Zero-latency transactions
• Temporal: Time-sensitive transactions
• Bloxroute: Blockchain network acceleration
• FlashBlock: High-speed transaction execution with API key authentication - Official Documentation
• BlockRazor: High-speed transaction execution with API key authentication - Official Documentation
• Node1: High-speed transaction execution with API key authentication - Official Documentation
• Astralane: Blockchain network acceleration

💰 Price Calculation Utilities

The SDK includes price calculation utilities for all supported protocols in src/utils/price/.

🧮 Amount Calculation Utilities

The SDK provides trading amount calculation functionality for various protocols, located in src/utils/calc/:

• Common Calculation Functions: Provides general fee calculation and division utilities
• Protocol-Specific Calculations: Specialized calculation logic for each protocol
  • PumpFun: Token buy/sell amount calculations based on bonding curves
  • PumpSwap: Amount calculations for multiple trading pairs
  • Raydium AMM V4: Amount and fee calculations for automated market maker pools
  • Raydium CPMM: Amount calculations for constant product market makers
  • Bonk: Specialized calculation logic for Bonk tokens

Key features include:

• Calculate output amounts based on input amounts
• Fee calculation and distribution
• Slippage protection calculations
• Liquidity pool state calculations

📁 Project Structure

src/
├── common/           # Common functionality and tools
├── constants/        # Constant definitions
├── instruction/      # Instruction building
├── swqos/            # MEV service clients
├── trading/          # Unified trading engine
│   ├── common/       # Common trading tools
│   ├── core/         # Core trading engine
│   ├── middleware/   # Middleware system
│   │   ├── builtin.rs    # Built-in middleware implementations
│   │   ├── traits.rs     # Middleware trait definitions
│   │   └── mod.rs        # Middleware module
│   ├── bonk/         # Bonk trading implementation
│   ├── pumpfun/      # PumpFun trading implementation
│   ├── pumpswap/     # PumpSwap trading implementation
│   ├── raydium_cpmm/ # Raydium CPMM trading implementation
│   ├── raydium_amm_v4/ # Raydium AMM V4 trading implementation
│   └── factory.rs    # Trading factory
├── utils/            # Utility functions
│   ├── price/        # Price calculation utilities
│   │   ├── common.rs       # Common price functions
│   │   ├── bonk.rs         # Bonk price calculations
│   │   ├── pumpfun.rs      # PumpFun price calculations
│   │   ├── pumpswap.rs     # PumpSwap price calculations
│   │   ├── raydium_cpmm.rs # Raydium CPMM price calculations
│   │   ├── raydium_clmm.rs # Raydium CLMM price calculations
│   │   └── raydium_amm_v4.rs # Raydium AMM V4 price calculations
│   └── calc/         # Amount calculation utilities
│       ├── common.rs       # Common calculation functions
│       ├── bonk.rs         # Bonk amount calculations
│       ├── pumpfun.rs      # PumpFun amount calculations
│       ├── pumpswap.rs     # PumpSwap amount calculations
│       ├── raydium_cpmm.rs # Raydium CPMM amount calculations
│       └── raydium_amm_v4.rs # Raydium AMM V4 amount calculations
├── lib.rs            # Main library file
└── main.rs           # Example program

📄 License

MIT License

💬 Contact

• Official Website: https://fnzero.dev/
• Project Repository: https://github.com/0xfnzero/sol-trade-sdk
• Telegram Group: https://t.me/fnzero_group
• Discord: https://discord.gg/vuazbGkqQE

⚠️ Important Notes

1. Test thoroughly before using on mainnet
2. Properly configure private keys and API tokens
3. Pay attention to slippage settings to avoid transaction failures
4. Monitor balances and transaction fees
5. Comply with relevant laws and regulations