TAO RPC API - Author Methods

v1.0.0

Base URL

https://tao.nownodes.ioTAO RPC

API for interacting with TAO via JSON-RPC. Contains author category methods for submitting and monitoring extrinsics.

Authentication

api-keyAuthapiKey

API Key: API_key in header

JSON-RPC

chain

Get the hash of the last finalized block

POST

https://tao.nownodes.io/chain_getFinalizedHead

Authorizations

ApiKeyAuthApiKeyAuth

API_key string

NOWNodes API key passed in the api-key header.

Returns the hash of the block that was finalized on the chain.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

Method parameters (empty array)

Response

200OK

Hash of the last finalized block

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Get the hash of the last finalized block

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

import { JsonRpcProvider } from "ethers";

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

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

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

import { createPublicClient, http } from "viem";

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

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

console.log(result);

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "chain_getFinalizedHead",
  "params": []
}

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

require 'net/http'
require 'json'

uri = URI('https://tao.nownodes.io/chain_getFinalizedHead')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "id": "test",
    "method": "chain_getFinalizedHead",
    "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",
  "id": "test",
  "method": "chain_getFinalizedHead",
  "params": []
}

200

{
  "jsonrpc": "2.0",
  "result": "0xb0e62ed11652d7562cb63598140c5eb7ac4f2086f0970334ce8472d403c66e1f",
  "id": "test"
}

Get block by hash

POST

https://tao.nownodes.io/chain_getBlock

Authorizations

ApiKeyAuthApiKeyAuth

API_key string

NOWNodes API key passed in the api-key header.

Returns full information of a block, including header, extrinsics, and digest.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<string>required

Array containing block hash to retrieve

Response

200OK

Full block details

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Get block by hash

curl -X POST 'https://tao.nownodes.io/chain_getBlock' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "test",
    "method": "chain_getBlock",
    "params": [
      "0x451c44b3009ba7a7a005f38c2cae2be4c2be56535f99f8dfac08995872666a44"
    ]
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://tao.nownodes.io/chain_getBlock");
const result = await provider.send("chain_getBlock", [
  "0x451c44b3009ba7a7a005f38c2cae2be4c2be56535f99f8dfac08995872666a44"
]);
console.log(result);

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

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

import { createPublicClient, http } from "viem";

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

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

console.log(result);

const endpoint = "https://tao.nownodes.io/chain_getBlock";
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: "chain_getBlock", params: [
  "0x451c44b3009ba7a7a005f38c2cae2be4c2be56535f99f8dfac08995872666a44"
], id: 1 });
console.log(result);

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "chain_getBlock",
  "params": [
    "0x451c44b3009ba7a7a005f38c2cae2be4c2be56535f99f8dfac08995872666a44"
  ]
}

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

require 'net/http'
require 'json'

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

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",
  "id": "test",
  "method": "chain_getBlock",
  "params": [
    "0x451c44b3009ba7a7a005f38c2cae2be4c2be56535f99f8dfac08995872666a44"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "block": {
      "header": {
        "parentHash": "0xd1b678077a900e1b03747ba5ade6c47960fe7ead346c8722289dbc3d9f1c9dc9",
        "number": "0x160303a",
        "stateRoot": "0x53e1c568f798214ff4406c8db027e4e05a1bc30c486ed391ebd0263ce74f3dc2",
        "extrinsicsRoot": "0xa4afa163cf63cc5851f7af044db5d25bc0229aa44645aadb1d98f9ec87f5ce63",
        "digest": {
          "logs": []
        }
      },
      "extrinsics": []
    },
    "justifications": null
  },
  "id": "test"
}

Get block hash by block number

POST

https://tao.nownodes.io/chain_getBlockHash

Authorizations

ApiKeyAuthApiKeyAuth

API_key string

NOWNodes API key passed in the api-key header.

Returns the block hash using the block number in the chain.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<integer>required

Array containing block number

Response

200OK

Block hash by block number

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Get block hash by block number

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

import { JsonRpcProvider } from "ethers";

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

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

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

import { createPublicClient, http } from "viem";

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

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

console.log(result);

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "chain_getBlockHash",
  "params": [
    20440517
  ]
}

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

require 'net/http'
require 'json'

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

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",
  "id": "test",
  "method": "chain_getBlockHash",
  "params": [
    20440517
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": "0x1e2dc73f800f496f8fc2e1ab3e8b8037267546cf24198b0c6e5a7b87e8b38320",
  "id": "test"
}

Documentation

How to migrate to NOWNodes

TAO RPC API - Author Methods

Authentication

JSON-RPC

chain

Get the hash of the last finalized block

Authorizations

Body

Response

Get block by hash

Authorizations

Body

Response

Get block hash by block number

Authorizations

Body

Response