ysq
e13c891cc9
Remove NonceCache singleton pattern and replace with fetch_nonce_info function that directly fetches nonce information from RPC. This simplifies the API by eliminating cache initialization and state management, making it easier for users to manage durable nonces.
74 lines
2.1 KiB
Markdown
74 lines
2.1 KiB
Markdown
# Nonce 使用指南
|
||
|
||
本指南介绍如何在 Sol Trade SDK 中使用 Durable Nonce 来实现交易重放保护和优化交易处理。
|
||
|
||
## 📋 什么是 Durable Nonce？
|
||
|
||
Durable Nonce 是 Solana 的一项功能，允许您创建在较长时间内有效的交易，而不受最近区块哈希的 150 个区块限制。
|
||
|
||
## 🚀 核心优势
|
||
|
||
- **交易重放保护**: 防止相同交易被重复执行
|
||
- **时间窗口扩展**: 交易可在更长时间内保持有效
|
||
- **网络性能优化**: 减少对最新区块哈希的依赖
|
||
- **交易确定性**: 提供一致的交易处理体验
|
||
- **离线交易支持**: 支持预签名交易的离线处理
|
||
|
||
## 🛠️ 实现方法
|
||
|
||
### 前提：
|
||
|
||
需要先创建你 payer 账号使用的 nonce 账户。
|
||
参考资料： https://solana.com/zh/developers/guides/advanced/introduction-to-durable-nonces
|
||
|
||
### 1. 获取 Nonce 信息
|
||
|
||
从 RPC 直接获取 nonce 信息：
|
||
|
||
```rust
|
||
use sol_trade_sdk::common::nonce_cache::fetch_nonce_info;
|
||
use solana_sdk::pubkey::Pubkey;
|
||
use std::str::FromStr;
|
||
|
||
// 设置 nonce 账户
|
||
let nonce_account = Pubkey::from_str("your_nonce_account_address_here")?;
|
||
|
||
// 获取 nonce 信息
|
||
let durable_nonce = fetch_nonce_info(&client.rpc, nonce_account).await;
|
||
```
|
||
|
||
### 2. 在交易中使用 Nonce
|
||
|
||
设置 nonce 参数：durable_nonce
|
||
|
||
```rust
|
||
let buy_params = sol_trade_sdk::TradeBuyParams {
|
||
dex_type: DexType::PumpFun,
|
||
mint: mint_pubkey,
|
||
sol_amount: buy_sol_amount,
|
||
slippage_basis_points: Some(100),
|
||
recent_blockhash: Some(recent_blockhash),
|
||
extension_params: Box::new(PumpFunParams::from_trade(&trade_info, None)),
|
||
address_lookup_table_account: None,
|
||
wait_transaction_confirmed: true,
|
||
create_wsol_ata: false,
|
||
close_wsol_ata: false,
|
||
create_mint_ata: true,
|
||
open_seed_optimize: false,
|
||
durable_nonce: durable_nonce, // 设置 durable nonce
|
||
};
|
||
|
||
// 执行交易
|
||
client.buy(buy_params).await?;
|
||
```
|
||
|
||
## 🔄 Nonce 使用流程
|
||
|
||
1. **获取**: 从 RPC 获取最新 nonce 值
|
||
2. **使用**: 在交易中设置 nonce 参数
|
||
3. **刷新**: 下次使用前重新调用 `fetch_nonce_info` 获取新的 nonce 值
|
||
|
||
## 🔗 相关文档
|
||
|
||
- [示例：Durable Nonce](../examples/nonce_cache/)
|