eth_getStorageAt - BSC

Example code for the eth_getStorageAt JSON RPC method. Сomplete guide on how to use eth_getStorageAt JSON RPC in GetBlock Web3 documentation.

This method returns the value from a storage position at a given address on the BNB Smart Chain. This allows reading raw contract storage, including private variables.

Parameters

Parameter	Type	Required	Description
address	string	Yes	Contract address
position	string	Yes	Storage position (hex)
blockNumber	string	Yes	Block number or "latest"

Request Example

cURL

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": "eth_getStorageAt",
    "params": [
        "0x55d398326f99059fF775485246999027B3197955",
        "0x0",
        "latest"
    ],
    "id": "getblock.io"
}'

JavaScript (Axios)

request.js

const axios = require('axios');

const url = 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/';

const payload = {
    jsonrpc: '2.0',
    method: 'eth_getStorageAt',
    params: [
        '0x55d398326f99059fF775485246999027B3197955',
        '0x0',
        'latest'
    ],
    id: 'getblock.io'
};

axios.post(url, payload, {
    headers: { 'Content-Type': 'application/json' }
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

Python

request.py

import requests

url = "https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/"

payload = {
    "jsonrpc": "2.0",
    "method": "eth_getStorageAt",
    "params": [
        "0x55d398326f99059fF775485246999027B3197955",
        "0x0",
        "latest"
    ],
    "id": "getblock.io"
}

response = requests.post(url, headers={"Content-Type": "application/json"}, json=payload)
print(response.json())

Rust

main.rs

use reqwest::Client;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    
    let payload = json!({
        "jsonrpc": "2.0",
        "method": "eth_getStorageAt",
        "params": [
            "0x55d398326f99059fF775485246999027B3197955",
            "0x0",
            "latest"
        ],
        "id": "getblock.io"
    });

    let response = client
        .post("https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/")
        .header("Content-Type", "application/json")
        .json(&payload)
        .send()
        .await?;

    let result: serde_json::Value = response.json().await?;
    println!("{:#?}", result);
    
    Ok(())
}

Response Example

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": "0x000000000000000000000000f68a4b64162906eff0ff6ae34e2bb1cd42fef62d"
}

Response Parameters

Parameter	Type	Description
result	string	32-byte storage value

Use Cases

• Read private contract variables

• Analyze proxy implementations

• Debug contract state

• Security research

Error Handling

Error Code	Description
-32602	Invalid params
-32603	Internal error

SDK Integration

Ethers.js

ethers.js

const { ethers } = require('ethers');

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

const storage = await provider.getStorage(
    '0x55d398326f99059fF775485246999027B3197955',
    0
);
console.log(storage);

Viem

viem.js

import { createPublicClient, http } from 'viem';
import { bsc } from 'viem/chains';

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

const storage = await client.getStorageAt({
    address: '0x55d398326f99059fF775485246999027B3197955',
    slot: '0x0'
});
console.log(storage);