Sui RPC endpoint documentatie | ERPC
Sui RPC endpoint documentatie
Gebruik ERPC als uw Sui RPC endpoint voor unaire gRPC-web-verzoeken. Sui RPC maakt deel uit van de RPC APIs van ERPC binnen onze Global Edge Blockchain Infrastructure, en de API key kan worden beheerd via het ERPC Web Dashboard.
U kunt dezelfde RPC key als Solana, Ethereum en Avalanche gebruiken.
Stuur uw API key mee als
Authorization: Bearer <YOUR_API_KEY>. De Sui SDK voegt het servicepad toe aan de basis-URL, dus de key hoort in de header en niet in de queryparameter api-key.Endpoints
Gebruik een van beide basis-URL's als
baseUrl van uw gRPC-web-transport:text
https://edge.erpc.global/suihttps://edge.erpc.global/suitext
https://sui.erpc.globalhttps://sui.erpc.globalVerzoeken worden als binaire gRPC-web-POST (
application/grpc-web+proto) naar /sui.rpc.v2.<Service>/<Method> verstuurd, met één ongecomprimeerd protobuf-frame per unaire aanroep.Voorbeelden
Hier is een voorbeeld van een transportconfiguratie.
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>' },
})Geef het transport door aan de unaire serviceclient die voor de Sui gRPC API is gegenereerd.
U kunt uw API key verkrijgen en controleren in het ERPC Web Dashboard: ERPC Web Dashboard
Batch-verzoeken
Sui kent geen batch-verzoeken. Elk HTTP-verzoek bevat één unaire aanroep en wordt gemeten als één aanroep. De request body mag maximaal 1 MiB groot zijn.
Tokengebruik
Het gebruik wordt gemeten in tokens, en het tokentarief kan per methode verschillen. Elke unaire aanroep wordt gemeten als één aanroep.
Limieten van het Free-abonnement
Bij het Free-abonnement kan uw account één verzoek per 10 seconden versturen. De limiet wordt per account geteld, niet per endpoint, dus een verzoek naar een andere chain kan ook meetellen. Een verzoek dat sneller wordt verstuurd, wordt beantwoord met HTTP
429, en de retry-after-header geeft de wachttijd in seconden aan.Ondersteunde methodes
Het endpoint bedient deze 19 unaire gRPC-web-methodes. Elke methode wordt aangeroepen op
/sui.rpc.v2.<Service>/<Method>, en hoofdletters en kleine letters moeten exact overeenkomen.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
Een pad dat niet in de lijst staat, wordt beantwoord met HTTP
400. Native gRPC, gRPC-web in tekstformaat, streaming en BatchGet*-aanroepen worden niet ondersteund.Antwoordstatuscodes
| HTTP-status | Betekenis |
|---|---|
| 200 | Geslaagde unaire aanroep. De body is application/grpc-web+proto. |
| 400 | Een pad buiten de lijst met ondersteunde methodes, een body die niet uit precies één ongecomprimeerd binair gRPC-web-frame bestaat, of een body groter dan 1 MiB. |
| 401 | Ontbrekende of ongeldige API key, of er wordt niet voldaan aan een IP- of Origin-beperking op de key. |
| 405 | Een andere requestmethode dan POST. |
| 426 | Er is een WebSocket Upgrade aangevraagd. Het endpoint ondersteunt alleen HTTP. |
| 429 | Rate-limited, inclusief de limiet van het Free-abonnement van één verzoek per 10 seconden. Als er een retry-after-header aanwezig is, wacht dan het aangegeven aantal seconden. |
| 502 | De upstream-aanroep kon niet worden voltooid: een mislukte upstream-respons, een respons groter dan 8 MiB, geen antwoord binnen 30 seconden, of een grpc-status anders dan 0. |
| 503 | De service is tijdelijk niet beschikbaar. |
Sui RPC-methoden en documentatie
Voor de volledige lijst van standaardmethoden, parameters en specificaties verwijzen wij u naar de officiële documentatie.