SuperAPI AI 工具集

trace-tx

编程与开发

查看项目

更新于 10-16 07:12

技能介绍

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 输出到文件。
  • 关于收费、价格、平台支持范围等更多信息暂未提供。