Filecoin.BeaconGetEntry

POST

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the drand beacon entry that corresponds to the given Filecoin chain epoch. Each epoch maps to a specific drand round, and the returned entry contains the round number and the randomness data (signature) produced by the drand network.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<integer>required

Ordered list of parameters. Contains a single element: the Filecoin chain epoch (block height) for which to retrieve the beacon entry.

idintegerrequired

An identifier for this JSON-RPC request. The same value is echoed back in the response so the caller can correlate requests with responses.

Response

200OK

Successful response containing the beacon entry for the requested epoch.

Filecoin.BeaconGetEntry

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

import { JsonRpcProvider } from "ethers";

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

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

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

import { createPublicClient, http } from "viem";

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

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

console.log(result);

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

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

const data = await response.json();

import requests

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

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

require 'net/http'
require 'json'

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "Round": 3595845,
    "Data": "puCJLBYbDtfh9v8W+ibQCosioetEi8JhLJ0J72NFJ4RR+u2dXfZSqfbGVRbf+BEsDN8CprLwUbOaMiW8lpZCHBkBbRiZleD9ebe6ErKX+lph26A6Osan29JGUfc2lITN"
  }
}

Documentation

How to migrate to NOWNodes

Filecoin.BeaconGetEntry

Authorizations

Body

Response