TronGrid Guía API: TRON Acceso al nodo para desarrolladores
TronGrid es la forma estándar en que los desarrolladores acceden a los datos de blockchain TRON sin operar un nodo completo. Expone puntos finales REST para saldos de cuentas, historial de transacciones, activadores de contratos y registros de eventos, utilizados directamente a través de HTTP o mediante TronWeb.
Esta guía cubre la configuración, la autenticación, los puntos finales comunes y las mejores prácticas de producción.
TronGrid vs nodo autohospedado
| Enfoque | Ventajas | Contras |
|---|---|---|
| TronGrid | Configuración rápida, infraestructura mantenida | Límites de tarifas, dependencia del proveedor |
| Propio nodo completo | Sin límites externos | Carga de operaciones, tiempo de sincronización, hardware |
La mayoría de las aplicaciones comienzan en TronGrid; Los intercambios de gran volumen a menudo ejecutan nodos privados.
Registro y clave API
- Visita https://www.trongrid.io
- Crear cuenta → Panel de control → Crear clave API
- Utilice la clave en el encabezado:
TRON-PRO-API-KEY: <your-key>
Sin una clave, las encuestas agresivas pueden afectar el estrangulamiento.
Puntos finales {#puntos finales}
| Red | URL básica |
|---|---|
| Red principal | https://api.trongrid.io |
| Red de prueba de Shasta | https://api.shasta.trongrid.io |
Configuración TronWeb:
const tronWeb = new TronWeb({
fullHost: 'https://api.trongrid.io',
headers: { 'TRON-PRO-API-KEY': 'your-key' },
});
Operaciones REST comunes
Obtener información de la cuenta
GET /v1/accounts/{address}
Devuelve el saldo TRX, los recursos (Energía/Ancho de banda) y los saldos de tokens TRC-20.
Consulte consulta TRC-20 API de equilibrio.
Obtener transacción por ID
GET /v1/transactions/{txid}
Consulte verificar API de transacción.
Transacción de transmisión
POST /wallet/broadcasttransaction
El cuerpo contiene la transacción firmada JSON de TronWeb.
Activar contrato inteligente
POST /wallet/triggersmartcontract
Se utiliza para llamadas de contrato de lectura/escritura: activar contrato inteligente.
Referencia completa: TRON HTTP API.
Límites de tarifas y confiabilidad
Patrones de producción:
- Caché de datos inmutables (bloques antiguos, txs confirmados)
- Retroceso exponencial en 429 respuestas
- Múltiples claves API por nivel de servicio si se permiten
- Webhook/híbrido de sondeo para detección de pagos
Eventos y registros
TronGrid admite consultas de complementos de eventos para eventos de contrato, lo que resulta útil para los oyentes de depósitos USDT. TronWeb contenedor: escuchas de eventos.
Seguridad
- Las claves API son secretas: variables de entorno, no paquetes de interfaz
- Firma de transacciones en el lado del servidor solo con claves seguras
- Validar direcciones antes de la transmisión.
Flujo de trabajo de desarrollo de Shasta
- Punto final Shasta + clave de prueba
- Grifo TRX
- Implementar contratos a través de TronBox
- Promocionar a la red principal con nuevas direcciones.
Consejos para la implementación de producción
Ejecute varias claves API en todos los servicios para aislar cuotas. Caché de datos inmutables (ABI de contrato, fuente verificada). Utilice un retroceso exponencial en 429 respuestas. Para la detección de pagos de misión crítica, considere un nodo completo dedicado o un nivel premium TronGrid.
Guía de selección de endpoints
Utilice /wallet/* para crear y transmitir transacciones. Utilice /v1/* para el historial y los eventos indexados. Mezclarlos incorrectamente (por ejemplo, sondear getaccount cada segundo para detectar pagos en lugar de API de eventos) desperdicia cuota y agrega latencia. Asigne cada característica del producto a la familia de terminales correcta durante la revisión del diseño.
Lista de verificación para solucionar problemas
Si algo sale mal en TRON, trátelo como un problema de depuración estructurado: confirme el txid exacto en la cadena, verifique la dirección del contrato de destino y solo entonces decida si la falla es recuperable. En TRON, muchos problemas "misteriosos" son simplemente uno de: red incorrecta (mainnet vs testnet), contrato de token incorrecto (falso USDT/tokens con nombres similares), recursos insuficientes (OUT_OF_ENERGY/ancho de banda) o retraso en la interfaz de usuario/indexador entre la billetera y el explorador.
Comience con estas comprobaciones en cadena:
- Copie siempre el txid/hash completo de su billetera o explorador.
- Confirme el estado del resultado del tx en TronScan (SUCCESS, REVERT, OUT_OF_ENERGY o aún pendiente).
- Compruebe si la dirección del destinatario/contrato coincide con la que desea enviar.
- Si se trata de una llamada de contrato, confirme que el selector de función y los parámetros coincidan con el estándar de token que cree que está utilizando (TRC-20 vs TRC-10 vs BEP-20 en BSC).
Luego aplique la ruta de corrección para su categoría:
- Confirmar el estado y los parámetros de la transacción.
- Verificar direcciones (contrato de token, destinatario, enrutador/gastador).
- Agregar o delegar recursos (Energía/Ancho de banda) cuando el fallo esté basado en recursos.
Errores comunes
Estos patrones causan la mayoría de los errores a nivel de usuario:- Usar direcciones de mainnet en testnet (o al revés).
- Copiar un símbolo de token en lugar de la dirección del contrato TRC-20 real.
- Firmar la dirección de aprobación/gastador incorrecta porque el enlace de la interfaz de usuario es malicioso o está desactualizado.
- Reintentar sin cambiar la entrada fallida (por ejemplo, REVERT sigue revirtiéndose hasta que corrija el parámetro).
Si no está seguro, no “simplemente envíe de nuevo”. Realice un cambio controlado, verifique en TronScan y luego continúe.
Preguntas frecuentes
¿Cómo sé si una transacción está realmente confirmada?
Utilice TronScan y verifique el estado del resultado del tx. Las etiquetas "pendientes" de la billetera pueden retrasarse; El estado de la cadena es la fuente de la verdad. Copie txid y verifique SUCCESS/REVERT/OUT_OF_ENERGY, no solo el texto de la interfaz de usuario.
¿Por qué la interfaz de usuario difiere de TronScan?
Algunas billeteras y dApps utilizan diferentes indexadores o capas de caché. Es normal que haya un breve retraso entre la transmisión y la indexación; compare txid y espere a que la cadena se estabilice antes de concluir que hay una falla.
¿Qué debo hacer después de un REVERT?
Detenga y decodifique la llamada fallida. La mayoría de los REVERT se deben a parámetros no válidos, dirección de contrato incorrecta, aprobaciones faltantes o una falta de coincidencia entre el estándar del token y el método. Solucione la causa y luego vuelva a firmar.
¿Es seguro firmar una aprobación ilimitada?
Las aprobaciones ilimitadas son seguras solo para direcciones de gastadores confiables que usted haya verificado (fuente verificada, enrutador correcto y contrato de token esperado). Para las pruebas, prefiera aprobaciones limitadas y revoque una vez que haya terminado.
¿Qué recursos requiere TRON para las llamadas de contrato?
La ejecución de contratos inteligentes consume principalmente energía, mientras que los bytes de transacciones consumen ancho de banda. Si recibe OUT_OF_ENERGY, agregue/congela/delegue energía. Si se agota el ancho de banda, concéntrese en mantener suficiente líquido TRX para bytes y asignación de recursos.
¿Cómo puedo reducir los tickets de soporte?
Muestre a los usuarios un mensaje claro de "qué sucedió" basado en el estado de la cadena y vincule directamente a la guía relevante (pendiente, fallida, sin energía o verificación). Guarda txid para que puedas conciliar rápidamente.
Guías relacionadas
- TRON Referencia de API HTTP
- Consulta TRC-20 API de equilibrio
- Verificar API de transacción
- Oyentes de eventos TronWeb
Preguntas frecuentes
¿Qué es TronGrid?
TronGrid es el servicio API alojado de TRON que proporciona acceso HTTP a datos completos del nodo: cuentas, transacciones, bloques y contratos inteligentes sin ejecutar su propio nodo.
¿Necesito una clave API para TronGrid?
El nivel gratuito funciona con límites. Las aplicaciones de producción deben registrarse para obtener una TRON-PRO-API-KEY para aumentar los límites de velocidad y la confiabilidad.
¿Es TronGrid lo mismo que TronScan API?
TronScan ofrece API de explorador para datos legibles por humanos. TronGrid es una infraestructura orientada a nodos del ecosistema Foundation TRON. Muchas aplicaciones usan ambos.
¿Puede TronGrid firmar transacciones?
No. Firmas localmente con TronWeb + clave privada o TronLink; TronGrid transmite txs firmados.
¿Qué sucede si TronGrid está caído?
Implemente reintentos, monitoreo de la página de estado y considere un nodo completo alternativo para sistemas críticos.
Gracias — tu feedback nos ayuda a mejorar la documentación.