debug_traceTransaction:参数、返回值与 CU
用 debug_traceTransaction 重放指定交易并返回执行追踪,结果格式由 tracer 决定;第一个参数是 32 字节交易哈希,目标区块须在近期状态窗口内,超出会返回 -32011,可用于定位失败原因。
用途
重放指定交易的执行过程,并生成执行追踪(Trace)数据。 官方文档
计算单位(CU)与价格
100 CU
$10.00
参数
| 参数名 | 类型 | 说明 |
|---|---|---|
transactionHash | HASH | 要追踪的 32 字节交易哈希,0x 十六进制。 |
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 合法),表示重建历史状态时最多回溯并重执行的区块数,不是目标区块号,也不改变追踪目标;接受该参数不代表节点实际发生回溯,支持范围取决于该链节点实现。 |
返回值
- 类型:
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)。
相关参考
最后更新: