JSON-RPC方法

debug_traceTransaction:参数、返回值与 CU

用 debug_traceTransaction 重放指定交易并返回执行追踪,结果格式由 tracer 决定;第一个参数是 32 字节交易哈希,目标区块须在近期状态窗口内,超出会返回 -32011,可用于定位失败原因。

用途

重放指定交易的执行过程,并生成执行追踪(Trace)数据。 官方文档

计算单位(CU)与价格

单次调用 CU

100 CU

每百万次调用价格(USD)

$10.00

参数

参数名类型说明
transactionHashHASH要追踪的 32 字节交易哈希,0x 十六进制。
optionsobject追踪选项对象(可选):tracer 为 callTracer、flatCallTracer、prestateTracer、4byteTracer 或 noopTracer,省略则使用默认 struct logger,其他值返回 -32602 tracer not allowed;tracerConfig 传入该 tracer 的配置(如 callTracer 的 onlyTopCall、withLog,prestateTracer 的 diffMode);timeout 最长 30s;reexec 为 Geth 兼容选项(非负整数,0 合法),表示重建历史状态时最多回溯并重执行的区块数,不是目标区块号,也不改变追踪目标;接受该参数不代表节点实际发生回溯,支持范围取决于该链节点实现。

返回值

  • 类型: ARRAY (flatCallTracer); OBJECT (callTracer, prestateTracer, 4byteTracer, noopTracer, default struct logger)
  • 说明: 返回形状由 tracer 决定:flatCallTracer 返回平铺 trace 条目数组,每项包含 action、type、整数数组 traceAddress、subtraces,以及成功时的 result 或失败时的 error;区块和交易上下文字段随节点和调用方式而异,模拟调用的 blockHash、transactionHash 可为 null,Arbitrum 条目还可包含 beforeEVMTransfers、afterEVMTransfers。callTracer 返回 CallFrame 调用树对象;prestateTracer 默认返回以地址为键的账户状态对象,diffMode 返回包含 pre、post 的状态差异对象;4byteTracer 返回签名与 calldata 大小到出现次数的映射对象;noopTracer 返回空对象;省略 tracer 时返回包含 gas、failed、returnValue、structLogs 的默认 struct logger 对象。

注意事项

目标交易所在区块须在链的状态保留窗口(state_window_blocks)内,超出窗口返回 -32011(不计费)。

请求示例

export BLOCKVECTRA_API_KEY=rgw_your_api_key

curl -X POST "https://api.blockvectra.com/v1/robinhood_mainnet" \
  -H 'Content-Type: application/json' \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "debug_traceTransaction",
    "params": [
      "<transactionHash>",
      {
        "tracer": "callTracer"
      }
    ],
    "id": 1
  }'

可用链

除以下链外,其余支持链均可用:Arbitrum Nova (arbnova_mainnet)、Arc (arc_mainnet)、Base (base_mainnet)、Berachain (berachain_mainnet)、Boba (boba_mainnet)、BNB Smart Chain (bsc_mainnet)、Celo (celo_mainnet)、Ethereum Sepolia (eth_sepolia)、Fraxtal (fraxtal_mainnet)、Gnosis (gnosis_mainnet)、HyperEVM (hyperevm_mainnet)、Ink (ink_mainnet)、Katana (katana_mainnet)、Linea (linea_mainnet)、Metal L2 (metall2_mainnet)、Mode (mode_mainnet)、OP Mainnet (op_mainnet)、Rootstock (rootstock_mainnet)、Soneium (soneium_mainnet)、Unichain (unichain_mainnet)、World Chain (world_mainnet)、Zora (zora_mainnet)。

最后更新: