RPC de Sui Mainnet: Cómo conectarse y qué verificar

Recomendación rápida: ¿endpoint público o nodo dedicado?

Antes de escribir una sola solicitud, decida cómo se conectará a Sui Mainnet. La elección correcta depende de su carga de trabajo, no de qué endpoint sea más fácil de copiar.

• Prototipos, pruebas o dApps de bajo volumen pueden comenzar con un endpoint RPC público. Es gratuito y adecuado para uso ligero, pero la infraestructura compartida significa que puede alcanzar límites de tasa durante picos de tráfico.
• Aplicaciones de producción, indexadores o cualquier cosa con carga sostenida deben usar un servicio RPC administrado o un nodo dedicado. Un nodo Sui dedicado le brinda capacidad aislada, rendimiento consistente y la capacidad de ajustar su infraestructura.

Si está evaluando proveedores, compárelos según los criterios en la matriz de evaluación de proveedores a continuación. Para un inicio rápido, el endpoint público es un primer paso razonable, pero planee mudarse a un nodo dedicado a medida que su tráfico crezca.

Configuración de la cadena Sui Mainnet de un vistazo

Sui es una blockchain de Capa 1 construida en Rust con un modelo de datos único centrado en objetos. A diferencia de las cadenas estilo Ethereum, Sui no usa un ID de cadena tradicional de la misma manera, pero sí tiene un identificador de red y una API RPC específica.

Nota: El endpoint público es compartido y tiene límites de tasa. Para cargas de trabajo de producción, considere un nodo Sui dedicado o un plan RPC administrado de OnFinality.

Entendiendo Sui JSON-RPC

La API RPC de Sui se basa en JSON-RPC, pero no es compatible con Ethereum. Usará métodos específicos de Sui como sui_getBalance, sui_getObject y sui_executeTransactionBlock. La API está documentada en la documentación de Sui, pero aquí están los esenciales.

Métodos comunes

• sui_getBalance – obtener el saldo de SUI de una dirección
• sui_getObject – obtener un objeto por su ID
• sui_executeTransactionBlock – enviar una transacción para ejecución
• sui_getTransactionBlock – recuperar una transacción por digest
• sui_getLatestCheckpointSequenceNumber – obtener el último checkpoint

Ejemplo: obtener saldo con curl

curl -X POST https://sui-mainnet.api.onfinality.io/public \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sui_getBalance",
    "params": ["0x0000000000000000000000000000000000000000"]
  }'

Reemplace la dirección con una real. La respuesta incluirá el saldo total y el desglose de monedas.

Ejemplo: obtener objeto con JavaScript

const response = await fetch('https://sui-mainnet.api.onfinality.io/public', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'sui_getObject',
    params: ['0xobjectid', { showType: true, showContent: true }]
  })
});
const data = await response.json();
console.log(data.result);

Matriz de evaluación de proveedores

Cuando vaya más allá del endpoint público, necesitará comparar proveedores de RPC. Aquí hay una matriz práctica para guiar su evaluación.

OnFinality ofrece opciones de RPC de Sui tanto compartidas como dedicadas. Puede comenzar con el endpoint público y actualizar a un nodo dedicado cuando necesite más capacidad. Consulte Precios de RPC para más detalles.

Errores comunes y cómo evitarlos

1. Usar la red incorrecta

Sui tiene endpoints separados para mainnet y testnet. Verifique dos veces que está usando la URL de mainnet, especialmente si está copiando código de tutoriales. El endpoint de testnet es https://sui-testnet.api.onfinality.io/public (ver Sui Testnet).

2. Ignorar los límites de tasa

Los endpoints públicos son compartidos. Si envía demasiadas solicitudes, recibirá errores 429. Implemente lógica de reintento con backoff exponencial y considere un nodo dedicado para cargas de trabajo de alto volumen.

3. Malinterpretar la propiedad de objetos

El modelo de objetos de Sui es diferente del modelo de cuentas de Ethereum. Necesita comprender los objetos propiedad, los objetos compartidos y los objetos inmutables para interactuar correctamente con la cadena. Lea la documentación de objetos de Sui antes de construir.

4. No manejar WebSocket para suscripciones

Si su aplicación necesita actualizaciones en tiempo real, use suscripciones WebSocket. El endpoint público admite WebSocket, pero para producción, asegúrese de que su proveedor ofrezca conexiones WebSocket confiables.

Depuración de su conexión RPC

Cuando algo salga mal, siga esta ruta de depuración:

1. Verifique el endpoint – ¿Es la URL correcta de mainnet? Pruebe con una llamada simple sui_getLatestCheckpointSequenceNumber.
2. Verifique el formato de su solicitud – ¿Está usando el método y los parámetros JSON-RPC correctos? Consulte la referencia de API de Sui.
3. Verifique la limitación de tasa – Busque respuestas 429. Si las ve, reduzca la velocidad o mejore su plan.
4. Verifique la conectividad de red – ¿Puede llegar al endpoint desde su servidor? Use curl -v para ver los encabezados de respuesta.
5. Verifique su código – ¿Está manejando los errores correctamente? Registre el cuerpo completo de la respuesta para depurar.

Cuándo mudarse a un nodo Sui dedicado

Un nodo dedicado le brinda acceso exclusivo a un validador o nodo completo de Sui. Esto es útil para:

• Aplicaciones de alto rendimiento que necesitan un rendimiento consistente
• Indexadores que necesitan consultar datos históricos sin límites de tasa
• Aplicaciones que requieren métodos RPC personalizados o configuración

OnFinality proporciona nodos Sui dedicados con recursos aislados. También puede usar el servicio API de OnFinality para acceso administrado.

Conclusiones clave

• Sui Mainnet usa una API JSON-RPC diferente a la de Ethereum, por lo que debe usar métodos específicos de Sui.
• El endpoint público es adecuado para pruebas, pero las aplicaciones de producción deberían considerar una solución administrada o dedicada.
• Evalúe a los proveedores según el rendimiento, la fiabilidad, la disponibilidad de datos y el soporte de transporte.
• Evite errores comunes como usar la red incorrecta o ignorar los límites de tasa.
• Use la ruta de depuración para resolver rápidamente los problemas de conexión.

Preguntas frecuentes

¿Cuál es la URL RPC de Sui Mainnet?

La URL RPC pública de Sui Mainnet es https://sui-mainnet.api.onfinality.io/public. Para producción, considere un nodo dedicado o un servicio RPC administrado.

¿Es el RPC de Sui compatible con Ethereum JSON-RPC?

No, Sui usa sus propios métodos JSON-RPC. No puede usar métodos de Ethereum como eth_getBalance en Sui.

¿Cómo obtengo un nodo Sui dedicado?

Puede aprovisionar un nodo Sui dedicado a través de un proveedor como OnFinality. Esto le brinda capacidad aislada y control total.

¿Cuál es la diferencia entre el RPC de Sui Mainnet y Testnet?

Mainnet es para activos reales y uso en producción, mientras que testnet es para desarrollo y pruebas. Tienen endpoints separados y faucets de tokens.

¿OnFinality admite Sui Mainnet?

Sí, OnFinality admite Sui Mainnet y Testnet. Consulte la página de la red Sui para más detalles.

Para obtener una lista completa de redes compatibles, visite redes RPC compatibles.