Cómo configurar un endpoint RPC de Sui personalizado para tu dApp

Recomendación rápida: Elige tu configuración de RPC de Sui

Antes de entrar en la configuración, decide qué configuración de RPC de Sui se adapta a tu proyecto. La elección correcta depende de tu tráfico, presupuesto y necesidades de control.

• Endpoint público: Gratis, pero con límites de tasa y no adecuado para producción. Úsalo para pruebas y prototipos.
• Proveedor administrado (por ejemplo, OnFinality): Confiable, escalable y fácil de integrar. Mejor para la mayoría de las dApps de producción.
• Nodo autohospedado: Control total y límites de tasa claros, pero requiere experiencia en infraestructura y mantenimiento continuo.

Para la mayoría de los equipos, un proveedor administrado como OnFinality ofrece el mejor equilibrio entre rendimiento y simplicidad. Si necesitas recursos dedicados o tienes alto rendimiento, considera un nodo dedicado de OnFinality.

¿Qué es un RPC de Sui personalizado?

Un endpoint RPC de Sui es una URL que tu dApp usa para comunicarse con la blockchain de Sui. Por defecto, Sui proporciona un endpoint público, pero puedes configurar un endpoint personalizado para apuntar a un proveedor diferente o a tu propio nodo. Esto es útil para:

• Evitar límites de tasa en endpoints públicos
• Mejorar la latencia eligiendo un servidor geográficamente más cercano
• Acceder a datos de archivo o APIs mejoradas
• Asegurar el tiempo de actividad con un proveedor confiable

Configuración de la cadena Sui de un vistazo

Aquí están los detalles clave que necesitas para configurar tu RPC de Sui:

Nota: El endpoint público anterior es solo para ilustración; para producción, usa un proveedor administrado como OnFinality. Consulta la página de la red Sui para obtener la información más reciente del endpoint.

Cómo configurar un endpoint RPC de Sui personalizado

Usando un proveedor administrado (OnFinality)

OnFinality proporciona un endpoint RPC de Sui confiable que puedes usar en tu dApp. Aquí te mostramos cómo configurarlo:

1. Regístrate en OnFinality y crea una clave API.
2. Obtén tu endpoint desde el panel de control. Se verá como https://sui-mainnet.onfinality.io/v1/your-api-key.
3. Configura tu dApp para usar este endpoint.

Usando un nodo autohospedado

Si ejecutas tu propio nodo de Sui, puedes usar su endpoint RPC local, típicamente http://localhost:9000. Configura tu dApp para que apunte a esta dirección.

Ejemplos de JSON-RPC para Sui

Sui usa JSON-RPC 2.0. Aquí tienes un ejemplo básico de curl para obtener el último checkpoint:

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

Para JavaScript (usando fetch):

const rpcUrl = 'https://sui-mainnet.onfinality.io/v1/your-api-key';

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

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

Errores comunes y solución de problemas

1. Límites de tasa en endpoints públicos

Los endpoints públicos a menudo tienen límites de tasa estrictos. Si ves 429 Too Many Requests, cambia a un proveedor administrado o a un nodo autohospedado.

2. URL de endpoint incorrecta

Verifica dos veces tu URL de endpoint por errores tipográficos. Una falta de /v1/ o una clave API incorrecta pueden causar errores de conexión.

3. Caídas de conexión WebSocket

Para actualizaciones en tiempo real, usa WebSocket. Asegúrate de que tu proveedor lo soporte y que tu cliente maneje la reconexión.

4. Método no encontrado

Si llamas a un método que no existe, obtendrás un error. Consulta la documentación de JSON-RPC de Sui para conocer los métodos disponibles.

Cuándo usar un nodo Sui dedicado

Si tu dApp tiene alto tráfico o requiere un rendimiento consistente, un nodo dedicado de OnFinality podría ser la elección correcta. Los beneficios incluyen:

• Límites de tasa claros
• Recursos garantizados
• Configuración personalizable
• Mayor confiabilidad

Considera un nodo dedicado si experimentas límites de tasa frecuentes o necesitas ejecutar consultas pesadas como suix_getDynamicFields.

Monitoreo de tu RPC de Sui

Para asegurar que tu dApp se mantenga saludable, monitorea tu endpoint RPC. Aquí tienes una verificación de salud simple usando curl:

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

Si obtienes una respuesta, tu endpoint está activo. Configura alertas para tiempo de inactividad y latencia.

Conclusiones clave

• Un endpoint RPC de Sui personalizado te da control sobre el rendimiento y la confiabilidad.
• Los endpoints públicos son adecuados para pruebas, pero no para producción.
• Los proveedores administrados como OnFinality ofrecen un equilibrio entre facilidad y rendimiento.
• El autohospedaje da control total pero requiere más esfuerzo.
• Siempre monitorea tu endpoint RPC para detectar problemas temprano.

Preguntas frecuentes

¿Cuál es el endpoint RPC de Sui predeterminado?

El endpoint público predeterminado es https://fullnode.mainnet.sui.io/, pero tiene límites de tasa. Para producción, usa un proveedor administrado.

¿Puedo usar un RPC de Sui personalizado con el SDK de Sui?

Sí, puedes pasar una URL RPC personalizada al inicializar el cliente de Sui. Por ejemplo, en el SDK de TypeScript:

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

const client = new SuiClient({ url: 'https://sui-mainnet.onfinality.io/v1/your-api-key' });

¿Cómo obtengo una clave API de OnFinality?

Regístrate en OnFinality, crea un proyecto y obtendrás una clave API.

¿Cuáles son los beneficios de un nodo Sui dedicado?

Un nodo dedicado proporciona recursos dedicados, límites de tasa claros y mejor rendimiento para aplicaciones de alto tráfico. Aprende más sobre nodos dedicados.

¿Dónde puedo ver la lista de redes compatibles?

Consulta la página de redes compatibles para ver todas las redes disponibles, incluida Sui.

Para más detalles sobre precios, visita nuestra página de precios de RPC.