Sui RPC - Quickstart
Sui RPC - Quickstart
Ce guide vous accompagne de zéro jusqu'à un transport gRPC-web Sui configuré avec ERPC.
1. Récupérez votre API key
Vous pouvez obtenir et vérifier votre API key sur le Dashboard Web ERPC : Dashboard Web ERPC
Vous utilisez déjà ERPC pour Solana, Ethereum ou Avalanche ? Vous pouvez utiliser la même RPC key.
2. Configurez le transport gRPC-web
Sui est servi en gRPC-web binaire (
application/grpc-web+proto), à raison d'un appel unaire par requête HTTP. Configurez un GrpcWebFetchTransport avec l'URL de base ERPC et votre API key comme 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>' },
})Passez ce transport au client de service unaire généré pour l'API gRPC Sui. Le client ajoute
/sui.rpc.v2.<Service>/<Method> à baseUrl, par exemple /sui.rpc.v2.LedgerService/GetServiceInfo. Comme le SDK ajoute le chemin à l'URL de base, l'API key se place dans l'en-tête Authorization plutôt que dans le paramètre d'URL api-key.Seuls les appels unaires en gRPC-web binaire sont pris en charge. Les requêtes JSON-RPC, le gRPC natif, le gRPC-web au format texte et le streaming ne le sont pas.
Prochaines étapes
- Endpoints, mesure d'utilisation et codes de statut : Documentation de l'endpoint RPC Sui
- Documentation officielle Sui : https://docs.sui.io/references/sui-api