🚀 FnZero Solana 示例项目

Solana DEX 交易与开发的实用示例和工具集

Rust 示例、SDK 和工具集合，用于构建高性能 Solana 交易机器人。包括交易示例、DEX 集成 SDK、交易解析、密钥管理和实时流式处理。

📋 目录

✨ 特性
📁 项目结构
🛠️ 示例
📎 示例文档索引
📦 SDK 与工具
📋 运行前准备与隐私
🚀 快速开始
📄 许可证
💬 联系方式

✨ 特性

交易示例: PumpSwap 外盘与 PumpFun 内盘交易机器人示例，支持自动化买入/卖出策略
多 SWQoS 支持: 通过多个 MEV 保护服务并发提交交易
全面的 SDK: 用于交易、解析、密钥管理和流式处理的模块化 SDK
实时流式处理: 基于 gRPC 的交易流式处理和低延迟事件解析
安全密钥管理: 支持密码保护的加密密钥库
生产就绪: 优化的构建配置，支持跨平台（Linux、macOS）

📁 项目结构

fnzero-examples/
├── pumpswap_trade/              # PumpSwap 外盘交易示例（直接私钥）
├── pumpswap_trade_with_safekey/ # PumpSwap 外盘交易示例（加密密钥库）
├── pumpfun_trade/               # PumpFun 内盘交易示例（直接私钥）
├── pumpfun_trade_with_safekey/  # PumpFun 内盘交易示例（加密密钥库）
├── sol-trade-sdk/              # 统一 DEX 交易 SDK
├── sol-parser-sdk/             # 交易解析 SDK（gRPC 流式处理）
├── sol-safekey/                # 加密密钥管理库
└── solana-streamer/            # Solana 交易流式处理工具

🛠️ 示例

交易示例

示例	描述	运行命令	源代码
PumpSwap 交易	PumpSwap 外盘自动化买→等→卖循环交易，可配置轮次和休息间隔	`./run.sh`	pumpswap_trade
PumpSwap 交易（加密）	同上，但使用带密码保护的加密密钥库文件	`./run.sh`	pumpswap_trade_with_safekey
PumpFun 交易	PumpFun 内盘（bonding curve）买→等→卖，代币须未毕业到 PumpSwap	`./run.sh`	pumpfun_trade
PumpFun 交易（加密）	同上，keystore / `KEYPAIR_BASE58`	`./run.sh`	pumpfun_trade_with_safekey

如何选择示例

场景	推荐目录
代币仍在 PumpFun 内盘（bonding curve），尚未毕业到 PumpSwap	`pumpfun_trade` 或 `pumpfun_trade_with_safekey`
代币已在 PumpSwap 外盘 AMM	`pumpswap_trade` 或 `pumpswap_trade_with_safekey`
私钥通过 `PRIVATE_KEY` 或 `solana.yaml` 的 `private_key`	`pumpfun_trade` / `pumpswap_trade`
加密 keystore + 密码（或备用 `KEYPAIR_BASE58`）	`pumpfun_trade_with_safekey` / `pumpswap_trade_with_safekey`

示例特性（四个交易示例共通）

✅ 自动化流程: 买入 → 等待约 30 秒 → 卖出；默认执行 1 轮（可在各示例 src/run.rs 中修改 ROUNDS、REST_SECS）
✅ 多 SWQoS: 多个 MEV 保护通道并发提交
✅ YAML + .env: config/dev|prod/solana.yaml、trading.yaml 与环境变量
✅ Durable Nonce: 启用 2 个及以上 SWQoS 时需在 nonce_config 或环境变量 NONCE_ACCOUNT 中配置有效 nonce 账户；YAML 中占位 "" 会被忽略并回退到 NONCE_ACCOUNT
✅ Gas / 滑点: trading.yaml 中可配
✅ 默认不等待链上确认（wait_tx_confirmed: false），买入后依赖固定等待时间再查余额；生产环境可按需改为等待确认或加长等待
⚠️ 卖出数量: 每轮按钱包该 mint 的全部代币余额卖出（含买入前已有持仓）

示例文档索引

示例	中文 README	English
PumpSwap（私钥）	pumpswap_trade/README_CN.md	pumpswap_trade/README.md
PumpSwap（加密）	pumpswap_trade_with_safekey/README_CN.md	pumpswap_trade_with_safekey/README.md
PumpFun（私钥）	pumpfun_trade/README_CN.md	pumpfun_trade/README.md
PumpFun（加密）	pumpfun_trade_with_safekey/README_CN.md	pumpfun_trade_with_safekey/README.md

配置说明

仓库内仅有 *.yaml.example 与 .env.example；本地的 solana.yaml、trading.yaml、.env 由你从模板复制生成，不会被 Git 跟踪（见「运行前准备与隐私」）。
环境变量可覆盖 YAML 中的项；多 SWQoS 时务必配置 durable nonce 或 NONCE_ACCOUNT。

支持的 SWQoS 服务

服务	传输协议
Astralane	HTTP, QUIC ⚡
BlockRazor	HTTP, gRPC
Bloxroute	HTTP
FlashBlock	HTTP
Jito	HTTP
NextBlock	HTTP
Node1	HTTP, QUIC ⚡
Soyas	QUIC ⚡
Speedlanding	QUIC ⚡
Stellium	HTTP
Temporal	HTTP
ZeroSlot	HTTP
Default	RPC

API Key 申请：通过官方网站申请 API 密钥：https://fnzero.dev/swqos

注意：⚡ = QUIC（Quick UDP Internet Connections）相比 HTTP/gRPC 提供更低的延迟。使用 QUIC 的服务（Astralane、Node1、Soyas、Speedlanding）通常提供最佳的交易提交性能。

📦 SDK 与工具

sol-trade-sdk

全面的 Solana DEX 交易 Rust SDK，提供多协议统一接口。

特性：

支持 PumpFun、PumpSwap、Bonk、Raydium CPMM、Raydium AMM V4、Meteora DAMM V2
多个 MEV 保护服务（Jito、BlockRazor、Astralane 等）
中间件系统，支持自定义指令修改
多钱包场景的共享基础设施
地址查找表（ALT）支持
Durable Nonce 管理
Gas 费策略优化

文档: sol-trade-sdk/README_CN.md

sol-parser-sdk

交易解析 SDK，支持 gRPC 流式处理和实时事件处理。

特性：

解析 PumpFun、PumpSwap、Raydium 等交易
基于 gRPC 的流式处理，低延迟事件处理
事件过滤和转换
交易事件提取
账户填充器优化账户查询

文档: sol-parser-sdk/README_CN.md

sol-safekey

加密密钥管理库，用于安全存储 Solana 密钥对。

特性：

使用密码保护加密/解密 Solana 密钥对
基于 JSON 的密钥库格式
Base58 私钥支持
CLI 密钥管理工具
与交易示例集成

文档: sol-safekey/README_CN.md

solana-streamer

Solana 交易流式处理和实时数据处理工具。

特性：

Shred 流订阅
交易流式处理
事件处理管道
性能优化的解析

文档: solana-streamer/README_CN.md

📋 运行前准备与隐私

以下步骤在首次运行任意交易示例前完成。 仓库不包含你的私钥、API Token 或真实 RPC 配置；仅提供 *.yaml.example 与 .env.example 模板。

1. 克隆本仓库

git clone https://github.com/0xfnzero/fnzero-examples.git
cd fnzero-examples

2. 在示例子目录中从模板生成本地配置（必做）

进入你要用的示例（如 pumpswap_trade、pumpfun_trade 等），每个环境各复制一次：

cd pumpswap_trade   # 或 pumpfun_trade / *_with_safekey

cp .env.example .env
cp config/dev/solana.yaml.example config/dev/solana.yaml
cp config/dev/trading.yaml.example config/dev/trading.yaml
# 若使用生产配置，同样复制 config/prod/*.example → config/prod/*.yaml

然后本地编辑（勿提交）：

文件	内容
`.env`	`PRIVATE_KEY` 或 `KEYSTORE_PASSWORD`、`SOLANA_RPC_URL`、`NONCE_ACCOUNT`（多 SWQoS 时）等
`config/*/solana.yaml`	`rpc_url`、`private_key` 或 `keystore_path`、SWQoS `api_token`、`nonce_config`
`config/*/trading.yaml`	买入金额、滑点、Gas 等

APP_ENV=dev 读 config/dev/，APP_ENV=prod 读 config/prod/。

3. 使用加密钱包时：单独准备 sol-safekey

本仓库的 .gitignore 不包含 sol-safekey 子模块目录。生成 keystore.json 前请先克隆该工具仓库：

cd /path/to/parent
git clone https://github.com/0xfnzero/sol-safekey.git
cd sol-safekey
cargo run --release -- export <私钥或助记词> /path/to/fnzero-examples/pumpswap_trade_with_safekey/keystore.json

再在对应示例的 solana.yaml 中设置 keystore_path（如 ./keystore.json）。

4. 隐私与 Git：不要提交的内容

以下文件已被 .gitignore 忽略，且切勿强行 git add -f 提交：

.env、.env.*（除 .env.example）
config/**/solana.yaml、config/**/trading.yaml（本地副本）
keystore.json、任何含私钥的文件

向他人分享代码或提 PR 前，用 git status 确认未包含上述文件。若曾在仓库中误提交过密钥，请立即轮换密钥并清理 Git 历史。

前置要求（环境）

Rust 1.70+ 和 Cargo
Solana CLI（可选）
可用的 Solana RPC（强烈建议自有或付费节点，避免默认公共节点限流）

🚀 快速开始

运行交易示例

须在对应示例子目录下执行（每个目录是独立 Cargo 包，仓库根目录无 workspace）。若尚未完成「运行前准备」中的复制与编辑，请先完成。

方式 1：私钥（PumpSwap 或 PumpFun 二选一）

cd pumpswap_trade          # 外盘；若做内盘则改为 cd pumpfun_trade

cp .env.example .env
cp config/dev/solana.yaml.example config/dev/solana.yaml
cp config/dev/trading.yaml.example config/dev/trading.yaml
# 编辑 .env 与 yaml：PRIVATE_KEY、RPC、SWQoS token、nonce 等（详见「运行前准备」）

./run.sh <TOKEN_MINT_ADDRESS>
# 或: cargo run --release -- <TOKEN_MINT_ADDRESS>

方式 2：加密 keystore（需已按上文单独克隆 sol-safekey）

cd /path/to/sol-safekey
cargo run --release -- export <你的私钥或助记词> /path/to/fnzero-examples/pumpswap_trade_with_safekey/keystore.json

cd /path/to/fnzero-examples/pumpswap_trade_with_safekey   # PumpFun 则用 pumpfun_trade_with_safekey

cp .env.example .env
cp config/dev/solana.yaml.example config/dev/solana.yaml
cp config/dev/trading.yaml.example config/dev/trading.yaml
# 编辑 solana.yaml：keystore_path（如 ./keystore.json）、SWQoS、nonce 等

./run.sh <TOKEN_MINT_ADDRESS>

配置详情

环境变量（.env）

# 环境：dev 或 prod
APP_ENV=dev

# 要交易的代币 mint 地址
MINT=your_token_mint_address

# 买入 SOL 数量
BUY_SOL_AMOUNT=0.01

# RPC URL
SOLANA_RPC_URL=https://your-rpc-endpoint.com

# 密钥库密码（加密密钥使用）
KEYSTORE_PASSWORD=your_password

# Durable nonce 账户（多 SWQoS 时必需）
NONCE_ACCOUNT=your_nonce_account_address

SWQoS 配置（config/dev/solana.yaml）

swqos:
  region: "Frankfurt"  # 或 NewYork、Tokyo 等
  enabled_providers:
    - provider: "Astralane"
      api_token: "your_token"
      enabled: true
    - provider: "BlockRazor"
      api_token: "your_token"
      enabled: true
    # 根据需要添加更多提供商

生产环境构建

各示例通过 .cargo/config.toml 将产物输出到 build-cache/release/（而非默认的 target/release/）。

cd pumpswap_trade    # 或 pumpfun_trade、pumpswap_trade_with_safekey、pumpfun_trade_with_safekey

cargo build --release
./build-cache/release/pumpswap_trade <TOKEN_MINT_ADDRESS>   # 二进制名与目录名一致

# 从 macOS 交叉编译 Linux（需已安装 x86_64-unknown-linux-gnu 工具链）
./build-linux-release.sh   # 生成 linux-release/deploy.tar.gz

📄 许可证

MIT License

详见 LICENSE。

💬 联系方式

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

⚠️ 重要提示

安全: 永远不要将私钥、keystore、solana.yaml / trading.yaml 本地副本或 .env 提交到版本控制；首次运行前务必阅读上文「运行前准备与隐私」
测试: 在主网使用前请在 devnet 上充分测试
风险: 加密货币交易存在重大风险
合规: 确保遵守当地法律法规
RPC 限制: 监控 RPC 使用以避免速率限制
MEV 服务: 正确配置 MEV 保护服务的 API tokens

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

📚 额外资源

由 FnZero 团队用 ❤️ 构建

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

🚀 FnZero Solana 示例项目

Solana DEX 交易与开发的实用示例和工具集

📋 目录

✨ 特性

📁 项目结构

🛠️ 示例

交易示例

如何选择示例

示例特性（四个交易示例共通）

示例文档索引

配置说明

支持的 SWQoS 服务

📦 SDK 与工具

sol-trade-sdk

sol-parser-sdk

sol-safekey

solana-streamer

📋 运行前准备与隐私

1. 克隆本仓库

2. 在示例子目录中从模板生成本地配置（必做）

3. 使用加密钱包时：单独准备 sol-safekey

4. 隐私与 Git：不要提交的内容

前置要求（环境）

🚀 快速开始

运行交易示例

配置详情

环境变量（.env）

SWQoS 配置（config/dev/solana.yaml）

生产环境构建

📄 许可证

💬 联系方式

⚠️ 重要提示

🤝 贡献

📚 额外资源

FilesExpand file tree

README_CN.md

Latest commit

History

README_CN.md

File metadata and controls

🚀 FnZero Solana 示例项目

Solana DEX 交易与开发的实用示例和工具集

📋 目录

✨ 特性

📁 项目结构

🛠️ 示例

交易示例

如何选择示例

示例特性（四个交易示例共通）

示例文档索引

配置说明

支持的 SWQoS 服务

📦 SDK 与工具

sol-trade-sdk

sol-parser-sdk

sol-safekey

solana-streamer

📋 运行前准备与隐私

1. 克隆本仓库

2. 在示例子目录中从模板生成本地配置（必做）

3. 使用加密钱包时：单独准备 sol-safekey

4. 隐私与 Git：不要提交的内容

前置要求（环境）

🚀 快速开始

运行交易示例

配置详情

环境变量（.env）

SWQoS 配置（config/dev/solana.yaml）

生产环境构建

📄 许可证

💬 联系方式

⚠️ 重要提示

🤝 贡献

📚 额外资源