Skip to main content

trace_replayTransaction RPC Method

Replays a transaction, returning the traces (Supported on Erigon).

Updated on
Jun 15, 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
REQUIRED

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 object with the following fields (all return values are hexadecimal unless otherwise noted):

output
string

The data returned as an output encoded in hexadecimal format

stateDiff
object

The altered Ethereum state due to execution of the transaction, null if no state changes

trace
array

An array containing the basic trace of the transaction execution

action
object

The action performed during the trace

from
string

The address of the sender

callType
string

The type of call such as call, delegatecall, staticcall

gas
string

The gas provided by the sender, encoded as hexadecimal

input
string

The data sent along with the call

to
string

The address of the receiver

value
string

The value sent with this call, encoded as hexadecimal

result
object

The result of the trace execution

gasUsed
string

The gas used by this specific call, encoded as hexadecimal

output
string

The value returned by the contract call or empty bytes if no RETURN was executed

subtraces
integer

The number of subtraces created by this call

traceAddress
array

The list of addresses identifying the position of this call in the trace tree

type
string

The type of trace such as call or create

vmTrace
object

The full trace of the virtual machine's state during execution, null if not requested

transactionHash
string

The transaction hash corresponding to this trace

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