Sui RPC - Guida rapida
Sui RPC - Guida rapida
Questa guida ti accompagna da zero a un trasporto gRPC-web per Sui configurato con ERPC.
1. Ottieni la tua chiave API
Puoi ottenere e verificare la tua chiave API sulla ERPC Web Dashboard: ERPC Web Dashboard
Usi già ERPC per Solana, Ethereum o Avalanche? Puoi usare la stessa chiave RPC.
2. Configura il trasporto gRPC-web
Sui è servito tramite gRPC-web binario (
application/grpc-web+proto), con una chiamata unaria per richiesta HTTP. Configura un GrpcWebFetchTransport con l'URL di base di ERPC e la tua chiave API come 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>' },
})Passa questo trasporto al client di servizio unario generato per l'API gRPC di Sui. Il client aggiunge
/sui.rpc.v2.<Service>/<Method> a baseUrl, ad esempio /sui.rpc.v2.LedgerService/GetServiceInfo. Poiché l'SDK aggiunge il percorso all'URL di base, la chiave API va nell'header Authorization invece che nel parametro di query api-key.Sono supportate solo chiamate unarie su gRPC-web binario. Richieste JSON-RPC, gRPC nativo, gRPC-web in formato testo e streaming non sono supportati.
Prossimi passi
- Endpoint, utilizzo dei token e codici di stato: Documentazione dell'endpoint RPC di Sui
- Documentazione ufficiale di Sui: https://docs.sui.io/references/sui-api