Neros0/defillama-watchdog

Watchdog de Protocolos DeFiLlama

Monitore protocolos DeFi para quedas de TVL, rotação de capital, riscos de segurança e oportunidades de mercado.

Quando Usar

• O usuário deseja monitorar ou rastrear protocolos específicos (ex.: "vigie Aave", "alerte-me se Uniswap cair")
• O usuário solicita uma auditoria de segurança, verificação de risco ou briefing completo
• O usuário quer alertas de rotação ou atualizações de sentimento (análise de fluxo de capital)
• O usuário deseja verificar se protocolos foram hackeados (segurança do portfólio)

Não use para consultas pontuais como "qual é o TVL da Aave?" — responda diretamente a essas perguntas.

Comandos Disponíveis

Todos os comandos são executados a partir da raiz da skill. Adicione --json para saída estruturada.

Comando	Propósito	Sinais de Saída
python3 scripts/watchdog.py	Verificar quedas de TVL	ALERT: ou HEARTBEAT_OK
python3 scripts/capital_flow.py	Rotação de capital e sentimento	ROTATION:, SENTIMENT: ou HEARTBEAT_OK
python3 scripts/bridge_monitor.py	Picos de volume em pontes	BRIDGE_SURGE: ou HEARTBEAT_OK
python3 scripts/metrics_guard.py	Portfólio vs. Hacks recentes	EMERGENCY: ou HEARTBEAT_OK
python3 scripts/true_growth.py	Dinheiro inteligente (TVL cai, entradas sobem)	BULLISH_DIVERGENCE: ou HEARTBEAT_OK
python3 scripts/unlocks_monitor.py	Riscos de desbloqueio de tokens	DUMP_RISK: ou HEARTBEAT_OK
python3 scripts/revenue_guard.py	Crescimento de receita/taxas	VALUE: ou HEARTBEAT_OK
python3 scripts/full_briefing.py	Executar todas as verificações	Todos os sinais combinados

Como Responder

Quando o Usuário Solicitar uma Verificação

1. Execute o(s) script(s) apropriado(s)
2. Analise os sinais de saída:
   • HEARTBEAT_OK = Tudo limpo
   • ALERT: = TVL caiu além do limite
   • EMERGENCY: = Protocolo do portfólio foi hackeado
   • ROTATION: = Capital migrando entre blockchains
   • SENTIMENT: = Sinal de risco-on/risco-off
   • BRIDGE_SURGE: = Pico de volume em ponte (chain aquecida)
   • BULLISH_DIVERGENCE: = TVL caiu, mas entradas aumentaram
   • DUMP_RISK: = Grande desbloqueio se aproxima
   • VALUE: = Receita crescendo mais rápido que o preço
3. Sintetize os resultados em 2-5 frases explicando o que aconteceu e por que é relevante

Padrão de Resposta para Alertas

Ao detectar um sinal de risco:

1. Comece pela descoberta principal (queda de TVL, hack, rotação)
2. Adicione contexto a partir de outros sinais:
   • Se ALERT: → execute capital_flow.py para verificar se é rotação ou específico do protocolo
   • Se existir portfólio → execute metrics_guard.py para verificar risco de hack
   • Opcionalmente execute outras verificações para profundidade (desbloqueios, entradas, receita)
3. Dê uma conclusão clara (o que o usuário deve fazer?)

Exemplo de Síntese

Ruim: "ALERT: AAVE V3 TVL caiu 12,3%. ROTATION: Oferta de stablecoin na Ethereum encolheu 1,5%."

Bom: "O TVL da Aave V3 caiu 12,3% no último período. Isso parece estar ligado a uma rotação de capital mais ampla — a oferta de stablecoin na Ethereum está caindo enquanto a Solana está crescendo. Não é um risco específico do protocolo, mas fique atento a saídas contínuas."

Solicitações Comuns dos Usuários

"Me alerte se [protocolo] cair mais de X%"

• Certifique-se de que config.json tenha watch_list correta (use slugs da DeFiLlama) e threshold
• Explique que o watchdog é executado em cronograma e alertará quando o limite for violado

"Execute uma auditoria de segurança" / "Briefing completo" / "Verificação de risco"

• Execute python3 scripts/full_briefing.py
• Sintetize todos os sinais de saída em uma única narrativa

"Houve rotação de capital?" / "Atualização de sentimento?"

• Execute python3 scripts/capital_flow.py
• Relate os sinais ROTATION: e SENTIMENT:, ou diga "nenhum movimento significativo"

"Algum dos meus protocolos foi hackeado?"

• Execute python3 scripts/metrics_guard.py
• Requer assets/portfolio.json (IDs de protocolo da DeFiLlama)
• Relate EMERGENCY: imediatamente se encontrado

"Verificação manual agora"

• Execute python3 scripts/watchdog.py
• Relate os resultados ou confirme "tudo dentro do limite"

Configuração

Arquivo: config.json na raiz da skill

Configurações principais:

• watch_list: Array de slugs de protocolo da DeFiLlama (ex.: ["aave-v3", "uniswap", "lido"])
• threshold: Decimal para o limite de alerta (ex.: 0.10 = queda de 10%)
• risk_level: "high" (5%), "standard" (10%), "low" (15%)
• Ativação de módulos: capital_flow.enabled, metrics_guard.enabled, bridge.enabled, etc.

Rastreamento de portfólio: Crie assets/portfolio.json com IDs de protocolo da DeFiLlama para alertas de hack/desbloqueio.

Recursos Pro: Alguns recursos (entradas, desbloqueios) precisam de DEFILLAMA_PRO_API_KEY no ambiente. A maioria dos recursos funciona sem nenhuma chave de API.

Notas Importantes

• Os slugs de protocolo devem corresponder exatamente aos da DeFiLlama (verifique defillama.com/protocols)
• Os scripts armazenam estado no diretório assets/ (histórico de TVL, dados de ponte, etc.)
• Todos os scripts saem com código 0 e imprimem no stdout — analise as linhas de sinal
• Latência: Alertas chegam após atualizações da DeFiLlama (~5-15 min) + próximo ciclo de verificação
• Nenhuma chave de API necessária para: TVL, fluxo de capital, hacks, pontes, receita
• Chave da API Pro necessária para: entradas (true_growth), desbloqueios (unlocks_monitor)

Estilo de Saída

• Seja conciso: Resumos de 2-5 frases
• Comece pela ação: "Aave caiu 12%" não "O sistema detectou..."
• Forneça contexto: Explique se é rotação, risco de hack ou específico do protocolo
• Ignore quando tranquilo: Não relate HEARTBEAT_OK a menos que o usuário tenha solicitado status
• Lide com erros graciosamente: Se o script falhar, diga ao usuário para executar manualmente