Neros0/defillama-watchdog

Monitor de Protocolos DeFiLlama

Monitorea protocolos DeFi para detectar caídas de TVL, rotación de capital, riesgos de seguridad y oportunidades de mercado.

Cuándo Usarlo

• El usuario quiere monitorear o seguir protocolos específicos (ej. "vigila Aave", "alértame si Uniswap cae")
• El usuario solicita una auditoría de seguridad, verificación de riesgos o informe completo
• El usuario quiere alertas de rotación o actualizaciones de sentimiento (análisis de flujo de capital)
• El usuario quiere verificar si algún protocolo fue hackeado (seguridad de cartera)

No usar para consultas puntuales como "¿cuál es el TVL de Aave?" — responde esas directamente.

Comandos Disponibles

Todos los comandos se ejecutan desde la raíz de la skill. Añade --json para salida estructurada.

Comando	Propósito	Señales de Salida
python3 scripts/watchdog.py	Verificar caídas de TVL	ALERT: o HEARTBEAT_OK
python3 scripts/capital_flow.py	Rotación de capital y sentimiento	ROTATION:, SENTIMENT:, o HEARTBEAT_OK
python3 scripts/bridge_monitor.py	Picos de volumen en puentes	BRIDGE_SURGE: o HEARTBEAT_OK
python3 scripts/metrics_guard.py	Cartera vs Hacks Recientes	EMERGENCY: o HEARTBEAT_OK
python3 scripts/true_growth.py	Dinero inteligente (TVL baja, entradas suben)	BULLISH_DIVERGENCE: o HEARTBEAT_OK
python3 scripts/unlocks_monitor.py	Riesgos de desbloqueo de tokens	DUMP_RISK: o HEARTBEAT_OK
python3 scripts/revenue_guard.py	Crecimiento de ingresos/tasas	VALUE: o HEARTBEAT_OK
python3 scripts/full_briefing.py	Ejecutar todas las verificaciones	Todas las señales combinadas

Cómo Responder

Cuando el Usuario Solicita una Verificación

1. Ejecuta el(los) script(s) apropiado(s)
2. Interpreta las señales de salida:
   • HEARTBEAT_OK = Todo en orden
   • ALERT: = TVL cayó por debajo del umbral
   • EMERGENCY: = Un protocolo de la cartera fue hackeado
   • ROTATION: = Capital moviéndose entre cadenas
   • SENTIMENT: = Señal de riesgo-on/risk-off
   • BRIDGE_SURGE: = Pico de volumen en puente (cadena activa)
   • BULLISH_DIVERGENCE: = TVL baja pero entradas suben
   • DUMP_RISK: = Gran desbloqueo próximo
   • VALUE: = Ingresos creciendo más rápido que el precio
3. Sintetiza los resultados en 2-5 oraciones explicando qué pasó y por qué importa

Patrón de Respuesta para Alertas

Cuando detectes una señal de riesgo:

1. Comienza con el hallazgo clave (caída de TVL, hack, rotación)
2. Añade contexto de otras señales:
   • Si ALERT: → ejecuta capital_flow.py para verificar si es rotación o específico del protocolo
   • Si existe cartera → ejecuta metrics_guard.py para verificar riesgo de hack
   • Opcionalmente ejecuta otras verificaciones para profundidad (desbloqueos, entradas, ingresos)
3. Da una conclusión clara (¿qué debería hacer el usuario?)

Ejemplo de Síntesis

Malo: "ALERT: AAVE V3 TVL cayó 12.3%. ROTATION: La oferta de stablecoins en Ethereum se redujo 1.5%."

Bueno: "El TVL de Aave V3 cayó 12.3% en el último período. Esto parece relacionado con una rotación de capital más amplia — la oferta de stablecoins en Ethereum está bajando mientras Solana crece. No es un riesgo específico del protocolo, pero hay que vigilar las salidas continuas."

Solicitudes Comunes de Usuarios

"Alértame si [protocolo] cae más del X%"

• Asegúrate de que config.json tenga la watch_list correcta (usa slugs de DeFiLlama) y el threshold
• Explica que el vigilante se ejecuta en horario programado y alertará cuando se supere el umbral

"Ejecutar una auditoría de seguridad" / "Informe completo" / "Verificación de riesgos"

• Ejecuta python3 scripts/full_briefing.py
• Sintetiza todas las señales de salida en una sola narrativa

"¿Hay rotación de capital?" / "Actualización de sentimiento?"

• Ejecuta python3 scripts/capital_flow.py
• Reporta las señales ROTATION: y SENTIMENT:, o di "sin movimientos significativos"

"¿Alguno de mis protocolos fue hackeado?"

• Ejecuta python3 scripts/metrics_guard.py
• Requiere assets/portfolio.json (IDs de protocolos DeFiLlama)
• Reporta EMERGENCY: inmediatamente si se encuentra

"Verificación manual ahora"

• Ejecuta python3 scripts/watchdog.py
• Reporta resultados o confirma "todo dentro del umbral"

Configuración

Archivo: config.json en la raíz de la skill

Ajustes clave:

• watch_list: Arreglo de slugs de protocolos DeFiLlama (ej. ["aave-v3", "uniswap", "lido"])
• threshold: Decimal para el umbral de alerta (ej. 0.10 = caída del 10%)
• risk_level: "high" (5%), "standard" (10%), "low" (15%)
• Activadores de funcionalidades: capital_flow.enabled, metrics_guard.enabled, bridge.enabled, etc.

Seguimiento de cartera: Crea assets/portfolio.json con IDs de protocolos DeFiLlama para alertas de hacks/desbloqueos.

Funciones avanzadas: Algunas funciones (entradas, desbloqueos) necesitan DEFILLAMA_PRO_API_KEY en el entorno. La mayoría de las funciones funcionan sin clave API.

Notas Importantes

• Los slugs de protocolos deben coincidir exactamente con DeFiLlama (verifica en defillama.com/protocols)
• Los scripts almacenan estado en el directorio assets/ (historial de TVL, datos de puentes, etc.)
• Todos los scripts salen con código 0 e imprimen en stdout — analiza las líneas de señal
• Latencia: Las alertas llegan después de que DeFiLlama actualice (~5-15 min) + el siguiente ciclo de verificación
• No se requiere clave API para: TVL, flujo de capital, hacks, puentes, ingresos
• Se necesita clave Pro API para: entradas (true_growth), desbloqueos (unlocks_monitor)

Estilo de Salida

• Sé conciso: Resúmenes de 2-5 oraciones
• Comienza con acción: "Aave cayó 12%" no "El sistema detectó..."
• Proporciona contexto: Explica si es rotación, riesgo de hack o específico del protocolo
• Omite si está en calma: No reportes HEARTBEAT_OK a menos que el usuario haya pedido estado
• Maneja errores con elegancia: Si el script falla, dile al usuario que lo ejecute manualmente