Filecoin.StateSearchMsg

POST

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Changed. A null element inside the tipset key array is now rejected with an error; before, it was silently dropped. To use the current head, pass an empty array [] or null for the whole key. Searches the blockchain for a message by its CID and returns the message receipt along with the tipset where it was included. The search starts from the specified tipset and proceeds backwards. Can optionally find messages that were replaced by another message with the same nonce but higher gas.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<array | object | integer | boolean>required

Ordered list containing tipset key, message CID, lookback limit, and allowReplaced flag.

Show child attributes

One of

TipSet key to start search from. Use null for chain head.

array | null

/string

Message CID.

Maximum epochs to search backwards. Use -1 for unlimited (search to genesis).

integer

Whether to return info if the message was replaced by another message with same sender/nonce.

boolean

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response containing message lookup result. Returns null if the message was not found within the search range.

Filecoin.StateSearchMsg

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

import { JsonRpcProvider } from "ethers";

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

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.StateSearchMsg", params: [
  null,
  {
    "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
  },
  -1,
  true
], 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.StateSearchMsg",
      "params": [
        null,
        {
          "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
        },
        -1,
        true
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

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

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "Message": {
      "/": "bafy2bzaceaxm23epjsmh75yvzcecsrbavlmkcxnva66bkdebdcnyw3bjrc74u"
    },
    "Receipt": {
      "ExitCode": 0,
      "Return": null,
      "GasUsed": 435623,
      "EventsRoot": null
    },
    "ReturnDec": null,
    "TipSet": [
      {
        "/": "bafy2bzacecnamxgqmtss3ajur6zprk4oxwx7ic5g7xzt7y6f6ygcgse2e6uhq"
      }
    ],
    "Height": 3500000
  }
}