TxGhost bot BRST TRON
Monitor TRC-20 · TRON

TxGhost v1.05

No mira solamente transferencias.
Interpreta lo que sucede detrás de ellas.

Herramienta propia en Python diseñada para observar, clasificar y analizar actividad TRC-20 del token BRST en la red TRON. Identifica contratos ejecutados, reconstruye el contexto de las operaciones e interpreta interacciones con protocolos como SunSwap V4. Los resultados se convierten en notificaciones enriquecidas y representaciones visuales generadas dinámicamente.

● OPERATIVO · MONITOREO 24/7 Python · TeleBot · Pillow Tronscan · TronGrid
7
Categorías de evento
8
Redes con estimación de costos
7
Fuentes externas integradas
24/7
Monitoreo continuo

Presentación / 01

TxGhost es un sistema de monitoreo on-chain desarrollado de forma independiente. Consulta periódicamente los eventos TRC-20 de un contrato observado, reconstruye el contexto de cada transacción a partir de múltiples fuentes y clasifica la operación según el contrato ejecutado y las direcciones involucradas.

El objetivo no es solo notificar movimientos, sino interpretar qué ocurrió: si fue una compra o venta a través de un router, un aporte o retiro de liquidez, una quema, un swap genérico o una transferencia P2P. Cada evento se enriquece con datos on-chain (supply, precio, holders) y se presenta con una interfaz visual generada en tiempo de ejecución.

Alcance. El mecanismo principal es consulta periódica a Tronscan, no una suscripción nativa a eventos. La clasificación combina reglas determinísticas y heurísticas; no todas las operaciones se identifican con la misma certeza. El monitoreo es continuo y la notificación ocurre en el siguiente ciclo de consulta.

Capacidades / 02

Seis módulos funcionales, cada uno resolviendo un problema concreto sobre datos on-chain.

C1 Monitoreo de actividad BRST

Consulta periódica del contrato observado, con caché de transacciones procesadas para evitar duplicados entre ciclos de monitoreo.

C2 Clasificación SunSwap V4

Distingue compra, venta, aporte y retiro de liquidez, burn y swap genérico según el contrato ejecutado.

C3 Exploración de transacciones

Detalle de bloque, fecha, estado, recursos (bandwidth/energy) y eventos paginados de cada hash.

C4 Análisis de holders

Top 10 holders y posición individual en el ranking, con balance y porcentaje de participación.

C5 Información de mercado

Precios on-chain (RATE()) y de mercado (CoinGecko, Binance) con tarjetas visuales generadas con PIL.

C6 Estimación comparativa de fees

Ocho redes, cuatro mecanismos de estimación distintos y fórmulas documentadas por red.

Arquitectura / 03

El núcleo del sistema es una cascada de tres etapas: captura, interpretación y clasificación. Cada etapa cumple una función específica en el procesamiento de los datos on-chain.

01 — CAPTURA

Eventos TRC-20

Tronscan entrega las transferencias del contrato observado. TxGhost mantiene una caché de transacciones procesadas (TX_SEEN) para evitar notificaciones duplicadas entre ciclos.

02 — INTERPRETACIÓN

Contrato ejecutado

Se consulta el detalle de la transacción y se busca el contrato ejecutado mediante fallbacks en cascada:

  • trigger_info.contract_address
  • contractData.contract_address
  • raw_data.contract[0].parameter
  • toAddress (último recurso, menor confianza: destino reportado por la API, no necesariamente el contrato ejecutado)
  • Normalización hex → Base58
03 — CLASIFICACIÓN

Tipo de operación

Se contrasta el contrato ejecutado, las direcciones involucradas y la heurística de método (es_swap) para identificar la operación.

Por qué los fallbacks

La respuesta de transaction-info de Tronscan no es consistente: toAddress puede venir vacío, el contrato puede aparecer en contractData o en raw_data según la versión del endpoint, y en algunos casos se devuelve en hexadecimal en lugar de Base58. La cascada no es defensiva por gusto: es el resultado de trabajar contra respuestas reales de la API.

Tronscan
▼
get_trc20_events()
▼
TX_SEEN (dedupe)
▼
obtener_detalle_transaccion()
▼
contrato_llamado ← fallbacks en cascada
▼
Router SunSwap
▼
compra / venta
PoolManager
▼
liquidez / retiro
PositionManager
▼
burn / swap
▼
notificar() ──▶ Telegram

Categorías de evento

CondiciónTipo detectado
to == SUN_POOL_MANAGER y router ejecutado🔄 VENTA / COMPRA BRST
to == SUN_POOL_MANAGER sin router🌞 APORTE LIQUIDEZ
from == SUN_POOL_MANAGER💰 RETIRO LIQUIDEZ
from/to == SUN_POSITION_MANAGER🔄 SWAP / 🔥 BURN
from == Q55_WALLET + destino y contrato ejecutado🤑 NUEVA COMPRA / 🔥 BURN (según condiciones adicionales)
es_swap(txID) == trueSWAP genérico
Sin coincidencia🤝 TRANSFERENCIA P2P

La clasificación se basa en origen, destino, contrato ejecutado y condiciones específicas de cada operación. El orden de evaluación de reglas evita falsos positivos cuando coinciden varias condiciones.

Integración SunSwap V4 / 04

SunSwap V4 distribuye la lógica entre tres contratos con roles distintos. La clasificación depende de identificar cuál fue ejecutado y cuál es el destino de la transferencia.

ContratoRolDirección
Universal RouterPunto de entrada de swapsTSJEtPuqHpvSaVnSwvCsngaeBxrGUzp95Q
Pool ManagerGestión de pools de liquidezTVjuTE3V5bMVdpfNhid8kD2v35T2k1u1Br
Position ManagerGestión de posiciones LPTC8xQzPHfn5KceZV6s6GmZkBCFWWUoPXs1
Lectura clave. Un swap no se detecta por el monto ni por el emisor, sino por la combinación (contrato ejecutado, from, to). Una misma transferencia puede adquirir significados distintos según el contrato ejecutado, el origen, el destino y el contexto de la operación.

Cross-chain Fee Estimator / 05

Módulo independiente que estima el costo de una transferencia en ocho redes. Cada red usa un mecanismo distinto según lo que expone su infraestructura.

RedMecanismoFuente
EthereumGas price + precio del tokenBlocknative + Binance
ArbitrumGas price + precio del tokenBlocknative + Binance
AvalancheGas price + precio del tokenBlocknative + Binance
PolygonGas price + precio del tokenBlocknative + Binance
BNB ChainGas price + precio del tokenBlocknative + Binance
TRONSimulación triggerconstantcontractTronGrid
SolanaEstimación por lamportsBinance (precio SOL)
BitTorrent Chaineth_gasPrice por RPCRPC BTTC + Binance
Supuestos. Las estimaciones son aproximaciones, no simulaciones exactas de ejecución. Se asume un consumo típico de recursos para transferencias (transfer(address,uint256)) y un costo de referencia por red. El consumo de referencia no contempla todas las variaciones posibles del estado del contrato receptor ni condiciones particulares de ejecución. Los valores reales dependen del estado de la red al momento de la ejecución. En TRON se habla de costos de transacción (Energy y Bandwidth), no de gas.

Interfaz y resultados / 06

Las notificaciones no son texto plano. Cada tipo de evento tiene una tarjeta visual generada en tiempo de ejecución con Pillow, y los comandos de consulta producen imágenes con datos on-chain actualizados.

Notificación de swap

Monto, equivalente en TRX, supply, precio on-chain y holders en un solo mensaje.

Ranking de holders

Posición, balance y porcentaje de participación con barra de progreso renderizada.

Tarjeta de precio

Precio, market cap, volumen 24h y ranking, con ícono del token.

Ficha de SR

Votos y posición en el ranking global de Super Representantes.

Capturas. Esta sección está pensada para incluir capturas reales de Telegram y de las imágenes generadas por el bot. Las imágenes deben ser propias del proyecto, no referencias externas.

Command interface / 07

Acceso controlado por clave temporal. Los chats autorizados se persisten en chat_ids.json.

/start <clave>

Autoriza el chat. Clave de 10 caracteres, válida 5 minutos.

/generar

Genera clave temporal (solo por privado).

/ghostinfo

Ficha ASCII del proyecto y datos del autor.

/txid <hash>

Detalle completo: bloque, fecha, estado, recursos y eventos paginados.

/mipuesto <dir>

Ranking del holder en BRST + imagen con posición, balance y % de participación.

/ghostlink

Precios del ecosistema TRON y accesos rápidos.

/pr <ticker>

Tarjeta de precio. /pr brst usa el RATE() on-chain.

/sr

Super Representante de Brutus: votos y posición.

Callbacks inline

holders:<contrato>

Top 10 holders con balance formateado.

ver_evt_<id>

Navegación paginada de eventos (10 por página).

gas_trk

Costos de transacción en USDT en 8 redes.

descargo / formulas

Validación del cálculo EVM con transacción real y fórmulas por red.

cerrar_qr

Cierra el mensaje asociado al callback.

Stack y dependencias / 08

CapaTecnología
RuntimePython
InterfazpyTelegramBotAPI (TeleBot)
ImágenesPillow (PIL)
HTTPrequests
Blockchain (TRON)Tronscan API, TronGrid, SunSwap V4
Blockchain (EVM)Blocknative, RPC BTTC
MercadoBinance, CoinGecko, 3xpl

Identidad y autoría / 09

Proyecto desarrollado de forma independiente. Sin infraestructura corporativa, sin protocolo propio. Un sistema independiente de interpretación de actividad on-chain, con monitoreo, clasificación, enriquecimiento de datos y una interfaz de consulta, construido sobre servicios existentes para resolver problemas concretos del ecosistema de Brutus.