eth_getProof

eth_getProof returns the core account fields on OP Mainnet — balance (in ETH wei), nonce, codeHash, and storageHash — together with Merkle-Patricia trie proofs for the account and for any storage slots you request. The proofs let a verifier check those values against the block's state root without trusting the node. OP Mainnet is an OP Stack optimistic rollup (Bedrock) that settles to Ethereum L1, which makes trie proofs especially relevant for bridges and cross-chain state checks across the Superchain. Send the request to https://optimism.therpc.io/YOUR_API_KEY (chain ID 10, 0xa).

Use cases

• Verify an OP Mainnet account or storage value trustlessly inside a light client or a Superchain bridge contract.
• Construct the state witnesses that back fraud-proof dispute resolution for the OP Stack rollup.
• Supply state witness data for stateless-client experiments without shipping the whole trie.
• Audit a token's supply by proving a balances storage slot against a known OP Mainnet block's state root.

Parameters

Response

Example request

1curl https://optimism.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 Optimism playground.

Errors & troubleshooting

Common pitfalls

• Verifying a proof means implementing Merkle-Patricia trie traversal; if you only need the value and not trustless verification, raw reads via eth_getStorageAt are far simpler on OP Mainnet.
• The request needs an archive node, or at least one that still holds state for the requested block; on a pruned node an old-block proof fails with a missing trie node error.
• A proof is only meaningful once you hash the accountProof up to a root and check it equals the stateRoot in that OP Mainnet block's header.

Supported networks

• Mainnet — Chain ID: 10
• Sepolia — Chain ID: 11155420

See also

• eth_getStorageAt
• eth_getCode
• eth_getBalance

1curl https://optimism.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",[],""]}'