¿Cuál es la URL RPC de la red TON y cómo se usa?

Respuesta rápida: URL RPC de TON

La URL RPC pública oficial de la red TON es https://ton-rpc.onfinality.io. Este endpoint HTTP te permite interactuar con la blockchain de TON utilizando métodos JSON-RPC estándar. Si estás construyendo una dApp, una billetera o un bot, esta es la URL que usarás para enviar transacciones, consultar estados de cuentas y leer datos de la blockchain.

Para aplicaciones de producción, depender de un endpoint público puede provocar limitaciones de velocidad y tiempo de inactividad. Ahí es donde un servicio RPC gestionado como OnFinality resulta útil: ofrece endpoints dedicados, mayor rendimiento y mejor fiabilidad. Puedes explorar los precios de RPC y la lista de redes RPC compatibles para encontrar la opción adecuada.

Guía de decisión: ¿Endpoint público o RPC gestionado?

Antes de copiar y pegar la URL en tu código, piensa en tu caso de uso. El endpoint público es adecuado para pruebas y proyectos pequeños, pero tiene limitaciones:

• Límites de velocidad: Los endpoints públicos suelen limitar las solicitudes, lo que puede romper tu aplicación durante picos de tráfico.
• Disponibilidad: Los endpoints públicos pueden caerse sin previo aviso, afectando a tus usuarios.
• Soporte: No tienes a quién contactar si algo sale mal.

Si estás construyendo una dApp de producción, un servicio RPC gestionado como OnFinality ofrece:

• Endpoints dedicados: Sin límites de velocidad compartidos, por lo que tu tráfico no se verá afectado por otros usuarios.
• Mayor fiabilidad: Infraestructura gestionada con monitoreo y conmutación por error.
• Soporte: Acceso a un equipo que puede ayudarte a solucionar problemas.

Recomendación rápida: Comienza con el endpoint público para desarrollo. Cuando estés listo para lanzar, muévete a un servicio RPC gestionado para garantizar disponibilidad y rendimiento. Consulta cómo elegir un proveedor de RPC para obtener más información.

¿Qué es la red TON?

TON (The Open Network) es una blockchain de capa 1 diseñada para transacciones de alta velocidad y bajo costo. Utiliza una arquitectura de fragmentación única que le permite procesar millones de transacciones por segundo. TON está estrechamente integrada con Telegram, lo que la convierte en una opción popular para mini-aplicaciones, bots y pagos.

Los desarrolladores interactúan con TON mediante su API RPC, que sigue el estándar JSON-RPC 2.0. La URL RPC es el punto de entrada para todas las solicitudes, ya sea para enviar una transacción, consultar un contrato inteligente u obtener saldos de cuentas.

Endpoint RPC de TON: Configuración de red de un vistazo

Aquí están los detalles clave que necesitas para conectarte a la red principal de TON:

Nota: TON no utiliza IDs de cadena estilo EVM. En su lugar, usa una estructura de workchain y shard. Para la mayoría de los desarrolladores, solo necesitarás la URL RPC.

Cómo conectarse a TON RPC: Ejemplos de código

Veamos cómo usar la URL RPC de TON en la práctica. Usaremos JavaScript con el paquete npm ton, que es la forma más común de interactuar con TON.

Instalar el SDK

npm install ton

Enviar una solicitud simple

import { TonClient } from "ton";

const client = new TonClient({
  endpoint: "https://ton-rpc.onfinality.io",
});

async function getAccountBalance(address) {
  const balance = await client.getBalance(address);
  console.log(`Balance: ${balance}`);
}

getAccountBalance("EQD..."); // Reemplaza con una dirección real

Usando curl para una llamada JSON-RPC cruda

Si prefieres probar con curl, puedes enviar una solicitud JSON-RPC cruda. Por ejemplo, para obtener la información de la masterchain:

curl -X POST https://ton-rpc.onfinality.io \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"ton.getMasterchainInfo","params":[],"id":1}'

Esto devolverá la información del bloque más reciente de la masterchain.

Entendiendo los métodos RPC de TON

TON RPC utiliza un conjunto de métodos que son diferentes a los de Ethereum. Aquí hay algunos comunes:

Estos métodos te permiten construir una amplia gama de aplicaciones, desde simples consultas de saldo hasta complejas interacciones con contratos inteligentes.

Errores comunes y cómo evitarlos

Al trabajar con TON RPC, los desarrolladores suelen encontrarse con algunos problemas:

1. Usar el endpoint incorrecto

Asegúrate de usar el endpoint de mainnet (https://ton-rpc.onfinality.io) y no uno de testnet. Si estás probando, puedes usar el endpoint de TON Testnet, pero no los mezcles.

2. No manejar los errores correctamente

TON RPC devuelve errores en un formato JSON-RPC estándar. Siempre verifica el campo error en la respuesta. Por ejemplo:

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "Algún mensaje de error"
  }
}

3. Ignorar los límites de velocidad

Los endpoints públicos tienen límites de velocidad. Si haces muchas solicitudes, puedes recibir errores 429 Too Many Requests. Para evitarlo, implementa lógica de reintento o usa un servicio gestionado.

Depurando tu conexión RPC de TON

Si tus solicitudes fallan, aquí tienes una ruta de depuración paso a paso:

1. Verifica la URL: Asegúrate de usar el endpoint correcto.
2. Prueba con curl: Usa el ejemplo de curl anterior para ver si el endpoint es accesible.
3. Verifica tu payload: Asegúrate de que tu solicitud JSON-RPC esté bien formada.
4. Observa los códigos de error: Los códigos comunes incluyen -32601 (método no encontrado) y -32602 (parámetros inválidos).
5. Comprueba la conectividad de red: Si estás detrás de un firewall, el endpoint podría estar bloqueado.

Si aún tienes problemas, considera usar un servicio de nodos dedicados que ofrezca soporte. La oferta de nodo dedicado de OnFinality te brinda un endpoint privado y acceso directo a expertos.

Lista de verificación para producción

Antes de implementar tu aplicación TON en producción, revisa esta lista:

• Usa un servicio RPC gestionado: Evita endpoints públicos para tráfico crítico.
• Implementa lógica de reintento: Maneja fallos transitorios con elegancia.
• Monitorea tus endpoints: Configura alertas para altas tasas de error.
• Protege tus claves API: Si usas un servicio con claves API, mantenlas seguras.
• Prueba primero en testnet: Usa la testnet de TON para validar tu lógica.

Conclusiones clave

• La URL RPC oficial de la red TON es https://ton-rpc.onfinality.io.
• Usa el endpoint público para desarrollo, pero cambia a un servicio gestionado para producción.
• TON RPC usa JSON-RPC 2.0, pero sus métodos son únicos de TON.
• Siempre maneja errores y límites de velocidad en tu código.
• Para producción, considera el servicio RPC de OnFinality para fiabilidad y soporte.

Preguntas frecuentes

¿Cuál es la URL RPC de la red TON?

La URL RPC de la red TON es https://ton-rpc.onfinality.io. Es el endpoint que usas para interactuar con la blockchain de TON mediante JSON-RPC.

¿Es gratuita la URL RPC de TON?

Sí, el endpoint público es gratuito, pero tiene límites de velocidad. Para límites más altos, puedes registrarte en un plan de pago en precios de RPC.

¿Puedo usar WebSocket con TON RPC?

TON RPC utiliza principalmente HTTP. El soporte de WebSocket puede estar disponible a través de algunos proveedores, pero no es estándar. Consulta con tu proveedor para más detalles.

¿Cómo obtengo un endpoint RPC dedicado de TON?

Puedes obtener un endpoint RPC dedicado de TON suscribiéndote a un servicio de nodos dedicados como nodos dedicados de OnFinality. Esto te brinda una URL privada con mayor rendimiento.

¿Cuáles son los límites de velocidad para el endpoint RPC público de TON?

Los límites de velocidad varían según el proveedor. Los endpoints públicos generalmente permiten un número limitado de solicitudes por segundo. Para producción, considera un plan de pago para evitar alcanzar los límites.