Sui RPC endpoint avec ERPC | Documentation
Documentation de l'endpoint RPC Sui
Utilisez ERPC comme votre endpoint RPC Sui pour vos requêtes gRPC-web unaires. Sui RPC fait partie des RPC APIs d'ERPC au sein de notre Global Edge Blockchain Infrastructure, et l'API key se gère depuis le Dashboard Web ERPC.
Vous pouvez utiliser la même RPC key que Solana, Ethereum et Avalanche.
Envoyez votre API key sous la forme
Authorization: Bearer <YOUR_API_KEY>. Le SDK Sui ajoute le chemin du service à l'URL de base : la clé se place donc dans l'en-tête plutôt que dans le paramètre d'URL api-key.Endpoints
Utilisez l'une ou l'autre URL de base comme
baseUrl de votre transport gRPC-web :text
https://edge.erpc.global/suihttps://edge.erpc.global/suitext
https://sui.erpc.globalhttps://sui.erpc.globalLes requêtes sont des POST gRPC-web binaires (
application/grpc-web+proto) vers /sui.rpc.v2.<Service>/<Method>, avec une trame protobuf non compressée par appel unaire.Exemples
Voici un exemple de configuration du transport.
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 le transport au client de service unaire généré pour l'API gRPC Sui.
Vous pouvez obtenir et vérifier votre API key sur le Dashboard Web ERPC : Dashboard Web ERPC
Requêtes en batch
Sui ne prend pas en charge les requêtes en batch. Chaque requête HTTP transporte un appel unaire et est mesurée comme un appel. Le corps de la requête peut atteindre 1 MiB.
Utilisation des tokens
L'utilisation est mesurée en tokens, et le tarif en tokens peut varier selon la méthode. Chaque appel unaire est mesuré comme un appel.
Limites du forfait Free
Avec le forfait Free, votre compte peut envoyer une requête toutes les 10 secondes. La limite est comptée par compte et non par endpoint, si bien qu'une requête vers une autre chaîne peut aussi y compter. Une requête envoyée plus tôt reçoit une réponse HTTP
429, et l'en-tête retry-after indique l'attente en secondes.Méthodes prises en charge
L'endpoint dessert ces 19 méthodes gRPC-web unaires. Chacune s'appelle sur
/sui.rpc.v2.<Service>/<Method>, et la casse doit correspondre exactement.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 chemin non listé reçoit une réponse HTTP
400. Le gRPC natif, le gRPC-web au format texte, le streaming et les appels BatchGet* ne sont pas pris en charge.Codes de statut de réponse
| Statut HTTP | Signification |
|---|---|
| 200 | Appel unaire réussi. Le corps est au format application/grpc-web+proto. |
| 400 | Un chemin hors de la liste des méthodes prises en charge, un corps qui n'est pas une trame gRPC-web binaire unique et non compressée, ou un corps de plus de 1 MiB. |
| 401 | API key manquante ou invalide, ou une restriction d'IP ou d'Origin définie sur la clé n'est pas respectée. |
| 405 | Une méthode de requête autre que POST. |
| 426 | Un WebSocket Upgrade a été demandé. L'endpoint ne prend en charge que HTTP. |
| 429 | Limité par le débit, y compris par la limite du forfait Free d'une requête toutes les 10 secondes. Si un en-tête retry-after est présent, attendez le nombre de secondes indiqué. |
| 502 | L'appel en amont n'a pas pu être complété : réponse en amont en échec, réponse de plus de 8 MiB, aucune réponse dans les 30 secondes, ou grpc-status différent de 0. |
| 503 | Le service est temporairement indisponible. |
Méthodes Sui RPC et documentation
Pour la liste complète des méthodes standard, des paramètres et des spécifications, veuillez consulter la documentation officielle.