Skip to main content

trace_replayTransaction RPC Method

Replays a transaction, returning the traces (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

hash
string

The hash of a transaction

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

object
object

The block trace result (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 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

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": {
5
"output": "0x",
6
"stateDiff": null,
7
"trace": [
8
{
9
"action": {
10
"from": "0x9cc573c775c61d7a783f125d9ff5c3df60a2e718",
11
"callType": "call",
12
"gas": "0x0",
13
"input": "0x",
14
"to": "0x885885521990b53fd00556c143ea056dd2f62a12",
15
"value": "0x8cc0c47d9477f90"
16
},
17
"result": {
18
"gasUsed": "0x0",
19
"output": "0x"
20
},
21
"subtraces": 0,
22
"traceAddress": [],
23
"type": "call"
24
}
25
],
26
"vmTrace": null,
27
"transactionHash": "0x3277c743c14e482243862c03a70e83ccb52e25cb9e54378b20a8303f15cb985d"
28
}
29
}
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": {
5
"output": "0x",
6
"stateDiff": null,
7
"trace": [
8
{
9
"action": {
10
"from": "0x9cc573c775c61d7a783f125d9ff5c3df60a2e718",
11
"callType": "call",
12
"gas": "0x0",
13
"input": "0x",
14
"to": "0x885885521990b53fd00556c143ea056dd2f62a12",
15
"value": "0x8cc0c47d9477f90"
16
},
17
"result": {
18
"gasUsed": "0x0",
19
"output": "0x"
20
},
21
"subtraces": 0,
22
"traceAddress": [],
23
"type": "call"
24
}
25
],
26
"vmTrace": null,
27
"transactionHash": "0x3277c743c14e482243862c03a70e83ccb52e25cb9e54378b20a8303f15cb985d"
28
}
29
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free