¿Cómo se accede a los datos de Sui con RPC y proveedores de datos?

Sui es una red de alto rendimiento donde el estado de la aplicación vive en objetos en lugar de un único libro mayor de cuentas global. Ese diseño da forma a cómo lees los datos: la mayoría de las consultas están centradas en objetos, y la superficie RPC está construida en torno a objetos, transacciones, checkpoints y eventos. Si estás conectando una billetera, un indexador o un panel a Sui, necesitas un endpoint que pueda responder esas consultas de forma fiable bajo tu tráfico real.

Esta página es una referencia práctica para RPC de Sui y acceso a datos. Explica qué expone la interfaz RPC, cómo configurar un endpoint, cómo hacer solicitudes reales y cómo decidir entre fullnodes públicos, una API RPC gestionada y un nodo dedicado.

Elegir tu ruta de acceso a datos de Sui

Antes de escribir código de integración, decide qué ruta de acceso se ajusta a tu carga de trabajo. Las tres rutas comunes difieren principalmente en aislamiento, capacidad y cuánto trabajo operativo asumes.

Una regla rápida: si todavía estás explorando la API, un fullnode público está bien. Una vez que tengas usuarios reales, pasa a una API RPC gestionada para no competir por capacidad compartida. Si tu carga de trabajo es grande, con picos o necesita un comportamiento predecible, considera un nodo dedicado para que tu tráfico no se vea afectado por otros inquilinos.

OnFinality proporciona RPC de Sui a través de su servicio API y opciones de nodo dedicado, para que puedas empezar en un endpoint gestionado y pasar a infraestructura dedicada a medida que crece la carga. Puedes revisar los detalles de la red en la página de RPC de Sui.

Qué expone la interfaz RPC de Sui

La API JSON-RPC del fullnode de Sui está organizada en torno a los tipos de datos principales de la red. Los métodos que usarás con más frecuencia se agrupan en unas pocas categorías:

• Lecturas de objetos: obtener un objeto por ID, incluidos su tipo, propietario y versión.
• Lecturas de transacciones: obtener una transacción por digest e inspeccionar sus efectos y eventos.
• Lecturas de checkpoints: recuperar datos de checkpoint y las transacciones que contiene.
• Consultas de eventos: consultar eventos por tipo, remitente o módulo, que es como la mayoría de los indexadores rastrean la actividad.
• Lecturas de monedas y saldos: buscar objetos de moneda y saldos de una dirección.
• Ejecución: enviar una transacción firmada para su ejecución.

Como el estado de Sui está basado en objetos, a menudo resolverás una dirección a sus objetos poseídos y luego leerás cada objeto, en lugar de leer un único saldo de cuenta. Planifica tu modelo de datos en torno a ese patrón desde el principio, porque afecta a cómo almacenas en caché e indexas.

Los nombres de los métodos y los parámetros evolucionan con la red, así que trata la documentación oficial de Sui como la fuente de verdad para la lista exacta de métodos y las formas de las solicitudes. Esta página se centra en cómo conectarse y operar contra esa interfaz.

Configurar un endpoint de Sui

Un endpoint de Sui es una URL HTTP JSON-RPC. Apuntas tu cliente a ella y envías solicitudes JSON-RPC estándar. La misma URL funciona para curl, SDKs de JavaScript y servicios backend.

Guarda el endpoint en una variable de entorno en lugar de codificarlo directamente, para que puedas cambiar entre desarrollo y producción sin cambios de código:

# .env
export SUI_RPC_URL="https://your-onfinality-sui-endpoint"

Luego referéncialo desde tu cliente. En JavaScript, el SDK de Sui acepta una URL de fullnode cuando creas un cliente:

import { SuiClient, getFullnodeUrl } from '@mysten/sui/client';

// Use your managed endpoint in production; the helper is convenient for local tests.
const client = new SuiClient({
  url: process.env.SUI_RPC_URL ?? getFullnodeUrl('mainnet'),
});

const object = await client.getObject({
  id: '0xYOUR_OBJECT_ID',
  options: { showType: true, showOwner: true },
});

console.log(object.data?.type, object.data?.owner);

Para una comprobación directa de que tu endpoint es accesible y devuelve datos, envía una solicitud JSON-RPC directamente:

curl -s "$SUI_RPC_URL" \
  -H 'content-type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sui_getLatestCheckpointSequenceNumber",
    "params": []
  }'

Una respuesta saludable devuelve un resultado JSON con el último número de secuencia de checkpoint. Si en su lugar obtienes un objeto de error, comprueba primero el nombre del método y los parámetros, y luego el propio endpoint.

Leer datos de Sui: objetos, transacciones y eventos

La mayoría de las integraciones con Sui siguen el mismo patrón de tres pasos: resolver lo que necesitas, leerlo y luego rastrear cambios.

1. Resolver. Dada una dirección o un ID conocido, encuentra los objetos o transacciones que te interesan. Para una dirección, consulta los objetos poseídos. Para un digest conocido, obtén la transacción directamente.
2. Leer. Obtén el objeto o la transacción con los campos que necesitas. Solicita solo las opciones que uses, ya que las respuestas grandes cuestan ancho de banda y tiempo.
3. Rastrear. Suscríbete o sondea eventos y checkpoints para que el estado de tu aplicación se mantenga actualizado.

Las consultas de eventos son la columna vertebral de la mayoría de los indexadores. Filtras por tipo de evento, módulo o remitente, y luego paginas los resultados. Como el volumen de eventos en una red ocupada puede ser alto, diseña tus consultas para paginar en lugar de solicitar todo a la vez, y guarda un cursor para poder reanudar después de un reinicio.

Si estás construyendo un backend que necesita estado histórico, confirma que tu proveedor ofrece acceso a archivo para los rangos que necesitas. No todos los endpoints conservan el historial completo, y esa brecha es una fuente común de sorpresas al final de un proyecto.

Lista de verificación para producción

Usa esta lista de verificación antes de enviar tráfico real a un endpoint de Sui. Está escrita para que puedas entregársela a quien sea responsable de la fiabilidad de tu aplicación.

Si no puedes responder a varias de estas, una API RPC gestionada suele ser la ruta más rápida que ejecutar tu propio fullnode. La página de precios de RPC de OnFinality describe los niveles de plan, y la lista de redes RPC compatibles muestra dónde encaja Sui junto a otras cadenas.

Modos de fallo comunes y cómo depurarlos

Los problemas de RPC de Sui suelen caer en unas pocas categorías reconocibles. Relaciona el síntoma con la causa probable antes de cambiar nada.

Un hábito de depuración útil es comparar dos endpoints en paralelo. Consulta el último número de secuencia de checkpoint de cada uno y compáralos. Si uno está consistentemente por detrás, ese endpoint está retrasado y deberías desviar el tráfico lejos de él hasta que se ponga al día.

Para una visión más amplia de la selección de endpoints y el diseño de failover, consulta cómo elegir un proveedor de RPC.

Cuándo pasar a un nodo dedicado de Sui

El RPC gestionado maneja bien la mayoría de las cargas de trabajo de producción. Un nodo dedicado vale la pena considerarlo cuando se aplica uno o más de estos casos:

• Tu tráfico es lo suficientemente grande como para que la capacidad compartida cree latencia impredecible.
• Necesitas aislamiento por cumplimiento, seguridad o residencia de datos.
• Ejecutas indexación pesada de eventos o consultas de archivo que serían costosas en un nivel compartido.
• Quieres control sobre la versión y configuración del nodo sin operar el hardware tú mismo.

Un nodo dedicado no es automáticamente la respuesta correcta. Añade coste y planificación, y solo compensa cuando tu carga de trabajo es lo suficientemente estable como para justificarlo. Si no estás seguro, empieza con gestionado y mide. Cuando la latencia o la limitación se convierten en un tema recurrente, esa es tu señal para evaluar infraestructura dedicada. La oferta de nodo dedicado de OnFinality es el lugar para revisar esa opción.

Puntos clave

• El acceso a datos de Sui está centrado en objetos, así que diseña tus consultas y caché en torno a objetos, transacciones, checkpoints y eventos.
• Los fullnodes públicos están bien para aprender; las aplicaciones en producción deberían usar una API RPC gestionada, y las cargas de alto volumen o aisladas deberían considerar un nodo dedicado.
• Mantén el endpoint en configuración, define un failover y establece tiempos de espera y reintentos antes del lanzamiento.
• Las consultas de eventos necesitan filtros y cursores; las necesidades de archivo deben confirmarse de antemano.
• La mayoría de los problemas de RPC de Sui se pueden diagnosticar comparando números de secuencia de checkpoint y verificando los nombres de métodos con los docs actuales.

Preguntas frecuentes

¿Necesito un fullnode de Sui para leer datos?

No. Puedes leer datos de Sui a través de cualquier endpoint JSON-RPC accesible, incluida una API RPC gestionada. Ejecutar tu propio fullnode solo es necesario si necesitas control total sobre el nodo o requisitos de aislamiento específicos.

¿Cuál es la diferencia entre un proveedor de RPC de Sui y un proveedor de datos?

Un proveedor de RPC te da un endpoint en vivo que responde consultas JSON-RPC contra el estado actual de la cadena. Un proveedor de datos puede añadir indexación, consultas históricas o conjuntos de datos agregados encima. Muchos equipos usan ambos: RPC para lecturas y escrituras en vivo, y datos indexados para analítica e historial.

¿Por qué se agotan mis consultas de eventos de Sui?

Las consultas de eventos amplias sin filtros ni paginación pueden devolver conjuntos de resultados muy grandes. Añade filtros por tipo, módulo o remitente, y pagina los resultados usando cursores para que cada solicitud se mantenga pequeña.

¿Cómo compruebo si un endpoint de Sui está saludable?

Consulta el último número de secuencia de checkpoint del endpoint y compáralo con un segundo endpoint. Un número consistentemente más bajo significa que el endpoint está retrasado.

¿Puedo usar OnFinality para RPC de Sui?

Sí. OnFinality ofrece RPC de Sui a través de su servicio API y opciones de nodo dedicado. Consulta la página de RPC de Sui para detalles de la red y precios de RPC para información de planes.