debug_storageRangeAt

eth_getStorageAt reads one slot at a block boundary. debug_storageRangeAt goes much deeper: it walks a contract's storage slots in pages, starting from a key hash you supply and returning up to your requested limit, captured at the state that exists immediately after a specific transaction inside a block. On BNB Smart Chain (BSC), where BEP-20 contracts power apps such as Venus and PancakeSwap and gas is paid in BNB, that mid-block snapshot is exactly what an incident review needs. Issue the call against chain ID 56 at https://bsc.therpc.io/YOUR_API_KEY. The method rebuilds historical state, which is heavy work, so it leans on a debug-enabled archive node.

Use cases

• Dump the full storage layout of a BEP-20 token or vault contract at one precise execution point for an incident post-mortem.
• Check that slot assignments in an upgradeable proxy line up with the layout the implementation contract expects.
• Diff a contract's storage just before and just after a suspicious transaction to see which slots the attacker touched.

Parameters

Response

Example request

1curl https://bsc.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        "0x8894E0a0c962CB723c1976a4421c95949bE2D4E3",
11        "0x0000000000000000000000000000000000000000000000000000000000000000",
12        5
13      ],
14    "id": 1
15  }'

Try it live in the BNB Smart Chain playground.

Errors & troubleshooting

Common pitfalls

• Keys come back as raw keccak256 hashes, so you rebuild mapping entries and dynamic-array slots by hand from the original key preimages.
• Historical blocks require full archive state. A pruned node answers only for the most recent window.
• A large contract holds thousands of slots and returns a bulky response, so set a sensible limit and follow nextKey page by page. Expect throttling on lower tiers.

Supported networks

• Mainnet — Chain ID: 56
• Testnet — Chain ID: 97

See also

• debug_traceTransaction
• debug_traceCall
• trace_replayTransaction

1curl https://bsc.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]}'