debug_storageRangeAt

debug_storageRangeAt reads the raw storage trie of a contract deployed on Polygon PoS — the MATIC-fee EVM chain whose Bor client is Geth-based, so this Geth-style debug method behaves exactly as it does on mainnet Ethereum. Point the call at https://polygon.therpc.io/YOUR_API_KEY (chain ID 137, 0x89). Given a block hash, a transaction index, and a contract address, it returns a paginated slice of that contract's raw storage slots at the state following the chosen transaction within the block, along with a nextKey cursor when more slots remain.

Use cases

• Dump the full storage layout of a QuickSwap pool or Aave market contract at a specific execution point for post-mortem analysis.
• Verify slot assignments in an upgradeable proxy pattern (common across Polygon DeFi deployments) against the expected layout.
• Compare a contract's storage state before and after a suspicious transaction to pinpoint exactly which slot changed.

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

Try it live in the Polygon playground.

Errors & troubleshooting

Common pitfalls

• Keys come back as raw keccak256 hashes, so mapping and dynamic-array slots must be decoded by hand against the Solidity layout — the method does not resolve human-readable variable names.
• Because Polygon produces a block every ~2 seconds, historical blocks fall outside recent state quickly; reading any older block requires a Bor archive node.
• Heavily used Polygon contracts can hold thousands of storage slots, so always set a sensible limit and follow the nextKey cursor instead of trying to pull everything in one call.

Supported networks

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

See also

• debug_traceTransaction
• debug_traceCall
• trace_replayTransaction

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