sol-trade-sdk/docs/TRADING_PARAMETERS_CN.md

📋 交易参数参考手册

本文档提供 Sol Trade SDK 中所有交易参数的完整参考说明。

📋 目录

• TradeBuyParams
• TradeSellParams
• 参数分类
• 重要说明

TradeBuyParams

TradeBuyParams 结构体包含在不同 DEX 协议上执行买入订单所需的所有参数。

基础交易参数

参数	类型	必需	描述
dex_type	DexType	✅	要使用的交易协议 (PumpFun, PumpSwap, Bonk, RaydiumCpmm, RaydiumAmmV4)
mint	Pubkey	✅	要购买的代币 mint 公钥
sol_amount	u64	✅	要花费的 SOL 数量（以 lamports 为单位）
slippage_basis_points	Option<u64>	❌	滑点容忍度（基点单位，例如 100 = 1%, 500 = 5%）
recent_blockhash	Hash	✅	用于交易有效性的最新区块哈希
extension_params	Box<dyn ProtocolParams>	✅	协议特定参数 (PumpFunParams, PumpSwapParams 等)

高级配置参数

参数	类型	必需	描述
lookup_table_key	Option<Pubkey>	❌	用于交易优化的地址查找表键
wait_transaction_confirmed	bool	✅	是否等待交易确认
create_wsol_ata	bool	✅	是否创建 wSOL 关联代币账户
close_wsol_ata	bool	✅	交易后是否关闭 wSOL ATA
create_mint_ata	bool	✅	是否创建代币 mint ATA
open_seed_optimize	bool	✅	是否使用 seed 优化以减少 CU 消耗
nonce_account	Option<Pubkey>	❌	nonce 账户
current_nonce	Option<u64>	❌	nonce 值

TradeSellParams

TradeSellParams 结构体包含在不同 DEX 协议上执行卖出订单所需的所有参数。

基础交易参数

参数	类型	必需	描述
dex_type	DexType	✅	要使用的交易协议 (PumpFun, PumpSwap, Bonk, RaydiumCpmm, RaydiumAmmV4)
mint	Pubkey	✅	要出售的代币 mint 公钥
token_amount	u64	✅	要出售的代币数量（最小代币单位）
slippage_basis_points	Option<u64>	❌	滑点容忍度（基点单位，例如 100 = 1%, 500 = 5%）
recent_blockhash	Hash	✅	用于交易有效性的最新区块哈希
with_tip	bool	✅	交易中是否包含小费
extension_params	Box<dyn ProtocolParams>	✅	协议特定参数 (PumpFunParams, PumpSwapParams 等)

高级配置参数

参数	类型	必需	描述
lookup_table_key	Option<Pubkey>	❌	用于交易优化的地址查找表键
wait_transaction_confirmed	bool	✅	是否等待交易确认
create_wsol_ata	bool	✅	是否创建 wSOL 关联代币账户
close_wsol_ata	bool	✅	交易后是否关闭 wSOL ATA
open_seed_optimize	bool	✅	是否使用 seed 优化以减少 CU 消耗
nonce_account	Option<Pubkey>	❌	nonce 账户
current_nonce	Option<u64>	❌	nonce 值

参数分类

🎯 核心交易参数

这些参数对于定义基本交易操作至关重要：

• dex_type: 确定用于交易的协议
• mint: 指定要交易的代币
• sol_amount (买入) / token_amount (卖出): 定义交易规模
• recent_blockhash: 确保交易有效性

⚙️ 交易控制参数

这些参数控制交易的处理方式：

• slippage_basis_points: 控制可接受的价格滑点
• wait_transaction_confirmed: 控制是否等待确认

🔧 账户管理参数

这些参数控制自动账户创建和管理：

• create_wsol_ata: 需要时自动将 SOL 包装为 wSOL
• close_wsol_ata: 交易后自动将 wSOL 解包装为 SOL
• create_mint_ata: 自动创建代币账户

🚀 优化参数

这些参数启用高级优化：

• lookup_table_key: 使用地址查找表减少交易大小
• open_seed_optimize: 使用基于 seed 的账户创建以降低 CU 消耗

🔄 非必填参数

当你需要使用 durable nonce 时，需要填入这两个参数：

• nonce_account: nonce 账户
• current_nonce: nonce 值

重要说明

🌱 Seed 优化

当 open_seed_optimize: true 时：

• ⚠️ 警告: 使用 seed 优化购买的代币必须通过此 SDK 出售
• ⚠️ 警告: 官方平台的出售方法可能会失败
• 📝 注意: 使用 get_associated_token_address_with_program_id_fast_use_seed 获取 ATA 地址

💰 wSOL 账户管理

create_wsol_ata 和 close_wsol_ata 参数提供精细控制：

• 独立控制: 创建和关闭操作可以分别控制
• 批量操作: 创建一次，多次交易，然后关闭
• 租金优化: 关闭账户时自动回收租金

🔍 地址查找表

使用 lookup_table_key 之前：

• 初始化 AddressLookupTableCache 来管理缓存的查找表
• 查找表减少交易大小并提高成功率
• 对于有许多账户引用的复杂交易特别有益

📊 滑点配置

推荐的滑点设置：

• 保守: 100-300 基点 (1-3%)
• 中等: 300-500 基点 (3-5%)
• 激进: 500-1000 基点 (5-10%)

🎯 协议特定参数

每个 DEX 协议需要特定的 extension_params：

• PumpFun: PumpFunParams
• PumpSwap: PumpSwapParams
• Bonk: BonkParams
• Raydium CPMM: RaydiumCpmmParams
• Raydium AMM V4: RaydiumAmmV4Params

请参阅相应的协议文档了解详细的参数规格。