¿Qué es la red RPC de Sui y qué endpoint deberías usar?

Lista de verificación para decidir sobre RPC de Sui

Antes de conectar una aplicación a la red RPC de Sui, revisa esta lista:

• Confirma si necesitas Mainnet, Testnet o Devnet. La red determina el endpoint, el estado que puedes leer y las transacciones que puedes enviar.
• Verifica qué estilo de API soporta el endpoint: JSON-RPC, GraphQL o gRPC. Sui se está alejando de JSON-RPC, por lo que las nuevas integraciones deben verificar el acceso a largo plazo.
• Revisa los límites de solicitudes y la política de uso justo. Los nodos completos públicos de Sui tienen límites de velocidad y no están destinados al tráfico de producción.
• Pregunta sobre el soporte de WebSocket si necesitas suscribirte a transacciones, checkpoints o eventos Move.
• Decide si necesitas datos históricos más allá de los checkpoints recientes, lo que puede afectar los requisitos de archivo.
• Planifica la redundancia. Eventos de alto tráfico como los mints de NFT pueden abrumar a un solo proveedor.
• Prueba los métodos RPC exactos y los formatos de payload que tu aplicación llamará antes del lanzamiento, e incluye endpoints de respaldo en la configuración de tu cliente.

¿Qué es la red RPC de Sui?

Sui es una blockchain de capa 1 con un modelo de datos centrado en objetos y ejecución paralela de transacciones. La red RPC de Sui es el conjunto de endpoints que los nodos completos exponen para que billeteras, exploradores, indexadores, juegos y servicios backend puedan interactuar con la red. A través de un endpoint RPC, una aplicación puede leer saldos, consultar objetos y transacciones, hacer dry-run de llamadas Move y enviar bloques de transacciones para su ejecución.

A diferencia de las redes EVM, Sui no expone un número de bloque canónico único de la misma manera. La red avanza a través de checkpoints, y la mayoría de los clientes hacen referencia a los números de secuencia de checkpoint o límites de época al rastrear el estado. Esta diferencia importa cuando construyes un indexador o cuando intentas razonar sobre la finalidad. Una transacción se considera final una vez que el checkpoint que la incluye ha sido certificado por el conjunto de validadores.

Hay dos formas comunes de acceder a la red RPC de Sui:

• Usar nodos completos públicos oficiales mantenidos por Sui. Son convenientes para prototipos, pero tienen límites de velocidad y no son adecuados para aplicaciones de producción.
• Usar un proveedor de RPC administrado como OnFinality. Los endpoints alojados por proveedores suelen ofrecer mayor rendimiento, monitoreo, conmutación por error y opciones de nodos dedicados para equipos que necesitan capacidad aislada.

Para cargas de trabajo de producción, debes tratar el acceso RPC como infraestructura. Eso significa evaluar los límites de solicitudes, las características de tiempo de actividad, el soporte y la redundancia, en lugar de simplemente copiar una URL de endpoint en un archivo de configuración.

Conceptos básicos del endpoint RPC de Sui

Los endpoints públicos comunes de la red Sui son:

Los endpoints de los proveedores difieren. OnFinality publica los detalles actuales de RPC de Sui en la página de la red Sui. Si usas un servicio administrado, normalmente recibes una URL que está balanceada entre múltiples nodos completos y se puede usar con clientes JSON-RPC o GraphQL estándar.

Al configurar una red, usa HTTPS y el puerto predeterminado 443 en casi todos los casos. No agregues segmentos de ruta al endpoint a menos que el proveedor documente una ruta de enrutamiento específica. Sui no usa un ID de cadena EVM, por lo que las billeteras y aplicaciones identifican la red por el propio endpoint. Al agregar la red a una billetera, usa el nombre de red proporcionado por el proveedor, la URL RPC y el símbolo SUI.

Cómo hacer una solicitud RPC de Sui

Los endpoints RPC de Sui hablan JSON-RPC 2.0. Una solicitud básica tiene un nombre de método, parámetros opcionales y un id que puedes usar para hacer coincidir las respuestas al agrupar múltiples solicitudes.

El siguiente ejemplo de curl llama a suix_getLatestCheckpointSequenceNumber para obtener el número de secuencia de checkpoint actual:

curl -X POST "https://YOUR_SUI_RPC_URL" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"suix_getLatestCheckpointSequenceNumber","params":[],"id":1}'

Para leer un saldo, pasa la dirección del propietario como una cadena hexadecimal:

curl -X POST "https://YOUR_SUI_RPC_URL" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"suix_getBalance","params":["0xYOUR_ADDRESS"],"id":1}'

Si usas TypeScript, la misma solicitud se puede hacer con fetch:

const rpcUrl = "https://YOUR_SUI_RPC_URL";

const response = await fetch(rpcUrl, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "suix_getBalance",
    params: ["0xYOUR_ADDRESS"]
  })
});

const result = await response.json();
console.log(result.result);

Sui usa SuiJSON, un formato JSON restringido para argumentos Move. Los enteros grandes sin signo como u64 y u128 deben codificarse como cadenas, y los valores de matriz deben ser homogéneos. Si ves un error de coerción de tipos, verifica que tus números sean cadenas y que el formato de tu dirección sea correcto.

Métodos RPC comunes de Sui

La API JSON-RPC de Sui usa prefijos de método suix_ y sui_. Algunos métodos son ampliamente utilizados:

• suix_getLatestCheckpointSequenceNumber — obtener la altura actual del checkpoint.
• suix_getBalance — obtener el saldo de SUI o monedas para una dirección.
• suix_getObject — obtener datos de objeto por ID de objeto.
• suix_dryRunTransactionBlock — simular un bloque de transacciones antes de ejecutarlo.
• suix_executeTransactionBlock — enviar un bloque de transacciones firmado.
• suix_getTransactions — consultar bloques de transacciones por filtros.

Estos métodos son útiles para construir un cliente básico de Sui. Por ejemplo, antes de enviar una transacción, siempre debes llamar a suix_dryRunTransactionBlock para verificar que la función Move acepta tus entradas y que los efectos de la transacción son los esperados.

Debido a que la Fundación Sui ha deprecado JSON-RPC en los nodos completos de mainnet, verifica si el proveedor también soporta GraphQL o gRPC. Varios proveedores de RPC, incluido OnFinality, están agregando o ya exponen métodos alternativos de acceso a datos. Puedes inspeccionar los detalles actuales del endpoint en la página de la red Sui.

Cómo elegir un proveedor de RPC de Sui

Una decisión sobre el proveedor de RPC de Sui debe basarse en la carga de trabajo que estás sirviendo. La tabla a continuación enumera los criterios que más importan:

Antes de comprometerte, ejecuta algunas solicitudes simples desde diferentes regiones y mide la latencia. Luego revisa la documentación del proveedor para los encabezados de límite de velocidad, códigos de respuesta y cualquier diferencia entre el comportamiento de JSON-RPC y GraphQL.

Para acceso compartido, el servicio de API de OnFinality proporciona endpoints RPC administrados en redes compatibles. Para equipos que necesitan capacidad aislada o configuración personalizada, un nodo dedicado te brinda tu propio nodo completo de Sui. Consulta precios de RPC y la lista completa de redes RPC compatibles al comparar opciones.

Modos de fallo comunes de RPC de Sui y depuración

Incluso con un buen proveedor, encontrarás errores de RPC. Los patrones más comunes son:

• 429 Too Many Requests — superaste el límite de velocidad. Usa retroceso exponencial, agrupa solicitudes o muévete a un endpoint de pago o dedicado.
• 503 Service Unavailable — el nodo completo o el balanceador de carga está sobrecargado. Verifica el estado del proveedor y agrega conmutación por error a otro proveedor.
• Invalid SuiJSON — se envió un número como número JSON en lugar de una cadena, o una matriz no era homogénea. Revisa las reglas de coerción de SuiJSON.
• Object not found — el ID de objeto o el digest es incorrecto, o el objeto fue eliminado. Verifica que el objeto exista en la red correcta.
• Desconexiones de WebSocket — las suscripciones pueden caerse durante sesiones largas. Reconecta con una estrategia de reintento/retroceso y vuelve a suscribirte después de la reconexión.
• Errores de ejecución de transacciones — usa suix_dryRunTransactionBlock primero para detectar fallos a nivel de Move antes de enviar una transacción firmada.

Al depurar, comienza con una sola solicitud desde una herramienta como curl, verifica el formato de respuesta y luego pasa al flujo completo del cliente. Si un método funciona en un proveedor y no en otro, compara la versión de API y los métodos compatibles enumerados en la documentación del proveedor.

Para problemas relacionados con la finalidad, consulta el número de secuencia de checkpoint antes y después de enviar una transacción. Si una transacción no es visible de inmediato, puede que aún esté esperando la certificación del checkpoint. Evita asumir que una transacción ha fallado solo porque no está en la primera respuesta que recibes.

Conclusiones clave

• La red RPC de Sui conecta aplicaciones a nodos completos de Sui para leer el estado y enviar transacciones.
• Los endpoints públicos oficiales son adecuados para prototipos, pero tienen límites de velocidad y no se recomiendan para producción.
• Sui se está moviendo de JSON-RPC a GraphQL y gRPC, por lo que los nuevos proyectos deben confirmar el soporte de API a largo plazo del proveedor.
• Evalúa a los proveedores según la cobertura de red, límites de solicitudes, datos históricos, redundancia y soporte.
• Prueba con dryRunTransactionBlock, agrupa solicitudes cuando sea posible y planifica la conmutación por error del proveedor antes del lanzamiento.
• OnFinality ofrece acceso administrado a RPC de Sui a través del servicio de API y nodos dedicados. Revisa precios de RPC y redes compatibles para elegir la opción adecuada.

Preguntas frecuentes

¿Qué es la red RPC de Sui?

La red RPC de Sui es la colección de endpoints y APIs de nodos completos que permiten a los clientes leer datos de Sui, enviar transacciones y suscribirse a eventos de la red. Es la forma estándar para que las billeteras y dApps interactúen con Sui.

¿Puedo usar el endpoint RPC público de Sui en producción?

El endpoint público de nodo completo puede manejar pruebas a pequeña escala, pero la documentación de Sui advierte que tiene un límite de velocidad de aproximadamente 100 solicitudes por 30 segundos. Las aplicaciones de producción deben usar un proveedor de RPC administrado o ejecutar un nodo completo dedicado.

¿El RPC de Sui soporta WebSocket?

Muchos proveedores de RPC de Sui soportan conexiones WebSocket para suscripciones, pero la disponibilidad varía según el proveedor y la red. Consulta la documentación del proveedor para conocer los métodos de suscripción compatibles y las pautas de reconexión.

¿JSON-RPC desaparecerá en Sui?

La Fundación Sui ha anunciado planes para deshabilitar JSON-RPC en los nodos completos de mainnet en 2026 y recomienda GraphQL o gRPC para nuevas integraciones. Al evaluar un proveedor, pregunta qué estilos de API se soportan hoy y cuáles están planificados.