Skip to main content
POST
/
efb0a5eccd2caa5135eb54eba6f7f300
debug_storageRangeAt
curl --request POST \
  --url https://optimism-mainnet.core.chainstack.com/efb0a5eccd2caa5135eb54eba6f7f300 \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "method": "debug_storageRangeAt",
  "id": 1,
  "params": [
    "0x00e80e42fdb4bc373a520c376091421452d26c57e67615f27a7d0fc8e47f1853",
    5,
    "0x94b008aA00579c1307B0EF2c499aD98a8ce58e58",
    "0x00000000000000000000000000000000",
    2
  ]
}
'
{
  "jsonrpc": "<string>",
  "id": 123,
  "result": {
    "storage": {},
    "complete": true
  }
}
The debug_storageRangeAt RPC method retrieves storage entries from a contract at a specific block. This method is useful for developers and analysts who need to inspect the state of a contract’s storage at a particular point in time.
Get you own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Request

To use debug_storageRangeAt, send a POST request with a JSON RPC call in the body.

​
Parameters

  • Block Hash (string): The hash of the block.
  • Transaction Index (integer): The index of the transaction in the block.
  • Contract Address (string): The address of the contract.
  • Storage Key (string): The starting point of the storage to inspect.
  • Max Results (integer): The maximum number of storage entries to return.

​
Response

The response includes storage entries within the specified range and a flag indicating if the storage snapshot is complete.
  • storage (object): A map of storage entries.
  • complete (boolean): Indicates whether the snapshot of storage is complete.

​
Use case

The debug_storageRangeAt method is essential for:
  • Developers debugging smart contracts by inspecting storage states at specific blocks.
  • Analysts conducting forensic analysis of contract interactions.
  • Tools and services that provide insights into contract state changes over time.

Body

application/json
​
jsonrpc
string
default:2.0
required
​
method
string
default:debug_storageRangeAt
required
​
id
integer
default:1
required
​
params
(string | integer)[]
required

Response

200 - application/json

Storage data for the specified range

​
jsonrpc
string
​
id
integer
​
result
object

The storage entries and a flag indicating if the storage is complete.

Last modified on August 7, 2025