Sui Testnet RPC y gRPC: endpoint, faucet y configuración para desarrolladores

Acceso gRPC-first en Sui Testnet y JSON-RPC heredado

El acceso a la testnet de Sui en OnFinality prioriza gRPC. La ruta de integración actual utiliza los servicios protobuf de Sui: LedgerService, StateService, TransactionExecutionService y SubscriptionService. Cubren consultas de checkpoints, lecturas de objetos y saldos, simulación y ejecución de transacciones, y suscripciones de streaming para checkpoints, transacciones y eventos.

El JSON-RPC heredado de Full Node todavía está presente en algunas herramientas existentes, pero debe tratarse como una superficie de migración. No construyas nuevos flujos de trabajo de testnet en torno a JSON-RPC; en su lugar, mapea los métodos heredados al flujo de trabajo gRPC equivalente antes de confirmar código de testnet.

• Usa LedgerService, StateService, TransactionExecutionService y SubscriptionService para nuevas integraciones en Sui Testnet.
• Trata el JSON-RPC de Full Node como heredado y solo para migración, no como la ruta principal de implementación.
• Mapea las llamadas JSON-RPC existentes a métodos gRPC antes de ampliar el código de testnet.

Configuración de endpoint y credenciales de testnet

OnFinality proporciona un endpoint gRPC gestionado para Sui Testnet. Recibirás una URL de endpoint y un token de API o credencial equivalente. Guárdalos en variables de entorno o en un gestor de secretos. No incrustes credenciales en repositorios.

El siguiente ejemplo de grpcurl utiliza marcadores de posición. Sustituye GRPC_ENDPOINT y ONFINALITY_API_TOKEN por los valores asignados. El comando list es una ayuda de reflexión de grpcurl; después de importar las definiciones protobuf de Sui, llama al método relevante de LedgerService, StateService, TransactionExecutionService o SubscriptionService.

Uso seguro del faucet oficial de Sui

El faucet oficial de Sui Testnet está en https://faucet.sui.io. Verifica siempre la política actual del faucet, los límites por dirección y los periodos de espera antes de integrarlo en pruebas automatizadas. Solicita SUI de prueba a una dirección de billetera que controles y nunca solicites tokens para direcciones que no te pertenezcan.

El SUI de prueba no tiene valor y no puede intercambiarse por activos de mainnet. Si tienes tokens de prueba sin usar, devuélvelos a la dirección de devolución del faucet para mantener la testnet saludable. Mantén separado el uso del faucet de testnet y de mainnet.

• Usa únicamente https://faucet.sui.io para el SUI de prueba oficial.
• Verifica los límites actuales del faucet y los periodos de espera antes de ejecutar CI.
• Mantén el SUI de prueba separado del SUI de mainnet; no uses direcciones de prueba para producción.
• Devuelve los tokens de prueba no utilizados cuando sea posible.

Despliegue de Move, lecturas de objetos y flujos de transacciones

Sui está centrado en objetos, por lo que tu flujo de trabajo en testnet debe enfocarse en lecturas de objetos, simulación de transacciones y ejecución. Usa StateService para consultar objetos y saldos antes de construir una transacción. Usa TransactionExecutionService para SimulateTransaction y así hacer una simulación en seco, y luego usa ExecuteTransaction para el envío final. Este patrón de dos pasos ayuda a detectar errores de tipos de Move, conflictos de versiones de objetos y problemas de estimación de gas sin avanzar el estado de la cadena.

Registra el digest de la transacción después de la ejecución y consulta los cambios de objetos resultantes para verificar las transiciones de estado.

• Consulta los objetos propios y saldos con StateService antes de construir una transacción.
• Llama a SimulateTransaction desde TransactionExecutionService para validar gas, versiones de objetos y lógica de Move.
• Usa ExecuteTransaction desde TransactionExecutionService para el envío final.
• Registra el digest de la transacción y consulta los cambios de objetos resultantes.

Checkpoints y suscripciones en tiempo real

Los checkpoints proporcionan un límite de cadena estable para indexar y sincronizar. Consulta los números de secuencia y los datos de los checkpoints a través de LedgerService. Para actualizaciones de streaming, usa SubscriptionService con SubscribeCheckpoints, SubscribeTransactions o SubscribeEvents.

Diseña tu cliente para manejar reconexiones y contrapresión. Los reinicios de testnet pueden interrumpir los streams, y los clientes de suscripción deben poder reestablecer las sesiones automáticamente.

• SubscribeCheckpoints para los límites de checkpoints.
• SubscribeTransactions para streaming a nivel de transacción.
• SubscribeEvents para filtrado de eventos y actualizaciones estructuradas.
• Maneja reconexiones y reinicios en los clientes de suscripción.

Configuración de billeteras, SDK y CI

Las billeteras y SDK deben apuntar al endpoint gRPC gestionado que se te asignó. En CI, inyecta el endpoint y la credencial mediante variables de entorno, y nunca subas secretos. Usa un job de stage o test que apunte a Sui Testnet con una cuenta solo de prueba. Mantén la configuración de mainnet en un perfil separado.

El siguiente ejemplo de entorno utiliza marcadores de posición para CI. Sustituye los valores por tus referencias de almacenamiento seguro.

Límites de testnet, reinicios y comprobaciones operativas

Sui Testnet no es permanente y puede reiniciarse. Los endpoints y los datos pueden ser eliminados o modificados. No trates los objetos de testnet, los digests de transacciones o los saldos del faucet como duraderos. Verifica la política actual del faucet antes de depender de ella. Supervisa tu uso de solicitudes, maneja con elegancia las respuestas de límite de tasa y mantén las credenciales de testnet aisladas de producción.

Ruta de migración a Sui mainnet

Después de que tu flujo de trabajo en Sui Testnet pase, planifica una implementación separada en mainnet. Usa el endpoint gRPC de mainnet y las credenciales de OnFinality; nunca reutilices tokens, direcciones o digests de objetos de testnet. Vuelve a ejecutar las mismas comprobaciones de simulación y ejecución con los costos de gas de mainnet.

Revisa las páginas de redes de Sui en /networks/sui-testnet y /networks/sui para obtener detalles actuales del endpoint y orientación del proveedor. Para los criterios de evaluación de proveedores, consulta /rpc-assistant/sui-rpc-providers.

Siguientes pasos: Guía de gRPC de Sui.

• Aprovisiona credenciales y endpoints separados para mainnet.
• Revalida los paquetes Move y los flujos de transacciones contra el estado de mainnet.
• Usa el mismo flujo de trabajo gRPC pero con límites y monitorización específicos de mainnet.
• No traslades suposiciones de testnet a producción.

Preguntas frecuentes