Get read proof for storage keys

POST

https://moonbeam.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns proof of storage entries at a specific block.

The state_getReadProof method generates a Merkle proof for the specified storage keys at a given block. This proof can be used to verify the existence and values of storage entries without needing to trust the node providing the data.

This method is essential for:

Light client verification
Cross-chain bridge operations
Trustless data verification
State proof generation

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getReadProofrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<Array<string> | string>required

Array containing storage keys and optional block hash.

Show child attributes

One of

Array<string>

Optional block hash to generate proof at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Read proof generated successfully

400Bad Request

Invalid storage keys or block hash

500Internal Server Error

Internal server error

Get read proof for storage keys

curl -X POST 'https://moonbeam.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_getReadProof",
    "id": 1,
    "params": [
      [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
      ],
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://moonbeam.nownodes.io/");
const result = await provider.send("state_getReadProof", [
  [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
  ],
  "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
]);
console.log(result);

require 'eth'
require 'json'
require 'net/http'

uri = URI('https://moonbeam.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "state_getReadProof",
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ],
  "id": 1
}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://moonbeam.nownodes.io/"))
response = w3.provider.make_request("state_getReadProof", [
  [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
  ],
  "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
])
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://moonbeam.nownodes.io/"),
});

const result = await client.request({
  method: "state_getReadProof",
  params: [
  [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
  ],
  "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
],
});

console.log(result);

const endpoint = "https://moonbeam.nownodes.io/";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({ jsonrpc: "2.0", method: "state_getReadProof", params: [
  [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
  ],
  "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
], id: 1 });
console.log(result);

const response = await fetch('https://moonbeam.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_getReadProof",
      "id": 1,
      "params": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
        ],
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_getReadProof",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

response = requests.post('https://moonbeam.nownodes.io/', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://moonbeam.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "method": "state_getReadProof",
    "id": 1,
    "params": [
      [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
      ],
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_getReadProof",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "at": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
    "proof": [
      "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid storage key format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error generating read proof"
  }
}

Documentation

How to migrate to NOWNodes

Get read proof for storage keys

Authorizations

Body

Response