JSON-RPC方法

debug_traceCall:参数、返回值与 CU

用 debug_traceCall 在指定区块状态上模拟调用并生成执行追踪,结果格式由 tracer 决定并用于排查调用过程;目标区块超出该链近期状态窗口会返回 -32011,解析失败参数则返回 -32602。

用途

在指定区块状态上模拟执行调用,并生成该调用的执行追踪(Trace)数据。 官方文档

计算单位(CU)与价格

单次调用 CU

100 CU

每百万次调用价格(USD)

$10.00

参数

参数名类型说明
callobject交易调用对象,包含 from、to、data、gas、gasPrice、value 等字段。
blockQUANTITY|TAG|HASH执行追踪所依据的区块号(0x 十六进制数量)、区块哈希,或标签 'latest' / 'pending';使用 safe、finalized、earliest 返回 -32011。
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 合法),表示重建历史状态时最多回溯并重执行的区块数,不是目标区块号,也不改变追踪目标;接受该参数不代表节点实际发生回溯,支持范围取决于该链节点实现;另支持 stateOverrides、blockOverrides 与 txIndex。

返回值

  • 类型: 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(不计费)。网关接受 pending 标签,但节点支持范围取决于链:在 arb_mainnet 上,debug_traceCall 的 block=pending 可返回节点错误 -32000,消息为 tracing on top of pending is not supported;此错误原样透传,不改写为 -32010 或 -32011。请改用 latest 或明确的区块号、区块哈希。

请求示例

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_traceCall",
    "params": [
      {
        "to": "<toAddress>",
        "data": "<callData>"
      },
      "latest",
      {
        "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)。

最后更新: