ERPC Sui RPC 快速開始

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>' },
})
將此 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 以及串流。

後續步驟