Мониторинг ликвидности DeFi-протокола
Протокол с $50M TVL без мониторинга ликвидности — это не экономия на инструментах, это слепое управление риском. Когда 30% ликвидности уходит из пула за 4 часа из-за whale withdrawal, у команды есть два варианта: узнать об этом через алерт и принять меры, или узнать из твита о том, что пользователи не могут совершить своп из-за high slippage.
Что мониторить и почему это нетривиально
Концентрация ликвидности в Uniswap v3
В Uniswap v2 общая ликвидность — понятная метрика: reserve0 * reserve1 = k, чем больше k, тем лучше слиппеж. В Uniswap v3 ликвидность концентрирована по тикам. Пул может иметь $10M TVL, но если 95% сосредоточено в диапазоне ±2% от текущей цены — при выходе цены из этого диапазона effective liquidity падает в 20 раз.
Правильный мониторинг: не просто totalValueLocked, а activeLiquidity — ликвидность в активном диапазоне вокруг текущей цены. Метрика из Uniswap v3 субграфа:
query ActiveLiquidity {
pool(id: "0x...") {
liquidity
sqrtPrice
tick
ticks(where: { liquidityNet_not: "0" }, orderBy: tickIdx) {
tickIdx
liquidityNet
}
}
}
Из этих данных строим depth chart: сколько ликвидности доступно при ±1%, ±5%, ±10% движении цены.
Whale withdrawal detection
Крупный LP может единовременно вывести ликвидность, обрушив depth на конкретном рынке. Для протокола, который зависит от ликвидности в определённых пулах (например, стейблкоин-пуле для redemption), это критический риск.
Мониторим события Burn (Uniswap v3) и RemoveLiquidity (Curve, Balancer) через WebSocket подписку. Если один LP выводит >10% от total liquidity — алерт немедленно.
Стек мониторинга
Сбор данных
Три слоя источников:
On-chain события (realtime). ethers.js WebSocket подписка на Sync, Swap, Mint, Burn события целевых контрактов. Задержка — секунды от подтверждения транзакции. Нужна собственная нода или WSS от Alchemy/Infura с поддержкой eth_subscribe.
The Graph субграфы (с задержкой 1-5 минут). Удобен для агрегированных метрик — hourly/daily TVL, volume, fees. Для исторических данных и трендов. Официальные субграфы Uniswap, Curve, Balancer, Aave, Compound доступны в The Graph Explorer.
DeFi Llama API (с задержкой 10-60 минут). Удобен для cross-protocol TVL сравнений и общей картины. Не подходит для realtime алертов.
Хранение и визуализация
TimescaleDB (PostgreSQL extension) — оптимален для time-series данных о ликвидности. Партиционирование по времени, гипертаблицы для автоматического архивирования исторических данных.
Grafana + TimescaleDB datasource — стандартный стек для дашборда. Преднастроенные панели для:
- TVL по пулам в реальном времени
- Depth chart (доступная ликвидность при заданном slippage)
- Volume/liquidity ratio (индикатор стресса)
- Top LP-провайдеры и их доля
Система алертов
| Метрика | Порог предупреждения | Порог критический | Канал |
|---|---|---|---|
| TVL drop | -10% за 1 час | -25% за 1 час | Telegram |
| Single LP withdrawal | >5% total liquidity | >15% total liquidity | PagerDuty |
| Slippage (1% trade) | >0.5% | >2% | Telegram |
| Price deviation from oracle | >2% | >5% | PagerDuty |
| Utilization (lending) | >80% | >95% | PagerDuty |
PagerDuty или OpsGenie для критических алертов — push-уведомление на телефон, независимо от времени суток. Telegram-бот для информационных уведомлений.
Tenderly Alerts — альтернатива для on-chain событий без собственной инфраструктуры: настраиваешь триггеры через UI, webhook на Discord/Slack/Telegram.
APY расчёт и мониторинг
APY в DeFi непостоянен: зависит от volume (trading fees), токен-эмиссии (liquidity mining rewards) и базовой ставки (для лендинга).
Формула для LP APY в Uniswap v3:
dailyFees = pool.volumeUSD24h * feeTier / 1_000_000
feeAPR = (dailyFees / pool.tvlUSD) * 365
При TVL $1M и дневном объёме $2M на пуле с fee 0.05% (500): dailyFees = $1000, feeAPR = 36.5%. Но это на весь TVL. LP с концентрированной позицией в активном диапазоне зарабатывает больше пропорционально своей effective liquidity.
Мониторим APY по каждому пулу с alerting при резком падении — это сигнал о снижении торговой активности или о том, что объём ушёл на конкурирующий пул.
Процесс внедрения
Инвентаризация (1 день). Список всех контрактов, событий, метрик для мониторинга. Приоритизация: что критично для работы протокола.
Настройка сбора данных (1-2 дня). WebSocket indexer на Node.js/TypeScript, запись в TimescaleDB. Для исторических данных — первичная синхронизация через The Graph.
Дашборд (1 день). Grafana с основными панелями. Не нужно делать красиво — нужно делать читаемо и с правильными временными окнами.
Алерты (1 день). Пороги на основе исторических данных протокола. Слишком чувствительные алерты — команда перестаёт на них реагировать. Начинаем с 5-6 критических метрик.
Ориентиры по срокам
Базовый мониторинг одного протокола (TVL, события, алерты) — 3-5 дней. Комплексный мониторинг нескольких протоколов с depth chart, APY трекингом и кастомным дашбордом — до 2 недель.