debug_storageRangeAt | Optimism

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.


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


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


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.

Try the debug_storageRangeAt RPC method yourself

Click Try It! to start a request and see the response here!