Skip to main content
The Chainstack Sui endpoint serves both JSON-RPC and gRPC on the same node, so you can migrate off Sui Foundation’s public JSON-RPC — shutting down Jul 31, 2026 — without re-syncing or switching providers. Keep calling JSON-RPC while you port your code, then move each call to gRPC on the same endpoint.

​
What you get

  • One node, both interfaces — JSON-RPC over HTTPS and native gRPC over HTTP/2, from a single Chainstack Sui node.
  • Deep checkpoint retention — tens of millions of checkpoints of history for point lookups and backfills.
  • Server reflection enabled on gRPC — explore services and call methods with grpcurl, no proto compilation needed.
  • x-token authentication on gRPC; auth token or basic auth on JSON-RPC.

​
Endpoints

Find your endpoint and credentials on Chainstack — see View node access and credentials. Copy the full HTTPS endpoint (shown below as YOUR_CHAINSTACK_ENDPOINT) — it already carries your auth token.
InterfaceEndpointAuthentication
JSON-RPC (HTTPS)YOUR_CHAINSTACK_ENDPOINTauth token or basic auth, built into the endpoint
gRPCsui-mainnet.core.chainstack.com:443x-token metadata header
Testnet gRPC is sui-testnet.core.chainstack.com:443. The auth token and x-token are the node’s access credentials, not your Chainstack platform API key. For every authentication option, see Authentication methods available on Chainstack.

​
Checkpoint retention

A Sui full node serves a moving window of recent checkpoints rather than the full ledger from genesis. Query the current window with GetServiceInfo, which reports the tip (checkpointHeight) and the oldest checkpoint the node still holds (lowestAvailableCheckpoint): 
grpcurl -H "x-token: YOUR_X_TOKEN" \
  sui-mainnet.core.chainstack.com:443 \
  sui.rpc.v2.LedgerService/GetServiceInfo

{
  "chain": "mainnet",
  "epoch": "1184",
  "checkpointHeight": "296723264",
  "lowestAvailableCheckpoint": "253124671",
  "server": "sui-node/1.74.1-8fc60f1fa966"
}
In this snapshot from Jul 10, 2026, the node served checkpoints from 253,124,671 to 296,723,264 — about 43.6M checkpoints of history. The window advances as the chain grows; check lowestAvailableCheckpoint at runtime for the current floor. For reads older than the window, query an archival store.

​
Verify your endpoint

curl --request POST \
  --url YOUR_CHAINSTACK_ENDPOINT \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sui_getLatestCheckpointSequenceNumber",
    "params": []
  }'

grpcurl -H "x-token: YOUR_X_TOKEN" \
  sui-mainnet.core.chainstack.com:443 \
  list
The list output shows the node’s sui.rpc.v2 services — Sui tooling describes what each one is for.
The official Sui TypeScript SDK (@mysten/sui) works here over a native gRPC transport — see the setup in Sui tooling. Its default gRPC-Web transport is not supported on Chainstack yet (HTTP 415), so browser apps should use JSON-RPC or proxy gRPC through a backend.

​
Next steps

Last modified on July 13, 2026