Chain Exploration

ChainHead

Gets the current ChainHead.

Method: POST

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

Example body (raw)

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

Example response: 200

{
    "jsonrpc": "2.0",
    "result": {
        "Cids": [
            {
                "/": "bafy2bzaceclrbtl6aqiyt2flri7oimvewc5mkm2z5vkqb36f5c734ogtbiewq"
            },
            {
                "/": "bafy2bzacebfntujcosoezie222i2bibrfxyzfb4c4g5b5pqetwfjsqkbyhsla"
            },
            {
                "/": "bafy2bzacebkxxbg7ea3cumdt34wcqnw4ujmvymhoo6qi5if6t5rnyyjbia4n4"
            },
            {
                "/": "bafy2bzacecrvxhfj6meblygn6s3sb7ubu6sxpbrqerffs7nh3oiwdew5cyvai"
            },
            {
                "/": "bafy2bzaceb3d5bl7twafukatcb3usmoirw3l4bb7fdy43ohjywyic2zjkbf5o"
            },
            {
                "/": "bafy2bzacedmouygn6ipu76dvaoxyahdyxzfzx447esfkw2axkx2hpcl6b5roa"
            },
            {
                "/": "bafy2bzacebpcadn5x7sw7xiga6gl2hlve2wudqjmhtjuogj54alb56q6ea7sk"
            },
            {
                "/": "bafy2bzacecamovvqu6oghptdtarhwqpasmvwxgja2xazafpsimke6ubio6cuw"
            }
        ],
        "Blocks": [
            {
                "Miner": "f01805566",
                "Ticket": {
                    "VRFProof": "rvZpNyAeGw5UXiNezj5Qvp1Wa/yLj5jo8dZrBxk+m4hDZoGdRvG2AzOot7mnSyzKCCX68PV+G23TDn1J/GU65P9Ze8HMoUe4SwuEWBF81ds2pi/CloAUDJH4a7IpQf8u"
                },
                "ElectionProof": {
                    "WinCount": 1,
                    "VRFProof": "synpTh5AebXgryUcvRAVnTbnQCbiAxlAawBq2vQn3oblOQlCeGxG5vlxnPdn6zqVA4hwCMCvaHzJ9FhMBQAvzI76e0vyQX/7kCC/3OPx5mddpiztYH9nzCJRIwM1JB7Y"
                },
                "BeaconEntries": [
                    {
                        "Round": 7140042,
                        "Data": "prsZN3Ly49I5DRJ3t74/lv8y4TKQ0GeAthJUwh50EzBrqcf3FIHPCQqBIWs1mxi+"
                    }
                ],
                "WinPoStProof": [
                    {
                        "PoStProof": 3,
                        "ProofBytes": "jv6fMUUMDIUz49Eyr7K9t/gvwJQot88xPEHhJq4YxBTbF6MTMQtnXxtgYZUyGYayrzC1xQDKwzykFALcJCIKrVRhGm1xc2zYiLyhcrvvXeBmuYkYmFl4xVDqMJOmPFSCCd4x1IUW0TxZGpLLZtaSPlrlWBb7MCcFLx3ttfeSt5uIM744PLK8Hi3I3nSATcL2gS/EYMO0cvfxDsyPeIXD8u/0PEunAbw/F3ByHvptRpOU0m7eh3KUZJ+1DK3S3s/0"
                    }
                ],
...

ChainGetTipSetByHeight

Returns a TipSet at the supplied Height.

Method: POST

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

Example body (raw)

{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetTipSetByHeight",
    "id": 1,
    "params": [
        2000,
        null
    ]
}

Example response: 200

{
    "jsonrpc": "2.0",
    "result": {
        "Cids": [
            {
                "/": "bafy2bzacealmy4ndoghpt2nnwa2cw4vbyhh57knnxa3szzmus6mbizjeorq3e"
            },
            {
                "/": "bafy2bzaceafatug7se2uu7kv3vk556nauf4q62wrlgkzyhldipzczuu7byfpy"
            },
            {
                "/": "bafy2bzacecqlgmd6q5nbejgnjdrmdgphvdtawipthymesqbi52tm4vxvmevvc"
            },
            {
                "/": "bafy2bzaceckns77n64soazv7kklaoazp6lepvxkfzfgsemvyzxrmwesv2vn44"
            }
        ],
        "Blocks": [
            {
                "Miner": "f02438",
                "Ticket": {
                    "VRFProof": "j8UMNotnEqQzRBTPNua1Zc3ESQ4vjth/5r1N3TByixfPqvjEHI2OvvDDdNID1+OXCFmhw/kBT0vodh8zxoDe7vtEBtvCwNvuT78YOVlTpwS+WULfdFZNIbo8ZvUmNPrT"
                },
                "ElectionProof": {
                    "WinCount": 1,
                    "VRFProof": "qg2oON9g1o/Vs72+5c0dx2EEmJ38Q+g43KVKWJoqyNDnYk+Kl9m/fkobwF3StfY1CaU6tcwPGda5DlOisCI4ttZcdruYnyU6VCugh0JisC8UhuBqW4gHnnZ79sfuI7KW"
                },
                "BeaconEntries": [
                    {
                        "Round": 83085,
                        "Data": "qaHmfG03JEwHoAao17nEAswc/mX0if+/xhnrA1jToA1MOm/N3MlWHqM0D67NWIDMEggLQBlmH1RRmmtnh8D5QnbYgCBF07O/oOicOjjBedYL/0bPn1UM4ZEVhd8DHa5p"
                    }
                ],
                "WinPoStProof": [
                    {
                        "PoStProof": 3,
                        "ProofBytes": "gLg1yruK7WtBl2igQNBcbYkbS+8tY29TSQiudaEF6mwqwxNPXDiXWFdBu8Jsx34Zt6VYmIEZqHQ9Q1DFxfUqoWaV+MveQtPy34adaoYL1OWfZtZYdusrXZy9tNzYNMUkDCzFyPs8ZmuSRxlFKaodkL8+snkBj7FQC36tWJdP1UfKHp1ZAx2zpAUeufBDExg7gePMs6rJkYmRof8DAjwEr4nOmW26Zy2oQNnBXs1j6PyL0HOW+BGrldBV59lnRLO3"
                    }
                ],
                "Parents": [
                    {
                        "/": "bafy2bzacea7ve732wry3btcqftxcjnwwqvityzho4y6ut5j47b776rbmfmjsc"
                    },
                    {
                        "/": "bafy2bzaceaxshhatiocfxpzdwiecnnad7iryfglqgmduii6wlbynfvamhz6bu"
                    },
                    {
                        "/": "bafy2bzacec5qioslft3r6tu4yfqatkxnf3viehdhx6t4dkwwlopq5fwr7xgpm"
                    }
                ],
...

ChainReadObj

You can pass any valid Cid to ChainReadObj, ensure it's formatted as:

Method: POST

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

Example body (raw)

{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainReadObj",
    "id": 1,
    "params": [
        {
            "/": "bafy2bzacedrx3uimgtgldpg4sqrml7kaxsnggjusdh6bxt64bpvkvde73mjna"
        }
    ]
}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": 1,
        "message": "blockstore get: ipld: could not find bafy2bzacedrx3uimgtgldpg4sqrml7kaxsnggjusdh6bxt64bpvkvde73mjna"
    }
}

ChainHasObj

You can pass any valid Cid to ChainReadObj, ensure it's formatted as:

Method: POST

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

Example body (raw)

{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainReadObj",
    "id": 1,
    "params": [
        {
            "/": "bafy2bzacedrx3uimgtgldpg4sqrml7kaxsnggjusdh6bxt64bpvkvde73mjna"
        }
    ]
}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": 1,
        "message": "blockstore get: ipld: could not find bafy2bzacedrx3uimgtgldpg4sqrml7kaxsnggjusdh6bxt64bpvkvde73mjna"
    }
}

ChainGetBlock

Ensure that the Cid you're passing to this method is a Block Header Cid. An array of block header Cids are returned from the ChainGetTipSetByHeight method, under the Cids param in the response.

Method: POST

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

Example body (raw)

{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetBlock",
    "id": 1,
    "params": [
        {
            "/": "bafy2bzacedrx3uimgtgldpg4sqrml7kaxsnggjusdh6bxt64bpvkvde73mjna"
        }
    ]
}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": 1,
        "message": "ipld: could not find bafy2bzacedrx3uimgtgldpg4sqrml7kaxsnggjusdh6bxt64bpvkvde73mjna"
    }
}

ChainGetBlockMessages

Returns the messages inside a Block.

Method: POST

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

Example body (raw)

{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetBlockMessages",
    "id": 1,
    "params": [
        {
            "/": "bafy2bzacedrx3uimgtgldpg4sqrml7kaxsnggjusdh6bxt64bpvkvde73mjna"
        }
    ]
}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": 1,
        "message": "ipld: could not find bafy2bzacedrx3uimgtgldpg4sqrml7kaxsnggjusdh6bxt64bpvkvde73mjna"
    }
}

ChainGetMessage

Ensure that the Cid you pass in here is an actual Message Cid. One way to get a Message Cid is through the ChainGetBlockMessages API method.

Method: POST

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

Example body (raw)

{
    "jsonrpc": "2.0",
    "method": "Filecoin.ChainGetMessage",
    "id": 1,
    "params": [
        {
            "/": "bafy2bzacebrbwqt23c7iut5fqolwkmyypv4tppdank5a72oem3h4n6aexxlbw"
        }
    ]
}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": 1,
        "message": "ipld: could not find bafy2bzacebrbwqt23c7iut5fqolwkmyypv4tppdank5a72oem3h4n6aexxlbw"
    }
}

MpoolPending

Gets the pending messages from the pool.

Method: POST

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

Example body (raw)

{
    "jsonrpc": "2.0",
    "method": "Filecoin.MpoolPending",
    "id": 1,
    "params": [
        null
    ]
}

Example response: 200

{
    "jsonrpc": "2.0",
    "result": [
        {
            "Message": {
                "Version": 0,
                "To": "f02207572",
                "From": "f3tfo3cq7j4zoacotlins6sm47j5ot7hws7dlhcpkumnmqxugzo6o6oy2cddej72i5p4yxjfo2ieuyepliktmq",
                "Nonce": 9238,
                "Value": "0",
                "GasLimit": 26231153,
                "GasFeeCap": "190613047013",
                "GasPremium": "100126",
                "Method": 5,
                "Params": "hQWBggBAgYINWMCW0AUIJCp9KCQ6+PscDC2TShewirgk0heETeP8M7XUlKTcE19AfAzCDSJeIfJ3BoOlbEx9yzv1bwoKbd1dp6JeEO35F5TyjXI+x0SrT38OcJv7Q7bRlJA9cFTYo7I9NXcIamDGU+qkn1EdZzPGNahl7Wl/v6ADFPpm7yv33oIy+JcFn0LI0VE0A2refeQsZzq3eV0bc6LV5Kynwf2il9aHFWgzkvzhyuKwOSQUYjtCqXtgZhbGgOBnjYTAG9Q+Ed4aADr1W1ggPAMWL34GkYcyPVMuWbM/CxevzLRkmSgoO9mDiKGb180=",
                "CID": {
                    "/": "bafy2bzacebo7dsvnym7yox7qv7fwbckt7xremqrf723jq5r6warocggml5atk"
                }
            },
            "Signature": {
                "Type": 2,
                "Data": "lP02upPP8glncrZEwVEyiY7GuzCNvlRCilcF8v65iDzIecF86GNO/7IczW5wM9FlCPJMj5urj4f+Qxanj/cGkZ5TlG1PXvGoZZ4vPntlPVYfFWr9jckcJQeuMKG6Wr8L"
            },
            "CID": {
                "/": "bafy2bzacebo7dsvnym7yox7qv7fwbckt7xremqrf723jq5r6warocggml5atk"
            }
        },
        {
            "Message": {
                "Version": 0,
                "To": "f01083914",
                "From": "f3sjfl2wv33ijq4igmps5ugm55aukktjxpvmrmudnwpful2axfxjbuiwildjw3mrfvilq4nrvbdq5bqqfdfz5q",
                "Nonce": 547897,
                "Value": "0",
                "GasLimit": 91388377,
                "GasFeeCap": "102406",
                "GasPremium": "101331",
                "Method": 7,
                "Params": "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",
                "CID": {
                    "/": "bafy2bzacedzuehjqn4ef4x5ewcylfkmpghnyhzhaspyhuernpckq3rdlomkzg"
                }
            },
            "Signature": {
                "Type": 2,
                "Data": "iDgxiKkiUxa8acM47hG4yUzGRN1+Rbzg7XlXAnCeKnovh9vQ2xJT7MiwYDIqZv+DEkBt1oMudtdO7vBBzFuu9fhC07+fsRDc3XsLCxDMlXdQ2kZ+8C6XUuhid5oyW0iL"
            },
            "CID": {
                "/": "bafy2bzacedzuehjqn4ef4x5ewcylfkmpghnyhzhaspyhuernpckq3rdlomkzg"
            }
        },
...

StateSearchMsg

Useful for checking to see if a Message with Cid can be considered "confirmed". Ensure the Message Cid you pass in here is valid. See ChainGetMessage for more information.

Method: POST

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

Example body (raw)

{
    "jsonrpc": "2.0",
    "method": "Filecoin.StateSearchMsg",
    "id": 1,
    "params": [
        {
            "/": "bafy2bzacebrbwqt23c7iut5fqolwkmyypv4tppdank5a72oem3h4n6aexxlbw"
        }
    ]
}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32602,
        "message": "wrong param count (method 'Filecoin.StateSearchMsg'): 1 != 4"
    }
}

StateReplay

Useful for checking to see if a Message with Cid can be considered "confirmed". Ensure the Message Cid you pass in here is valid. See ChainGetMessage for more information.

Method: POST

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

Example body (raw)

{
    "jsonrpc": "2.0",
    "method": "Filecoin.StateSearchMsg",
    "id": 1,
    "params": [
        {
            "/": "bafy2bzacebrbwqt23c7iut5fqolwkmyypv4tppdank5a72oem3h4n6aexxlbw"
        }
    ]
}

Example response: 200

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32602,
        "message": "wrong param count (method 'Filecoin.StateSearchMsg'): 1 != 4"
    }
}

StateCall

Method: POST

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

Example body (raw)

{
    "jsonrpc": "2.0",
    "method": "Filecoin.StateCall",
    "id": 1,
    "params": [
        {
            "To": "t2pmws5gnnjoyju6cfonngkpzlrv3ydlzar6oqdrq",
            "From": "t1nq5k2mps5umtebdovlyo7y6a3ywc7u4tobtuo3a",
            "Nonce": 25,
            "Value": "0",
            "Method": 2,
            "Params": "hFUCey0uma1LsJp4RXNaZT8rjXeBryBABVgYglUBbDqtMfLtGTIEbqrw7+PA3iwv05P0"
        },
        null
    ]
}

Example response: 200

{
    "jsonrpc": "2.0",
    "result": {
        "MsgCid": {
            "/": "bafy2bzacebo2357z3ugdfqccyzo7omv6jcaaq6zqodrsodopp7rxkat47kbya"
        },
        "Msg": {
            "Version": 0,
            "To": "f2pmws5gnnjoyju6cfonngkpzlrv3ydlzar6oqdrq",
            "From": "f1nq5k2mps5umtebdovlyo7y6a3ywc7u4tobtuo3a",
            "Nonce": 47,
            "Value": "0",
            "GasLimit": 4611686018427387903,
            "GasFeeCap": "0",
            "GasPremium": "0",
            "Method": 2,
            "Params": "hFUCey0uma1LsJp4RXNaZT8rjXeBryBABVgYglUBbDqtMfLtGTIEbqrw7+PA3iwv05P0",
            "CID": {
                "/": "bafy2bzacebo2357z3ugdfqccyzo7omv6jcaaq6zqodrsodopp7rxkat47kbya"
            }
        },
        "MsgRct": {
            "ExitCode": 5,
            "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": "f023667",
                "To": "f2pmws5gnnjoyju6cfonngkpzlrv3ydlzar6oqdrq",
                "Value": "0",
                "Method": 2,
                "Params": "hFUCey0uma1LsJp4RXNaZT8rjXeBryBABVgYglUBbDqtMfLtGTIEbqrw7+PA3iwv05P0",
                "ParamsCodec": 81,
                "GasLimit": 9223372036854776,
                "ReadOnly": false
            },
            "MsgRct": {
                "ExitCode": 5,
                "Return": null,
                "ReturnCodec": 0
            },
...