Skip to main content

trace_replayBlockTransactions RPC Method

Replays all transactions in a block returning the requested traces for each transaction (Supported on Erigon).

Updated on
Mar 27, 2026
This RPC method is included in the Free Trial with limited usage. Upgrade your plan to get full access and higher limits. Learn more onĀ our pricing page.

Parameters

blockNumber
string

The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators

array
array
REQUIRED

The type of trace, which can be one of the following:

vmTrace
string

To get a full trace of the virtual machine's state during the execution of the given of given transaction, including for any subcalls

trace
string

To get the basic trace of the given transaction

stateDiff
string

To get information on altered Ethereum state due to execution of the given transaction

Returns

array
array

The block traces (all return values are hexadecimal unless otherwise noted):

output
string

The output returned by the execution, encoded in hexadecimal

stateDiff
string

The altered Ethereum state due to execution of the given transaction, or null if not available

trace
array

An array of trace objects describing the execution path

type
string

The type of trace, e.g., 'call' or 'create'

action
object

The action performed in this trace step

from
string

The address of the sender

callType
string

The type of call such as 'call' or 'delegatecall'

gas
string

The gas provided for the call, encoded as hexadecimal

input
string

The input data sent with the transaction, encoded as hexadecimal

to
string

The address of the receiver

value
string

The value sent with this transaction, encoded as hexadecimal

result
object

The result of the call execution

gasUsed
string

The amount of gas used by this call, encoded as hexadecimal

output
string

The return value from the call; contains the bytes returned by the RETURN opcode, or '0x' if empty

subtraces
integer

The number of sub-traces (nested calls) made by this transaction

traceAddress
array

The call path to this trace (an array of integers representing depth and order of execution)

vmTrace
string

The full trace of the EVM state during execution, or null if not enabled

transactionHash
string

The hash of the transaction associated with this trace

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": [
5
{
6
"output": "0x",
7
"stateDiff": null,
8
"trace": [],
9
"vmTrace": null,
10
"transactionHash": "0xbaa27fa540f50254c7200cacfb5c725174f96ae3198b653853e1353a9bdc03b2"
11
},
12
{
13
"output": "0x",
14
"stateDiff": null,
15
"trace": [],
16
"vmTrace": null,
17
"transactionHash": "0x661466a232b217110b9f9a83534cac4b4bf980078ef08489053af9b50f50bee8"
18
}
19
]
20
}
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": [
5
{
6
"output": "0x",
7
"stateDiff": null,
8
"trace": [],
9
"vmTrace": null,
10
"transactionHash": "0xbaa27fa540f50254c7200cacfb5c725174f96ae3198b653853e1353a9bdc03b2"
11
},
12
{
13
"output": "0x",
14
"stateDiff": null,
15
"trace": [],
16
"vmTrace": null,
17
"transactionHash": "0x661466a232b217110b9f9a83534cac4b4bf980078ef08489053af9b50f50bee8"
18
}
19
]
20
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free