eth_getProof RPC Method

Parameters

address

string

REQUIRED

The address of the account for which the balance is to be checked

storageKeys

array[strings]

REQUIRED

An array of storage-keys that should be proofed and included

blockNumber

string

The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain

Returns

address

The address associated with the account

accountProof

An array of rlp-serialized MerkleTree-Nodes which starts with the stateRoot-Node and follows the path of the SHA3 address as key

balance

The current balance of the account in wei

codeHash

A 32 byte hash of the code of the account

nonce

The hash of the generated proof-of-work. Null if pending

storageHash

A 32 byte SHA3 of the storageRoot. All storage will deliver a MerkleProof starting with this rootHash

storageProof

An array of storage-entries as requested. Each entry is an object with the following fields:

key

The requested storage key

value

The storage value

proof

An array of rlp-serialized MerkleTree-Nodes which starts with the stateRoot-Node and follows the path of the SHA3 address as key

Request

curl https://docs-demo.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getProof","params":["0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",["0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"],"latest"],"id":1,"jsonrpc":"2.0"}'

require 'eth'

client = Eth::Client.create 'https://docs-demo.quiknode.pro/'
payload = {
    "jsonrpc": "2.0",
    "method": "eth_getProof",
    "params": ["0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",["0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"],"latest"],
    "id": "1"
}

response = client.send(payload.to_json)
puts response

import { ethers } from "ethers";
(async () => {
  const provider = new ethers.JsonRpcProvider("https://docs-demo.quiknode.pro/");
  const response = await provider.send("eth_getProof", [
    "0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
    ["0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"],
    "latest"
  ]);
  console.log(response)
})();

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
  "method": "eth_getProof",
  "params": [
    "0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
    [
      "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
    ],
    "latest"
  ],
  "id": 1,
  "jsonrpc": "2.0"
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://docs-demo.quiknode.pro/", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

import requests
import json

url = "https://docs-demo.quiknode.pro/"

payload = json.dumps({
  "method": "eth_getProof",
  "params": [
    "0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
    [
      "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
    ],
    "latest"
  ],
  "id": 1,
  "jsonrpc": "2.0"
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.quiknode.pro/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "method": "eth_getProof",
  "params": [
    "0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
    [
      "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
    ],
    "latest"
  ],
  "id": 1,
  "jsonrpc": "2.0"
})

response = https.request(request)
puts response.read_body

from web3 import Web3, HTTPProvider
provider = Web3.HTTPProvider("https://docs-demo.quiknode.pro/")
result = provider.make_request('eth_getProof', ["0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",["0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"],"latest"])
print(result)

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
    "accountProof": [
      "0xf90211a07748e0ae8ea2fef03f451de36b0aee0fac3d0386226336cb5f4701f65f7a45fda07559ee14579a2601dba2cfed49360415d910bcc41dafec2e3cc72623def264dca080e4b792965c58ffa8d91b70cecc29a43d670b0a50b3a1af2280b35cc4b3b930a0eb36450a59001741e015219a6b5bc7b171e7bfa9891d2a4af20aa0177f9e6e0ea0e862e5335b298f11640f569cdb6092e6f0821592b1dd65bf48b40bf986944992a01a21e5cbae755b6a09df8b3bc6efac48af76b495899674c949056b3400c4c18ca00c306bc38f1bc2fb10f338668a55e22cf5e05fbd3db83f430575eb60d77ed64da03006aec14fa37ec1f488f747454172cc2b439ced2165d5b522b24cddf6b6aa34a02288734ffea3dd09a51ca29dfbd53902408873cebbb01b07b17f3d019de8a628a020eb396649f9e3006f88cf0ce247cf6eeedfd467bb3bdd1397526f8e40f2c24da02d10ffaec0c8726142418a60557851a5ac8e93adb873c4c41ff3b4dc9fdcf33ca048f755a2dc3844378068b7d745d6975b2ac7a5db0fad7728ff1a2d4652024992a00dd78f3aa4d3421d73b74d2661d378f3d7a19771b4a5c767c150d4d49c30fbf1a0601a47237b3b07dbdfeffe5a8d4df6c8e3c78acddc68fc11db93b3ac88467a4ea046382891d56dc23e95beac277e39f8da5a3fbaad4b14f19061a293a212a03aa9a00201400a0de259e1c262479e7c6a28ee98be0877a3085455e6e0c6484ce88e7d80",
      "0xf90211a0f3313850997a7ddc3f6a1bf25ec50cbfe16f4e8c096e02aa2ebeb880c47b8a2ba09baaa5194e546990e9c8cf7c42babe16a4dcf993a7ebf45c139375ba9f655b1aa00e17333837d72f1c1a20dd848c45247883e56569b60b6cc974e8bf324f29441fa02f389a00c1455547aa2edc3e86781b5df2bd48447140b77ba1d1e190a700d5daa0b8833cf6230038b52f2bb859f3b3e208c8e896466ae258c87d3c5d0173e4be8ba0635a4a29241fac3bd2d3afe728dc2a542d1f40f912b8107e92a288a5416cc5d7a05a06460d673f299f62bb45cfb6b36ac98f917487dfbd20e2c54316563dcbdde4a0fa50b4ee43eb9f3771f3d9b8f5f7d73b1653a71ad3aa58c4a59df739851d7b87a02b398e546fd99ad861784532b0448a716eea1923bc7813348961aa3965db1b25a0016b6236e56bb920fd649a85c5ca9964a0ce6c34fbe7a4b4b3bea84f40c83671a0781b2de8af840cce9f2383d0822306bb08bd11ee24efe3bff059d56e7bf83846a063ff1709e5645dda9d903df8fee536f0bb17835b4a77c66bf35399b1c5de7444a0f2265ca3267ba44d9eeb7469a3100a5348f7c523d3a8f39364d6c3f4560e826aa080d0dd56740b41a7583fbf64ed40e9b8c529e8dae54bd4f7214fc2eff3a1b428a0f917bc583a90e813023c8ee209c30ff7a5e98c046c3a1eff76a230824ff851cfa0d40e5e707d520f224102a8a6ba04ecb223958c5523f3388be00db895fcbfc6ba80",
      "0xf90211a02c54458569d304d8ded30eef297d094e872c8f14cfff65bd34ae40f84e9150e0a03002fe9bbbe4392c7f9949eef627a847e9a8f5b11dede92e7d36fb1819073eeea02a226c181bc613f3c13270473e4d85e77140cf5475779284475804a544e9a6b6a005794db3f0ad227699a23034c3093c2c3f4f1bc28a6cad4676356e36cdb2c6fea06d7a932bb5ba12d9078ae19af240ad89d5c615038eb30df8f7952946b1e8f885a05ddef0f330f2a41295341884afdd1a588bb71d56f7346a202bae8f8c505abdd8a0bc82dda81de94c0bacca2f64b89ab9fb34a8d9c24aea2ec7004571db12e37812a0ab07dc7671fd975880e1e89a635ce4d9f34b637e622e31cd0981a89828852eb1a01d77788a17e11dc1cc8025733004d4aca55b5b07ad47d7e229612c9ce346e8a5a0f7b2289d8494649912498816ea64120ee254246fc9b533ad5982d66e93dadefda0d526f032b44e938986a9e3e791295269504ac7df9c253777e99f45ef95ad4c5ba0f5ac7b35e2ae9f40beaa188ed7b885b504cf7c8949953ab22fe1a95c47af6e54a05818166c1aac9ee030cae4e1dcc8c0e0291453e9e9660b892afa3087d1f70a52a0ae0f73ee549162a1727aff97766151116a8c56cf6b459a999ebaa8755ababc94a0095aba630b03975511f8cb53e6e1bb5f883dbcf187e2ff4444f5902ecb61fe63a0e06f91c6bfe3b8e8e1828cdcc0e596c0ccbc75b364363b4c2b7a34a44d941f3180",
      "0xf90211a010b5c2ed729d59a25a5403b5907492f3ee4db7c0c2dd9a9d1640f310d3a9d518a096cab9bc9fd0489d2fb00480cef191690eee48d8156d1f15207c486c91e7ab5ea0fbe4fe7d00470dc41196f1121fc61c33bbf71075d1fd2f55b203203acddf1d53a0881603025be1055ea0b42bfd6b4fff0692f88353e384238a44504ada2ad559eca0d00a6569537455467e3a9272e8ab85212d51122e7c193796f1233dfdb60ce330a03299f2ec873071037a40ab3b6aec459931c58d384aee9556826173b9d9f022f3a0e3cbfae08af241aa62b40946a942f93d5c31baccd851c291c250ab58f69171d4a0008a28fd6ef80ea34c280382c7c0535c74f3a026f188e90cac850f576ce7bf71a0ef888a99a3eb12b0cdfe38deaa883de1c76b6a6db933dfe64663cfc8efbffd11a007080ed1cc6ce7abee625e958550528af098c2da5845a4f79d6d343a5a86c6e6a011f2064d5347904ca9e7ca19164451c73c521f98305297d5202797d4a8c06775a051faa0712bd24f6bb769070a8a6ddf946966795db8ff0e7bc582d6ee831f1419a0e83e2eed4462457135a134821662e08affb7af4eae71a82fae8f61a4532aec33a0ef0da4f72cbf7a882092334f18e76e339a0ecbf25892084dc34184cdcf716697a0a2073b4e79992f97b7accd99d22a3741d4925b7aa2d943210b6702583b9b866aa098353f0c2c252cfa18e71bd6c1a1bd0bcd0b448575c7bd3a90f5f773c50785c680",
      "0xf90211a07f5c1f9f15dcc8a217f433037b29f5da922523d4ea37a4ec46ce924ac572bb1ca020466fda4771fc787b8aaa4f86dc1514ecbe97377eb5a555016d383ce9793c0da0d2bea5f8ca0b82e460d7f0ff8378d32b6bdaf3218fe06e9a1def1cf1b9c289eba07753e22ba6994e3cdf1da716199c9d9f644bc6727d5e594c48a45e75b6ba5556a0a4c35480c62e5591a5969ebd64bc4b1e9c09920c786dd10142b0ac1da2eb341aa092dc64a659aaa166fe72495c03dd4585f09b296b0872c2d7385ab6ef55263f8ba08ece322079646a7cacf0401973df6c864e558229785a9887cff747ac30351621a0c0dca299e86c02e90cd1eb3e5610d1b67f92b775d62ee2eee74d42d2a262509ca0addc57ab7b274f2b3d2ef925dc11e0fa857466d1ccd1a82f223c2623425644cea0d784edfdd48a449271658c315aabfa92df22d88959568159b75f4bee439bcfa1a03b654467e0d4eb59a9677225916d864c6369958268d459fb525f1a39947c542ea06a4325838f41d054323ca9d3da2265a86ef20a9e0f7c5e5f7f3225fc97691f03a026d8745d391cbe69ce33cacc0a05d965c1af2309c7c9baaa5986d9a7ae0a28afa0005be891114ab150056bab37880b744a0d51bec80c389ab83c18097e9e019383a04d439a85502bf6696992db7759403ed918b4dead80d480789f3ef76d48d2414da0e5e047c909a126324564e03de33c188dd3427d219d1c9e2db4eaa7ea6244a83a80",
      "0xf90211a05a73eef51137e24e4b69ede04c835dc6cc7842ed9f7bcaefb4cfacf83dbe0519a0d5972a93881fbc2c842219b10ae8e3ac11a1a8955aa589b7a47bc8c3796b1190a0f653320ff64860646e63978ce9c13a44e665fe953d10797ce9ad306a6e6ed1a7a0fbaf976258d0fc3f40999b9671463b6ee4c114e38f8f22fb0c28fd1de1147f20a0560b6564f65c227a31bd465d9e86eb20597cb179cc71c87685c36f08e5bd51f1a0f632c2c8c30e39b5133517c35febec9aea78f540edb4be978ad56f319bf49e40a0c9d3d26e2b7e516e3e7f4a19619648fe77403e4299e0cc46ec51fb442d937ae9a0fcb8b705085b72cadb88b80588ede4b8d0b5b4da7b048c8f382edcd3e9edc835a09d1b19f35a51b55ebe272f6f8b4481319d324bbe003ff3831e08a53026223fa6a0ef31a0155c8448dbfeefaa04f338037f9f9fe5d6c5e8f678083cd160da63f0fda025643dd27e91d7d1cbecb78b3b078503d081ad68e49ab403c60d7887ac9f091ea0bffe4da49c2989d02e962905f5985d0cc8e0bd154a8c8e6ae461d6f464a0c628a0ba8765cbf6d94185ece61fdbd9033d3ab72fc156805f5c3b5e68168e8125614ca03c14f8e7bb3b2164c218804b5cd142f837620313bcad8409c596323deaf93f8ba0bcca082ddbcc689dd16e9cace69c8935536623b2d55165e525ea167a15454f33a0a7e9c2052eb03fade25fd2f4ea91ad9336a0ce009defad678a88f24b763bd3fa80",
      "0xf90171a000595129cf1c67ce97ed615df7184fb47a0d018d9147a2a7952a639e464cdfd380a06cdf38906044fbc505fd84a1852f3f8e89a881570933a853934055f75867dd96a0d99cae2bc3b6fc3e8e2767b4d7a5884b9b2d9d20da7890318beefcdb9c7346d58080a0f63571735d99e763dafadb03d1abe3a93a98740ecddc8514d13df46a35a8d946a0845e78ee0371846b1df62e9d2c8242d3b242bb64231fbfe719905cde3aa3293fa07ecd034cdeaa45d891a17d6ccb7dba49ae6eb3642b48b8033fb1be2e44b7eca8a0f0252504ee8753335ecf0ca1f73cf13d4505783ed5110bf4e9b384a68ad88f69a0d38a18ef7b993c9ad2d848453e7722c26998ff3d63e243b99cdab0dabf84157ea005aa031ec87523b402d31371cdef7c7f0587907f1f56c3874062bf4b936a7a9480a075e63932261595dd80a09eeed066c1b2f903e32b3ee98b3c8a18e63e3b5decba80a0d6d689405b1cf73786c5fdabb55ec22f9b5712d1ba9c0bfcd46d4b93721fcac780",
      "0xf8669d37f29e142d49f8824d4e7f1735ec3da219687387629b5fccd86812df84b846f8440180a056e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421a01d93f60f105899172f7255c030301c3af4564edd4a48577dbdc448aec7ddb0ac"
    ],
    "balance": "0x0",
    "codeHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "nonce": "0x0",
    "storageHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "storageProof": [
      {
        "key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
        "value": "0x0",
        "proof": []
      }
    ]
  }
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free