eth_getProof

Returns the account and storage values of the specified account including the Merkle-proof.

Parameters

OBJECT - The filter options:

Object NameRequiredTypeDetail
ADDRESSString/ArrayAddress to check proof
STORAGE KEYSArrayStorage keys to generate proofs
BLOCK PARAMETERString/ObjectA hex code of an integer that represents the block number, "latest", "earliest" . Learn more here.
"params":[
    "0x5ecddc1ac099074ae965d140a7c62bd71b7fc80a",
    ["0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"],
    "latest"
]

Result

It is an array of account objects.

Result Fields

KeyTypeDetail
addressStringAddress of the account.
accountProofArrayArray of rlp-serialized MerkleTree-Nodes, starting with the stateRoot-Node, following the path of the SHA3 (address) as key.
balanceStringA hex code of an integer that represents the balance of the account.
codeHashStringA hex code of an integer that represents the hash of the code of the account.
nonceStringA hex code of an integer that represents the nonce of the account.
storageHashStringSHA3 of the StorageRoot. All storage will deliver a MerkleProof starting with this rootHash.
storageProofArrayArray of storage-entries as requested

Example

Request

curl <your-endpoint> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","method":"eth_getProof","params":["0x5ecddc1ac099074ae965d140a7c62bd71b7fc80a",["0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"],"latest"],"id":1}'

Return

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "address": "0x5ecddc1ac099074ae965d140a7c62bd71b7fc80a",
        "accountProof": [
            "0xf90211a07151432e04ca3cb8d46389670d8ec46cfafd1c0e74b5abc353c4227dfaf2c1f3a0338e36fa06e3783096c3aca94f57c9a113bc8c3ae81faf636f0546535b915134a0d2cc08b62bd181692fff309fcbe0a0d05dcd36414a972487227847485ad06cdca0c23af95149218e1ad6cbb13bd26814b673126c53458ab89b94c51f3d86259dfba06df6bafa9b79f11ef7ab9f868b84dde3005a8b67343c22649d08efd4a3efbac5a0dc7a053c0f2c6dd6e7f0519d83182dc1964fbe222d95e03c7d7ecdf15f1dfb69a0456f8a5b4c39e74fe7a76e0a88e772031984c3bdc778d73e56d4fd748b3d03a3a00c23eaa8278695f0c2b705bb48adbe2db9be1aa28983ac8efd9a08980ee5871fa036084b3fcd15f527988effc6ee4bc4910f5d99d0c3c4da5dfca94adf762579f2a01ae3e5ea6465a5231dcf536fbc4b6a7721c01ee466addd3523e3714583f8a3daa0a8c6312039e90a2046373257212efbd474679d3930f196a59868235fb757b81aa01b17e4e4ac7973d968e369b70e52605fcd038545fd0fbd9dac25841bbb0b38a6a0d6708d858c393885b74ba880ef5372392fe5e7e216a54be744b2940b55536c91a0fa96fdbf626827ed307a730f826ab25aeef3a4e69ce45798bd784d75ccd7eeefa0dc20d96ae20ab81072f9b82839626930875f812df46d4cde32aaa4a8684fd0eaa054c31da965d314d35c44357b1c6742c09fd63b44f6a3a03228d3dacb2840c36b80",
            "0xf90211a0e7b9155f7ca22b722083b5298de03da59ce047de3162686372629b75a69334b2a075b9c70a9bc4fab41679ffc40be8835b93e71a54e350905a17bee8c511997b69a0b904c12e9b74f16615ee316f9d407b999d36ca8d6eb5b018217ba0b5a0309114a0d4fad4ffa89ae386d1bea6ee22fd9b33aca347048fcf2ddffde4ad6cd51a0a0fa0e3ceadd781e6d6e511509f1ccf4f975863988de63da0abcc7f1d5fbe77e5d77aa0abb975f3aa027401d9866c6404d60b52a0c77c685c485f8231de0900b35f9c79a0bedd0da115a0d14480c78178d92faf700261f05bde9968c2553faceaaa88b087a01d93b24de0c8aa5919986562aaacabc66cbdd2e214546753b66815dd0be09ed9a04d4be0333d9e8960474324a862a8f215835e83866b52feaf7a65d4c997c6a149a0439c26af4a9691c473367ecc330d9aa8de8fde1081627cfe2eec16f97886c7a6a02fa013957701d9be491679aee327e10935e1c6288ffae1f48777d99bffe0cc38a0152c8d312fdb5ad084974e11430d88986424a688584a55be8a8f89b7a9463f93a00cd1e7ae9782b72848f82937a8caf0a9d8470e137582e4f5a69d680a1d16e26ba0cf6a8323e3488c24ae1ed46984f71d7d55fd9c9c162633d4074b7f58608d5298a0cd015d0db701761ad5100e131cd5c6090ddcba2366f0f3f4627181a1883723eba0e4be7c0df9346a300f865831e4a80b6097f5d2ba49f80457fd3ad3820720d20e80",
            "0xf90211a02ab3216122b7d6410eea810da054c96e547ac004991e8dee77400c8ba9ddd555a0b2b405a8c8975bf2071160ef17ac1b0d00309f5d5bde15c198d6f6985bd38966a0dd0f7d530cb322e90078deb7c57d915b2b94c2efaa69f199c3ca42b29652f8fda0fb4de66dd091cc878dd0b46468110e5f8c1f0cf6845c6627ffbc12df1f7d99f6a0220a2c78f6e9cc3d55b6666551179a8e814354c055dbbf19284d312b5dadfcfda0c1eddfe5956fabdd7baad9d16df7a2015fdaf8ea3a089d7ef546b806bb0b95aea01ac6bd83aced7c63ae417f3c7962006d0202f1f02b1083ae5da0d6a899a9d31aa0df0d7b67fb6a36ffb91537dbaf5e88e6539314ac13d1650ff26ef020fbc922faa0f1d2e0d3d442591fbac2241c5b1302991236bbea095df07701eff8d2300a6788a07e1c75c33824d83b0ca23a195ff3f293b0fbcd7a1feafa44e957f7bb11497251a0538e9970d7cfecf117e145331925cc6147b358b03d8945a4aaf53ba583a9976ba0e563a4c49a95e10af2a55b3e0483665e586e2e130a476b3f139dbd5b71a134eaa00408d2fbd4ad829e3d7a491ca39650390c7e9ffde6391bc932d6e9c5ea2eb442a0b4654657507e58042acb0ccce33c4182dc3a038744ea1781c48694e19c4a547ca0fa39fde8fef8f71e8972d80abc3fdd0bc003e511bbdc5da1c0fea50c10ab043ba0e412df706d5ff1a020ec7c81ef9611b952e83b716143161f60d4cefc59f76b0780",
            "0xf90211a0c20985629b5d92d9fa8788fe4d2f4d14d62ab35934e569dec3977533a9eafb85a0187a066d779ea3c12cd44b638ddc8bcd9e2eddee86430f57c8415d6bce5bd2aaa07da7f57112f0a6799deb02b290e3129fa6a19d988fdf853a436976b51df848bda0eb2faa9218231189f8a8bc363417b9da5a9f87acfde1d394b580f0e72807a3bda0fc5f2e6a01af967defde35dfadbce541e31c6843ca12854b4bebef703ccc527ea06850593ea3cdbda37a0872725f1ab01437c76664ac1ee2d7368adf6a3996152da08c4ff32f1cd13baa1688baba000ff6a009f85d775dddb038da994a467a15dc68a0dda64bcd7db61f658420a907cb48a6fcb2b7fbb930ea856810a00356f3a23400a0099db083850f6740d023a1a3199f034c92d47ba744f427764e7e5a52fb2aba62a0f6d455d99d99490960938078bc7ee6cd16ddfef68b133cce90a3fee6d0235a6aa0bf6e77111dc595a367edf7a0c4ef0654310f5eb3ca194458327c46d130452c9ca0f9172826799f5b77c34265548b2337fe3e9363cf70bdb73dd0fcade4cd44f42aa0624d55aa3cd7d738359f6cff6f0ce787d710519edad0193da38ca9a2e7d7fa4fa0e5ba4ab1832797781130567a472c4c91e5fef9ab8eb8b442a6f7f8a2c3af4dc8a0a05e4eb51620fee78b0424a82315d514659d824ff33796ef992ec8fd7bf15580a056a6d471c67a6f90963372f5c0e7542ddefd45f3fb8e9af680a845f2e197f44080",
            "0xf90211a0b94992df6e6bab6bfb255c6112f6968b13c0e518573b0d10b61180fcd0177265a00619937da640c4f9fc5c9ab349ee00b94ab98ccda47171f3890d22e865faf632a0881ceb6561cf6cb727adbd6b47d29d44258db2dd70f0f39d4f168b34ff6a1e70a0616fa333a87c12b60d86b44d90f7208e314093c76feff0a3fc382301c520a773a0d2a29beb812a31b83a7824ca05a4d27459501520460e373144ec0636c1d42dd6a0a12d15361c37ad32ef49a18beb53afd9da2d5768d2fe0a41b066d251a0938240a07039d55574fbcbd9f6ad291cbe85c72bef3ba960b536ec2f5f88a1112548ef3ba0f9e6613bb28dc33a48c595f506b2329017832953437ca0c5cf476f3c9e62fe40a0521cef5feb3fcba5a93c7effb1e03e19dfb7fdbe92aeb1f70c3c4a3703040155a06297e67003a48848b3dff5bd607daabec235c1cabe709e3814ec37d0fa37c28ba0f683e37e31961204efdc9be0f9fea2423bfbf70980e3ecf8edf3ca90a00abe16a0650e55eb03f8acc8136b1f6ad57aca8040fd4bcdf235119ee6f4539e380a5a6ca01f14da2f8ad08f0818bab8a4d8b8d425b23eb15c22e6e0a0d49891f225b21c6da043bf60153980da2bc1a4748e2e3c53e7c2306959160a4d0261c0197cb409edaba09a25cc03b8eaad417b71dc668a8ab4b9a7e9858ac9f26726c7708ced9a0dcd0aa05f42a11fafb9b27a2b2a4dac7d37f093ea9e588a726e62d7a562753452f6c7e280",
            "0xf90211a015833cc979f5a4a7292d58de5ae15f8d2b6c87c34f62b59cc15b49b78552a2c2a0f78b045a73915f1b09288c84c125828d0119a262d81d961f9a9b81071140dff4a04a9c0954b21f3ecb83de4185a7bd922ef009a5535cb63f0211973d56b36c45eea0fca62a893be98c8bff2cb6549ac1da938913eac4ddd5e90940137463598d0728a0b59855da0b867b5682b9a2406bd30d40c664bf87faf3be30a102be0d40acf085a0af397bd910225a2b9e3d7d78e7f89c557ae8ee2c0ea88cb2aea0c91d8f2bd164a0c7cd4ea598ba94b5316c831442ef84a664f05c54e14a7d9de8e6eac2d0e1f733a0b42a8cef1e4e8bd9ca0dba92988cbbf74fbd25d9d34a4c35bb779347f98e0aaea063e23ecce0a8f82dda92105dbe727436a0d7e5aa260db8c2ada11555a6d4da7ca09c02c7df281eadfc97e59fc53ceb5fbc0652bc0ea50fc3211ef0ec2804c81728a0c0f20b5b9097b45855808a436fabfcc57c29adf503810876183bbf2b423982afa000a6b8814560df082082a362235194aae73b5c01f1e47f8ee1093c6f4f392019a022cd1b7d4835d78cd1a270e03e5e1b1ec6e77a9cfdf8de7fc578ae965ad46b5ca049e0df8d44769813d15b761f9b1efa61ab7234395cf6f0b10ce9a20c716ca200a0757fa6d0203cbde299eb232872bc3a9cbd297363ce78ff8a4f6a0daf037f623aa02bb415d9ce922d94481fec16cb0e4325da1d58742679d0f6ac52deb21461580680",
            "0xf8f18080a09a1122b13a0e740000f51aaf14008803cf6944330f303208ac2126e6e0e21c6780a0c2a353fa63ccd21c757a5e0bb2ad6fd68768cb78328b3ba61dff9f2ebafeac028080a063b393dc0e28b5d51af0d60a87ee1e8cb4b803cdac50cfb3a5b242aa3015f3b5808080a0c772da230aaa0cd083eae65d4965c1c09a2d7b4120c81e100c2428cffa4d20aea01d56d2374011b9b31a4b09663a9ea4b82f87a9dd6d1d6390a97c47db662b37dd80a04bcb5fe9d900ba9b0d41b3c0e3029d02c3bc9b87a36de69a8b6727c459ddae57a03833cabbde9e04c9a436eb1553a4619fe204c30d3b8f2da5beb2281241f69ccc80",
            "0xf8729d3622fba7f79abec316967dee3a19f2226cd6a6d335308a660f61017578b852f850830bddba89054c3d094a2eb9b70da056e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421a0c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470"
        ],
        "balance": "0x54c3d094a2eb9b70d",
        "codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
        "nonce": "0xbddba",
        "storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
        "storageProof": [
            {
                "key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
                "value": "0x0",
                "proof": []
            }
        ]
    }
}
Language
Click Try It! to start a request and see the response here!