¿Qué es un endpoint de TON y cómo elijo uno?

Los endpoints de TON son la forma estándar para que carteras, bots y servicios backend se comuniquen con The Open Network. Son endpoints puente HTTP o JSON-RPC que leen datos de blockchain, consultan contratos inteligentes y envían mensajes firmados. Debido a que los nodos TON hablan ADNL en lugar de HTTP, la capa de endpoint generalmente se construye sobre la implementación de referencia ton-http-api.

Esta página explica qué es un endpoint de TON, en qué se diferencia de un endpoint RPC de EVM, qué opciones de endpoints de mainnet y testnet son comunes, y cómo probar un endpoint antes de depender de él.

Lista de verificación para decidir sobre un endpoint de TON

Revisa esta lista antes de comprometerte con un endpoint de TON. Solo toma unos minutos y previene la mayoría de los problemas de integración.

• ¿Mainnet o testnet? Usa testnet para desarrollo y staging; apunta la producción a mainnet.
• ¿Versión de API? Elige v2 para acceso directo a liteserver o v3 si necesitas consultas indexadas para trazas, jettons y NFTs.
• ¿Cobertura de métodos? Confirma que el endpoint soporta los métodos que tu cartera o bot necesita.
• ¿Autenticación? Comprende si necesitas una clave de API y cómo se aplican los límites de velocidad.
• ¿Streaming? Si reaccionas a transacciones en tiempo real, verifica el soporte de SSE o WebSocket.
• ¿Redundancia? Planifica para interrupciones del proveedor y prueba endpoints de respaldo.
• ¿Modelo de costos? Compara endpoints públicos compartidos con precios de RPC y nodos dedicados.

RPC de TON vs RPC de EVM: por qué la forma del endpoint es diferente

Muchos desarrolladores llegan con un modelo mental de Ethereum. Esperan métodos como eth_blockNumber, eth_call y eth_getLogs. TON no es compatible con EVM.

El componente central de TON es la TVM (Máquina Virtual de TON), y los nodos usan el protocolo binario ADNL para la comunicación. Un endpoint HTTP es un servicio intermedio. Recibe solicitudes HTTP, usa tonlib para hablar con un liteserver y devuelve JSON. Puedes usar el servicio público de TON Center, ejecutar tu propio ton-http-api, o usar un proveedor de RPC alojado que ya haya desplegado infraestructura de TON.

Esta arquitectura también explica los nombres de los métodos. Los métodos más comunes son getAddressInformation, getTransactions, runGetMethod, estimateFee y sendBoc. No hay métodos eth_ ni llamadas web3_clientVersion. Cuando alguien dice 'endpoint de TON', generalmente se refiere a la dirección de la API HTTP, no a un nodo JSON-RPC en el sentido de Ethereum.

Opciones de endpoints de mainnet y testnet

Para un inicio rápido, TON Center es la API de referencia. Sus endpoints públicos v2 son:

Ambos son públicos y con límite de velocidad. TON Center también ofrece una API v3 con un indexador, además de una API de Streaming v2 sobre SSE y WebSocket.

Proveedores alojados como OnFinality te dan un endpoint gestionado para que no tengas que ejecutar un nodo TON. Consulta la página de red de TON para detalles de mainnet y la página de testnet de TON para staging. También puedes ver la lista completa de redes compatibles.

Cómo probar un endpoint de TON

La forma más rápida de verificar un endpoint es con una simple solicitud curl. Reemplaza EQD... con una dirección real.

curl 'https://toncenter.com/api/v2/getAddressInformation?address=EQD...' -H 'Accept: application/json'

Una respuesta exitosa se ve así:

{
  "ok": true,
  "result": {
    "@type": "raw.fullAccountState",
    "balance": "123456789",
    "state": "active"
  }
}

Después de que la solicitud tenga éxito, prueba una llamada de solo lectura a un contrato inteligente con runGetMethod, luego prueba estimateFee antes de intentar transmitir una transacción.

Métodos de API de TON que usarás más

Aquí están los métodos que es más probable que necesites en una cartera o bot:

• getAddressInformation – devuelve saldo, estado, hash de código y otros detalles de la cuenta.
• getTransactions – devuelve el historial de transacciones recientes de una dirección.
• runGetMethod – llama a un get-method en un contrato inteligente (solo lectura, sin tarifas).
• estimateFee – estima las tarifas para un mensaje externo.
• sendBoc – envía un mensaje externo firmado (una Bolsa de Celdas) a la red.
• detectAddress – normaliza direcciones entre formatos raw y amigable para el usuario.
• getTokenData – lee metadatos y saldos de jetton (token).

Si tu caso de uso necesita consultas históricas ricas, la API v3 de TON Center agrega acceso indexado a trazas, jettons y NFTs. Sin embargo, una cartera típica se puede construir con v2 y los métodos anteriores.

Elegir entre endpoints de TON públicos, alojados y dedicados

Los endpoints públicos son atractivos para prototipos. Para cualquier cosa que se ejecute continuamente, verifica qué sucede cuando excedes un límite de velocidad. Muchos endpoints públicos devuelven una respuesta 429 sin orientación de reintento, lo que puede estar bien para una demostración local pero es arriesgado para un servicio.

Usa la tabla a continuación para evaluar cualquier endpoint de TON, incluida tu propia instancia autoalojada.

Errores comunes con endpoints de TON

Incluso después de tener un endpoint, la integración de TON tropieza a los desarrolladores de varias maneras.

• Asumir JSON-RPC de EVM. No envíes métodos eth_ a un endpoint de TON. Usa métodos específicos de TON en su lugar.
• Usar el formato de dirección incorrecto. TON soporta direcciones amigables en base64 y direcciones raw workchain:hex. Normaliza con detectAddress antes de consultar.
• Alcanzar límites de velocidad. Las respuestas 429 significan que el endpoint te está limitando. Agrega reintento con backoff y usa una clave de API cuando sea posible.
• Mezclar mainnet y testnet. Una dirección de testnet consultada en mainnet devolverá estado de cuenta no inicializado o datos vacíos. Verifica la red en tu configuración.
• Olvidar que sendBoc requiere un mensaje externo firmado. Debes construir y firmar una Bolsa de Celdas; no puedes simplemente enviar una clave privada o una transacción hex cruda.
• Usar v2 para consultas históricas profundas. getTransactions solo devuelve lo que el liteserver tiene. Para historial de transacciones, trazas o NFTs, usa una API indexada como TON Center v3.
• Ignorar los requisitos de prueba. Si necesitas verificación sin confianza, las API HTTP pueden no devolver paquetes de prueba. En ese caso, conéctate a un liteserver con tonlib o usa un servicio que proporcione pruebas.

Próximos pasos con OnFinality

Una vez que conozcas la forma del endpoint, pruébalo en el entorno de desarrollo de tu aplicación. Para producción, decide si un endpoint público compartido es suficiente o si necesitas más control.

OnFinality ofrece acceso a la API RPC de TON como parte de su cobertura de red e infraestructura de nodos dedicados para equipos que quieren un endpoint privado. Antes de desplegar, consulta la página de red de TON para información actual del endpoint y la página de testnet de TON para staging. También puedes revisar precios de RPC para entender las compensaciones entre configuraciones compartidas y dedicadas.

Cualquiera que sea el endpoint que elijas, ten en cuenta la lista de verificación: verifica red, cobertura de métodos, límites de velocidad y soporte de streaming antes de escribir código de producción.

Conclusiones clave

• Un endpoint de TON es un puente HTTP/JSON-RPC hacia los liteservers de TON. Usa métodos específicos de TON, no métodos EVM.
• La API v2 de TON Center es la implementación de referencia; v3 agrega consultas indexadas para historial rico.
• Prueba los endpoints con curl antes de integrar, y verifica límites de velocidad y autenticación.
• Usa endpoints de mainnet y testnet deliberadamente; mezclarlos causa errores confusos.
• Para producción, considera un endpoint de TON alojado o dedicado de OnFinality en lugar de depender de endpoints públicos gratuitos.

Preguntas frecuentes

¿Qué es un endpoint de TON?

Un endpoint de TON es una dirección de API HTTP que permite a las aplicaciones leer datos de TON, consultar contratos inteligentes y enviar transacciones sin hablar ADNL directamente.

¿Es TON compatible con JSON-RPC de Ethereum?

No. TON usa TVM y el protocolo ADNL. Una API HTTP como TON Center expone métodos como getAddressInformation y sendBoc, no métodos eth_.

¿Cuál es la diferencia entre la API v2 y v3 de TON?

v2 consulta un liteserver directamente a través de ton-http-api. v3 usa una base de datos indexada para soportar consultas más ricas para transacciones, trazas, jettons y NFTs.

¿Cómo elijo un proveedor de endpoints de TON?

Verifica cobertura de mainnet/testnet, soporte de métodos, límites de velocidad, autenticación, capacidad de streaming, y si necesitas historial indexado o un nodo dedicado. Compara planes en precios de RPC.