gavindiaz/sol-trade-sdk

Fork 0

Files

T

ysq cf030cec49 feat: upgrade to v3.1.0

2025-10-07 23:48:09 +08:00

14 KiB

Executable File

Raw Blame History

🚀 Sol Trade SDK

全面的 Rust SDK，用于无缝 Solana DEX 交易

将 PumpFun、PumpSwap、Bonk、Raydium 和 Meteora 交易功能集成到您的应用程序中，提供强大的工具和统一的接口。

中文 | English | Website | Telegram | Discord

✨ 项目特性

PumpFun 交易: 支持购买、卖出功能
PumpSwap 交易: 支持 PumpSwap 池的交易操作
Bonk 交易: 支持 Bonk 的交易操作
Raydium CPMM 交易: 支持 Raydium CPMM (Concentrated Pool Market Maker) 的交易操作
Raydium AMM V4 交易: 支持 Raydium AMM V4 (Automated Market Maker) 的交易操作
Meteora DAMM V2 交易: 支持 Meteora DAMM V2 (Dynamic AMM) 的交易操作
多种 MEV 保护: 支持 Jito、Nextblock、ZeroSlot、Temporal、Bloxroute、FlashBlock、BlockRazor、Node1、Astralane 等服务
并发交易: 同时使用多个 MEV 服务发送交易，最快的成功，其他失败
统一交易接口: 使用统一的交易协议枚举进行交易操作
中间件系统: 支持自定义指令中间件，可在交易执行前对指令进行修改、添加或移除

📦 安装

直接克隆

将此项目克隆到您的项目目录：

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

在您的Cargo.toml中添加依赖：

# 添加到您的 Cargo.toml
sol-trade-sdk = { path = "./sol-trade-sdk", version = "3.1.0" }

使用 crates.io

# 添加到您的 Cargo.toml
sol-trade-sdk = "3.1.0"

🛠️ 使用示例

📋 使用示例

1. 创建 SolanaTrade 实例

可以参考示例：创建 SolanaTrade 实例。

// 钱包
let payer = Keypair::from_base58_string("use_your_payer_keypair_here");
// RPC 地址
let rpc_url = "https://mainnet.helius-rpc.com/?api-key=xxxxxx".to_string();
let commitment = CommitmentConfig::processed();
// 可以配置多个SWQOS服务
let swqos_configs: Vec<SwqosConfig> = vec![
    SwqosConfig::Default(rpc_url.clone()),
    SwqosConfig::Jito("your uuid".to_string(), SwqosRegion::Frankfurt, None),
    SwqosConfig::NextBlock("your api_token".to_string(), SwqosRegion::Frankfurt, None),
    SwqosConfig::Bloxroute("your api_token".to_string(), SwqosRegion::Frankfurt, None),
    SwqosConfig::ZeroSlot("your api_token".to_string(), SwqosRegion::Frankfurt, None),
    SwqosConfig::Temporal("your api_token".to_string(), SwqosRegion::Frankfurt, None),
    SwqosConfig::FlashBlock("your api_token".to_string(), SwqosRegion::Frankfurt, None),
    SwqosConfig::Node1("your api_token".to_string(), SwqosRegion::Frankfurt, None),
    SwqosConfig::BlockRazor("your api_token".to_string(), SwqosRegion::Frankfurt, None),
    SwqosConfig::Astralane("your api_token".to_string(), SwqosRegion::Frankfurt, None),
];
// 创建 TradeConfig 实例
let trade_config = TradeConfig::new(rpc_url, swqos_configs, commitment);
// 创建 SolanaTrade 客户端
let client = SolanaTrade::new(Arc::new(payer), trade_config).await;

2. 配置 Gas Fee 策略

有关 Gas Fee 策略的详细信息，请参阅 Gas Fee 策略参考手册。

// 创建 GasFeeStrategy 实例
let gas_fee_strategy = GasFeeStrategy::new();
// 设置全局策略
gas_fee_strategy.set_global_fee_strategy(150000, 500000, 0.001, 0.001);

3. 构建交易参数

有关所有交易参数的详细信息，请参阅交易参数参考手册。

let buy_params = sol_trade_sdk::TradeBuyParams {
  dex_type: DexType::PumpSwap,
  input_token_type: TradeTokenType::WSOL,
  mint: mint_pubkey,
  input_token_amount: buy_sol_amount,
  slippage_basis_points: slippage_basis_points,
  recent_blockhash: Some(recent_blockhash),
  extension_params: Box::new(params.clone()),
  address_lookup_table_account: None,
  wait_transaction_confirmed: true,
  create_input_token_ata: true,
  close_input_token_ata: true,
  create_mint_ata: true,
  open_seed_optimize: false,
  durable_nonce: None,
};

4. 执行交易

client.buy(buy_params).await?;

⚡ 交易参数

有关所有交易参数（包括 TradeBuyParams 和 TradeSellParams）的详细信息，请参阅专门的交易参数参考手册。

关于shredstream

当你使用 shred 订阅事件时，由于 shred 的特性，你无法获取到交易事件的完整信息。请你在使用时，确保你的交易逻辑依赖的参数，在shred中都能获取到。

📊 使用示例汇总表格

描述	运行命令	源码路径
创建和配置 SolanaTrade 实例	`cargo run --package trading_client`	examples/trading_client
PumpFun 代币狙击交易	`cargo run --package pumpfun_sniper_trading`	examples/pumpfun_sniper_trading
PumpFun 代币跟单交易	`cargo run --package pumpfun_copy_trading`	examples/pumpfun_copy_trading
PumpSwap 交易操作	`cargo run --package pumpswap_trading`	examples/pumpswap_trading
Raydium CPMM 交易操作	`cargo run --package raydium_cpmm_trading`	examples/raydium_cpmm_trading
Raydium AMM V4 交易操作	`cargo run --package raydium_amm_v4_trading`	examples/raydium_amm_v4_trading
Meteora DAMM V2 交易操作	`cargo run --package meteora_damm_v2_direct_trading`	examples/meteora_damm_v2_direct_trading
Bonk 代币狙击交易	`cargo run --package bonk_sniper_trading`	examples/bonk_sniper_trading
Bonk 代币跟单交易	`cargo run --package bonk_copy_trading`	examples/bonk_copy_trading
自定义指令中间件示例	`cargo run --package middleware_system`	examples/middleware_system
地址查找表示例	`cargo run --package address_lookup`	examples/address_lookup
Nonce示例	`cargo run --package nonce_cache`	examples/nonce_cache
SOL与WSOL相互转换示例	`cargo run --package wsol_wrapper`	examples/wsol_wrapper
Seed 优化交易示例	`cargo run --package seed_trading`	examples/seed_trading
Gas费用策略示例	`cargo run --package gas_fee_strategy`	examples/gas_fee_strategy

⚙️ SWQOS 服务配置说明

在配置 SWQOS 服务时，需要注意不同服务的参数要求：

Jito: 第一个参数为 UUID（如无 UUID 请传入空字符串 ""）
其他的MEV服务，第一个参数为 API Token

自定义 URL 支持

每个 SWQOS 服务现在都支持可选的自定义 URL 参数：

// 使用自定义 URL（第三个参数）
let jito_config = SwqosConfig::Jito(
    "your_uuid".to_string(),
    SwqosRegion::Frankfurt, // 这个参数仍然需要，但会被忽略
    Some("https://custom-jito-endpoint.com".to_string()) // 自定义 URL
);

// 使用默认区域端点（第三个参数为 None）
let nextblock_config = SwqosConfig::NextBlock(
    "your_api_token".to_string(),
    SwqosRegion::NewYork, // 将使用该区域的默认端点
    None // 没有自定义 URL，使用 SwqosRegion
);

URL 优先级逻辑：

如果提供了自定义 URL（Some(url)），将使用自定义 URL 而不是区域端点
如果没有提供自定义 URL（None），系统将使用指定 SwqosRegion 的默认端点
这提供了最大的灵活性，同时保持向后兼容性

当使用多个MEV服务时，需要使用Durable Nonce。你需要使用fetch_nonce_info函数获取最新的nonce值，并在交易的时候将durable_nonce填入交易参数。

🔧 中间件系统说明

SDK 提供了强大的中间件系统，允许您在交易执行前对指令进行修改、添加或移除。中间件按照添加顺序依次执行：

let middleware_manager = MiddlewareManager::new()
    .add_middleware(Box::new(FirstMiddleware))   // 第一个执行
    .add_middleware(Box::new(SecondMiddleware))  // 第二个执行
    .add_middleware(Box::new(ThirdMiddleware));  // 最后执行

🔍 地址查找表

地址查找表 (ALT) 允许您通过将经常使用的地址存储在紧凑的表格格式中来优化交易大小并降低费用。详细信息请参阅地址查找表指南。

🔍 Durable Nonce

使用 Durable Nonce 来实现交易重放保护和优化交易处理。详细信息请参阅 Nonce 使用指南。

🛡️ MEV 保护服务

可以通过官网申请密钥：社区官网

Jito: 高性能区块空间
NextBlock: 快速交易执行
ZeroSlot: 零延迟交易
Temporal: 时间敏感交易
Bloxroute: 区块链网络加速
FlashBlock: 高速交易执行，支持 API 密钥认证 - 官方文档
BlockRazor: 高速交易执行，支持 API 密钥认证 - 官方文档
Node1: 高速交易执行，支持 API 密钥认证 - 官方文档
Astralane: 高速交易执行，支持 API 密钥认证

📁 项目结构

src/
├── common/           # 通用功能和工具
├── constants/        # 常量定义
├── instruction/      # 指令构建
│   └── utils/        # 指令工具函数
├── swqos/            # MEV 服务客户端
├── trading/          # 统一交易引擎
│   ├── common/       # 通用交易工具
│   ├── core/         # 核心交易引擎
│   ├── middleware/   # 中间件系统
│   └── factory.rs    # 交易工厂
├── utils/            # 工具函数
│   ├── calc/         # 数量计算工具
│   └── price/        # 价格计算工具
└── lib.rs            # 主库文件

📄 许可证

MIT 许可证

💬 联系方式

官方网站: https://fnzero.dev/
项目仓库: https://github.com/0xfnzero/sol-trade-sdk
Telegram 群组: https://t.me/fnzero_group
Discord: https://discord.gg/vuazbGkqQE

⚠️ 重要注意事项

在主网使用前请充分测试
正确设置私钥和 API 令牌
注意滑点设置避免交易失败
监控余额和交易费用
遵循相关法律法规

14 KiB Executable File Raw Blame History Unescape Escape