ERPC Sui RPC クイックスタート

Sui RPC クイックスタート

このガイドでは、ゼロの状態から ERPC で Sui の gRPC-web トランスポートを設定するまでの手順を解説します。

1. API key を取得する

API key は ERPC Web Dashboard 上にて取得、確認いただけます: ERPC Web Dashboard
すでに ERPC を Solana、Ethereum、Avalanche のいずれかで利用中ですか?同じ RPC キーを利用できます。

2. gRPC-web トランスポートを設定する

Sui はバイナリ gRPC-web(application/grpc-web+proto)で提供され、HTTP リクエスト 1 回につき unary 呼び出しは 1 件です。ERPC のベース URL を指定し、API key を Bearer トークンとして渡して GrpcWebFetchTransport を設定します。
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>' },
})
このトランスポートを、Sui gRPC API 用に生成した unary サービスクライアントに渡します。クライアントは baseUrl の後ろに /sui.rpc.v2.<Service>/<Method>(例: /sui.rpc.v2.LedgerService/GetServiceInfo)を付け足します。SDK がベース URL にパスを付け足すため、API key は api-key クエリパラメータではなく Authorization ヘッダーで渡します。
対応しているのは、バイナリ gRPC-web による unary 呼び出しだけです。JSON-RPC リクエスト、ネイティブ gRPC、テキスト形式の gRPC-web、ストリーミングには対応していません。

次のステップ