Documentación del endpoint RPC de Sui | ERPC
Documentación del endpoint RPC de Sui
Usa ERPC como tu endpoint RPC de Sui para solicitudes gRPC-web unarias. Sui RPC forma parte de las RPC APIs de ERPC dentro de nuestra Global Edge Blockchain Infrastructure, y la API key se puede gestionar desde ERPC Web Dashboard.
Puedes usar la misma RPC key que Solana, Ethereum y Avalanche.
Envía tu API key como
Authorization: Bearer <YOUR_API_KEY>. El SDK de Sui añade la ruta del servicio a la URL base, por lo que la key va en el header y no en el parámetro de consulta api-key.Endpoints
Usa cualquiera de las dos URL base como
baseUrl de tu transporte gRPC-web:text
https://edge.erpc.global/suihttps://edge.erpc.global/suitext
https://sui.erpc.globalhttps://sui.erpc.globalLas solicitudes son POST de gRPC-web binario (
application/grpc-web+proto) a /sui.rpc.v2.<Service>/<Method>, con un frame protobuf sin comprimir por llamada unaria.Ejemplos
Este es un ejemplo de configuración del transporte.
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>' },
})Pasa el transporte al cliente de servicio unario generado para la API gRPC de Sui.
Puedes obtener y comprobar tu API key en ERPC Web Dashboard: ERPC Web Dashboard
Solicitudes por lotes
Sui no admite solicitudes por lotes. Cada solicitud HTTP lleva una llamada unaria y se mide como una llamada. El cuerpo de la solicitud puede ocupar hasta 1 MiB.
Uso de tokens
El uso se mide en tokens, y la tarifa de tokens puede variar según el método. Cada llamada unaria se mide como una llamada.
Límites del Plan Free
En el Plan Free, tu cuenta puede enviar una solicitud cada 10 segundos. El límite se contabiliza por cuenta, no por endpoint, así que una solicitud a otra chain también puede contar para él. Una solicitud enviada antes se responde con HTTP
429, y el header retry-after indica la espera en segundos.Métodos compatibles
El endpoint sirve estos 19 métodos gRPC-web unarios. Cada uno se llama en
/sui.rpc.v2.<Service>/<Method>, y las mayúsculas y minúsculas deben coincidir exactamente.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
Una ruta que no figure en la lista se responde con HTTP
400. No se admiten gRPC nativo, gRPC-web en formato de texto, streaming ni las llamadas BatchGet*.Códigos de estado de respuesta
| Estado HTTP | Significado |
|---|---|
| 200 | Llamada unaria correcta. El cuerpo es application/grpc-web+proto. |
| 400 | Una ruta fuera de la lista de métodos compatibles, un cuerpo que no sea un único frame gRPC-web binario sin comprimir, o un cuerpo de más de 1 MiB. |
| 401 | API key ausente o inválida, o no se cumple una restricción de IP u Origin configurada en la key. |
| 405 | Un método de solicitud distinto de POST. |
| 426 | Se solicitó un WebSocket Upgrade. El endpoint solo admite HTTP. |
| 429 | Limitado por tasa, incluido el límite del Plan Free de una solicitud cada 10 segundos. Si hay un header retry-after, espera el número de segundos indicado. |
| 502 | No se pudo completar la llamada upstream: una respuesta upstream fallida, una respuesta de más de 8 MiB, ninguna respuesta en 30 segundos, o un grpc-status distinto de 0. |
| 503 | El servicio no está disponible temporalmente. |
Métodos y documentación de Sui RPC
Para la lista completa de métodos estándar, parámetros y especificaciones, consulta la documentación oficial.