如何 10 分钟跑起 jev-trader：AI 链上交易机器人 Dry-Run 快速上手完整指南

如何 10 分钟跑起 jev-traderAI 链上交易机器人 Dry-Run 快速上手完整指南【免费下载链接】jev-traderOne AI trade decision every Monad block. Jev on Kuru MON-USDC.项目地址: https://gitcode.com/gh_mirrors/je/jev-traderjev-trader 是什么jev-trader是一个跑在 Monad 链上的AI 链上交易机器人它让 TypeSafe 的 Jev 模型盯着 Kuru 交易所的 MON-USDC 订单簿每 300 毫秒一个区块就做一次买入/卖出决策并真实挂出一笔 post-only 限价单。对新手最友好的一点是不配置钱包私钥时它自动进入Dry-Run 模拟模式——真实行情、真实决策、模拟成交零风险体验完整链路。整个上手过程大约 10 分钟装 Bun → 三条命令跑起来 → 打开浏览器看 AI 实时交易。下面开始。5 分钟安装一条命令 clone 安装依赖前置要求只需安装 Bun项目基于 Bun 运行时自动加载.env无需 dotenv。一键安装步骤克隆仓库git clone https://gitcode.com/gh_mirrors/je/jev-trader cd jev-trader初始化环境并启动cp .env.example .env bun install bun run start这三条命令就是 README 里给出的全部启动流程bun run start实际执行的是 package.json 中的bun run src/index.ts。启动后终端会打印一行类似下面的状态行来自 src/index.tsjev-trader · modelmock · post-only 1 tick inside the touch · horizon 100 blocks · DRY RUN · :3000看到DRY RUN字样说明模拟模式已生效。此时打开浏览器访问http://localhost:3000就能看到一个每 300 毫秒跳动一次的实时交易仪表盘。配置环境变量.env 关键项解读所有配置集中在 src/config.ts模板文件是 .env.example。Dry-Run 场景下你不需要改任何一行默认值即可运行但建议了解这几个关键开关变量默认值作用PRIVATE_KEY空留空即 Dry-Run真实行情 模拟成交填入私钥则真实发单DRY_RUNtrue显式强制模拟模式MODELmock决策大脑mock为内置动量启发式jev为真实 AI 模型TRADE_SIZE_MON200每笔挂单数量Kuru 该市场的最低下单量MAX_POSITION_MON1000最大持仓上限HORIZON_BLOCKS100模型预判的价格窗口约 30 秒PORT3000仪表盘服务端口RPC_URL/READ_RPC_URLMonad 公共 RPC公共端点免费模拟模式直接够用⚠️ 提示真实交易live才需要自备钱包、保证金资金和专用 RPC 节点本文的 Dry-Run 全程使用公共 RPC无需任何付费服务。Dry-Run 模式是怎么模拟成交的Dry-Run 并非假数据回放而是一条真实链上数据 本地撮合的完整流水线理解它能帮你读懂仪表盘上的每个数字读订单簿每个区块一次eth_call读取 Kuru MON-USDC 的挂单src/book.ts公共 RPC 实测约 18 ms模型决策把订单簿、价差、近期成交流压缩成一份紧凑状态喂给模型得到buy/sell及各自概率src/model.ts模拟挂单在模型选中的方向、最优价内侧 1 个 tick 处挂一笔 200 MON 的 post-only 限价单src/trader.ts真实成交判定链上真实的吃单成交单如果扫过模拟挂单的价格就按该价格模拟成交simulated: true。也就是说行情是真的、决策是真的、PL 计算是真的只有发交易这一步被本地替换。每笔块事件还会追加写入data/events.jsonl方便事后回放分析。仪表盘上你会看到什么仪表盘是一个单页应用源码在 web/src/设计上动效即内容——每 300 ms 都有可见变化价格曲线MON-USDC 中间价滚动图每个成交点标记绿/红三角决策面板web/src/components/DecisionPanel/本区块 AI 的 buy/sell 概率条、决策耗时毫秒级计数器行web/src/components/StatsRow/区块数、决策数、成交数、AI 推理花费、Gas 花费、PL——六个数字全部实时成交记录带web/src/components/Feed/最近 12 笔成交含区块高度、方向、价格、交易哈希。后端通过 SSE/events端点把每个区块的事件推给前端src/server.ts所以浏览器里的跳动就是链上节奏本身约每秒 3.3 次。进阶把 mock 换成真正的 Jev 模型默认MODELmock是一个动量 订单簿失衡的确定性启发式src/model.ts作用是在没有 AI 密钥时也能跑通整条生产管线它甚至故意 sleep 80 ms 来模拟推理延迟。想接入真正的 Jev只需改 .env 两行MODELjev TYPESAFE_AI_API_KEY你的密钥Jev 走 AI SDK 的 typed evaluation 接口只返回带概率的结构化决策约 100 ms 出结果不输出任何文本。项目里还有个有趣的对比Jev 推理一小时的成本约 $0.20而同一小时 Gas 要 $2~5——正如 SPEC.md 里写的那样AI 比 Gas 还便宜。项目结构速览源码非常精炼核心就 9 个文件值得一读src/config.ts 环境变量与默认值 src/chain.ts 区块流WebSocket newHeads 轮询兜底 src/book.ts 单次 eth_call 读取并解码订单簿 src/market.ts Kuru 挂单/撤单、保证金、本地 nonce src/model.ts 模型接口JevModel / MockModel src/trader.ts 主循环读簿 → 决策 → 挂单 → 持仓与 PL 记账 src/server.ts Bun.serve快照、历史、SSE 推送完整设计思路见 SPEC.md300 ms 预算的热路径优化细节在 README.md 的 The 300 ms budget 一节整条热路径只有 2 次 RPC 往返读簿 p50 约 18 ms、整循环 p50 约 100 ms。常见问题FAQQ1没有 API Key、没有私钥能跑吗能。PRIVATE_KEY留空 MODELmock就是纯本地 Dry-Run公共 RPC 免费这是本文推荐的第一次运行方式。Q2为什么决策显示hold模型超时decision.late: true时该区块不发单只记一次holdsrc/trader.ts。mock 模型极少出现接入真实模型后偶属正常。Q3Dry-Run 的 PL 是亏的正常吗正常且刻意如此。项目定位是展示 AI 决策过程不是盈利策略post-only 挂单赚取价差但价差与 Gas 的侵蚀会被如实展示亏损和盈利同样醒目。Q4能改成其他交易对吗可以MARKET与MARGIN_ACCOUNT指向 Kuru 的具体市场合约.env.example但该机器人是按 MON-USDC 的精度和最低单量200 MON调校的换市场建议先阅读 src/market.ts。小结你的 10 分钟清单安装 Bungit clone仓库30 秒cp .env.example .env bun installbun run start确认输出DRY RUN浏览器打开http://localhost:3000看 AI 每 300 ms 交易一次可选填入TYPESAFE_AI_API_KEY把MODEL改为jev体验真·AI 决策至此你就已经跑起了一个每个 Monad 区块都做出真实 AI 交易决策的链上机器人。下一步建议打开 SPEC.md 看看产品设计的取舍或者进 src/trader.ts 读懂主循环——它是理解AI 如何变成链上订单的最短路径。【免费下载链接】jev-traderOne AI trade decision every Monad block. Jev on Kuru MON-USDC.项目地址: https://gitcode.com/gh_mirrors/je/jev-trader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考