Sui RPC Endpoint mit ERPC - Dokumentation
Sui RPC Endpoint Dokumentation
Nutzen Sie ERPC als Ihren Sui RPC Endpoint für unäre gRPC-web-Anfragen. Sui RPC ist Teil der RPC APIs von ERPC innerhalb unserer Global Edge Blockchain Infrastructure, und der API key kann über das ERPC Web Dashboard verwaltet werden.
Sie können denselben RPC key wie bei Solana, Ethereum und Avalanche verwenden.
Senden Sie Ihren API key als
Authorization: Bearer <YOUR_API_KEY>. Das Sui SDK hängt den Service-Pfad an die Basis-URL an, daher gehört der Key in den Header und nicht in den Query-Parameter api-key.Endpoints
Verwenden Sie eine der beiden Basis-URLs als
baseUrl Ihres gRPC-web-Transports:text
https://edge.erpc.global/suihttps://edge.erpc.global/suitext
https://sui.erpc.globalhttps://sui.erpc.globalAnfragen sind binäre gRPC-web-POSTs (
application/grpc-web+proto) an /sui.rpc.v2.<Service>/<Method>, mit einem unkomprimierten Protobuf-Frame pro unärem Aufruf.Beispiele
Hier ist ein Beispiel für die Transport-Konfiguration.
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>' },
})Übergeben Sie den Transport an den unären Service-Client, der für die Sui gRPC API generiert wurde.
Sie können Ihren API key im ERPC Web Dashboard abrufen und prüfen: ERPC Web Dashboard
Batch-Anfragen
Bei Sui gibt es keine Batch-Anfragen. Jede HTTP-Anfrage enthält einen unären Aufruf und wird als ein Aufruf gemessen. Der Request-Body darf bis zu 1 MiB groß sein.
Token-Nutzung
Die Nutzung wird in Token gemessen, und der Token-Satz kann je nach Methode unterschiedlich sein. Jeder unäre Aufruf wird als ein Aufruf gemessen.
Limits des Free-Plans
Beim Free-Plan kann Ihr Konto eine Anfrage pro 10 Sekunden senden. Das Limit wird pro Konto gezählt, nicht pro Endpoint, sodass auch eine Anfrage an eine andere Chain darauf angerechnet werden kann. Eine Anfrage, die früher gesendet wird, wird mit HTTP
429 beantwortet, und der retry-after-Header gibt die Wartezeit in Sekunden an.Unterstützte Methoden
Der Endpoint bedient diese 19 unären gRPC-web-Methoden. Jede wird unter
/sui.rpc.v2.<Service>/<Method> aufgerufen, und die Groß- und Kleinschreibung muss exakt übereinstimmen.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
Ein nicht aufgeführter Pfad wird mit HTTP
400 beantwortet. Natives gRPC, gRPC-web im Textformat, Streaming und BatchGet*-Aufrufe werden nicht unterstützt.Antwort-Statuscodes
| HTTP-Status | Bedeutung |
|---|---|
| 200 | Erfolgreicher unärer Aufruf. Der Body ist application/grpc-web+proto. |
| 400 | Ein Pfad außerhalb der Liste der unterstützten Methoden, ein Body, der nicht aus genau einem unkomprimierten binären gRPC-web-Frame besteht, oder ein Body über 1 MiB. |
| 401 | Fehlender oder ungültiger API key, oder eine IP- oder Origin-Beschränkung des Keys ist nicht erfüllt. |
| 405 | Eine andere Request-Methode als POST. |
| 426 | Ein WebSocket-Upgrade wurde angefordert. Der Endpoint unterstützt nur HTTP. |
| 429 | Rate-limitiert, einschließlich des Free-Plan-Limits von einer Anfrage pro 10 Sekunden. Wenn ein retry-after-Header vorhanden ist, warten Sie so viele Sekunden, wie dort angegeben. |
| 502 | Der Upstream-Aufruf konnte nicht abgeschlossen werden: eine fehlgeschlagene Upstream-Antwort, eine Antwort über 8 MiB, keine Antwort innerhalb von 30 Sekunden oder ein grpc-status ungleich 0. |
| 503 | Der Dienst ist vorübergehend nicht verfügbar. |
Sui RPC Methoden und Dokumentation
Die vollständige Liste der Standardmethoden, Parameter und Spezifikationen finden Sie in der offiziellen Dokumentation.