gRPC
gRPC offers a high-performance, efficient communication protocol that uses Protocol Buffers for fast, compact data serialization. Its strongly typed interfaces reduce runtime errors and simplify client and server development across multiple languages.
The Sui Full Node gRPC API provides a fast, type-safe, and efficient interface for interacting with the Sui blockchain.
When should I use gRPC?
Use gRPC for:
- Backend systems, indexers, and typed clients.
- Low-latency point lookups.
- Transaction submission and simulation.
- Filtered queries over checkpoints, transactions, and events.
- Streaming subscriptions with server-side filtering.
When should I use something else?
For frontends, tools, dynamic-language clients, and queries that join multiple resource types, consider GraphQL RPC.
Full node gRPC is limited by the node's retention; query an Archival Service endpoint directly when you need higher-retention point lookups.
What is gRPC?
Learn what gRPC is, how it compares to GraphQL RPC, when to use it for streaming and high-throughput access to Sui data, and the JSON-RPC deprecation timeline.
Querying Data with gRPC
Learn how to query the Sui network using gRPC clients with grpcurl, Buf CLI, TypeScript, Go, and Python, including how to use field masks to control response fields.
gRPC Migration Cookbook
Side-by-side JSON-RPC to gRPC migration examples for event queries, checkpoint streaming, batch lookups, and common data-access patterns.