Skip to main content
The Chainstack Sui endpoint serves gRPC, the interface that replaces JSON-RPC, which Sui removes from the full node in v1.82 — see Migrate Sui from JSON-RPC to gRPC and GraphQL. Sui Mainnet Global Nodes also serve GraphQL for filtered queries on the same endpoint — see Sui GraphQL endpoint.

​
What you get

  • One endpoint — native gRPC over HTTP/2 and gRPC-Web over HTTPS, plus GraphQL on Mainnet.
  • 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, basic auth, or x-token on GraphQL.

​
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. 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

The Chainstack Sui node holds a window of checkpoints from lowestAvailableCheckpoint to the tip, not the full ledger from genesis. GetServiceInfo reports both ends of the window — the tip (checkpointHeight) and the oldest checkpoint the node holds (lowestAvailableCheckpoint):
In this response from Sep 27, 2026, the node held checkpoints 237,661,232 through 327,352,270 — about 89.7M checkpoints. lowestAvailableCheckpointObjects is the matching floor for historical object versions. The floor can change, so read lowestAvailableCheckpoint at runtime instead of hard-coding it. How the window applies to each interface:
  • gRPC — checkpoints, transactions, and object versions older than the window return NotFound.
  • GraphQL — point lookups share this floor, and filtered transaction and event queries keep a shorter window. serviceConfig.availableRange reports each window — see How far back GraphQL history goes.
For data older than the window, query an archival service — see Sui’s Archival Store and Service.

​
Verify your endpoint

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 both its default gRPC-Web transport and a native gRPC transport — see the setup in Sui tooling. gRPC-Web is served over HTTPS on Mainnet and Testnet, so browser apps can use the SDK directly, no proxy required.

​
Next steps

Last modified on October 20, 2026