trace_replayTransaction

trace_replayTransaction re-executes one historical Polygon PoS transaction and returns whichever trace types you request for it. Its standout output is the stateDiff, which marks each touched account with = (unchanged), + (created), - (deleted), or *{from,to} (modified) — a precise record of how a MATIC-fee transaction reshaped chain state. Send the request to https://polygon.therpc.io/YOUR_API_KEY (chain ID 137, 0x89), passing the transaction hash and your traceTypes. It replays the transaction and returns a selectable combination of call-tree trace, opcode-level VM trace, and state diff.

Use cases

• Reconstruct the exact storage changes a historical Polygon transaction caused, for forensic analysis on a QuickSwap or Aave incident.
• Debug a revert by reading the stateDiff to see which storage slot changed (or failed to) right before the failure.
• Produce a complete audit trail of MATIC balance and storage changes for compliance reporting.

Parameters

Response

Example request

1curl https://polygon.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 Polygon playground.

Errors & troubleshooting

Common pitfalls

• Requesting vmTrace on a complex Polygon DeFi transaction produces enormous output — stick to trace or stateDiff when you do not need opcode detail.
• It requires a trace-enabled Bor archive node; recent-state-only Polygon nodes will not serve historical replays.
• The vmTrace format is Parity-specific — do not confuse it with Bor's Geth-style debug_traceTransaction struct-log; the two parse differently.

Supported networks

• Mainnet — Chain ID: 137
• Amoy — Chain ID: 80002

See also

• trace_transaction
• trace_replayBlockTransactions
• trace_call
• debug_traceTransaction

1curl https://polygon.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",[]]}'