Documentazione dell'endpoint RPC di Sui | ERPC
Documentazione dell'endpoint RPC di Sui
Usa ERPC come tuo endpoint RPC di Sui per richieste gRPC-web unarie. Sui RPC fa parte delle RPC APIs di ERPC all'interno della nostra Global Edge Blockchain Infrastructure, e la chiave API può essere gestita dalla ERPC Web Dashboard.
Puoi usare la stessa chiave RPC di Solana, Ethereum e Avalanche.
Invia la tua chiave API come
Authorization: Bearer <YOUR_API_KEY>. L'SDK di Sui aggiunge il percorso del servizio all'URL di base, quindi la chiave va nell'header e non nel parametro di query api-key.Endpoint
Usa uno dei due URL di base come
baseUrl del tuo trasporto gRPC-web:text
https://edge.erpc.global/suihttps://edge.erpc.global/suitext
https://sui.erpc.globalhttps://sui.erpc.globalLe richieste sono POST gRPC-web binari (
application/grpc-web+proto) verso /sui.rpc.v2.<Service>/<Method>, con un frame protobuf non compresso per ogni chiamata unaria.Esempi
Ecco un esempio di configurazione del trasporto.
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 il trasporto al client di servizio unario generato per l'API gRPC di Sui.
Puoi ottenere e verificare la tua chiave API sulla ERPC Web Dashboard: ERPC Web Dashboard
Richieste in batch
Sui non supporta richieste in batch. Ogni richiesta HTTP contiene una chiamata unaria e viene misurata come una chiamata. Il corpo della richiesta può arrivare a 1 MiB.
Utilizzo dei token
L'utilizzo viene misurato in token, e la tariffa in token può variare in base al metodo. Ogni chiamata unaria viene misurata come una chiamata.
Limiti del piano Free
Con il piano Free, il tuo account può inviare una richiesta ogni 10 secondi. Il limite viene conteggiato per account, non per endpoint, quindi anche una richiesta a un'altra chain può rientrare nel conteggio. Una richiesta inviata prima riceve una risposta HTTP
429, e l'header retry-after indica l'attesa in secondi.Metodi supportati
L'endpoint serve questi 19 metodi gRPC-web unari. Ciascuno viene chiamato su
/sui.rpc.v2.<Service>/<Method>, e maiuscole e minuscole devono corrispondere esattamente.LedgerService(5):GetServiceInfo,GetCheckpoint,GetObject,GetTransaction,GetEpochMovePackageService(4):GetPackage,GetDatatype,GetFunction,ListPackageVersionsNameService(2):LookupName,ReverseLookupNameSignatureVerificationService(1):VerifySignatureStateService(5):GetCoinInfo,GetBalance,ListBalances,ListDynamicFields,ListOwnedObjectsTransactionExecutionService(2):ExecuteTransaction,SimulateTransaction
Un percorso non elencato riceve una risposta HTTP
400. Il gRPC nativo, il gRPC-web in formato testo, lo streaming e le chiamate BatchGet* non sono supportati.Codici di stato della risposta
| Stato HTTP | Significato |
|---|---|
| 200 | Chiamata unaria riuscita. Il corpo è application/grpc-web+proto. |
| 400 | Un percorso al di fuori dell'elenco dei metodi supportati, un corpo che non è un singolo frame gRPC-web binario non compresso, o un corpo superiore a 1 MiB. |
| 401 | Chiave API mancante o non valida, oppure non è soddisfatta una restrizione di IP o di Origin impostata sulla chiave. |
| 405 | Un metodo di richiesta diverso da POST. |
| 426 | È stato richiesto un WebSocket Upgrade. L'endpoint supporta solo HTTP. |
| 429 | Rate limitato, compreso il limite del piano Free di una richiesta ogni 10 secondi. Se è presente un header retry-after, attendi il numero di secondi indicato. |
| 502 | La chiamata upstream non è stata completata: una risposta upstream non riuscita, una risposta superiore a 8 MiB, nessuna risposta entro 30 secondi, o un grpc-status diverso da 0. |
| 503 | Il servizio è temporaneamente non disponibile. |
Metodi RPC di Sui e documentazione
Per l'elenco completo dei metodi standard, dei parametri e delle specifiche, consulta la documentazione ufficiale.