trace_replayTransaction

trace_replayTransaction replays a single historical OP Mainnet transaction and returns whichever combination of call-tree trace, opcode-level VM trace, and state diff you request through traceTypes. The stateDiff output is the standout: it maps every touched address to its balance, nonce, code, and storage changes, making it ideal for reconstructing exactly what a transaction altered. OP Mainnet is the OP Stack rollup where gas and value are denominated in ETH, chain ID 10 (0xa); send the request to https://optimism.therpc.io/YOUR_API_KEY with the transaction hash and your chosen trace types.

Use cases

• Reconstruct the exact storage changes a historical OP Mainnet transaction caused for forensic analysis.
• Debug a revert by examining the stateDiff to see which storage slot's value triggered the failure.
• Produce a complete audit trail of ETH balance and storage changes for compliance reporting.

Parameters

Response

Example request

1curl https://optimism.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5    "jsonrpc": "2.0",
6    "method": "trace_replayTransaction",
7    "params": [
8        "0x0000000000000000000000000000000000000000000000000000000000000000",
9        [
10          "trace"
11        ]
12      ],
13    "id": 1
14  }'

Try it live in the Optimism playground.

Errors & troubleshooting

Common pitfalls

• Requesting vmTrace on a complex OP Mainnet transaction produces enormous output; stick to trace or stateDiff when you do not need opcode-level detail.
• It requires a trace-enabled archive node; pruned OP Mainnet nodes lack the historical state to replay older transactions.
• The vmTrace format is Parity-specific — do not confuse it with the Geth debug_traceTransaction struct-log format.

Supported networks

• Mainnet — Chain ID: 10
• Sepolia — Chain ID: 11155420

See also

• trace_transaction
• trace_replayBlockTransactions
• trace_call
• debug_traceTransaction

1curl https://optimism.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"trace_replayTransaction","params":["0x0000000000000000000000000000000000000000000000000000000000000000",[]]}'