trace_rawTransaction

Simulates a signed transaction without submitting it.

Erigon reference · All supported methods

Parameters

Parameters are positional, in the order below.

Parameter	Type	Required	Description
signedTransaction	Hexadecimal bytes	Yes	Signed transaction to simulate; it is not broadcast.
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_rawTransaction","params":["0xf869018203e882520894f17f52151ebef6c7334fad080c5704d77216b732881bc16d674ec80000801ba02da1c48b670996dcb1f447ef9ef00b33033c48a4fe938f420bec3e56bfd24071a062e0aa78a81bf0290afbc3a9d8e9a068e6d74caa66c5e0fa8a46deaae96b0833",["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 simulations require archive state. Requests whose execution point is determined by latest follow the reference-block rules.

This method simulates the supplied signed bytes; it does not broadcast them. The transaction’s encoding and declared gas limit are preserved.

Limits

Simulations allow up to 30 million gas per call. Omitted gas uses that ceiling; an explicit higher allowance is rejected rather than silently reduced. State and block overrides are not included in the supported contract.

The signed transaction’s declared gas limit must fit the simulation ceiling. Signed bytes are never rewritten to meet it.

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.