Kava

Kava

eth_getCode

The eth_getCode method returns the compiled bytecode of a smart contract at a specified address. This essential method allows developers to verify contract implementations, perform security audits, and distinguish between regular accounts and smart contracts on the Ethereum blockchain.

Use Cases

• Smart contract verification and implementation checking
• Contract bytecode comparison and version validation
• Contract audit and security analysis workflows
• Differentiating between contracts and EOAs (Externally Owned Accounts)
• Contract implementation analysis for upgradeable systems
• Proxy contract verification and delegate implementation checks
• Detecting self-destructed contracts and contract existence
• Determining if an address is a token contract
• Smart contract reverse engineering and analysis
• Historical bytecode analysis across different blocks

Method Details

This method retrieves the EVM bytecode deployed at a specific address at the requested block height.

Response Example

1{
2	"jsonrpc": "2.0",
3	"id": 1,
4	"result": "0x60806040526004361061016a5763ffffffff7c010000000000000000000000000000000000000000000000000000000060003504166306fdde03811461016f578063095ea7b3146101f957806318160ddd1461023957806323b872dd14610260578063313ce567146102a..." // Truncated for brevity
5}

Special Cases and Return Values

• Empty contract: Returns "0x" if no code exists at the address
• EOA address: Returns "0x" for regular wallet addresses (Externally Owned Accounts)
• Self-destructed contract: Returns "0x" after a contract has been destroyed via selfdestruct
• Pre-deployment: If checking a block before contract deployment, returns "0x"
• Standard contracts: Returns the full EVM bytecode for typical contracts
• Proxy contracts: Returns the proxy code, not the implementation code they delegate to

Identifying Contract Types

Different types of contracts have recognizable bytecode patterns:

1. Proxy Contracts: Often contain delegate call operations
2. ERC20 Tokens: Include transfer and approve functions
3. ERC721 NFTs: Contain standard NFT interfaces
4. Minimal Proxies (EIP-1167): Start with 0x363d3d37363d73...
5. Diamond Proxies (EIP-2535): Include facet management logic
6. UUPS Proxies: Include upgrade functionality in implementation

Practical Example

1// Example: Verify if an address is a contract or EOA
2async function isContract(address) {
3	const code = await provider.send('eth_getCode', [address, 'latest']);
4	return code !== '0x';
5}
6 
7// Example: Verify proxy implementation
8async function verifyProxyImplementation(proxyAddress, expectedImplementation) {
9	// For EIP-1967 proxies, the implementation address is stored at a specific slot
10	const implementationSlot = '0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc';
11 
12	const storageValue = await provider.send('eth_getStorageAt', [proxyAddress, implementationSlot, 'latest']);
13 
14	// Extract address from storage value (remove padding)
15	const implementationAddress = '0x' + storageValue.slice(26);
16 
17	// Get implementation bytecode
18	const implementationCode = await provider.send('eth_getCode', [implementationAddress, 'latest']);
19 
20	const expectedCode = await provider.send('eth_getCode', [expectedImplementation, 'latest']);
21 
22	return {
23		isProxy: implementationCode !== '0x',
24		implementationAddress,
25		implementationMatches: implementationCode === expectedCode,
26	};
27}
28 
29// Usage
30const addressToCheck = '0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984'; // UNI token
31const isContractResult = await isContract(addressToCheck);
32console.log(`${addressToCheck} is ${isContractResult ? 'a contract' : 'an EOA'}`);

Advanced Usage: Contract Type Detection

1// Simple contract type detector based on bytecode patterns
2async function detectContractType(address) {
3    const code = await provider.send('eth_getCode', [address, 'latest']);
4    
5    if (code === '0x') return 'Not a contract (EOA or self-destructed)';
6    
7    // Check for proxy patterns
8    if (code.includes('363d3d37363d73')) return 'EIP-1167 Minimal Proxy';
9    if (code.includes('5c60806040527f360894')) return 'EIP-1967 Transparent Proxy';
10    
11    // Check common ERC standards (simplified)
12    if (code.includes('6e0a6eecd9d3362a2dcfb7fac5fea5d4bd0a73001ddb12dd96e21df6ab138d72')) 
13        return 'Likely ERC-20 Token';
14    if (code.includes('80ac58cd')) return 'Likely ERC-721 NFT';
15    if (code.includes('d9b67a26')) return 'Likely ERC-1155 Multi-Token';
16    
17    return 'Standard contract (type unknown)';
18}

Common Contract Bytecode Prefixes

• 0x60806040: Common EVM bytecode prefix for Solidity contracts (version 0.4.x-0.8.x)
• 0x6080604052: Another common prefix for Solidity contracts
• 0x363d3d373d3d3d363d73: Common prefix for proxy contracts
• 0x363d3d37363d73: Common minimal proxy pattern (EIP-1167)
• 0x3d602d80600a3d3981f3: Another variation of minimal proxy

See also

• eth_getStorageAt - Returns the value from a specific storage position
• eth_call - Execute a read-only call to a contract
• eth_getBalance - Returns an account's ether balance
• eth_getProof - Generate proof of account and storage values

1curl https://kava.therpc.io \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getCode","params":["0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984","latest"]}'