debug_traceTransaction

Replays a transaction and returns its complete EVM execution trace.

Debug methods require a node with debug APIs enabled. Availability and rate limits vary by node provider. These methods replay transactions and are computationally expensive — avoid calling them in hot paths.

Replays a transaction and returns its complete EVM execution trace, including every opcode executed, gas consumed at each step, stack contents, and storage changes.

Parameters

transactionHash · string · required

The 32-byte hash of the transaction to trace.

traceOptions · object

Optional tracing configuration.

Show Trace options fields

disableStorage · boolean

If true, omits storage capture from struct logs. Reduces response size. Defaults to false.

disableMemory · boolean

If true, omits memory capture from struct logs. Reduces response size. Defaults to false.

disableStack · boolean

If true, omits stack capture from struct logs. Defaults to false.

tracer · string

Name of a built-in tracer. Options: "callTracer" (returns a call tree), "prestateTracer" (returns the pre-execution state). Omit to use the default struct log tracer.

tracerConfig · object

Configuration for the selected tracer. For callTracer: { "onlyTopCall": true } skips internal calls.

timeout · string

Execution timeout as a Go duration string (e.g., "10s", "30s"). Defaults to "5s".

Returns

result · object

The execution trace. Format depends on the tracer option selected.

Show Default struct log trace fields

gas · number

Total gas provided for the transaction.

failed · boolean

Whether the transaction failed (reverted).

returnValue · string

Hex-encoded return value from the transaction execution.

structLogs · array

Array of struct log entries, one per EVM opcode executed.

Show Struct log entry fields

pc · number

Program counter position.

op · string

EVM opcode name (e.g., "PUSH1", "SLOAD").

gas · number

Remaining gas at this step.

gasCost · number

Gas cost of this opcode.

depth · number

Call depth (1 = top-level call).

stack · array

EVM stack values at this step.

memory · array

EVM memory contents as 32-byte chunks.

storage · object

Contract storage changes at this step (slot → value).

Show callTracer result fields

type · string

Call type: "CALL", "STATICCALL", "DELEGATECALL", or "CREATE".

from · string

Sender address.

to · string

Recipient address.

value · string

ETH value sent with the call.

gas · string

Gas provided for the call.

gasUsed · string

Gas actually consumed.

input · string

Call data sent.

output · string

Return data from the call.

error · string

Error message if the call reverted. Optional.

calls · array

Array of nested call objects for internal calls.

Example

Request (default trace)

{
  "jsonrpc": "2.0",
  "method": "debug_traceTransaction",
  "params": [
    "0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238",
    {}
  ],
  "id": 1
}