Lotus JSON-RPC supported endpoints

The deployed Lotus cluster is meant to support basic wallet and chain exploration functionality. This documentation is broken into two sections covering each of those use cases.

Any endpoints that are not required for basic wallet and chain exploration functionality are block-listed.

Please note that the JWT's used through these docs are for example only. You will have to replace with your own token when making requests.

Message sending

When sending Filecoin in the Glif wallet, we use the following calls described in this folder, usually in this exact order.

POSTWalletBalance

http://127.0.0.1:1234/rpc/v0

First, we check to make sure the wallet address that is attempting to send Filecoin has enough Filecoin to send the desired message.

NOTE - the string returned from the JSON-RPC represents the AttoFil value. We use the filecoin-number package to convert between AttoFil and Fil denominations.

HEADERS

Authorization

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBbGxvdyI6WyJyZWFkIiwid3JpdGUiLCJzaWduIiwiYWRtaW4iXX0.7J3Bh0YHYlHVMdfjxDs_PUotZ3OQ7r4jQnfYG0m8isk

Content-Type

application/json

Bodyraw

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

Example Request

curl

curl --location 'https://lotus-dev.temporal.cloud/rpc/v0' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBbGxvdyI6WyJyZWFkIiwid3JpdGUiLCJzaWduIiwiYWRtaW4iXX0.7J3Bh0YHYlHVMdfjxDs_PUotZ3OQ7r4jQnfYG0m8isk' \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"method": "Filecoin.WalletBalance",
"id": 1,
"params": ["t1jdlfl73voaiblrvn2yfivvn5ifucwwv5f26nfza"]
}'

200 OK

Example Response

plain

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

Server

nginx

Date

Fri, 10 Jan 2020 14:18:04 GMT

Content-Type

text/plain; charset=utf-8

Content-Length

Access-Control-Allow-Origin

Access-Control-Allow-Credentials

true

Access-Control-Allow-Headers

Authorization,Accept,Origin,DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Content-Range,Range

Access-Control-Allow-Methods

GET,POST,OPTIONS,PUT,DELETE,PATCH

Strict-Transport-Security

max-age=315360000; includeSubDomains;

POSTMpoolGetNonce

http://127.0.0.1:1234/rpc/v0

Next, we get the address' nonce value.

IMPORTANT - if this is the first time wallet, this call will return an error. If the error contains "address not found", we assume the Nonce is 0, since no on-chain transactions reference this address.

AUTHORIZATIONBearer Token

HEADERS

Content-Type

application/json

Authorization

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBbGxvdyI6WyJyZWFkIiwid3JpdGUiLCJzaWduIiwiYWRtaW4iXX0.7J3Bh0YHYlHVMdfjxDs_PUotZ3OQ7r4jQnfYG0m8isk

Bodyraw

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

Example Request

curl

curl --location 'https://lotus-dev.temporal.cloud/rpc/v0' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBbGxvdyI6WyJyZWFkIiwid3JpdGUiLCJzaWduIiwiYWRtaW4iXX0.7J3Bh0YHYlHVMdfjxDs_PUotZ3OQ7r4jQnfYG0m8isk' \
--data '{
"jsonrpc": "2.0",
"method": "Filecoin.MpoolGetNonce",
"id": 1,
"params": ["t1jdlfl73voaiblrvn2yfivvn5ifucwwv5f26nfza"]
}'

200 OK

Example Response

plain

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

Server

nginx

Date

Fri, 10 Jan 2020 13:37:18 GMT

Content-Type

text/plain; charset=utf-8

Content-Length

Access-Control-Allow-Origin

Access-Control-Allow-Credentials

true

Access-Control-Allow-Headers

Authorization,Accept,Origin,DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Content-Range,Range

Access-Control-Allow-Methods

GET,POST,OPTIONS,PUT,DELETE,PATCH

Strict-Transport-Security

max-age=315360000; includeSubDomains;