debug_getAccessibleState | Arbitrum

POST /66f812de2a6724a75a51f60dd6f2a154

debug_getAccessibleState

cURL

curl --request POST \
  --url https://nd-954-882-037.p2pify.com/66f812de2a6724a75a51f60dd6f2a154 \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "debug_getAccessibleState",
  "params": [
    "0x1C9C380",
    "latest"
  ]
}
'

200

{
  "jsonrpc": "<string>",
  "id": 123,
  "result": 123
}

Arbitrum API method that finds the first block number in a given range where the state is accessible on disk. This is useful for determining which historical states are available for querying on the node, as nodes may prune older state data.

Learn how to deploy a node with the debug and trace API methods enabled.

This method is available for post-Nitro blocks only (block 22,207,815 and later). For pre-Nitro blocks, use the arbtrace_* methods instead.

Get your 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.

Parameters

• from — the start of the block range to search, as a hex-encoded block number or block tag.
• to — the end of the block range to search, as a hex-encoded block number or block tag.

Response

• result — the block number (as a decimal integer) of the first block in the range where the state is accessible. Returns an error if no accessible state is found in the range.

debug_getAccessibleState code examples

ethers.js

const ethers = require('ethers');
const NODE_URL = "YOUR_CHAINSTACK_ENDPOINT";
const provider = new ethers.JsonRpcProvider(NODE_URL);

const debugGetAccessibleState = async (from, to) => {
  const result = await provider.send("debug_getAccessibleState", [from, to]);
  console.log(result);
};

debugGetAccessibleState("0x1C9C380", "latest");

Use case

The debug_getAccessibleState method is useful for determining the historical state availability of a node. Before calling state-dependent methods like debug_accountRange or debug_dumpBlock on a specific block, developers can use this method to verify that the node still has the state data for that block. This is particularly relevant for nodes that use state pruning, where older state data may have been removed.

Body

application/json

id · integer · default: 1

jsonrpc · string · default: 2.0

method · string · default: debug_getAccessibleState

params · string[]

Block number in hex format or tag.

Response

200 - application/json

Returns the first block number in the range where state is accessible.

jsonrpc · string

id · integer

result · integer