Sui RPC - Quickstart
Sui RPC - Quickstart
Esta guía te lleva de cero a un transporte gRPC-web de Sui configurado con ERPC.
1. Obtén tu API key
Puedes obtener y comprobar tu API key en ERPC Web Dashboard: ERPC Web Dashboard
¿Ya usas ERPC para Solana, Ethereum o Avalanche? Puedes usar la misma RPC key.
2. Configura el transporte gRPC-web
Sui se sirve sobre gRPC-web binario (
application/grpc-web+proto), con una llamada unaria por solicitud HTTP. Configura un GrpcWebFetchTransport con la URL base de ERPC y tu API key como Bearer token: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 este transporte al cliente de servicio unario generado para la API gRPC de Sui. El cliente añade
/sui.rpc.v2.<Service>/<Method> a baseUrl, por ejemplo /sui.rpc.v2.LedgerService/GetServiceInfo. Como el SDK añade la ruta a la URL base, la API key va en el header Authorization en lugar de en el parámetro de consulta api-key.Solo se admiten llamadas unarias sobre gRPC-web binario. No se admiten solicitudes JSON-RPC, gRPC nativo, gRPC-web en formato de texto ni streaming.
Próximos pasos
- Endpoints, medición de uso y códigos de estado: Documentación del endpoint RPC de Sui
- Documentación oficial de Sui: https://docs.sui.io/references/sui-api