eth_getProof

eth_getProof returns an account's core fields — balance, nonce, codeHash, storageHash — together with Merkle-Patricia trie proofs for the account itself and for any storage slots you request. Those proofs let a verifier confirm the values against the block's stateRoot without trusting the node. Base is Coinbase's OP Stack optimistic rollup that settles to Ethereum L1 and meters gas in ETH, so verifiable state reads matter for bridges and light clients that anchor on L1. Call it at https://base.therpc.io/YOUR_API_KEY (chain ID 8453, hex 0x2105) with an address, an array of storage keys, and a block tag.

Use cases

• Verify a Base account balance or storage slot trustlessly inside a light client or a bridge contract that only holds the block's stateRoot.
• Build witness data for OP Stack dispute and exit flows where a claim about Base state must be proven against L1.
• Feed state witnesses into stateless-client or proof-of-state experiments that replay execution without a full database.
• Audit a token's total supply by proving the value of its supply storage slot against a known Base block.

Parameters

Response

Example request

1curl https://base.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5    "jsonrpc": "2.0",
6    "method": "eth_getProof",
7    "params": [
8        "0x0000000000000000000000000000000000000000",
9        [],
10        "latest"
11      ],
12    "id": 1
13  }'

Try it live in the Base playground.

Errors & troubleshooting

Common pitfalls

• Consuming the proof means implementing Merkle-Patricia trie traversal and keccak hashing; if you do not need trustless verification, eth_getStorageAt hands you the raw value with far less work.
• Proofs at older Base heights require an archive node, or at least one that still retains state for that block — pruned nodes answer with Missing trie node.
• A proof only means something once you check its root against the stateRoot in the corresponding Base block header; an unanchored accountProof proves nothing.

Supported networks

• Mainnet — Chain ID: 8453
• Sepolia — Chain ID: 84532

See also

• eth_getStorageAt
• eth_getCode
• eth_getBalance

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