trace_replayTransaction

Replays a transaction and returns call traces, state differences, or both.

Erigon reference · All supported methods

Parameters

Parameters are positional, in the order below.

Parameter	Type	Required	Description
transactionHash	32-byte hash	Yes	Transaction to replay.
traceTypes	Array of strings	Yes	trace, stateDiff, or both.

Return value

Tracing output in the requested formats. Replay and simulation results include execution output and the requested call traces or state differences; multi-call and whole-block methods return one result per call or transaction.

Example

Replace <gateway-url> with your gateway base URL and <service-url> with the chain’s service path, such as service/ethereum.

curl -X POST "<gateway-url>/<service-url>" \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","id":1,"method":"trace_replayTransaction","params":["0x1111111111111111111111111111111111111111111111111111111111111111",["trace"]]}'

Illustrative response; values depend on the selected network and request:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "output": "0x",
    "stateDiff": null,
    "trace": [],
    "vmTrace": null
  }
}

Direct behavior

The gateway selects providers supporting the requested tracing group and format. Unsupported formats are rejected rather than replaced.

Supported output types are trace, stateDiff, or both. vmTrace is not supported. The gateway matches the requested combination automatically.

Historical replay requires archive state and full chain history alongside the tracing group. Checks exercise that combination, not just old balance queries and recent traces.

Limits

Reconstruction, internal splitting, and recovery share the gateway deadline; none gives the request an unlimited fresh budget.

For providers

Qualify for the entire applicable tracing group, including required formats and options. Historical combinations are verified separately; recent success alone does not establish historical coverage.

See provider qualification for checks and continued eligibility.