debug_accountRange - Scroll

Example code for the debug_accountRange JSON-RPC method. Complete guide on how to use debug_accountRange JSON-RPC in GetBlock Web3 documentation.

This method enumerates a range of accounts from the state trie at a given block, starting from a hashed key. It is a Dedicated Node tier method used for state export and analysis.

This method belongs to the debug namespace and is available on GetBlock Dedicated Nodes only. It is not served on shared endpoints.

Parameters

Parameter	Type	Required	Description
blockParameter	string	Yes	Block number in hex, block hash, or "latest"
startKey	string	Yes	Hashed account key to start from
limit	number	Yes	Maximum number of accounts to return

Request

cURL

curl --location --request POST 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "debug_accountRange",
    "params": ["0x14b8a10", "0x0000000000000000000000000000000000000000000000000000000000000000", 5],
    "id": "getblock.io"
}'

Axios

example.js

const axios = require('axios');

const response = await axios.post('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/', {
    jsonrpc: '2.0',
    method: 'debug_accountRange',
    params: ['0x14b8a10', '0x0000000000000000000000000000000000000000000000000000000000000000', 5],
    id: 'getblock.io'
}, {
    headers: { 'Content-Type': 'application/json' }
});

console.log(response.data.result);

Request

example.py

import requests

response = requests.post(
    'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/',
    headers={'Content-Type': 'application/json'},
    json={
        'jsonrpc': '2.0',
        'method': 'debug_accountRange',
        'params': ['0x14b8a10', '0x0000000000000000000000000000000000000000000000000000000000000000', 5],
        'id': 'getblock.io'
    }
)

print(response.json())

Rust

example.rs

use reqwest::Client;
use serde_json::{json, Value};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();

    let response = client
        .post("https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/")
        .header("Content-Type", "application/json")
        .json(&json!({
            "jsonrpc": "2.0",
            "method": "debug_accountRange",
            "params": ["0x14b8a10", "0x0000000000000000000000000000000000000000000000000000000000000000", 5],
            "id": "getblock.io"
        }))
        .send()
        .await?
        .json::<Value>()
        .await?;

    println!("Result: {}", response["result"]);
    Ok(())
}

Response

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": {
        "root": "0x56e81f...",
        "accounts": {},
        "next": "0x0a1b..."
    }
}

Response Parameters

Parameter	Type	Description
jsonrpc	string	JSON-RPC protocol version ("2.0")
id	string	Request identifier matching the request
result	object	State root, account map, and pagination cursor

Use Cases

• State Export: Page through accounts for a state snapshot

• Analytics: Sample the account set at a historical block

• Auditing: Enumerate accounts for compliance or research

• Migration Tooling: Extract account state for chain analysis

Error Handling

Error Code	Message	Description
-32602	Invalid params	Malformed block parameter, start key, or limit
-32601	Method not found	The debug namespace is not enabled on this endpoint

Web3 Integration

Ethers.js

ethers-example.js

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/');

const range = await provider.send('debug_accountRange', ['0x14b8a10', '0x00...00', 5]);

Viem

viem-example.js

import { createPublicClient, http } from 'viem';

const client = createPublicClient({
  transport: http('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/')
});

const range = await client.request({ method: 'debug_accountRange', params: ['0x14b8a10', '0x00...00', 5] });