solana-arb-executor 是做什么的?
为 Solana 套利搭建 Rust 执行热路径:stream(数据流) -> detect(检测) -> simulate(模拟) -> bundle(打包) -> land(落地),并封装在风险门(限额、熔断器、紧急暂停开关)和确认门中。这是早期项目仅分析的链上层:agiprolabs/claude-trading-skills 是 Python 分析层(信号、回测,无执行),TypeScript 套利技能则跳过了延迟敏感的落地路径。而这是真正的空白区域——需要快速、正确且安全的部分。
诚实的经济学(承重部分): Solana 上的空间 DEX 套利以基础设施为主导且竞争激烈;原始价格差会被网络位置优于单台机器的一方获取。零售操作者的持久优势不是原始速度——而是正确的落地(先模拟、合适的 CU 定价、小费大小、重试纪律)、风险纪律(限额/断路器/紧急暂停开关)以及竞争较少的套利机会(资金费率差异、跨场所利率差距、更长期限的玩法)。这是框架 + 知识,不是托管式机器人,也不是保证盈利的机器。
优先级(先阅读此部分,再生成代码)
- 先阅读
references/safety-rails.md。 所有发出的执行路径都必须遵循它。 - 切勿发出无明确类型化人工确认门的资金转移/签名交易的代码;任何标志都不能绕过它。默认
DRY_RUN=true、REQUIRE_CONFIRM=true。始终在提交前模拟。 - 使用
references/sdk-versions.md中固定的 crate 版本(已验证至 2026-06)。将jito-sdk-rust标记为早期 0.x 版本。 - 通过
references/delegation.md将程序/Anchor/IDL/交易签名工作委托给../solana-dev/。不要在此处重复。 - 强制限额(最大名义金额、最大持仓、每日亏损)+ 断路器 + 紧急暂停开关在每个订单到达确认门之前对其进行把关。
任务路由指南
将用户意图映射到恰好一个叶子节点。
| 用户询问... | 打开此叶子节点 |
|---|---|
| 热路径设计/延迟预算 | references/architecture.md |
| 流账户/插槽/ShredStream 数据摄取 | references/streaming-ingestion.md |
| Jito 打包/小费/领导者时序 | references/jito-bundles.md |
| 落地交易/优先费/模拟/重试 | references/transaction-landing.md |
| 检测机会/价差/阈值 | references/opportunity-detection.md |
| 风险/断路器/紧急暂停开关/限额 | references/risk-and-killswitch.md |
| 安全/确认门 | references/safety-rails.md |
| crate/版本/安装 | references/sdk-versions.md |
| 程序/Anchor/签名 | references/delegation.md |
渐进式公开
- 路由(此文件): 仅提供指针——无大量内容。
- 叶子节点(每节点约 60-200 行): 紧凑、正确、最小化。代码位于
skill/templates/。 - 纯逻辑可离线测试:
templates/src/fees.rs和templates/src/risk.rs仅依赖标准库且自包含——可独立运行rustc --edition 2021 --test fees.rs(和risk.rs)。完整 crate(stream.rs、jito.rs、detector.rs、main.rs)可通过cargo build针对固定 crate 编译。 - 委托:
../solana-dev/用于程序/交易/签名。
代理
| 代理 | 角色 | 模型 |
|---|---|---|
agents/arb-execution-architect.md | 在写代码前设计延迟预算、数据摄取/落地拓扑结构和风险边界 | opus |
agents/rust-perf-engineer.md | 连接流 -> 检测器 -> RiskGate(风险门)-> 先模拟的 Jito 打包 | sonnet |
命令
| 命令 | 功能 |
|---|---|
commands/scaffold-executor.md | 生成执行器 crate 骨架(默认 DRY_RUN + REQUIRE_CONFIRM) |
commands/wire-yellowstone.md | 生成带重连/回退的 Yellowstone gRPC 数据摄取模块 |
commands/add-killswitch.md | 插入带限额 + 断路器 + 紧急暂停开关的 RiskGate(风险门) |