sui_getCheckpoints RPC Method

Parameters

cursor

string

(Optional) Paging cursor to start fetching from the next item after the specified cursor. Defaults to the first item if not provided

limit

integer

(Optional) Maximum number of items returned per page. Defaults to QUERY_MAX_RESULT_LIMIT_CHECKPOINTS if not specified

descendingOrder

boolean

REQUIRED

Query result ordering. Defaults to false (ascending order), oldest record first

Returns

result

object

Paginated list of checkpoints and metadata

data

array

List of checkpoint objects

epoch

string

Checkpoint's epoch ID (BigInt for uint64)

sequenceNumber

string

Checkpoint sequence number (BigInt for uint64)

digest

string

Digest of the checkpoint

networkTotalTransactions

string

Total number of transactions committed since genesis, including those in this checkpoint

previousDigest

string

(Optional) Digest of the previous checkpoint

epochRollingGasCostSummary

object

Rolling gas cost summary for the current epoch until this checkpoint

computationCost

string

Total computation cost

storageCost

string

Total storage cost

storageRebate

string

Total storage rebate

nonRefundableStorageFee

string

Non-refundable storage fee

timestampMs

string

Timestamp of the checkpoint in milliseconds since the Unix epoch

transactions

array

List of transaction digests included in the checkpoint

transactionDigest

string

A single transaction digest

checkpointCommitments

array

Commitments to checkpoint state

validatorSignature

string

Validator signature in Base64 format

nextCursor

string

Cursor for the next page of results

hasNextPage

boolean

Indicates whether there is another page of results

Request

curl --location 'https://docs-demo.sui-mainnet.quiknode.pro/' \
--header 'Content-Type: application/json' \
--data '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getCheckpoints",
  "params": [
    "1004",
    4,
    false
  ]
}'

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getCheckpoints",
  "params": [
    "1004",
    4,
    false
  ]
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("https://docs-demo.sui-mainnet.quiknode.pro/", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

import requests
import json

url = "https://docs-demo.sui-mainnet.quiknode.pro/"

payload = json.dumps({
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getCheckpoints",
  "params": [
    "1004",
    4,
    False
  ]
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.sui-mainnet.quiknode.pro/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sui_getCheckpoints",
  "params": [
    "1004",
    4,
    false
  ]
})

response = https.request(request)
puts response.read_body

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free