eth_getProof

---

Method

• JSON-RPC method name: eth_getProof
• JSON-RPC version: 2.0

Parameters

Name	Type	Required	Description
Address	string	yes
StorageKeys	string[]	yes
Block	anyOf	yes

Parameter schema

{
  "Address": {
    "required": true,
    "schema": {
      "title": "hex encoded address",
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    }
  },
  "StorageKeys": {
    "required": true,
    "schema": {
      "title": "Storage keys",
      "type": "array",
      "items": {
        "title": "32 hex encoded bytes",
        "type": "string",
        "pattern": "^0x[0-9a-f]{0,64}$"
      }
    }
  },
  "Block": {
    "required": true,
    "schema": {
      "title": "Block number, tag, or block hash",
      "anyOf": [
        {
          "title": "Block number",
          "type": "string",
          "pattern": "^0x([1-9a-f]+[0-9a-f]*|0)$"
        },
        {
          "title": "Block tag",
          "type": "string",
          "enum": [
            "earliest",
            "finalized",
            "safe",
            "latest",
            "pending"
          ],
          "description": "`earliest`: The lowest numbered block the client has available; `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error"
        },
        {
          "title": "Block hash",
          "type": "string",
          "pattern": "^0x[0-9a-f]{64}$"
        }
      ]
    }
  }
}

Result

• Name: Account
• Type: object

Result schema

{
  "title": "Account proof",
  "type": "object",
  "required": [
    "address",
    "accountProof",
    "balance",
    "codeHash",
    "nonce",
    "storageHash",
    "storageProof"
  ],
  "additionalProperties": false,
  "properties": {
    "address": {
      "title": "address",
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    "accountProof": {
      "title": "accountProof",
      "type": "array",
      "items": {
        "title": "hex encoded bytes",
        "type": "string",
        "pattern": "^0x[0-9a-f]*$"
      }
    },
    "balance": {
      "title": "balance",
      "type": "string",
      "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$"
    },
    "codeHash": {
      "title": "codeHash",
      "type": "string",
      "pattern": "^0x[0-9a-f]{64}$"
    },
    "nonce": {
      "title": "nonce",
      "type": "string",
      "pattern": "^0x([1-9a-f]+[0-9a-f]{0,15})|0$"
    },
    "storageHash": {
      "title": "storageHash",
      "type": "string",
      "pattern": "^0x[0-9a-f]{64}$"
    },
    "storageProof": {
      "title": "Storage proofs",
      "type": "array",
      "items": {
        "title": "Storage proof",
        "type": "object",
        "required": [
          "key",
          "value",
          "proof"
        ],
        "additionalProperties": false,
        "properties": {
          "key": {
            "title": "key",
            "type": "string",
            "pattern": "^0x[0-9a-f]{0,64}$"
          },
          "value": {
            "title": "value",
            "type": "string",
            "pattern": "^0x([1-9a-f]+[0-9a-f]{0,31})|0$"
          },
          "proof": {
            "title": "proof",
            "type": "array",
            "items": {
              "title": "hex encoded bytes",
              "type": "string",
              "pattern": "^0x[0-9a-f]*$"
            }
          }
        }
      }
    }
  }
}

Positional parameters

Parameter order:

1. Address
2. StorageKeys
3. Block

---

Errors

This method may return JSON-RPC standard errors (e.g. -32600, -32601, -32602, -32603) as well as application-specific errors.

TODO: Document method-specific error codes and conditions.

Named Parameters

{
  "jsonrpc": "2.0",
  "method": "eth_getProof",
  "params": {
    "Address": "string",
    "StorageKeys": [
      "string"
    ],
    "Block": "example"
  },
  "id": 1
}

Successful Response

{
  "jsonrpc": "2.0",
  "result": {
    "address": "string",
    "accountProof": [
      "string"
    ],
    "balance": "string",
    "codeHash": "string",
    "nonce": "string",
    "storageHash": "string",
    "storageProof": [
      {
        "key": "string",
        "value": "string",
        "proof": [
          "string"
        ]
      }
    ]
  },
  "id": 1
}

Positional Parameters

{
  "jsonrpc": "2.0",
  "method": "eth_getProof",
  "params": [
    "string",
    [
      "string"
    ],
    "example"
  ],
  "id": 2
}

Successful Response

{
  "jsonrpc": "2.0",
  "result": {
    "address": "string",
    "accountProof": [
      "string"
    ],
    "balance": "string",
    "codeHash": "string",
    "nonce": "string",
    "storageHash": "string",
    "storageProof": [
      {
        "key": "string",
        "value": "string",
        "proof": [
          "string"
        ]
      }
    ]
  },
  "id": 2
}