eth_getCode
curl --request POST \
--url https://nd-422-757-666.p2pify.com/0a9d79d93fb2f4a4b1e04695da2b77a7 \
--header 'Content-Type: application/json' \
--data '
{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
"latest"
]
}
'import requests
url = "https://nd-422-757-666.p2pify.com/0a9d79d93fb2f4a4b1e04695da2b77a7"
payload = {
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": ["0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D", "latest"]
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
id: 1,
jsonrpc: '2.0',
method: 'eth_getCode',
params: ['0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D', 'latest']
})
};
fetch('https://nd-422-757-666.p2pify.com/0a9d79d93fb2f4a4b1e04695da2b77a7', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://nd-422-757-666.p2pify.com/0a9d79d93fb2f4a4b1e04695da2b77a7",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'id' => 1,
'jsonrpc' => '2.0',
'method' => 'eth_getCode',
'params' => [
'0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D',
'latest'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://nd-422-757-666.p2pify.com/0a9d79d93fb2f4a4b1e04695da2b77a7"
payload := strings.NewReader("{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"eth_getCode\",\n \"params\": [\n \"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D\",\n \"latest\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://nd-422-757-666.p2pify.com/0a9d79d93fb2f4a4b1e04695da2b77a7")
.header("Content-Type", "application/json")
.body("{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"eth_getCode\",\n \"params\": [\n \"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D\",\n \"latest\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://nd-422-757-666.p2pify.com/0a9d79d93fb2f4a4b1e04695da2b77a7")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"eth_getCode\",\n \"params\": [\n \"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D\",\n \"latest\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"jsonrpc": "<string>",
"id": 123,
"result": {}
}Ethereum node API
eth_getCode | Ethereum
Ethereum API method that retrieves the compiled bytecode of a smart contract providing its address as a parameter. Ethereum via Chainstack.
POST
/
0a9d79d93fb2f4a4b1e04695da2b77a7
eth_getCode
curl --request POST \
--url https://nd-422-757-666.p2pify.com/0a9d79d93fb2f4a4b1e04695da2b77a7 \
--header 'Content-Type: application/json' \
--data '
{
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
"latest"
]
}
'import requests
url = "https://nd-422-757-666.p2pify.com/0a9d79d93fb2f4a4b1e04695da2b77a7"
payload = {
"id": 1,
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": ["0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D", "latest"]
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
id: 1,
jsonrpc: '2.0',
method: 'eth_getCode',
params: ['0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D', 'latest']
})
};
fetch('https://nd-422-757-666.p2pify.com/0a9d79d93fb2f4a4b1e04695da2b77a7', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://nd-422-757-666.p2pify.com/0a9d79d93fb2f4a4b1e04695da2b77a7",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'id' => 1,
'jsonrpc' => '2.0',
'method' => 'eth_getCode',
'params' => [
'0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D',
'latest'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://nd-422-757-666.p2pify.com/0a9d79d93fb2f4a4b1e04695da2b77a7"
payload := strings.NewReader("{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"eth_getCode\",\n \"params\": [\n \"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D\",\n \"latest\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://nd-422-757-666.p2pify.com/0a9d79d93fb2f4a4b1e04695da2b77a7")
.header("Content-Type", "application/json")
.body("{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"eth_getCode\",\n \"params\": [\n \"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D\",\n \"latest\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://nd-422-757-666.p2pify.com/0a9d79d93fb2f4a4b1e04695da2b77a7")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"eth_getCode\",\n \"params\": [\n \"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D\",\n \"latest\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"jsonrpc": "<string>",
"id": 123,
"result": {}
}Ethereum 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.
The following example retrieves the compiled bytecode from the APE token smart contract.
The
When called against a block older than the latest ~128 blocks, this method is treated as an archive request (2 RUs instead of 1 RU). See request units.
Get your own node endpoint todayStart 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
-
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. A chain reorganization is to be expected.safe— the block that received justification from the beacon chain. Although this block could be involved in a chain reorganization, it would necessitate either a coordinated attack by the majority of validators or an instance of severe propagation latency.finalized— the block accepted as canonical by more than 2/3 of the validators. A chain reorganization is extremely unlikely, and it would require at least 1/3 of the staked ETH to be burned.earliest— the earliest available or genesis blockpending— 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.
Response
data — the compiled bytecode of a smart contract. Returns 0x if the address is not associated with a smart contract.
eth_getCode code examples
Learn more about the
ChainstackProvider in ethers.js: ethers ChainstackProvider Documentation.const ethers = require("ethers");
// Create a ChainstackProvider instance for Ethereum mainnet
const chainstack = new ethers.ChainstackProvider("mainnet");
const getCode = async (address, block) => {
const code = await chainstack.send("eth_getCode", [address, block]);
console.log(code);
};
getCode("0x4d224452801ACEd8B2F0aebE155379bb5D594381", "latest");
from web3 import Web3
node_url = "CHAINSTACK_NODE_URL"
code = web3.eth.get_code("0x4d224452801ACEd8B2F0aebE155379bb5D594381", "latest")
print(web3.to_hex(code)) # Convert the Bytes result into HEX.
Use case
A practical use case for theeth_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 ethers.js:
index.js
const ethers = require("ethers");
// Create a ChainstackProvider instance for Ethereum mainnet
const chainstack = new ethers.ChainstackProvider("mainnet");
async function verifyContractAddress(address) {
try {
const bytecode = await chainstack.getCode(address);
return bytecode !== '0x';
} catch (error) {
console.error(`Error: ${error.message}`);
return false;
}
}
async function main() {
const addressToVerify = "0x4d224452801ACEd8B2F0aebE155379bb5D594381"
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.`);
}
}
main();
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 provider.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 provider.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 0x4d224452801ACEd8B2F0aebE155379bb5D594381. 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 Ethereum 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.Last modified on June 25, 2026
Was this page helpful?