Returns deployed bytecode for an address in live, pinned, or retained execution state. Without a CLIENT, it builds a reusable READ and does not access state.
Local
Exact signatures with descriptions, requirements, inputs, returns, and examples.
code_at(CLIENT, ADDRESS) # Immediate Read · RPC required Reads the CLIENT's current state context. For live clients that means latest; pinned and execution clients retain their own exact state identity.
| Name | Type |
|---|---|
code | BYTES |
Deployed bytecode. Returns the deployed bytecode as BYTES, or NULL/empty code for EOAs, pre-deploy addresses, or historical blocks where no code existed. Historical reads may require an archive-capable RPC provider.
The two-argument overload reads latest and can change after upgrades, redeploys on new chains, or proxy changes in surrounding state.
Use block_number for reproducible bytecode evidence.
Relation-sized attached pinned reads may share one hash-pinned JSON-RPC batch; each inner request keeps the durable blockHash and requireCanonical selector.
Older block heights may require an archive node.
code_at(CLIENT, ADDRESS, BIGINT) # Immediate Read · RPC required Returns the deployed bytecode at a specific block height for reproducible historical replay.
| Name | Type |
|---|---|
code | BYTES |
Deployed bytecode. Returns the deployed bytecode as BYTES, or NULL/empty code for EOAs, pre-deploy addresses, or historical blocks where no code existed. Historical reads may require an archive-capable RPC provider.
Named parameters · RPC required
code_at(ADDRESS) # Read Builder · RPC required Builds a reusable account-code READ; no client is resolved and no state is accessed.
Named parameters · RPC required