debug_dumpBlock | Arbitrum

POST /66f812de2a6724a75a51f60dd6f2a154

debug_dumpBlock

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_dumpBlock",
  "params": [
    "latest"
  ]
}
'

200

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

Arbitrum API method that retrieves the state of all accounts at a given block number. This method returns a dump of the state trie, including account balances, nonces, code hashes, and storage. It is primarily used for debugging and state inspection.

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

• quantity — the block number in hex format or block tag (latest, earliest, pending, safe, finalized).

Response

• result — an object containing the state dump:
  • root — the state root hash of the block.
  • accounts — a map of account addresses to account data:
    • balance — the account balance in Wei.
    • nonce — the account nonce.
    • root — the storage root hash.
    • codeHash — the hash of the account’s contract code.
    • code — the contract bytecode.
    • storage — the account’s storage slots.
    • address — the account address.

This method returns up to 256 accounts per call. For iterating over all accounts, use debug_accountRange which supports pagination.

debug_dumpBlock code examples

ethers.js

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

const debugDumpBlock = async (blockNumber) => {
  const result = await provider.send("debug_dumpBlock", [blockNumber]);
  console.log(result);
};

debugDumpBlock("latest");

Use case

The debug_dumpBlock method is useful for inspecting the state of all accounts at a specific block. Developers can use it to verify account states during debugging, compare state snapshots between blocks, or build tools that analyze the distribution of contract deployments and account balances at a point in time.

Body

application/json

id · integer · default: 1

jsonrpc · string · default: 2.0

method · string · default: debug_dumpBlock

params · string[]

Block number in hex format or tag (latest, earliest, pending, safe, finalized).

Response

200 - application/json

Returns the state dump at the given block.

jsonrpc · string

id · integer

result · object