Filecoin.ChainHead

POST

https://fil.nownodes.io/rpc/v1

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the current heaviest tipset (chain head) as tracked by this node. The chain head represents the latest consensus state of the Filecoin blockchain. It is updated every ~30 seconds as new blocks are produced.

Body

application/json

jsonrpcstringrequired

JSON-RPC protocol version. Must always be "2.0".

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<any>required

This method takes no parameters.

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the current chain head tipset.

Filecoin.ChainHead

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

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://fil.nownodes.io/rpc/v1");
const result = await provider.send("Filecoin.ChainHead", []);
console.log(result);

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

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

import { createPublicClient, http } from "viem";

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

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

console.log(result);

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.ChainHead",
  "params": [],
  "id": 1
}

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

require 'net/http'
require 'json'

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

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "Cids": [
      {
        "/": "bafy2bzaceckjauv7cdrs6aj6oohdjd4vz4gc5c2e36duah245wtyrv6jqiife"
      },
      {
        "/": "bafy2bzacedfilxbnpt7wr6kc5jc3cyqgtzetrya4s5nqvggzdgmtvb2oljhhm"
      },
      {
        "/": "bafy2bzacebkq525eg6vh5e56atkfoohwj4wwutxgtfkguuouyrvtofirvhmfq"
      },
      {
        "/": "bafy2bzacedrqxhc4gzith64cb6faosenyvffhq6zsktnjrobyn7wv74quyncm"
      }
    ],
    "Blocks": [
      {
        "Miner": "f03161054",
        "Ticket": {
          "VRFProof": "mdr93QcpE2SC06HOEVCjgd0/8ti9jgPqVDFU3OWe0Lfiozgo8O2bDVTL8U+f3F3NDvjawCwHbbC+FJCVAornSza7RH/uhc/5LF+8zuTgz9zlqgpZu47tQIfa5f0dDOaw"
        },
        "ElectionProof": {
          "WinCount": 1,
          "VRFProof": "kI1BjxyLmfuHHwWF0GmpNHwSNeIaSvfyEXnBFndRtvtsRjfUF5MW7zv0nSBa/z0jEMa5ykkm0i7b/TEQN2fPjMKD6xh8xVbCPwxMggm4HQFyWDzVPkDlwBSSoL00zqTs"
        },
        "BeaconEntries": [
          {
            "Round": 26432632,
            "Data": "pPGyg2xtaKa1w8JmeCH7DBUAIVrbUvgvERATs3C4DRklmkDvYIuw0d+cW9ht8V34"
          }
        ],
        "WinPoStProof": [
          {
            "PoStProof": 3,
            "ProofBytes": "owmwp5OK/zcP09Caf/gf3SqtuO51h4FytkWQ6h7Sc8s9tsl3QgSHentWzL3sLW9OivDYlx2/191yCVy8dY3tZAtcD7VgaQRAHeBeOkh95Jq5AwPhFXK9uKcVPCm1NSfHCuEj3oH3YdqjKi9CKo3AN32GeRNTm1uloVk51pSkJc619j7FOhKuGYHZC4KAX8RqqJyDBaE8VjPj9qdcoh5B/stQlPnqrf7Ivy8WVobimCm5pmVnvt1/1/+ihU6Yf/4p"
          }
        ],
        "Parents": [
          {
            "/": "bafy2bzaceb2pcwegz567dscrrcwnjv65xiwcktaafimyvchcw46aquvd3rdvs"
          },
          {
            "/": "bafy2bzacec4bjidpolddqh6k22r75g2jj7aijssgwszjmohgjy7a5dhb53tcc"
          },
          {
            "/": "bafy2bzacebw5xltybc4pohierextz75ykxxjlr5lam4ckdhpfq7zxl3bhshqe"
          },
          {
            "/": "bafy2bzaceb5xhrjoiplvkat2dpg5lggjygi26ai36kvuaqs632w5jyjlp2vss"
          },
          {
            "/": "bafy2bzaceblpxqi2z4npwrh7d2qxdcgxua4tthetn74ihpd6iocfwtolofaxy"
          }
        ],
        "ParentWeight": "138604845913",
        "Height": 5793163,
        "ParentStateRoot": {
          "/": "bafy2bzacedbktmi2eh4gy2dnwnsnfoyowd4nvbi22j3zfx7swdrqmzybyz3i2"
        },
        "ParentMessageReceipts": {
          "/": "bafy2bzacea73k5imzhbrf5tpe76s7y5lmyex2byeebyvkrafzf5ix6vaftgoi"
        },
        "Messages": {
          "/": "bafy2bzacebcn4stlzbfdrtkgh4a5bf6iup3bciyaiqaadmtrl2pducvm62qai"
        },
        "BLSAggregate": {
          "Type": 2,
          "Data": "h8+iRBEcwIXRfJ+hGrkvB/Sa32aPSa3gOQMPwlCwe06FwE0F65UxeQnGO9rys4I0BpSIaPktYfAOEUIqABqO5AeXUfU3UTOtGJE9J0xA3yPIXspdt6zny7rN91+TuZ+8"
        },
        "Timestamp": 1772101290,
        "BlockSig": {
          "Type": 2,
          "Data": "g1Niy/wm/dFY1sGVVNVRnZv6QX4Vi50e9tH+VBSHFePg4tKWU3kmeszIfMHi93NHDvMbpQklLNr7+b2/YMp132xfFEprLca8+5gmUWqr8+KdYAipQKa9Vobxk3/EBlgu"
        },
        "ForkSignaling": 0,
        "ParentBaseFee": "100"
      }
    ],
    "Height": 5793163
  }
}

Documentation

How to migrate to NOWNodes

Filecoin.ChainHead

Authorizations

Body

Response