Returns the full EVM execution trace for a transaction. Requires a node with debug APIs enabled.
Replays a transaction and returns its complete EVM execution trace, including every opcode executed, gas consumed at each step, stack contents, and storage changes.
Debug methods replay transactions and are computationally expensive. Availability and rate limits vary among providers in the Builder Stack. Avoid calling these in hot paths.
Parameters
string
required
The 32-byte transaction hash to trace.
object
Optional tracing configuration.
Show Trace Options
string
Built-in tracer name. "callTracer" returns a call tree. "prestateTracer" returns the pre-execution account state. Omit to use the default struct log tracer.
object
Options for the selected tracer. For "callTracer": { "onlyTopCall": true } skips internal calls.
boolean
If true, omits storage capture from struct logs. Reduces response size. Defaults to false.
boolean
If true, omits memory capture from struct logs. Reduces response size. Defaults to false.
boolean
If true, omits stack capture from struct logs. Defaults to false.
string
Execution timeout as a Go duration string (e.g., "10s", "30s"). Defaults to "5s".
Returns
object
The execution trace. Format depends on the tracer option.
Show Default Struct Log Trace
number
Total gas provided for the transaction.
boolean
Whether the transaction failed (reverted).
string
Hex-encoded return value from the execution.
array
Array of struct log entries, one per EVM opcode executed.
Show Struct Log Fields
number
Program counter position.
string
EVM opcode name (e.g., "PUSH1", "SLOAD").
number
Remaining gas at this step.
number
Gas cost of this opcode.
number
Call depth (1 = top-level call).
array
EVM stack values at this step.
array
EVM memory contents as 32-byte chunks.
object
Contract storage changes at this step (slot → value).
Show callTracer Result
string
Call type: "CALL", "STATICCALL", "DELEGATECALL", or "CREATE".