Filecoin.StateLookupID

POST

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Resolves any Filecoin address to its corresponding on-chain ID address (f0 format). ID addresses are compact numeric identifiers assigned to actors when they are created on-chain. This method is useful for normalizing addresses, optimizing message size, and looking up actor state. Returns an error if the address does not exist on-chain.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<string | array>required

Ordered list containing the address to resolve and an optional tipset key for state context.

Show child attributes

One of

The Filecoin address to resolve. Supports f1, f2, f3, and f4 formats. f0 addresses are returned as-is.

string

TipSet key for state context. Use null for current head.

array | null

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing the ID address.

Filecoin.StateLookupID

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

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://fil.nownodes.io/rpc/v1");
const result = await provider.send("Filecoin.StateLookupID", [
  "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
  null
]);
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.StateLookupID",
  "params": [
    "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
    null
  ],
  "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.StateLookupID", [
  "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
  null
])
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.StateLookupID",
  params: [
  "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
  null
],
});

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.StateLookupID", params: [
  "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
  null
], 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.StateLookupID",
      "params": [
        "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
        null
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.StateLookupID",
  "params": [
    "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
    null
  ],
  "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.StateLookupID",
    "params": [
      "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
      null
    ],
    "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.StateLookupID",
  "params": [
    "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
    null
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "f033259"
}

Documentation

How to migrate to NOWNodes

Filecoin.StateLookupID

Authorizations

Body

Response