Filecoin.StateCall

POST

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Performs a dry-run execution of a message against the specified chain state without persisting any changes. This is useful for gas estimation, testing contract calls, debugging failed transactions, and validating message parameters before actual submission. 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.

Body

application/json

jsonrpcstringrequired

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

methodstringrequired

The name of the JSON-RPC method to invoke.

paramsArray<object | array>required

Ordered list containing the message to simulate and an optional tipset key for state context.

Show child attributes

One of

Versioninteger

Message format version (always 0).

Tostring

Target actor address.

Fromstring

Sender address (must exist on-chain).

Nonceinteger

Message nonce (can be any value for simulation).

Valuestring

Transfer amount in attoFIL.

GasLimitinteger

Maximum gas for execution.

GasFeeCapstring

Max fee per gas (can be "0" for simulation).

GasPremiumstring

Priority fee per gas (can be "0" for simulation).

Methodinteger

Actor method number to invoke.

Paramsstring | null

CBOR-encoded method parameters (Base64).

TipSet key for state context. Null uses chain head.

array | null

idintegerrequired

An identifier for this JSON-RPC request.

Response

200OK

Successful response with detailed execution results.

Filecoin.StateCall

curl -X POST 'https://fil.nownodes.io/rpc/v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "Filecoin.StateCall",
    "params": [
      {
        "Version": 0,
        "To": "f01234",
        "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
        "Nonce": 0,
        "Value": "0",
        "GasLimit": 10000000,
        "GasFeeCap": "0",
        "GasPremium": "0",
        "Method": 0,
        "Params": null
      },
      null
    ],
    "id": 1
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://fil.nownodes.io/rpc/v1");
const result = await provider.send("Filecoin.StateCall", [
  {
    "Version": 0,
    "To": "f01234",
    "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
    "Nonce": 0,
    "Value": "0",
    "GasLimit": 10000000,
    "GasFeeCap": "0",
    "GasPremium": "0",
    "Method": 0,
    "Params": null
  },
  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.StateCall",
  "params": [
    {
      "Version": 0,
      "To": "f01234",
      "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
      "Nonce": 0,
      "Value": "0",
      "GasLimit": 10000000,
      "GasFeeCap": "0",
      "GasPremium": "0",
      "Method": 0,
      "Params": null
    },
    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.StateCall", [
  {
    "Version": 0,
    "To": "f01234",
    "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
    "Nonce": 0,
    "Value": "0",
    "GasLimit": 10000000,
    "GasFeeCap": "0",
    "GasPremium": "0",
    "Method": 0,
    "Params": None
  },
  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.StateCall",
  params: [
  {
    "Version": 0,
    "To": "f01234",
    "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
    "Nonce": 0,
    "Value": "0",
    "GasLimit": 10000000,
    "GasFeeCap": "0",
    "GasPremium": "0",
    "Method": 0,
    "Params": null
  },
  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.StateCall", params: [
  {
    "Version": 0,
    "To": "f01234",
    "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
    "Nonce": 0,
    "Value": "0",
    "GasLimit": 10000000,
    "GasFeeCap": "0",
    "GasPremium": "0",
    "Method": 0,
    "Params": null
  },
  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.StateCall",
      "params": [
        {
          "Version": 0,
          "To": "f01234",
          "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
          "Nonce": 0,
          "Value": "0",
          "GasLimit": 10000000,
          "GasFeeCap": "0",
          "GasPremium": "0",
          "Method": 0,
          "Params": null
        },
        null
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "Filecoin.StateCall",
  "params": [
    {
      "Version": 0,
      "To": "f01234",
      "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
      "Nonce": 0,
      "Value": "0",
      "GasLimit": 10000000,
      "GasFeeCap": "0",
      "GasPremium": "0",
      "Method": 0,
      "Params": None
    },
    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.StateCall",
    "params": [
      {
        "Version": 0,
        "To": "f01234",
        "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
        "Nonce": 0,
        "Value": "0",
        "GasLimit": 10000000,
        "GasFeeCap": "0",
        "GasPremium": "0",
        "Method": 0,
        "Params": null
      },
      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.StateCall",
  "params": [
    {
      "Version": 0,
      "To": "f01234",
      "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
      "Nonce": 0,
      "Value": "0",
      "GasLimit": 10000000,
      "GasFeeCap": "0",
      "GasPremium": "0",
      "Method": 0,
      "Params": null
    },
    null
  ],
  "id": 1
}

200

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "MsgCid": {
      "/": "bafy2bzaceb6nbpdoa63zxbfck22sxvkusmk3jizh7widc7cohn7sus23no5cs"
    },
    "Msg": {
      "Version": 0,
      "To": "f01234",
      "From": "f1abjxfbp274xpdqcpuaykwkfb43omjotacm2p3za",
      "Nonce": 963734,
      "Value": "0",
      "GasLimit": 4611686018427388000,
      "GasFeeCap": "0",
      "GasPremium": "0",
      "Method": 0,
      "Params": null,
      "CID": {
        "/": "bafy2bzaceb6nbpdoa63zxbfck22sxvkusmk3jizh7widc7cohn7sus23no5cs"
      }
    },
    "MsgRct": {
      "ExitCode": 0,
      "Return": null,
      "GasUsed": 0,
      "EventsRoot": null
    },
    "GasCost": {
      "Message": null,
      "GasUsed": "0",
      "BaseFeeBurn": "0",
      "OverEstimationBurn": "0",
      "MinerPenalty": "0",
      "MinerTip": "0",
      "Refund": "0",
      "TotalCost": "0"
    },
    "ExecutionTrace": {
      "Msg": {
        "From": "f033259",
        "To": "f01234",
        "Value": "0",
        "Method": 0,
        "Params": null,
        "ParamsCodec": 0,
        "GasLimit": 9223372036854776,
        "ReadOnly": false
      },
      "MsgRct": {
        "ExitCode": 0,
        "Return": null,
        "ReturnCodec": 0
      },
      "InvokedActor": {
        "Id": 1234,
        "State": {
          "Code": {
            "/": "bafk2bzaceautzxqsrstcxerpxtykn4syogslbiwpsfoh562jex262vxeluc4w"
          },
          "Head": {
            "/": "bafy2bzacedqnjnstx2h4ytcuzmh23tcvfh4ez7pu67mz76b5qotrpxhosmngq"
          },
          "Nonce": 0,
          "Balance": "0",
          "DelegatedAddress": null
        }
      },
      "GasCharges": [
        {
          "Name": "none",
          "tg": 0,
          "cg": 0,
          "sg": 0,
          "tt": 0
        }
      ],
      "Subcalls": null
    },
    "Error": "",
    "Duration": 1970507
  }
}