eth_getCode - BSC

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

This method returns the bytecode stored at a given address on the BNB Smart Chain. This is useful for verifying contract deployments, distinguishing between EOAs and contracts, and analyzing smart contract code.

Parameters

Parameter	Type	Required	Description
address	string	Yes	Contract address to query
blockNumber	string	Yes	Block number in hex, or "latest", "earliest", "pending"

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

JavaScript (Axios)

request.js

const axios = require('axios');

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

// USDT contract on BSC
const payload = {
    jsonrpc: '2.0',
    method: 'eth_getCode',
    params: ['0x55d398326f99059fF775485246999027B3197955', 'latest'],
    id: 'getblock.io'
};

axios.post(url, payload, {
    headers: { 'Content-Type': 'application/json' }
})
.then(response => {
    const code = response.data.result;
    console.log('Is Contract:', code !== '0x');
    console.log('Code Length:', (code.length - 2) / 2, 'bytes');
})
.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_getCode",
    "params": ["0x55d398326f99059fF775485246999027B3197955", "latest"],
    "id": "getblock.io"
}

response = requests.post(url, headers={"Content-Type": "application/json"}, json=payload)
code = response.json()["result"]
print(f"Is Contract: {code != '0x'}")

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_getCode",
        "params": ["0x55d398326f99059fF775485246999027B3197955", "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

response.json

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

Response Parameters

Parameter	Type	Description
result	string	Bytecode (0x if EOA, actual bytecode if contract)

Use Cases

• Verify contract deployment on BSC

• Distinguish contracts from EOAs

• Analyze BEP-20 token contracts

• Validate proxy implementations

• Security auditing

Error Handling

Error Code	Description
-32602	Invalid params - malformed address
-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 code = await provider.getCode('0x55d398326f99059fF775485246999027B3197955');
console.log('Is Contract:', code !== '0x');

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 code = await client.getCode({
    address: '0x55d398326f99059fF775485246999027B3197955'
});
console.log('Is Contract:', code !== undefined && code !== '0x');