debug_storageRangeAt

debug_storageRangeAt returns a paginated slice of an OP Mainnet contract's raw storage slots, captured at the state that exists immediately after a specific transaction within a block has executed. On OP Mainnet — the OP Stack rollup where gas is paid in ETH — this lets you read the exact storage of any deployed contract (a Velodrome pool, a Synthetix vault, or your own contract) at a precise historical point, not just its current state. Point your request at https://optimism.therpc.io/YOUR_API_KEY (chain ID 10, 0xa); you supply the block hash, the transaction index inside that block, the contract address, a start key, and a limit, and the node walks the storage trie from that key.

Use cases

• Dump the full storage layout of an OP Mainnet contract at a specific execution point for post-mortem analysis.
• Verify slot assignments in an upgradeable proxy (common in OP Stack governance and DeFi contracts) against the expected layout before an upgrade.
• Compare a contract's storage state before and after a suspicious transaction to pinpoint exactly which slot changed.

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": "debug_storageRangeAt",
7    "params": [
8        "0x0000000000000000000000000000000000000000000000000000000000000000",
9        0,
10        "0x0000000000000000000000000000000000000000",
11        "0x0000000000000000000000000000000000000000000000000000000000000000",
12        5
13      ],
14    "id": 1
15  }'

Try it live in the Optimism playground.

Errors & troubleshooting

Common pitfalls

• Keys come back as raw keccak256 hashes — mapping and dynamic-array slots have to be decoded manually against the contract's Solidity layout.
• Reading any non-recent OP Mainnet block requires an archive node; a pruned node only retains state for the last few thousand blocks.
• Large contracts can hold thousands of slots, so always set a sane limit and follow nextKey to page rather than pulling everything at once.

Supported networks

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

See also

• debug_traceTransaction
• debug_traceCall
• trace_replayTransaction

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":"debug_storageRangeAt","params":["0x0000000000000000000000000000000000000000000000000000000000000000",0,"","0x0000000000000000000000000000000000000000000000000000000000000000",10]}'