POST
/
efb0a5eccd2caa5135eb54eba6f7f300
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 today

Start 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.