trace_transaction
trace_transaction 方法检索由其哈希标识的交易的详细追踪信息。此方法提供了对交易执行的每一步的洞察，包括合约之间的内部调用，允许进行深入分析和调试。
使用场景
- 调试特定交易以识别错误
- 分析单个操作的燃料消耗
- 追踪交易内的内部调用
- 理解复杂的合约交互
- 调查交易失败
- 安全审计和漏洞分析
- 验证预期的合约行为
- 跟踪资金在多个合约之间的流动
- 分析类似交易的执行模式
- 调试失败或回退的交易
方法详情
此方法返回交易执行期间所有操作的追踪数组。
参数:
要追踪的交易的哈希
返回值:
交易中所有操作的追踪对象数组
关于调用操作的详情
调用类型（call, delegatecall 等）
发送者地址
为调用提供的燃料（十六进制）
调用的输入数据（十六进制）
接收者地址
以 wei 为单位转移的价值（十六进制）
包含此追踪的区块的哈希
包含此追踪的区块号
调用结果
使用的燃料量（十六进制）
调用的输出数据（十六进制）
子追踪数量
调用树中追踪位置的地址路径
被追踪的交易的哈希
交易在区块中的索引位置
操作类型（call, create, suicide）
如果调用失败的错误消息（可选）
响应示例
{
"jsonrpc": "2.0",
"id": 1,
"result": [
{
"action": {
"callType": "call",
"from": "0x83806d539d4ea1c140489a06660319c9a303f874",
"gas": "0x1a1f8",
"input": "0x",
"to": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"value": "0x7a16c911b4d00000"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x2982",
"output": "0x"
},
"subtraces": 2,
"traceAddress": [],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"type": "call"
},
{
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x13e99",
"input": "0x16c72721",
"to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
"value": "0x0"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x183",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
},
"subtraces": 0,
"traceAddress": [0],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"type": "call"
},
{
"action": {
"callType": "call",
"from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
"gas": "0x8fc",
"input": "0x",
"to": "0x70faa28a6b8d6829a4b1e649d26ec9a2a39ba413",
"value": "0x7a16c911b4d00000"
},
"blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
"blockNumber": 3068185,
"result": {
"gasUsed": "0x0",
"output": "0x"
},
"subtraces": 0,
"traceAddress": [1],
"transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
"transactionPosition": 2,
"type": "call"
}
]
}
理解追踪树
追踪树表示交易的执行流程：
- 根级追踪：主交易（空
traceAddress） - 第一级子追踪：直接来自主交易的内部调用（
traceAddress为[0]、[1]等） - 更深层级：后续内部调用（
traceAddress为[0, 0]、[0, 1]等）
调用类型
callType 字段可能有不同的值：
- call：常规消息调用
- delegatecall：在调用者上下文中执行代码的调用
- staticcall：只读调用（不允许状态修改）
- callcode：类似于 delegatecall 但传递值（遗留）
追踪类型
type 字段表示操作类型：
- call：消息调用
- create：合约创建
- suicide：合约自毁（SELFDESTRUCT 操作码）
重要注意事项
- 此方法需要在以太坊节点上启用追踪 API
- 对于具有许多内部调用的复杂交易，响应可能非常大
- 该方法计算密集，对于复杂交易可能需要时间完成
- 并非所有以太坊客户端都支持此方法
- 如果节点保持存档数据，才能追踪历史交易
- 一些客户端可能对可追踪的历史交易有限制
- 对于更详细的虚拟机级执行追踪，考虑使用
trace_replayTransaction - 与事件日志不同，追踪捕获所有合约交互，包括那些不发出事件的交互
- 失败的交易仍然会产生直到失败点的追踪
- 出于历史原因，SELFDESTRUCT 操作以类型 "suicide" 出现
另请参阅
- trace_filter - 基于条件搜索追踪
- trace_block - 检索区块中所有交易的追踪
- trace_replayTransaction - 获取带有状态变化的更详细追踪
- debug_traceTransaction - 替代详细交易追踪
帮助我们变得更好！
分享此页面并帮助我们为您创建更好的产品。