refactor: Refactor SDK core architecture and trading parameter system

- Refactor SolanaTrade main class structure with improved modular design
- Refactor trading parameter system: BuyParams/SellParams -> InternalBuyParams/InternalSellParams
- Remove deprecated PriorityFee and related utility functions
- Add SwqosSettings to replace legacy SwqosConfig
- Add comprehensive technical documentation:
  • Address Lookup Table usage guide (EN/CN)
  • Nonce Cache mechanism documentation (EN/CN)
  • Trading Parameters documentation (EN/CN)
- Refactor all example code to adapt to new API interfaces
- Optimize public API design and code comments
- Clean up redundant utility functions and type definitions

Impact: 43 files changed, 2013 insertions(+), 1735 deletions(-)

examples/seed_trading/src/main.rs

@@ -1,9 +1,7 @@
 use sol_trade_sdk::{
-    common::{
-        fast_fn::get_associated_token_address_with_program_id_fast_use_seed, AnyResult,
-        PriorityFee, TradeConfig,
-    },
-    swqos::SwqosConfig,
+    common::{fast_fn::get_associated_token_address_with_program_id_fast_use_seed, AnyResult},
+    constants::trade::trade::{DEFAULT_CU_LIMIT, DEFAULT_CU_PRICE},
+    swqos::{settings::SwqosSettings, SwqosConfig},
     trading::{core::params::PumpSwapParams, factory::DexType},
     SolanaTrade,
 };
@@ -24,23 +22,24 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
     // Buy tokens
     println!("Buying tokens from PumpSwap...");
     let buy_sol_amount = 100_000;
-    client
-        .buy(
-            DexType::PumpSwap,
-            mint_pubkey,
-            buy_sol_amount,
-            slippage_basis_points,
-            recent_blockhash,
-            None,
-            Box::new(PumpSwapParams::from_pool_address_by_rpc(&client.rpc, &pool).await?),
-            None,
-            true,
-            true,
-            true,
-            true,
-            true, // ❗️❗️❗️❗️ open seed optimize
-        )
-        .await?;
+    let buy_params = sol_trade_sdk::TradeBuyParams {
+        dex_type: DexType::PumpSwap,
+        mint: mint_pubkey,
+        sol_amount: buy_sol_amount,
+        slippage_basis_points: slippage_basis_points,
+        recent_blockhash: recent_blockhash,
+        extension_params: Box::new(
+            PumpSwapParams::from_pool_address_by_rpc(&client.rpc, &pool).await?,
+        ),
+        custom_cu_limit: None,
+        lookup_table_key: None,
+        wait_transaction_confirmed: true,
+        create_wsol_ata: true,
+        close_wsol_ata: true,
+        create_mint_ata: true,
+        open_seed_optimize: true, // ❗️❗️❗️❗️ open seed optimize
+    };
+    client.buy(buy_params).await?;
 
     tokio::time::sleep(std::time::Duration::from_secs(4)).await;
 
@@ -59,23 +58,24 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
     );
     let balance = rpc.get_token_account_balance(&account).await?;
     let amount_token = balance.amount.parse::<u64>().unwrap();
-    client
-        .sell(
-            DexType::PumpSwap,
-            mint_pubkey,
-            amount_token,
-            slippage_basis_points,
-            recent_blockhash,
-            None,
-            false,
-            Box::new(PumpSwapParams::from_pool_address_by_rpc(&client.rpc, &pool).await?),
-            None,
-            true,
-            true,
-            true,
-            true, // ❗️❗️❗️❗️ open seed optimize
-        )
-        .await?;
+    let sell_params = sol_trade_sdk::TradeSellParams {
+        dex_type: DexType::PumpSwap,
+        mint: mint_pubkey,
+        token_amount: amount_token,
+        slippage_basis_points: slippage_basis_points,
+        recent_blockhash: recent_blockhash,
+        with_tip: false,
+        extension_params: Box::new(
+            PumpSwapParams::from_pool_address_by_rpc(&client.rpc, &pool).await?,
+        ),
+        custom_cu_limit: None,
+        lookup_table_key: None,
+        wait_transaction_confirmed: true,
+        create_wsol_ata: true,
+        close_wsol_ata: true,
+        open_seed_optimize: true, // ❗️❗️❗️❗️ open seed optimize
+    };
+    client.sell(sell_params).await?;
 
     tokio::signal::ctrl_c().await?;
     Ok(())
@@ -84,27 +84,18 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
 /// Create SolanaTrade client
 /// Initializes a new SolanaTrade client with configuration
 async fn create_solana_trade_client() -> AnyResult<SolanaTrade> {
-    println!("Creating SolanaTrade client...");
-
-    let payer = Keypair::from_base58_string("use_your_own_keypair");
+    println!("🚀 Initializing SolanaTrade client...");
+    let payer = Keypair::from_base58_string("use_your_payer_keypair_here");
     let rpc_url = "https://api.mainnet-beta.solana.com".to_string();
-
-    let swqos_configs = vec![SwqosConfig::Default(rpc_url.clone())];
-
-    let mut priority_fee = PriorityFee::default();
-    priority_fee.buy_tip_fees = vec![0.001];
-    // Configure according to your needs
-    priority_fee.rpc_unit_limit = 150000;
-
-    let trade_config = TradeConfig {
-        rpc_url,
-        commitment: CommitmentConfig::confirmed(),
-        priority_fee: priority_fee,
-        swqos_configs,
-    };
-
-    let solana_trade_client = SolanaTrade::new(Arc::new(payer), trade_config).await;
-    println!("SolanaTrade client created successfully!");
-
-    Ok(solana_trade_client)
+    let commitment = CommitmentConfig::confirmed();
+    let swqos_settings: Vec<SwqosSettings> = vec![SwqosSettings::new(
+        SwqosConfig::Default(rpc_url.clone()),
+        DEFAULT_CU_LIMIT,
+        DEFAULT_CU_PRICE,
+        0.0,
+        0.0,
+    )];
+    let solana_trade = SolanaTrade::new(Arc::new(payer), rpc_url, commitment, swqos_settings).await;
+    println!("✅ SolanaTrade client initialized successfully!");
+    Ok(solana_trade)
 }