trace-tx 是一个用于获取 EVM 交易完整执行轨迹的技能,基于 debug_traceTransaction API 实现。
用途 该技能用于追踪 EVM 交易的完整执行过程。当用户需要追踪一笔交易、检查内部调用或分析交易失败原因时,可以使用此技能。执行轨迹会揭示完整的调用树,包括每一次内部 CALL、DELEGATECALL、CREATE 调用、每一步消耗的 gas、输入输出数据以及任何 revert 原因。
主要能力
- 通过 debug_traceTransaction 获取交易的完整执行轨迹。
- 展示完整的调用树,涵盖内部 CALL、DELEGATECALL、CREATE 等调用。
- 显示每一步消耗的 gas。
- 显示输入输出数据。
- 显示 revert 原因。
- 默认使用 callTracer(嵌套调用树,适合大多数任务),也支持 prestateTracer 和原始 opcode 轨迹。
使用方式 脚本调用格式: ~/.claude/skills/trace-tx/scripts/trace_tx.sh [-o <output_file>] <TX_HASH> <RPC_URL> [TRACER] [onlyTopCall]
使用用户提供的 RPC URL。
如果设置了 ALCHEMY_API_KEY,可以构造 Alchemy URL:https://<chain-slug>.g.alchemy.com/v2/$ALCHEMY_API_KEY 并将其作为 RPC URL 使用。常见 slug 映射:"Ethereum"/"ETH" → eth-mainnet,"Arbitrum"/"Arb" → arb-mainnet,"Base" → base-mainnet,"Optimism"/"OP" → opt-mainnet,"Polygon"/"MATIC" → polygon-mainnet,"BSC"/"BNB Chain" → bnb-mainnet,"Sepolia" → eth-sepolia。仅在必要时查阅 references/rpc_urls.md 获取完整 slug 列表。
如果两者都不可用,需要寻找一个支持 debug_traceTransaction 且适用于该特定交易的 RPC URL。
默认 tracer 为 callTracer(嵌套调用树,适合大多数任务)。也支持 prestateTracer 和原始 opcode 轨迹。
工作流程 使用 -o 参数将轨迹写入文件,因为轨迹可能达到数兆字节: ~/.claude/skills/trace-tx/scripts/trace_tx.sh -o trace_0xabc123.json 0xabc... https://your-rpc-url
告知用户保存文件的路径。
参考 完整 RPC URL 列表:references/rpc_urls.md
适用场景
- 追踪一笔 EVM 交易的完整执行过程。
- 检查交易中的内部调用。
- 分析交易失败或 revert 的原因。
- 查看每一步的 gas 消耗和输入输出数据。
限制
- 需要可用的 RPC URL,且该 RPC 必须支持 debug_traceTransaction。
- 轨迹文件可能很大(数兆字节),建议使用 -o 输出到文件。
- 关于收费、价格、平台支持范围等更多信息暂未提供。