DeFiLlama 프로토콜 Watchdog
DeFi 프로토콜의 TVL 하락, 자본 이동, 보안 위험 및 시장 기회를 모니터링합니다.
사용 시점
- 사용자가 특정 프로토콜을 모니터링하거나 추적하려고 할 때 (예: "Aave 감시", "Uniswap 하락 시 알림")
- 사용자가 보안 감사, 위험 점검, 또는 전체 브리핑을 요청할 때
- 사용자가 로테이션 알림이나 시장 심리 업데이트 (자본 흐름 분석)를 원할 때
- 사용자가 프로토콜 해킹 여부를 확인하려고 할 때 (포트폴리오 안전)
사용하지 말아야 할 때: "Aave의 TVL이 얼마인가요?"와 같은 단순 질문은 직접 답변하세요.
사용 가능한 명령어
모든 명령어는 스킬 루트 디렉토리에서 실행합니다. --json 플래그를 추가하여 구조화된 출력을 받을 수 있습니다.
| 명령어 | 목적 | 출력 신호 |
|---|---|---|
python3 scripts/watchdog.py | TVL 하락 확인 | ALERT: 또는 HEARTBEAT_OK |
python3 scripts/capital_flow.py | 자본 이동 및 시장 심리 | ROTATION:, SENTIMENT:, 또는 HEARTBEAT_OK |
python3 scripts/bridge_monitor.py | 브리지 볼륨 급증 | BRIDGE_SURGE: 또는 HEARTBEAT_OK |
python3 scripts/metrics_guard.py | 포트폴리오 대 최근 해킹 | EMERGENCY: 또는 HEARTBEAT_OK |
python3 scripts/true_growth.py | 스마트 머니 (TVL 하락, 유입 증가) | BULLISH_DIVERGENCE: 또는 HEARTBEAT_OK |
python3 scripts/unlocks_monitor.py | 토큰 언락 위험 | DUMP_RISK: 또는 HEARTBEAT_OK |
python3 scripts/revenue_guard.py | 수익/수수료 성장 | VALUE: 또는 HEARTBEAT_OK |
python3 scripts/full_briefing.py | 모든 점검 실행 | 모든 신호 종합 |
응답 방법
사용자가 점검을 요청할 때
- 적절한 스크립트 실행
- 출력 신호 분석:
HEARTBEAT_OK= 이상 없음ALERT:= TVL이 임계값 이상 하락EMERGENCY:= 포트폴리오 프로토콜 해킹 발생ROTATION:= 체인 간 자본 이동 중SENTIMENT:= 위험 선호/회피 신호BRIDGE_SURGE:= 브리지 볼륨 급증 (핫 체인)BULLISH_DIVERGENCE:= TVL 하락 중이지만 유입 증가DUMP_RISK:= 대규모 언락 예정VALUE:= 수익이 가격보다 빠르게 성장 중
- 결과 종합하여 2-5문장으로 상황과 중요도 설명
알림 응답 패턴
위험 신호를 감지했을 때:
- 핵심 발견 사항으로 시작 (TVL 하락, 해킹, 로테이션)
- 다른 신호로 맥락 추가:
ALERT:발생 시 →capital_flow.py실행하여 로테이션인지 프로토콜 특화 문제인지 확인- 포트폴리오가 있을 경우 →
metrics_guard.py실행하여 해킹 위험 확인 - 선택적으로 기타 검사 실행 (언락, 유입, 수익)
- 명확한 시사점 제시 (사용자가 무엇을 해야 하는가?)
예시 요약
나쁜 예: "ALERT: AAVE V3 TVL이 12.3% 하락했습니다. ROTATION: 이더리움의 스테이블코인 공급이 1.5% 감소했습니다."
좋은 예: "Aave V3 TVL이 지난 기간 동안 12.3% 하락했습니다. 이는 더 넓은 자본 이동과 관련된 것으로 보입니다. 이더리움의 스테이블코인 공급은 감소하는 반면 솔라나는 증가하고 있습니다. 프로토콜 특화 위험은 아니지만, 지속적인 유출을 주시해야 합니다."
일반적인 사용자 요청
"[프로토콜]이 X% 이상 하락하면 알려줘"
config.json에 올바른watch_list(DeFiLlama 슬러그 사용)와threshold가 있는지 확인- 워치독이 예약된 일정에 따라 실행되며 임계값을 위반하면 알림이 전송된다고 설명
"보안 감사 실행" / "전체 브리핑" / "위험 점검"
python3 scripts/full_briefing.py실행- 모든 출력 신호를 하나의 스토리로 종합
"자본 이동 있나요?" / "시장 심리 업데이트?"
python3 scripts/capital_flow.py실행ROTATION:및SENTIMENT:신호 보고, 또는 "중요한 움직임 없음"이라고 답변
"내 프로토콜 중 해킹당한 것이 있나요?"
python3 scripts/metrics_guard.py실행assets/portfolio.json(DeFiLlama 프로토콜 ID) 필요- 발견 시 즉시
EMERGENCY:보고
"지금 수동 확인"
python3 scripts/watchdog.py실행- 결과 보고 또는 "모든 값이 임계값 이내" 확인
설정
파일: 스킬 루트 디렉토리의 config.json
주요 설정:
watch_list: DeFiLlama 프로토콜 슬러그 배열 (예:["aave-v3", "uniswap", "lido"])threshold: 알림 임계값 소수 (예:0.10= 10% 하락)risk_level:"high"(5%),"standard"(10%),"low"(15%)- 기능 토글:
capital_flow.enabled,metrics_guard.enabled,bridge.enabled등
포트폴리오 추적: assets/portfolio.json을 생성하여 해킹/언락 알림에 사용할 DeFiLlama 프로토콜 ID를 추가하세요.
Pro 기능: 일부 기능(유입, 언락)은 환경 변수 DEFILLAMA_PRO_API_KEY가 필요합니다. 대부분의 기능은 API 키 없이 작동합니다.
중요 참고 사항
- 프로토콜 슬러그는 DeFiLlama과 정확히 일치해야 합니다 (defillama.com/protocols에서 확인)
- 스크립트는
assets/디렉토리에 상태를 저장합니다 (TVL 기록, 브리지 데이터 등) - 모든 스크립트는 exit 0으로 종료되며 stdout에 출력합니다 — 신호 라인을 파싱하세요
- 지연 시간: DeFiLlama 업데이트 후 + 다음 검사 주기까지 약 5-15분 소요
- API 키 불필요: TVL, 자본 이동, 해킹, 브리지, 수익
- Pro API 키 필요: 유입 (true_growth), 언락 (unlocks_monitor)
출력 스타일
- 간결하게: 2-5문장 요약
- 행동으로 시작: "시스템이 감지한 내용"이 아닌 "Aave 12% 하락"
- 맥락 제공: 로테이션, 해킹 위험 또는 프로토콜 특화 문제인지 설명
- 조용할 때 생략: 사용자가 상태를 요청하지 않는 한
HEARTBEAT_OK는 보고하지 않음 - 오류 처리 우아하게: 스크립트 실패 시 사용자에게 수동 실행을 안내