eth_getProof - Merlin

Returns the account and storage values of the specified account including the Merkle-proof. This call can be used to verify that the data you are pulling from is not tampered with.

Parameters

  • DATA, 20 Bytes - Address of the account.
  • ARRAY, 32 Bytes - Array of storage-keys which should be proofed and included. See eth_getStorageAt
  • QUANTITY|TAG - Integer block number, or the string "latest" or "earliest", see the default block parameter

Returns

Object - A account object:

  • balance: QUANTITY - The balance of the account. See eth_getBalance
  • codeHash: DATA, 32 Bytes - Hash of the code of the account. For a simple Account without code it will return "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470"
  • nonce: QUANTITY - Nonce of the account. See eth_getTransactionCount
  • storageHash: DATA, 32 Bytes - SHA3 of the StorageRoot. All storage will deliver a MerkleProof starting with this rootHash.
  • accountProof: ARRAY - Array of rlp-serialized MerkleTree-Nodes, starting with the stateRoot-Node, following the path of the SHA3 (address) as key.
  • storageProof: ARRAY - Array of storage-entries as requested. Each entry is a object with these properties:
    • key: QUANTITY - the requested storage key
    • value: QUANTITY - the storage value
    • proof: ARRAY - Array of rlp-serialized MerkleTree-Nodes, starting with the storageHash-Node, following the path of the SHA3 (key) as path.

Example

Request

curl --location 'https://merlin-mainnet.unifra.io/v1/{your-api-key}' \
--header 'Content-Type: application/json' \
--data '{
    "method": "eth_getProof",
    "params": [
        "0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",
        [
            "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
        ],
        "latest"
    ],
    "id": 1,
    "jsonrpc": "2.0"
}'

Result

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842",
        "accountProof": [
            "0xf90211a0d354ac174db418f3d14f69aa7bc01d0db3439a97da666c486ad1a348f0b4b060a0f374ea151a7734f8d8d4b42ac64a49580d7296a025a4b85419c062e52c1df4d8a082c0965ae6604b94acb8a61daec821e744f708cdaa14b55bba065836e2fac512a08e6f4a82af0200539dbd05f1e32d49727c0799da00264e35f6d3b2f3a85515eca0a679db1ebeaf8185732227567b7ddc0c067e6cb71aceab94f01aa45d38a66c70a01707f74fcc17b467895fad0610baab31c608f5f93323a69ad467d4caee333774a002503cca5020b85efe202ae02386e88b1f44bf5714f5ecfb5d97e9d7820dbf3da025a6d14c16ce2e142dd7aa62a162e0d8fc300e47aa2b42a6df622c8ede7544cca0e9578709db52f97e433173b090795037c341ca11f5aa528672a3ab946a4be44da0f93953176ad8500a38e3bb0da77536236579f3bad6b75c66b6deb057a764de4ea00775cf9267e0bf4f4a0ad374718170ed557429fc24ab61dfd4652efa7902d001a09f26153aab292abed2e72903df80c2ff709ba7da8039f3401c4a9cd012d6c990a0771eb65515c19f62649c57104f740ffe9bb860c965b44e78cc7f995133680f81a0ddf9df01838f82720e0a18e39a1a5a4e63a1b822518c089133492441d6f4c6f7a05952d2069ac319481c446a1b6cabcf75addac5ab46380cfefe53372c72a597bca00bf6222e43045c3197fe3c0e5f130a9baf3a61d998895734011689e708d2d95f80",
            "0xf90211a07644fea73015ad0b1927172275068c0b218c5db6099a40384e8f0aa766c84c1ea0c5c4f1772e45c7f6b51ccb769ad3ecdfb54253f36aaaa66ff3fb5a5abcb94cfea09de250543754dc765a9e2433883873af4ec07c301fd2627bb039ffdf79892d21a098777fe7b685e5b4c2fc628dad704d2b69ca22894a4b0ee8bfc93e3eedee8994a0fd2eed237e42ab881894866e2861eeb02a642ba02f42604e8dc7e33d6403bdc6a084ba4fb4904a7ae66fcc1c7844c9c7aaf2791a8284d734e348e9b0d3c3e8bb41a0a60b3fc8b95c4702fb8595f9edf651b798889908cf48f827333a49745842e26ca0d6df31bc24d28f14770c61319504bfef096a84a7a26be0fb0d06164faae21555a0877a9d307988866707b6110ad021d54996623ea8a5a23064064e115fde3876a7a040cb3869bb438af84a0394b8b2cf8c91536b558dcbf526d0557edc17b06c838ea0f8894282b74bc79234ef466fa26de9d75261beca73f35e0cfa0a3f765d759777a0201f559925d726dc212e3a3af85af03cfdf59406b10568852116b7e33cbbc519a0c179214095b9c773372e9d288134b89880d21207a3745ee3a80be38c98315875a0beb09cc957d672674439b84d1d102050d875b04a6ef705e0627730266e45cd42a0e9cd57b88bada61158f3434013fcd278dbcf031fbe06e5887d63cb86d318dc66a0fb53e9b1635fa8c2320a5e82baaa5c0e9d9c1a25779d1d652ead8c5945041bff80",
            "0xf90211a0b8eb133cd865b1bc57b0dcb03f14b8b85b2a7b4b8dd165d22e420b49f87f6ed1a0fd08afa2bb2d4e07ab85ac0d27a5bc897a9b6602d0f353b7255a4984566f6f85a0912c35c18602ff3093a37c362389f6ee18b091ad707e846da5cedfc34863adbba022688058a3356626b6b643d13c256f824cbe972a250e26347cd3427660487084a0119dea23315ab034eb168b2b89b3b82a56a2c85e781de9206072846a468e4077a0675b245f178f333a15289e172c9e5ec6ebf419ac261a7bc55081c1f813b9e771a0ee267153ef40dfa54708a2260fb269fd1921d80b5edbd5a120ef9d18a7355abea0d129069c29a3e6b9194ab79f06774012941b21cff117b7652d87d07d22438b52a0e4b573fb28bb46f669cc3c2aad69434550575ca60c75782926ee36a5753f4f9da006d8b957fd15c2186d0eb40d5ccf593e50e46661a27483516dc48a667e86a533a001b10b966e38aa34720ee901c2598fd750f206a7c70e2d0c26b2c89272bf4166a0947174ce839866d298bf0062e7670ed6341e5ad977ce45c794f5e75ea252f898a09dba03d5f61667a5780dbd95bc89887f03dcfae1c709f8de2425e4b009492185a0566bb5abf028b86549c88db8569e5d3b1a574e946f63fbb7b162c86cbc20cb02a0545d5f75cc5adb158a0ab58ad0d2eed5ce294d27e50b8f88f1fd5cf4a65f031da0ba5fcefc077bad4f303579153a768547258a76deb29d033bdaea11dab606455580",
            "0xf90211a043dae40b5874765bf9cd7b3699d839d0aba4429c21c410882e0800e6469485dda0b9b5ecf15e059156d89b860266dc344be708c00e4986736074069142d9864899a03aaa056aa10913145ae28fe946f1f10be6a9b694b20b2b66c6f0b4bc7996f483a0351f05db0bd5ccbeefa23390df2ad39cf624a36b8257c81835e347fde446a9cea039af412ce97a689dd86d173cf812fef753e49e0acee83a211e535588935f5aa8a0d553b3a5ed67f4f96b3a05bbe054dcf64833edb996e187ab47d346c81b28234aa0c42a9180dba07fce43e86042873147927955e0cb843f7194a38eec677ffd88daa0b6b225caf4f07b8cb31ac2c2ba9d2772d50abd7b9bbc0770e9cd0cdc37ca3cd1a0e0306ad4105980967bf779030c4a1059f8f72cae9aa52bfa9fa46f859cbdda3fa047ea961a5184b307608bafe4e69162710b0552b8ca0b4676012b7c80fcb39880a0ffa88a52ad54224626015a084aa94e379da38341dfc365cb5bc11f96ce6b6cd2a072a7d192e954b8e02142265b8259f32ed2096ad7cf9d66bb85db6127b7930571a0bf29df34b07d4a2bd2c9ab554103579d79b291afed7bbf51cbebd716486e2c1fa00814b216bb43d0c8d3846f53e45153dc718574e86e47f8e6d8710053d2b1c252a08558956c33411676152e441661a1cb15120e4eed4e286e9fee2b1d31135e58f4a0ab62f367e18e2fb58aed688d19c6db434fb74e1f86c7a383a8a4f74515ce096780",
            "0xf90211a073aa46337f788c983683db9db2626210db8c668f2af59382dcbaa4280bcdb1fda098ded1cd1484e6f30e8db944a24e2a3aa5ef4cb9a0a54d9a385a5043f608cf2ca0a59458b8c03d555b5e80fc09b66ca19606cf7acac2f4000f8aace363870b6d9ba0b43185e042a79eb4391fc84cc568f0f9ee12821167a8b610f81243a9943e6029a03fdfa08bcd9a8ee50a449697a93e89c6dfe8138c3208ad6434e4ac4d00840f40a094dd735cc6365ba96d6a9d430e1bde75555a2eb7cb28b2e2dead84103a8fcc51a0bba9723727240fa9a9309539d93c0406f07544058b63b3623c60ee41732d2641a0dd806b1791a75f6c1acbc4ae0df53aeda38dffbda9bab34598b2b1f21c8b2f99a0a9335a885adec811e3ae7b8b276b67a619b5c5f575535f7ad4a00b087c61614ca0e9ffdea2825e4c4b9efa8eb7d5de200f46fd9d35ac4fb8b9ba7ff01c87f6e882a0c956338e5b2a99629166918175ff213f431c2744280b5284880b0c81e651bff7a08c7df1ce8b62d1e7ecdd8a77f32c4cb541d2b1f0b958da55761fd6faeef18325a0b226a0b22452facfa73d257c67aaed26812bfe87ba3fd59b1cc588aa263e1cd9a00e15f2674e706ebdad278004b2a72b266868cb54035ece5bf2a61579951ef395a0d539410a6a58e55a914596a7edc6176509fe96118166b86cbdce0b327d3305baa06073d9425d7bb2d3a709f3c99a162ccceea84c9521c3b1da0ab87df93ce50c1f80",
            "0xf891808080808080a07fe11c3a709c38f841ec78b70a722f205601900d441d8e9f211418f6fc670181a0bff20677553e1ad5961b76fcc231d6c16dad0d09dc826e6159b8c3d4b34cd0108080a0d896455a115dba4c3ba727ae5ca757bb1b2b84ff2d089244d7f872299e32ffbc80808080a0cba9c433b41f5172f3023b4f3acf0d9d499a38564570895db8e7116e8f0dd18f80"
        ],
        "balance": "0x0",
        "codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
        "nonce": "0x0",
        "storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
        "storageProof": [
            {
                "key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
                "value": "0x0",
                "proof": []
            }
        ]
    }
}

🚧

The below parameter inputs do not work, please reference the section above instead.

Language
Click Try It! to start a request and see the response here!