debug_traceCall:参数、返回值与 CU
用 debug_traceCall 在指定区块状态上模拟调用并生成执行追踪,结果格式由 tracer 决定并用于排查调用过程;目标区块超出该链近期状态窗口会返回 -32011,解析失败参数则返回 -32602。
用途
在指定区块状态上模拟执行调用,并生成该调用的执行追踪(Trace)数据。 官方文档
计算单位(CU)与价格
100 CU
$10.00
参数
| 参数名 | 类型 | 说明 |
|---|---|---|
call | object | 交易调用对象,包含 from、to、data、gas、gasPrice、value 等字段。 |
block | QUANTITY|TAG|HASH | 执行追踪所依据的区块号(0x 十六进制数量)、区块哈希,或标签 'latest' / 'pending';使用 safe、finalized、earliest 返回 -32011。 |
options | object | 追踪选项对象(可选):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)。
相关参考
最后更新: