> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sui gRPC endpoint

> The Chainstack Sui endpoint serves JSON-RPC and gRPC on the same node, with deep checkpoint retention and x-token authentication. Migrate off Sui's public JSON-RPC without switching providers.

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](/docs/sui-migrate-json-rpc-to-grpc) — 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](/docs/manage-your-node#view-node-access-and-credentials). Copy the full HTTPS endpoint (shown below as `YOUR_CHAINSTACK_ENDPOINT`) — it already carries your auth token.

| Interface        | Endpoint                              | Authentication                                    |
| ---------------- | ------------------------------------- | ------------------------------------------------- |
| JSON-RPC (HTTPS) | `YOUR_CHAINSTACK_ENDPOINT`            | auth token or basic auth, built into the endpoint |
| gRPC             | `sui-mainnet.core.chainstack.com:443` | `x-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](/docs/authentication-methods-for-different-scenarios).

## 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`):

```bash theme={"system"}
grpcurl -H "x-token: YOUR_X_TOKEN" \
  sui-mainnet.core.chainstack.com:443 \
  sui.rpc.v2.LedgerService/GetServiceInfo
```

```json theme={"system"}
{
  "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

<CodeGroup>
  ```bash JSON-RPC theme={"system"}
  curl --request POST \
    --url YOUR_CHAINSTACK_ENDPOINT \
    --header 'Content-Type: application/json' \
    --data '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "sui_getLatestCheckpointSequenceNumber",
      "params": []
    }'
  ```

  ```bash gRPC theme={"system"}
  grpcurl -H "x-token: YOUR_X_TOKEN" \
    sui-mainnet.core.chainstack.com:443 \
    list
  ```
</CodeGroup>

The `list` output shows the node's `sui.rpc.v2` services — [Sui tooling](/docs/sui-tooling#grpc-api) describes what each one is for.

<Info>
  The official Sui TypeScript SDK (`@mysten/sui`) works here over a native gRPC transport — see [the setup in Sui tooling](/docs/sui-tooling#grpc-from-code). 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.
</Info>

## Next steps

* [Migrate Sui from JSON-RPC to gRPC](/docs/sui-migrate-json-rpc-to-grpc) — call-by-call method mapping and quickstart.
* [Sui tooling](/docs/sui-tooling) — SDKs and per-language connection code.