Get runtime metadata

POST

https://dot.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the runtime metadata as a hex-encoded string.

The state_getMetadata method provides the complete runtime metadata for the chain. This metadata describes all the types, storage entries, extrinsics, and events available in the runtime. It's essential for building type-safe applications and understanding the chain's capabilities.

This method is crucial for:

Generating type definitions for applications
Understanding available storage items and extrinsics
Building dynamic DApp interfaces
Runtime version compatibility checking

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getMetadatarequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Optional parameters array. Can be empty or contain an optional block hash for historical metadata.

Response

200OK

Runtime metadata retrieved successfully

400Bad Request

Invalid request parameters

500Internal Server Error

Internal server error

Get runtime metadata

curl -X POST 'https://dot.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_getMetadata",
    "id": 1,
    "params": []
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://dot.nownodes.io/");
const result = await provider.send("state_getMetadata", []);
console.log(result);

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

uri = URI('https://dot.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "state_getMetadata",
  "params": [],
  "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://dot.nownodes.io/"))
response = w3.provider.make_request("state_getMetadata", [])
print(response)

import { createPublicClient, http } from "viem";

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

const result = await client.request({
  method: "state_getMetadata",
  params: [],
});

console.log(result);

const endpoint = "https://dot.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_getMetadata", params: [], id: 1 });
console.log(result);

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_getMetadata",
  "id": 1,
  "params": []
}

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

require 'net/http'
require 'json'

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

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_getMetadata",
  "id": 1,
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x6d6574610e0000001c00000000000000020000000000000003000000000000000400000000000000"
}

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving metadata"
  }
}

Documentation

How to migrate to NOWNodes

Get runtime metadata

Authorizations

Body

Response