eth_getCode | Avalanche

Avalanche API method that retrieves the compiled bytecode of a smart contract providing its address as a parameter. This method returns a hexadecimal string representing the smart contract's bytecode.

Developers can use this bytecode to verify if a smart contract is legitimate and to ensure that it performs the intended functions.


  • address β€” the address of the smart contract to query

  • quantity or tag β€” the integer of a block encoded as hexadecimal or the string with:

    • latest β€” the most recent block in the blockchain and the current state of the blockchain at the most recent block

    • earliest β€” the earliest available or genesis block

    • pending β€” the pending state and transactions block. The current state of transactions that have been broadcast to the network but have not yet been included in a block.


      See the default block parameter.


data β€” the compiled bytecode of a smart contract. Returns 0x if the address is not associated with a smart contract.

eth_getCode code examples

The following example retrieves the compiled bytecode from the SushiSwapRouter smart contract.

const Web3 = require("web3");
const web3 = new Web3(NODE_URL);

async function getCode(address, block) {
  const code = await web3.eth.getCode(address, block)
 getCode("0x1b02dA8Cb0d097eB8D57A175b88c7D8b47997506", "latest" )
const ethers = require('ethers');
const provider = new ethers.JsonRpcProvider(NODE_URL);

const getCode = async (address, block) => {
    const code = await provider.send("eth_getCode", [address, block]);

  getCode("0x1b02dA8Cb0d097eB8D57A175b88c7D8b47997506", "latest")
from web3 import Web3  

code = web3.eth.get_code("0x1b02dA8Cb0d097eB8D57A175b88c7D8b47997506", "latest") 
print(web3.to_hex(code))   # Convert the Bytes result into HEX.

Use case

A practical use case for the eth_getcode method is verifying whether an address is associated with a smart contract. This can be particularly useful for blockchain explorers, auditors, and DApp developers, who must ensure that the code they interact with is legitimate.

Here is an example using web3.js:

const Web3 = require("web3");
const web3 = new Web3(NODE_URL);

async function verifyContractAddress(address) {
  try {
    const bytecode = await web3.eth.getCode(address);
    return bytecode !== '0x';
  } catch (error) {
    console.error(`Error: ${error.message}`);
    return false;

async function main() {
  const addressToVerify = "0xf26f52d5985F6391E541A8d638e1EDaa522Ae56C"
  const isContract = await verifyContractAddress(addressToVerify);

  if (isContract) {
    console.log(`πŸ“‘The address ${addressToVerify} is a smart contract.`);
  } else {
    console.log(`🚨The address ${addressToVerify} is not a smart contract.`);


The verifyContractAddress function takes an address as a parameter and returns a boolean value indicating whether the address is associated with a smart contract. The function works by using the web3.eth.getCode method to retrieve the bytecode of the contract associated with the given address. If the returned bytecode is not equal to 0x, then the function assumes that the address is associated with a smart contract and returns true. If an error occurs while calling web3.eth.getCode, the function returns false and logs the error message to the console.

The main function is responsible for calling verifyContractAddress with a specific address to verify and log the results to the console. In this example, main is set up to verify the address 0xc094fd7ef80be094f3d98e227a487490ab1f9b9c. After calling verifyContractAddress, main logs either a success message indicating that the address is associated with a smart contract or a warning message indicating that it is not.

Overall, this code provides a useful utility for verifying the legitimacy of smart contract addresses on the Avalanche blockchain. It can be useful for auditors, blockchain explorers, and DApp developers who want to ensure that they are interacting with trustworthy code on the blockchain.

Try the eth_getCode RPC method yourself

Click Try It! to start a request and see the response here!