debug_storageRangeAt - Pharos
Example code for the debug_storageRangeAt JSON-RPC method. Complete guide on how to use debug_storageRangeAt JSON-RPC in GetBlock Web3 documentation.
This method enumerates storage slots of a contract at a specific block and transaction index, starting from a hashed key. It is a Dedicated Node tier method for deep state inspection.
Parameters
blockHash
string
Yes
32-byte block hash
txIndex
number
Yes
Transaction index within the block
address
string
Yes
20-byte contract address
startKey
string
Yes
Hashed storage key to start from
limit
number
Yes
Maximum number of slots to return
Request
curl --location --request POST 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
"jsonrpc": "2.0",
"method": "debug_storageRangeAt",
"params": ["0x9f2b4c1d7e3a6084b5c9d0e1f2a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d", 0, "0x7e5f1a2b3c4d5e6f70819a2b3c4d5e6f70819a2b", "0x0000000000000000000000000000000000000000000000000000000000000000", 5],
"id": "getblock.io"
}'const axios = require('axios');
const response = await axios.post('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/', {
jsonrpc: '2.0',
method: 'debug_storageRangeAt',
params: ['0x9f2b4c1d7e3a6084b5c9d0e1f2a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d', 0, '0x7e5f1a2b3c4d5e6f70819a2b3c4d5e6f70819a2b', '0x0000000000000000000000000000000000000000000000000000000000000000', 5],
id: 'getblock.io'
}, {
headers: { 'Content-Type': 'application/json' }
});
console.log(response.data.result);import requests
response = requests.post(
'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/',
headers={'Content-Type': 'application/json'},
json={
'jsonrpc': '2.0',
'method': 'debug_storageRangeAt',
'params': ['0x9f2b4c1d7e3a6084b5c9d0e1f2a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d', 0, '0x7e5f1a2b3c4d5e6f70819a2b3c4d5e6f70819a2b', '0x0000000000000000000000000000000000000000000000000000000000000000', 5],
'id': 'getblock.io'
}
)
print(response.json())Response
Response Parameters
jsonrpc
string
JSON-RPC protocol version ("2.0")
id
string
Request identifier matching the request
result
object
Storage entries and a pagination cursor
Use Cases
Deep State Inspection: Enumerate a contract's storage layout
Debugging: Inspect storage as of a specific transaction index
Auditing: Export contract storage for analysis
Reverse Engineering: Map unknown storage slots to values
Error Handling
-32602
Invalid params
Malformed block hash, index, address, or key
-32601
Method not found
The debug namespace is not enabled on this endpoint
Web3 Integration
Was this helpful?