Sui RPC 快速开始 - ERPC
Sui RPC 快速开始
本指南将带您从零开始，使用 ERPC 配置好 Sui gRPC-web transport。
1. 获取 API key
您可以在 ERPC Web Dashboard 获取和查看 API key。
已经在 Solana、Ethereum 或 Avalanche 上使用 ERPC 了吗？您可以直接使用相同的 RPC key。
2. 配置 gRPC-web Transport
Sui 通过二进制 gRPC-web（
application/grpc-web+proto）提供服务，每个 HTTP 请求承载一次 unary 调用。使用 ERPC 的 base URL 配置 GrpcWebFetchTransport，并将 API key 作为 Bearer token 传入：typescript
import { GrpcWebFetchTransport } from '@protobuf-ts/grpcweb-transport'
const transport = new GrpcWebFetchTransport({
baseUrl: 'https://sui.erpc.global', // or https://edge.erpc.global/sui
format: 'binary',
meta: { Authorization: 'Bearer <YOUR_API_KEY>' },
})import { GrpcWebFetchTransport } from '@protobuf-ts/grpcweb-transport'
const transport = new GrpcWebFetchTransport({
baseUrl: 'https://sui.erpc.global', // or https://edge.erpc.global/sui
format: 'binary',
meta: { Authorization: 'Bearer <YOUR_API_KEY>' },
})将此 transport 传给为 Sui gRPC API 生成的 unary 服务客户端。客户端会在
baseUrl 后追加 /sui.rpc.v2.<Service>/<Method>，例如 /sui.rpc.v2.LedgerService/GetServiceInfo。由于 SDK 会在 base URL 后追加路径，API key 需放在 Authorization 请求头中，而不是 api-key 查询参数中。仅支持通过二进制 gRPC-web 进行的 unary 调用。不支持 JSON-RPC 请求、原生 gRPC、文本格式的 gRPC-web 以及流式传输。
后续步骤
- 端点、计量与状态码：Sui RPC 端点文档
- 官方 Sui 文档：https://docs.sui.io/references/sui-api