🚀 Solana 自动交易机器人

---

✨ 特性

🔥 核心交易功能

• 实时代币检测: 监控 Helius WebSocket 上的新代币上线及交易机会
• 多 DEX 支持: 同时支持 PumpFun 和 Raydium DEX，提供最大的交易灵活性
• 自动化交易: 根据市场状况和策略自动执行买卖订单
• 风险管理: 内置止损和止盈机制
• 仓位跟踪: 实时监控当前持仓及盈亏情况
• 多代币支持: 可同时管理多个代币的持仓

🚀 高级功能

• Nozomi 集成: 通过 Nozomi 提供 MEV 保护与交易优先级设置
• Zero Slot 支持: 结合 Zero Slot 实现超快速交易执行
• Telegram 通知: 实时推送交易、错误及状态更新提醒
• Jito 集成: 支持 MEV 保护与交易捆绑功能

🛡️ 安全与保障

• 滑点保护: 可配置的交易滑点容忍度
• 流动性检查: 在交易前验证最低流动性要求
• 错误处理: 全面的错误捕获与恢复机制
• 速率限制: 内置速率限制以防止 API 滥用
• 交易重试逻辑: 自动重试并采用指数退避策略

📊 监控与分析

• 实时日志记录: 使用 tracing 提供可配置级别的详细日志
• 投资组合跟踪: 跟踪总盈亏及交易统计数据
• 绩效指标: 监控成功率与盈利能力
• 交易监控: 实时跟踪交易状态与确认进度

🔧 技术特性

• Rust 性能: 高性能且内存安全的实现
• 模块化架构: 清晰易维护的代码结构
• WebSocket 重连: 自动重连并采用指数退避策略
• 交易优化: 针对 Solana 的交易模型进行优化
• Async/Await: 完全异步支持并发操作

---

🚀 安装

前置条件

• Rust（最新稳定版）
• Cargo（随 Rust 一起安装）
• Solana 钱包，需持有 SOL 用于交易
• Helius API Key（用于 WebSocket 数据流）
• Telegram Bot（可选，用于通知）

快速开始

1. 克隆仓库

   git clone https://github.com/radioman/Auto-solana-trading-bot.git
   cd Auto-solana-trading-bot
   

2. 安装 Rust（如尚未安装）

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   source ~/.cargo/env
   

3. 设置环境变量 在项目根目录下创建 .env 文件：

   touch .env
   

4. 配置环境 编辑 .env 文件以填写您的设置：

   # 必需
   SOL_PUBKEY=your_solana_public_key_here
   RPC_ENDPOINT=your_helius_rpc_endpoint
   RPC_WEBSOCKET_ENDPOINT=your_helius_websocket_endpoint
   TARGET_PUBKEY=target_wallet_to_monitor
   JUP_PUBKEY=jupiter_aggregator_pubkey
   
   # 可选
   NOZOMI_URL=your_nozomi_endpoint
   NOZOMI_TIP_VALUE=0.001
   ZERO_SLOT_URL=your_zeroslot_endpoint
   ZERO_SLOT_TIP_VALUE=0.001
   TELEGRAM_BOT_TOKEN=your_telegram_bot_token
   TELEGRAM_CHAT_ID=your_telegram_chat_id
   

5. 构建并运行

   # 开发模式
   cargo run
   
   # 发布模式
   cargo build --release
   ./target/release/trading-bot
   

---

⚙️ 配置

环境变量

变量	描述	默认值	是否必需
SOL_PUBKEY	您的 Solana 公钥	-	✅
RPC_ENDPOINT	Helius RPC 端点	-	✅
RPC_WEBSOCKET_ENDPOINT	Helius WebSocket 端点	-	✅
TARGET_PUBKEY	监控的目标钱包	-	✅
JUP_PUBKEY	Jupiter 聚合器公钥	-	✅
NOZOMI_URL	Nozomi MEV 保护端点	-	❌
NOZOMI_TIP_VALUE	Nozomi 提示金额（以 SOL 计）	0.001	❌
ZERO_SLOT_URL	Zero Slot 端点	-	❌
ZERO_SLOT_TIP_VALUE	Zero Slot 提示金额（以 SOL 计）	0.001	❌
TELEGRAM_BOT_TOKEN	Telegram 机器人令牌	-	❌
TELEGRAM_CHAT_ID	Telegram 聊天 ID	-	❌

交易配置

您可以在 src/common/constants.rs 中修改交易参数：

pub const BUY_AMOUNT_SOL: f64 = 0.01;           // 每笔交易使用的 SOL 数量
pub const MAX_CONCURRENT_TRADES: usize = 5;     // 最大持仓数量
pub const STOP_LOSS_PERCENTAGE: f64 = 20.0;     // 止损百分比
pub const TAKE_PROFIT_PERCENTAGE: f64 = 50.0;   // 止盈百分比

DEX 配置

该机器人支持 PumpFun 和 Raydium DEX：

• PumpFun: 适用于新上线代币及模因币
• Raydium: 适用于具有流动资金池的成熟代币
• 自动检测: 机器人会根据代币特性自动选择合适的 DEX 进行交易

---

🎯 使用

基本使用

# 以开发模式启动机器人
cargo run

# 构建并以发布模式运行
cargo build --release
./target/release/trading-bot

高级使用

该机器人作为一个独立的可执行文件运行，其工作流程如下：

1. 连接到 Helius WebSocket，实时监控交易数据
2. 监控目标钱包，寻找潜在的交易机会
3. 在 PumpFun 或 Raydium 上执行交易，依据检测到的模式
4. 发送通知（若已配置），通过 Telegram 推送交易、错误及状态更新

命令行选项

# 使用特定配置文件运行
cargo run -- --config custom_config.toml

# 启用调试日志
RUST_LOG=debug cargo run

# 设置特定日志级别
RUST_LOG=info cargo run

监控

机器人提供以下实时监控方式：

1. 控制台日志: 使用 tracing crate 输出带时间戳的详细日志
2. Telegram 通知: 实时推送交易、错误及状态更新提醒
3. 交易跟踪: 实时监控交易状态与确认进度
4. 性能指标: 内置性能监控与统计功能

功能演示

• Helius WebSocket: 监控实时交易流以寻找交易机会
• PumpFun 集成: 自动在 PumpFun 上交易新上线的代币
• Raydium 集成: 在 Raydium 上执行已上市代币的交易
• Nozomi 保护: 在可用时使用 Nozomi 进行 MEV 保护
• Zero Slot 速度: 利用 Zero Slot 实现超快速交易执行
• Telegram 警报: 发送成功交易、错误及重要事件的通知

---

📊 API 参考

核心模块

交易引擎 (src/engine/)

• strategy.rs: 包含交易策略和兑换逻辑
• sniper.rs: 实现狙击交易功能
• swap.rs: 处理 PumpFun 和 Raydium 的兑换执行

DEX 集成 (src/dex/)

• pumpfun.rs: PumpFun DEX 集成及交易逻辑
• raydium.rs: Raydium DEX 集成及 AMM 操作

服务 (src/services/)

• nozomi.rs: Nozomi MEV 保护服务
• zeroslot.rs: Zero Slot 超快速交易服务
• telegram.rs: Telegram 通知服务
• jito.rs: Jito MEV 保护与捆绑
• rpc_client.rs: RPC 客户端工具及连接管理

关键函数

交易函数

// Raydium 兑换执行
pub async fn raydium_swap(
    state: AppState,
    amount_in: f64,
    swap_direction: &str,
    in_type: &str,
    slippage: u64,
    use_jito: bool,
    amm_pool_id: Pubkey,
    pool_state: AmmInfo,
) -> Result<Vec<String>>

// PumpFun 兑换执行
pub async fn pump_swap(
    state: AppState,
    amount_in: f64,
    // ... 参数
) -> Result<Vec<String>>

服务函数

// Nozomi 小费账户选择
pub fn get_tip_account() -> Result<Pubkey>

// Zero Slot 交易发送
pub async fn send_transaction(
    &self,
    transaction: &Transaction,
) -> Result<Signature, ClientError>

---

🔧 开发

项目结构

src/
├── common/             # 共享工具与配置
│   ├── cache.rs       # 缓存工具
│   ├── constants.rs   # 配置常量
│   ├── logger.rs      # 日志工具
│   ├── mod.rs         # 模块声明
│   └── utils.rs       # 辅助函数
├── core/               # 核心交易逻辑
│   ├── mod.rs         # 模块声明
│   ├── token.rs       # 代币处理
│   └── tx.rs          # 交易工具
├── dex/                # DEX 集成
│   ├── mod.rs         # 模块声明
│   ├── pumpfun.rs     # PumpFun DEX 集成
│   └── raydium.rs     # Raydium DEX 集成
├── engine/             # 交易引擎
│   ├── mod.rs         # 模块声明
│   ├── sniper.rs      # 狙击交易逻辑
│   ├── strategy.rs    # 交易策略
│   └── swap.rs        # 兑换执行逻辑
├── services/           # 外部服务集成
│   ├── bloxroute.rs   # BloxRoute 集成
│   ├── jito.rs        # Jito MEV 保护
│   ├── mod.rs         # 模块声明
│   ├── nozomi.rs      # Nozomi MEV 保护
│   ├── rpc_client.rs  # RPC 客户端工具
│   ├── telegram.rs    # Telegram 通知
│   └── zeroslot.rs    # Zero Slot 集成
├── lib.rs              # 库入口点
└── main.rs             # 主程序入口点

构建

# 调试模式构建
cargo build

# 发布模式构建
cargo build --release

# 清理构建产物
cargo clean

# 不构建直接检查代码
cargo check

测试

# 运行所有测试
cargo test

# 带输出运行测试
cargo test -- --nocapture

# 运行特定测试
cargo test test_name

---

🛡️ 安全考量

钱包安全

• 切勿将私钥提交到版本控制
• 使用环境变量存储敏感数据
• 考虑使用硬件钱包存放大额资金
• 定期轮换密钥并监控交易

交易风险

• 先从小额开始测试机器人
• 定期监控表现
• 设置合适的止损位以限制损失
• 充分了解自动化交易的风险

最佳实践

• 先在测试网上测试，再部署到主网
• 监控日志以发现错误和异常
• 及时更新机器人以应用最新改动
• 定期备份配置文件

---

📈 性能提示

优化建议

1. 使用快速 RPC 端点以提升性能
2. 监控内存使用情况以应对长时间运行实例
3. 根据市场状况调整交易频率
4. 为您的策略选择合适的滑点设置

监控建议

1. 设置关键错误警报
2. 定期监控盈亏情况
3. 检查交易成功率
4. 回顾交易日志以发现规律

---

🤝 贡献

我们欢迎各位贡献！详细信息请参阅我们的 贡献指南。

如何贡献

1. fork 仓库
2. 创建特性分支
3. 进行修改
4. 添加测试（如适用）
5. 提交拉取请求

开发环境搭建

# fork 并克隆
git clone https://github.com/radioman/Auto-solana-trading-bot.git
cd Auto-solana-trading-bot

# 安装依赖
npm install

# 创建特性分支
git checkout -b feature/your-feature-name

# 修改并测试
npm run dev

# 提交 PR
git push origin feature/your-feature-name

---

📝 许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

---

⚠️ 免责声明

本软件仅用于教育目的。加密货币交易涉及重大亏损风险，并不适合所有投资者。高杠杆率可能对您有利也可能不利。在决定交易加密货币之前，您应仔细考虑自己的投资目标、经验水平和风险承受能力。您有可能会损失全部或部分初始投资，因此不应投入您无法承受损失的资金。您应当了解加密货币交易的所有风险，如有疑问，请咨询独立的财务顾问。

---

🆘 支持

获取帮助

• 问题: GitHub Issues
• 讨论: GitHub Discussions
• 文档: Wiki

常见问题

1. 连接问题：请检查您的 RPC 端点和互联网连接。
2. 交易失败：请确认钱包余额和 Gas 设置是否正确。
3. WebSocket 断线：请检查网络稳定性及重连设置。

---

Auto-solana-trading-bot 快速上手指南

🛠️ 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统: Linux, macOS 或 Windows (WSL2 推荐)
• Rust 工具链: 需安装最新稳定版 Rust 和 Cargo
• Solana 钱包: 拥有用于交易的 SOL 余额
• API 密钥:
  • Helius API Key: 用于获取 RPC 和 WebSocket 数据流（核心依赖）
  • Telegram Bot Token (可选): 用于接收交易通知

💡 国内开发者提示: 由于网络原因，安装 Rust 或连接 Solana 节点时可能会遇到延迟。

• Rust 安装: 推荐使用国内镜像源安装 rustup。
• RPC 节点: 建议购买或配置位于亚洲区域的 Helius 专属节点以获得更低延迟。

📦 安装步骤

1. 克隆项目

git clone https://github.com/radioman/Auto-solana-trading-bot.git
cd Auto-solana-trading-bot

2. 安装 Rust (如未安装)

使用官方脚本安装（国内用户若下载缓慢，可配置 RUSTUP_DIST_SERVER 和 RUSTUP_UPDATE_ROOT 为国内镜像）：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env

3. 配置环境变量

在项目根目录创建 .env 文件并填入您的配置信息：

touch .env

编辑 .env 文件，填入以下内容（必填项不可留空）：

# --- 必填配置 ---
SOL_PUBKEY=你的 Solana 公钥
RPC_ENDPOINT=你的 Helius RPC 端点
RPC_WEBSOCKET_ENDPOINT=你的 Helius WebSocket 端点
TARGET_PUBKEY=需要监控的目标钱包地址
JUP_PUBKEY=Jupiter 聚合器公钥

# --- 可选配置 (MEV 保护与通知) ---
NOZOMI_URL=你的 Nozomi 端点
NOZOMI_TIP_VALUE=0.001
ZERO_SLOT_URL=你的 ZeroSlot 端点
ZERO_SLOT_TIP_VALUE=0.001
TELEGRAM_BOT_TOKEN=你的 Telegram 机器人 Token
TELEGRAM_CHAT_ID=你的 Telegram 聊天 ID

4. 编译与运行

# 开发模式运行 (便于查看日志)
cargo run

# 生产环境编译 (性能更优)
cargo build --release
./target/release/trading-bot

🚀 基本使用

启动后，机器人将自动执行以下流程：

1. 连接监听: 通过 Helius WebSocket 实时监听链上交易。
2. 目标监控: 追踪配置的 TARGET_PUBKEY 钱包动向。
3. 自动交易:
   • 识别新币发射（自动对接 PumpFun）。
   • 识别成熟代币流动性（自动对接 Raydium）。
   • 根据预设策略执行买入/卖出，并自动应用止盈止损。
4. 实时通知: 若配置了 Telegram，将实时推送交易成功、错误及状态更新。

调整交易策略

如需修改单笔交易金额、最大并发数或止盈止损比例，请编辑 src/common/constants.rs 文件：

pub const BUY_AMOUNT_SOL: f64 = 0.01;           // 每笔交易 SOL 数量
pub const MAX_CONCURRENT_TRADES: usize = 5;     // 最大持仓数量
pub const STOP_LOSS_PERCENTAGE: f64 = 20.0;     // 止损百分比
pub const TAKE_PROFIT_PERCENTAGE: f64 = 50.0;   // 止盈百分比

修改后重新编译即可生效。

⚠️ 安全警告:

• 切勿将私钥提交到代码仓库。
• 首次运行建议使用小额 SOL 在主网测试，或在 Devnet 环境充分验证。
• 自动化交易存在风险，请密切关注日志输出 (RUST_LOG=debug cargo run) 以监控异常。