¿Cómo obtengo un endpoint RPC de Sui para mi aplicación en 2026?

Sui es una capa 1 de alto rendimiento donde la mayor parte de la lógica de la aplicación se ejecuta a través de un endpoint RPC: leer objetos, enviar transacciones, consultar eventos y transmitir checkpoints. Si buscaste cómo obtener un endpoint RPC de Sui en 2026, probablemente necesites una de tres cosas: una URL para pegar en tu SDK, un endpoint de nivel producción que no se doblegue bajo carga, o una forma de probar contra la testnet de Sui antes de lanzar. Esta página responde a las tres, y luego te ayuda a decidir qué tipo de endpoint se ajusta realmente a tu carga de trabajo.

¿Qué tipo de endpoint de Sui se ajusta a tu carga de trabajo?

Antes de copiar una URL, decide a qué te estás conectando. Las tres opciones comunes se comportan de manera muy diferente una vez que el tráfico crece.

Si estás prototipando, un endpoint público está bien. En el momento en que tengas usuarios reales, trabajos programados o un pipeline de transacciones, pasa a una API RPC gestionada. Si tu carga de trabajo es constante y lo suficientemente pesada como para que la capacidad compartida se convierta en un cuello de botella, un nodo dedicado te da recursos aislados y un comportamiento predecible. OnFinality ofrece tanto una API RPC de Sui gestionada como nodos Sui dedicados, para que puedas empezar con gestión y pasar a dedicado sin cambiar el código de tu aplicación.

Formatos de endpoint de Sui y configuración de la cadena

Sui expone una interfaz JSON-RPC sobre HTTPS. El endpoint es una URL base; añades la llamada al método en el cuerpo de la solicitud, no en la ruta. Una URL RPC típica de Sui se ve como https://<host>/ y envías cargas JSON-RPC 2.0 mediante POST.

Configuraciones clave que debes tener claras:

• Transporte: HTTPS para solicitud/respuesta. Sui también admite suscripciones WebSocket para flujos de eventos y checkpoints en proveedores que lo habilitan.
• Red: Sui Mainnet y Sui Testnet son endpoints separados. Nunca apuntes una clave de producción a testnet.
• Identificador de cadena: Sui utiliza su propio modelo de objetos y transacciones, así que no asumas métodos eth_* al estilo EVM. Usa métodos JSON-RPC de Sui como sui_getObject, sui_getLatestCheckpointSequenceNumber y sui_executeTransactionBlock.
• Versionado de API: Sui ha ido evolucionando su superficie RPC. Fija la versión de tu SDK y verifica la disponibilidad de métodos contra el endpoint que elijas.

Para el endpoint actual de Sui de OnFinality y los transportes compatibles, consulta la página de la red Sui. Esa página es la fuente autorizada para la URL exacta y cualquier nota específica de la red, así que trátala como tu referencia en lugar de codificar una URL de un artículo de blog.

Prueba el endpoint antes de construir sobre él

La forma más rápida de confirmar que un endpoint de Sui funciona es una sola llamada JSON-RPC. Esta solicitud pide el último número de secuencia de checkpoint, que cualquier fullnode saludable debería responder.

curl -s https://<your-sui-rpc-endpoint>/ \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sui_getLatestCheckpointSequenceNumber",
    "params": []
  }'

Una respuesta saludable devuelve un objeto JSON con un campo result que contiene un checkpoint numérico. Si obtienes un timeout, un 429 o un cuerpo vacío, el endpoint está limitado por tasa, mal configurado o caído. Reemplaza <your-sui-rpc-endpoint> con la URL de la página de la red Sui.

Una vez que la llamada en bruto funciona, conéctala a tu cliente. En una aplicación JavaScript/TypeScript que usa el SDK de Sui, apuntas el cliente a tu endpoint:

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

// Use your managed or dedicated endpoint in production.
const client = new SuiClient({
  url: process.env.SUI_RPC_URL, // e.g. your OnFinality Sui endpoint
});

const checkpoint = await client.getLatestCheckpointSequenceNumber();
console.log('latest checkpoint:', checkpoint);

Mantener la URL en una variable de entorno te permite cambiar entre endpoints públicos, gestionados y dedicados sin cambiar el código.

Testnet de Sui: endpoint separado, claves separadas

Sui Testnet es una red distinta con su propio endpoint y su propio faucet. Si estás construyendo o probando, solicita SUI de testnet del faucet oficial de Sui, luego apunta un cliente de prueba al endpoint de Sui Testnet. Mantén las credenciales de testnet y mainnet completamente separadas: una clave que puede mover activos de mainnet nunca debe cargarse en un script de prueba.

Un flujo de trabajo práctico:

1. Desarrolla contra Sui Testnet usando un endpoint de testnet gestionado.
2. Ejecuta pruebas de integración que envíen transacciones reales en testnet.
3. Promociona el mismo código a Sui Mainnet cambiando solo la URL del endpoint y la clave.

OnFinality lista Sui Testnet junto con mainnet en sus redes RPC compatibles, para que puedas mantener ambos entornos en el mismo proveedor y la misma configuración del SDK.

Público, gestionado y dedicado: qué cambia a escala

Un fullnode público es un recurso compartido. Es excelente para aprender y lecturas ligeras, pero no está diseñado para rendimiento sostenido, y no tienes un canal de soporte cuando se degrada. Una API RPC gestionada añade planificación de capacidad, monitoreo y una vía de soporte sobre la misma interfaz JSON-RPC. Un nodo dedicado te da cómputo y memoria aislados para que una consulta pesada sui_getEvents o una ráfaga de envíos de transacciones no compita con otros inquilinos.

Señales de que es hora de subir de nivel:

• Ves respuestas 429 intermitentes o picos de latencia durante horas pico.
• Tu indexador o backend necesita rendimiento consistente, no de mejor esfuerzo.
• Necesitas consultas de profundidad de archivo o suscripciones WebSocket que los endpoints públicos no garantizan.
• Quieres una relación tipo SLA y un contacto de soporte designado.

Si no estás seguro de qué nivel coincide con tu tráfico, la página de precios de RPC describe las opciones, y la guía de selección de proveedor cubre los criterios de evaluación en profundidad.

Modos comunes de fallo de RPC de Sui y cómo depurarlos

La mayoría de los problemas de RPC de Sui caen en unos pocos patrones. Relaciona el síntoma con la causa probable antes de cambiar de proveedor.

Un hábito útil es registrar el host del endpoint junto con cada error. Cuando ejecutas múltiples entornos, la mayoría de los informes de "Sui está roto" resultan ser una URL de testnet en una configuración de mainnet.

Lista de verificación de preparación para producción

Antes de apuntar tráfico real a un endpoint de Sui, confirma cada uno de estos puntos:

• Propiedad del endpoint: Sabes en qué proveedor y nivel estás, y tienes una vía de soporte.
• Separación de entornos: Las URL y claves de mainnet y testnet se almacenan por separado.
• Conmutación por error: Tienes un segundo endpoint o proveedor al que cambiar si el primario se degrada.
• Monitoreo: Rastreas la tasa de errores, la latencia y las respuestas de límite de tasa, no solo el tiempo de actividad.
• Necesidades de archivo: Si consultas estado histórico, confirma que el endpoint admite la profundidad que necesitas.
• Suscripciones: Si dependes de flujos de eventos, confirma el soporte de WebSocket y prueba la reconexión.
• Modelo de costos: Entiendes cómo el volumen de solicitudes se asigna a tu factura.

Si alguno de estos puntos no está claro, esa es la señal para pasar de un endpoint público a uno gestionado o dedicado. Las opciones de API RPC y nodo dedicado de OnFinality están diseñadas exactamente para esta transición.

Puntos clave

• Un endpoint RPC de Sui es una URL base JSON-RPC sobre HTTPS; envías cargas JSON-RPC 2.0 mediante POST, no métodos al estilo EVM.
• Sui Mainnet y Sui Testnet son endpoints separados con claves y faucets separados.
• Los fullnodes públicos están bien para prototipar; las API RPC gestionadas y los nodos dedicados son para tráfico de producción.
• Prueba cualquier endpoint con una sola llamada sui_getLatestCheckpointSequenceNumber antes de construir sobre él.
• La mayoría de los fallos de RPC de Sui son límites de tasa, desajustes de versión o la red incorrecta, no una cadena rota.
• Mantén el endpoint en una variable de entorno para que puedas cambiar de nivel sin cambios en el código.
• Consulta la página de la red Sui para el endpoint actual y precios de RPC para opciones de nivel.

Preguntas frecuentes

¿Existe un endpoint RPC de Sui gratuito? Sí. Los fullnodes públicos están disponibles para uso ligero y pruebas. Son compartidos, por lo que no son ideales para rendimiento de producción. Para tráfico sostenido, usa una API RPC gestionada o un nodo dedicado.

¿Cuál es la diferencia entre los endpoints de Sui Mainnet y Sui Testnet? Son redes separadas con estado separado y endpoints separados. El SUI de testnet proviene de un faucet y no tiene valor real. Mantén siempre las dos configuraciones separadas.

¿Sui usa JSON-RPC o gRPC? Sui expone una interfaz JSON-RPC sobre HTTPS, y algunos proveedores también ofrecen suscripciones WebSocket. Verifica los transportes compatibles del endpoint específico antes de diseñar en torno a uno.

¿Cómo sé si mi endpoint de Sui está limitado por tasa? Normalmente verás respuestas HTTP 429 o picos repentinos de latencia bajo carga. Si eso ocurre durante el tráfico normal, es hora de pasar a un nivel gestionado o dedicado.

¿Puedo usar un endpoint tanto para mainnet como para testnet? No. Son redes diferentes. Usa endpoints separados y credenciales separadas para cada entorno.

¿Dónde encuentro el endpoint actual de Sui de OnFinality? La página de la red Sui lista el endpoint y los transportes compatibles. Úsala como tu fuente de verdad en lugar de una URL codificada de cualquier artículo.

Próximos pasos

Si aún estás prototipando, toma un endpoint público y ejecuta la prueba de checkpoint anterior. Si te diriges a producción, compara las opciones gestionadas y dedicadas en la página de precios de RPC, luego revisa la lista completa de redes RPC compatibles para confirmar que Sui y cualquier otra cadena de la que dependas están cubiertas. Cuando estés listo, la API RPC de Sui de OnFinality te da un endpoint gestionado al que puedes apuntar tu SDK hoy, con un camino hacia nodos Sui dedicados a medida que crece tu tráfico.