gRPC API
Sui nodes on Chainstack support gRPC for high-performance access. gRPC uses HTTP/2 and Protocol Buffers for binary serialization, which makes payloads smaller and adds server-side streaming — ideal for indexers, backends, and low-latency lookups. gRPC is the forward path as Sui deprecates JSON-RPC.Endpoint and authentication
Your Sui gRPC endpoint issui-mainnet.core.chainstack.com:443 (testnet: sui-testnet.core.chainstack.com:443), with TLS. Authenticate by passing your token in the x-token metadata header on every call. To find your endpoint and token on Chainstack, see View node access and credentials.
Explore with grpcurl
Sui gRPC has server reflection enabled, so grpcurl can list services and call methods without compiling proto files:sui.rpc.v2 services:
gRPC from code
In TypeScript, use the official@mysten/sui SDK with a native gRPC transport (its default transport is gRPC-Web, which Chainstack does not serve). From other languages, generate typed stubs from Sui’s proto definitions. Either way, attach the x-token metadata to every call, and use recent client versions — @mysten/sui 2.16+ and @grpc/grpc-js 1.14+ — since older releases produce intermittent gRPC errors under load.
The native gRPC transport above works only in Node.js and other server runtimes. The SDK’s browser transport is gRPC-Web, which Chainstack does not serve yet (HTTP 415) — from the browser, use JSON-RPC or proxy gRPC through your backend.
JSON-RPC API
Interact with your Sui node using the Sui JSON-RPC API. Chainstack’s JSON-RPC endpoints keep working after Sui’s public endpoints shut down, so this is a valid path while you migrate to gRPC. Use your Chainstack Sui RPC endpoint to make API calls. Example to get the latest checkpoint:Sui TypeScript SDK
The Sui TypeScript SDK is the official SDK for building Sui applications.Installation
Basic usage
Sui Rust SDK
The Sui Rust SDK provides comprehensive Rust bindings for Sui.Installation
Add to yourCargo.toml: