ysq
4907aafead
- Add nonce_account and current_nonce to trade parameters - Remove hardcoded NonceCache dependency from nonce_manager - Update examples and documentation for new nonce usage - Fix nonce documentation errors and improve clarity
150 lines
5.5 KiB
Markdown
150 lines
5.5 KiB
Markdown
# 📋 交易参数参考手册
|
||
|
||
本文档提供 Sol Trade SDK 中所有交易参数的完整参考说明。
|
||
|
||
## 📋 目录
|
||
|
||
- [TradeBuyParams](#tradebuyparams)
|
||
- [TradeSellParams](#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`
|
||
|
||
请参阅相应的协议文档了解详细的参数规格。
|