¿Qué es un RPC de testnet de TON y cómo se usa?

Recomendación rápida: ¿qué RPC de testnet de TON deberías usar?

Si estás construyendo una dApp, billetera o bot en TON, necesitas un endpoint de testnet que sea lo suficientemente confiable para integración continua y depuración. Los endpoints públicos como https://testnet.toncenter.com/api/v2/jsonRPC funcionan para pruebas ligeras, pero a menudo tienen límites de tasa y sin garantía de tiempo de actividad. Para una experiencia más estable, considera un proveedor de RPC administrado como OnFinality, que ofrece endpoints dedicados de testnet de TON con mayor rendimiento y mejor confiabilidad. Consulta la página de red de testnet de TON para obtener los últimos detalles del endpoint.

¿Qué es la testnet de TON?

La testnet de TON (The Open Network) es una red blockchain separada utilizada para desarrollo y pruebas. Refleja la funcionalidad de la mainnet pero utiliza tokens TON de prueba que no tienen valor real. Los desarrolladores la usan para desplegar contratos inteligentes, probar integraciones de billeteras y simular transacciones sin riesgo financiero.

Endpoints RPC de testnet de TON de un vistazo

La siguiente tabla enumera endpoints RPC públicos comunes de testnet de TON. Ten en cuenta que la disponibilidad y los límites de tasa pueden cambiar, así que siempre consulta la documentación del proveedor.

Cómo conectarse al RPC de testnet de TON

Usando curl con JSON-RPC

La API v2 de TON admite JSON-RPC. Aquí hay una llamada básica a getMasterchainInfo:

curl "https://testnet.toncenter.com/api/v2/jsonRPC" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getMasterchainInfo",
    "params": {}
  }'

Si tienes una clave de API, agrégala mediante un encabezado o parámetro de consulta:

curl "https://testnet.toncenter.com/api/v2/jsonRPC" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: TU_CLAVE_API" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getMasterchainInfo",
    "params": {}
  }'

Usando JavaScript (librería ton)

Si estás usando el paquete npm ton, puedes crear un cliente con un endpoint HTTP personalizado:

import { TonClient } from "ton";

const client = new TonClient({
  endpoint: "https://testnet.toncenter.com/api/v2/jsonRPC",
  apiKey: "TU_CLAVE_API" // opcional
});

async function main() {
  const info = await client.getMasterchainInfo();
  console.log(info);
}

main();

Autenticación y límites de tasa

Los endpoints públicos de testnet de TON a menudo limitan las solicitudes a una por segundo sin una clave de API. Para aumentar tus límites, debes registrarte para obtener una clave de API. La API v2 de TON Center acepta la clave en el encabezado X-API-Key o como parámetro de consulta api_key. Mantén siempre tu clave de API en secreto y nunca la expongas en código del lado del cliente.

Elegir un proveedor de RPC de testnet de TON

Al seleccionar un proveedor para tu RPC de testnet, considera lo siguiente:

• Confiabilidad: Los endpoints públicos pueden caerse o limitar el tráfico. Un proveedor administrado como OnFinality ofrece infraestructura dedicada con mejor tiempo de actividad.
• Límites de tasa: Los endpoints públicos gratuitos a menudo tienen límites estrictos. Si tus pruebas hacen muchas solicitudes, necesitas un proveedor con mayores asignaciones.
• Distribución geográfica: Los proveedores con múltiples regiones reducen la latencia para tus usuarios.
• Soporte: Los servicios administrados típicamente ofrecen canales de soporte y documentación.

Para cargas de trabajo de producción, también podrías considerar un nodo dedicado. Consulta Precios de RPC para opciones.

Errores comunes y solución de problemas

429 Demasiadas solicitudes

Este error significa que excediste el límite de tasa. Espera un segundo o agrega una clave de API para aumentar tu límite.

Errores de autenticación

Si obtienes un 401, tu clave de API es inválida o falta. Verifica que la estás enviando correctamente en el encabezado o parámetro de consulta.

Problemas de red

Si el endpoint es inalcanzable, prueba con otro proveedor o verifica tu conexión a Internet. También puedes usar una herramienta de monitoreo para probar la salud del endpoint.

Conclusiones clave

• Los endpoints RPC de testnet de TON te permiten interactuar con la testnet para desarrollo y pruebas.
• Los endpoints públicos son convenientes pero pueden tener límites de tasa y problemas de confiabilidad.
• Para desarrollo serio, considera un proveedor de RPC administrado como OnFinality para mejor rendimiento y soporte.
• Siempre asegura tus claves de API y sigue las mejores prácticas de autenticación.

Preguntas frecuentes

¿Cuál es la URL RPC para la testnet de TON?

Un endpoint público común es https://testnet.toncenter.com/api/v2/jsonRPC. OnFinality también proporciona un endpoint de testnet en https://ton-testnet.api.onfinality.io/public/jsonRPC.

¿Necesito una clave de API para el RPC de testnet de TON?

No estrictamente, pero sin una estás limitado a una solicitud por segundo. Para límites más altos, debes obtener una clave de API del proveedor.

¿Puedo usar el RPC de testnet de TON para producción?

No, la testnet es solo para desarrollo y pruebas. Para producción, debes usar endpoints RPC de mainnet de TON.

¿Cómo obtengo tokens TON de prueba?

Puedes obtener TON de prueba del faucet de testnet de TON. Consulta la documentación oficial de TON para la URL actual del faucet.

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

El RPC de testnet se conecta a la red de testnet, que usa tokens de prueba y es para desarrollo. El RPC de mainnet se conecta a la red en vivo con TON real.

Para más información sobre redes y endpoints compatibles, visita la página de redes RPC compatibles.