​

State Proofs

​

The Difference

​

Store backends

• Classic IAVL stores
• store/v2 memiavl commitment stores
• Any other proof-capable (queryable) store reached through cache, tracekv, Giga cache, or prefix store wrappers

​

What This Affects

• Light clients verifying state without trusting an RPC node
• Cross-chain bridges proving inclusion of state on Sei
• Applications verifying contract storage values trustlessly

​

Calling eth_getProof

​

Storage key requirements

• Keys must be hex-encoded. Each storage key must be a valid hex-encoded value (for example 0x0000000000000000000000000000000000000000000000000000000000000001). Keys are decoded and left-padded to 32 bytes. A malformed, non-hex key is rejected with an invalid storage key error. Raw byte strings, which were previously accepted, no longer work.
• At most 1024 keys per request. A single proof request may include a maximum of 1024 storage keys. Requesting more returns a too many storage keys error. Split larger sets across multiple requests.

import { createPublicClient, http } from 'viem';
import { sei } from 'viem/chains';

const client = createPublicClient({ chain: sei, transport: http() });

const proof = await client.getProof({
  address: '0xContractAddress',
  storageKeys: ['0xStorageSlot'],
});

// proof.accountProof and proof.storageProof contain IAVL proof data,
// not Ethereum MPT proofs — do not pass to an MPT verifier

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://evm-rpc.sei-apis.com');

const proof = await provider.send('eth_getProof', [
  '0xContractAddress',
  ['0xStorageSlot'],
  'latest',
]);

// Same caveat — proof data is IAVL format

​

Verifying Proofs