eth_getProof

eth_getProof implements EIP-1186. It returns the account's value (balance, nonce, code hash, storage root) together with the cryptographic proof needed to verify those values against the block's stateRoot — and, for each storage key you pass, the slot value plus its proof against the account's storageHash.

Use it whenever a client needs to trust the state without trusting the provider: Polygon PoS bridge L1↔L2 state verification, light-client SDKs (e.g. Helios-style verifying clients), and any flow that re-checks a balance or storage slot against a known block hash. A verifier walks accountProof from the stateRoot down to the account, then walks each storageProof[].proof from storageHash down to the slot.

Gotchas. The response grows with the number of storage keys — each key adds its own value plus a full proof branch, so a request for hundreds of keys can return tens of kilobytes. Request only the slots you actually verify. Proofs are block-specific: pin an explicit block number or hash for reproducible verification rather than relying on latest, which advances every block (~2 s on Polygon). Available on the free tier; no daily cap applies — limits are requests-per-second per tier with short bursts.

Positional params array: [address, storageKeys, blockTag].

Response fields

Errors are returned in the standard JSON-RPC envelope. See errors.md for the full shape and the data payload fields.

JavaScript (fetch)

const res = await fetch("https://api.triport.io", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TRIPORT_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "eth_getProof",
    params: [
      "0x0000000000000000000000000000000000001010",
      ["0x0000000000000000000000000000000000000000000000000000000000000000"],
      "latest",
    ],
  }),
});


const { result } = await res.json();
console.log(result.storageHash, result.storageProof[0].value);

TypeScript SDK (@triport/sdk)

import { Triport } from "@triport/sdk";


const triport = new Triport({ apiKey: process.env.TRIPORT_API_KEY! });


const proof = await triport.polygon.rpc("eth_getProof", [
  "0x0000000000000000000000000000000000001010",
  ["0x0000000000000000000000000000000000000000000000000000000000000000"],
  "latest",
]);


console.log(proof.accountProof.length, proof.storageProof[0].value);

Python (triport-sdk)

import os
from triport import Triport


triport = Triport(api_key=os.environ["TRIPORT_API_KEY"])


proof = triport.polygon.rpc(
    "eth_getProof",
    [
        "0x0000000000000000000000000000000000001010",
        ["0x0000000000000000000000000000000000000000000000000000000000000000"],
        "latest",
    ],
)


print(len(proof["accountProof"]), proof["storageProof"][0]["value"])

• Pin the block. For reproducible bridge or light-client verification, pass an explicit hex block number instead of latest so the proof matches a known stateRoot.
• Payload scales with keys. Each entry in storageKeys adds a value and a full proof branch. Batch only the slots you verify; request account-only proofs with [] when you don't need storage.
• Verifying a slot means walking storageProof[i].proof from storageHash to the leaf, and accountProof from the block's stateRoot to storageHash — both must check out for the value to be trusted.
• Related methods: eth_getStorageAt for an unproven slot read and eth_getBalance for an unproven balance read.