¿Cómo me conecto a la testnet de TON?

Recomendación rápida: elige un endpoint que se ajuste a tu carga de trabajo

Antes de escribir código, decide cómo interactuarás con la testnet de TON. La elección correcta depende de si estás construyendo un script simple, una dApp de nivel de producción o un indexador de alto rendimiento.

• Para experimentos rápidos y llamadas puntuales, un endpoint público o la API HTTP de TON Center es suficiente. Puedes comenzar con una clave API gratuita y un límite de una solicitud por segundo.
• Para staging, control de calidad y pruebas de carga, necesitas un endpoint RPC de testnet dedicado que pueda manejar tráfico sostenido sin limitaciones. Los endpoints públicos a menudo limitan agresivamente, lo que puede romper tu suite de pruebas.
• Para planificación de producción, trata la testnet como un ensayo para mainnet. Elige un proveedor que ofrezca los mismos tipos de endpoint y confiabilidad en ambas redes, para que puedas migrar con cambios mínimos de código.

Si no estás seguro, comienza con un servicio RPC administrado como el endpoint de testnet de TON de OnFinality y consulta los precios de RPC para ver si un plan gratuito se ajusta a tus necesidades. Siempre puedes cambiar más tarde.

¿Qué es la testnet de TON?

La testnet de TON es una red blockchain separada mantenida por la Fundación TON y validadores de la comunidad. Refleja la funcionalidad de mainnet pero usa TON de testnet (tGRM) que no tiene valor real. Los desarrolladores la usan para desplegar contratos inteligentes, probar integraciones de billeteras y simular transacciones sin riesgo financiero.

La testnet tiene sus propios exploradores, como testnet.tonscan.org y testnet.tonviewer.com, y su propia API HTTP en testnet.toncenter.com. Ten en cuenta que los recursos originales de testnet en test.ton.org están desactualizados y ya no son compatibles; usa siempre los endpoints actuales mantenidos por la comunidad.

Configuración de la red de un vistazo

Estos ajustes son suficientes para configurar una billetera o una dApp. Para una lista completa de redes compatibles, consulta redes RPC compatibles.

Obtener monedas de testnet

Para interactuar con la testnet, necesitas TON de testnet (tGRM). El faucet oficial es un bot de Telegram llamado @testgiver_ton_bot. Así es como usarlo:

1. Abre Telegram y busca @testgiver_ton_bot.
2. Inicia el bot y haz clic en Get 2 GRAM in testnet.
3. Completa el captcha e ingresa la dirección de tu billetera de testnet.
4. Espera unos segundos para que el bot procese la solicitud.
5. Verifica la transferencia usando un explorador de testnet.

Puedes solicitar 2 tGRM por hora. Para cantidades mayores, es posible que necesites ejecutar tu propio faucet o usar un faucet de la comunidad. Siempre verifica que la dirección que proporcionas sea una dirección de testnet, no una de mainnet.

Conexión a través de la API HTTP

La forma más sencilla de interactuar con la testnet de TON es a través de la API HTTP de TON Center. Puedes usarla sin clave API, pero el límite es de 1 solicitud por segundo. Para límites más altos, registra una clave API a través del bot @toncenter.

Aquí tienes un ejemplo básico de curl para obtener el saldo de una dirección:

curl -X GET \
  'https://testnet.toncenter.com/api/v2/getAddressBalance?address=EQD...' \
  -H 'accept: application/json'

Reemplaza EQD... con tu dirección de testnet. La respuesta incluirá el saldo en nanoTON.

Uso de un endpoint RPC dedicado

Para desarrollo y pruebas, un endpoint RPC administrado suele ser más confiable que uno público. OnFinality proporciona un endpoint de testnet de TON que puedes usar con la misma interfaz JSON-RPC que mainnet. Así es como hacer una solicitud:

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

Nota: La URL exacta del endpoint y los nombres de los métodos pueden variar. Consulta la página de red de testnet de TON para obtener los últimos detalles.

Elegir un proveedor de RPC de testnet

Al evaluar un proveedor de RPC de testnet, considera los siguientes criterios:

Un servicio administrado como OnFinality ofrece endpoints consistentes en testnet y mainnet, lo que puede ahorrarte tiempo cuando pases a producción. Consulta los precios de RPC para ver si un plan gratuito se ajusta a tus necesidades.

Errores comunes y cómo evitarlos

• Usar direcciones de mainnet en testnet: Las direcciones de testnet y mainnet se ven similares pero no son intercambiables. Siempre genera una billetera de testnet nueva.
• Ignorar los límites de tasa: Los endpoints públicos tienen límites estrictos. Si tu suite de pruebas hace muchas solicitudes, recibirás errores 429. Usa un endpoint dedicado o agrega lógica de reintento.
• Asumir que la testnet siempre está disponible: Las testnets pueden tener tiempo de inactividad o reinicios. Monitorea tus endpoints y ten un plan de respaldo.
• Olvidar verificar las transacciones: Después de solicitar monedas de testnet, verifica la transferencia en un explorador. El faucet no envía un mensaje de confirmación.

Depurar tu conexión a testnet

Si tienes problemas para conectarte, sigue esta ruta de depuración:

1. Verifica la URL de tu endpoint: Asegúrate de usar la URL correcta de testnet, no la de mainnet.
2. Prueba con una solicitud simple: Usa curl para llamar a getMasterchainInfo y ver si obtienes una respuesta.
3. Verifica tu clave API: Si usas una clave, verifica que sea válida y no haya expirado.
4. Busca errores de límite de tasa: Si ves respuestas 429, espera o cambia a un endpoint de nivel superior.
5. Verifica tu dirección: Asegúrate de usar una dirección de testnet y que esté formateada correctamente.

Aquí tienes un comando curl para verificar la información de masterchain:

curl -X POST \
  https://ton-testnet.onfinality.io/api/v3 \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "ton_getMasterchainInfo",
    "id": 1
  }'

Si obtienes una respuesta, tu conexión está funcionando. Si no, verifica la configuración de red y el firewall.

Conclusiones clave

• La testnet de TON es un sandbox público para desarrollo, con sus propios exploradores, APIs y faucets.
• Usa el bot oficial de Telegram @testgiver_ton_bot para obtener monedas de testnet.
• Para un desarrollo confiable, elige un endpoint RPC dedicado en lugar de uno público, especialmente para staging y control de calidad.
• Evalúa proveedores según límites de tasa, tiempo de actividad, soporte de métodos y paridad con mainnet.
• Siempre verifica tu dirección y transacciones de testnet para evitar errores comunes.

Preguntas frecuentes

¿Cuál es la diferencia entre la testnet de TON y mainnet?

La testnet usa TON de testnet (tGRM) sin valor real, mientras que mainnet usa TON real. La testnet es para desarrollo y pruebas, y su estado puede restablecerse en cualquier momento.

¿Cómo obtengo TON de testnet?

Usa el bot de Telegram @testgiver_ton_bot para solicitar 2 tGRM por hora. Necesitas una dirección de billetera de testnet para recibir las monedas.

¿Puedo usar el mismo endpoint RPC para testnet y mainnet?

Sí, si tu proveedor soporta ambas redes. OnFinality ofrece endpoints tanto para testnet de TON como para mainnet, por lo que puedes cambiar con cambios mínimos de código.

¿Cuáles son los límites de tasa para la API de testnet de TON?

Los endpoints públicos como TON Center te limitan a 1 solicitud por segundo sin clave API. Con una clave, los límites son más altos. Los proveedores administrados pueden ofrecer límites diferentes; consulta su documentación.

¿Cómo verifico una transacción en la testnet?

Usa un explorador de testnet como testnet.tonscan.org o testnet.tonviewer.com. Ingresa la dirección de tu billetera o el hash de la transacción para ver los detalles.