TheRPC入门

已选择的链

Ethereum

介绍

API参考

以太坊API

Core API

Trace API

Debug API

指南

基本操作

指南

SDK和工具

常见问题

Ethereum/Trace API/trace_replayBlockTransactions

trace_replayBlockTransactions

trace_replayBlockTransactions 方法重放指定区块中的所有交易并返回每个交易的详细追踪信息。这提供了对交易执行流程的见解，允许进行详细分析和调试。

使用场景

分析特定区块中的交易执行流程
调试复杂的智能合约交互
理解交易执行导致的状态变化
审计和验证交易结果
燃料优化研究
调查失败的交易
研究和分析历史区块
测试特定区块条件下的合约行为
识别区块中多个交易的模式
在交易级别验证共识规则

方法详情

此方法重放区块中的所有交易并提供详细的追踪信息。

参数:

blockNumberstring[required]

十六进制格式的区块号或区块标签（latest, earliest, pending）

traceTypesarray[required]

响应中包含的追踪类型数组

返回值:

resultarray

区块中每个交易的追踪结果数组

outputstring

交易的输出数据

stateDiffobject

交易导致的状态差异（如果请求）

addressobject

地址的状态变化

tracearray

追踪对象数组

actionobject

关于调用操作的详情

callTypestring

调用类型（call, delegatecall 等）

fromstring

发送者地址

gasstring

为调用提供的燃料

inputstring

调用的输入数据

tostring

接收者地址

valuestring

以 wei 为单位转移的价值

resultobject

调用结果

gasUsedstring

使用的燃料量

outputstring

调用的输出数据

subtracesinteger

子追踪数量

traceAddressarray

调用树中追踪位置的地址路径

typestring

追踪类型

transactionHashstring

交易的哈希

vmTraceobject

虚拟机执行追踪（如果请求）

codestring

正在执行的 EVM 字节码

opsarray

已执行操作的数组

costinteger

操作的燃料成本

exobject

操作的执行结果

pcinteger

程序计数器

subobject

关于调用子执行的信息

响应示例

{
	"jsonrpc": "2.0",
	"id": 1,
	"result": [
		{
			"output": "0x0000000000000000000000000000000000000000000000000000000000000001",
			"stateDiff": {
				"0x1234567890123456789012345678901234567890": {
					"balance": {
						"*": {
							"from": "0x100",
							"to": "0x110"
						}
					},
					"code": "=",
					"nonce": {
						"*": {
							"from": "0x10",
							"to": "0x11"
						}
					},
					"storage": {
						"0x0000000000000000000000000000000000000000000000000000000000000001": {
							"*": {
								"from": "0x0000000000000000000000000000000000000000000000000000000000000000",
								"to": "0x0000000000000000000000000000000000000000000000000000000000000001"
							}
						}
					}
				}
			},
			"trace": [
				{
					"action": {
						"callType": "call",
						"from": "0x71c7656ec7ab88b098defb751b7401b5f6d8976f",
						"gas": "0x4c40d",
						"input": "0xa9059cbb000000000000000000000000ea674fdde714fd979de3edf0f56aa9716b898ec80000000000000000000000000000000000000000000000002b5e3af16b1880000",
						"to": "0xdac17f958d2ee523a2206206994597c13d831ec7",
						"value": "0x0"
					},
					"result": {
						"gasUsed": "0x9868",
						"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
					},
					"subtraces": 0,
					"traceAddress": [],
					"type": "call"
				}
			],
			"transactionHash": "0x69f8de1af3129dc3b1adb5b3c1577476f737f9335f156e177b48c2ed88f3f7c4",
			"vmTrace": {
				"code": "0x60606040...",
				"ops": [
					{
						"cost": 3,
						"ex": {
							"mem": null,
							"push": ["0x60"],
							"store": null,
							"used": 16723979
						},
						"pc": 0,
						"sub": null
					}
					// 额外的操作...
				]
			}
		}
		// 额外的交易追踪...
	]
}