debug_storageRangeAt

debug_storageRangeAt reads the raw storage slots of a contract deployed on the Avalanche C-Chain — the EVM chain where AVAX pays for gas and Snowman consensus settles blocks in roughly one to two seconds. Given a block hash, a transaction index, and a contract address, it returns a paginated slice of that contract's storage tree as it stood immediately after the chosen transaction executed. Point your request at https://avalanche.therpc.io/YOUR_API_KEY (chain ID 43114, hex 0xa86a). Because storage can hold thousands of slots, the response is delivered in pages: each call returns up to limit entries plus a nextKey cursor you feed back in as startKey to continue.

Use cases

• Dump the full storage layout of a C-Chain contract at one exact execution point for a post-mortem of an exploit or stuck transaction.
• Verify slot assignments in an upgradeable proxy (common across Avalanche DeFi such as Aave or Trader Joe deployments) against the expected layout.
• Compare a contract's storage before and after a suspicious AVAX-moving transaction to pinpoint which slot changed.

Parameters

Response

Example request

1curl https://avalanche.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 Avalanche playground.

Errors & troubleshooting

Common pitfalls

• Keys come back as raw keccak256 hashes, so mapping and dynamic-array slots must be decoded manually against the contract's Solidity layout — the raw keys are not human-readable.
• Historical C-Chain blocks require an archive node; a pruned node only retains recent state and will return block not found for older blocks.
• A large Avalanche contract may hold thousands of slots; always set a sensible limit and follow nextKey rather than trying to read the entire tree in one call.

Supported networks

• Mainnet — Chain ID: 43114
• Fuji

See also

• debug_traceTransaction
• debug_traceCall
• trace_replayTransaction

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