Разработка системы расчета impermanent loss
LP-позиция в USDC/ETH пуле на Uniswap V2 открыта при цене ETH $2000. Через 3 месяца ETH стоит $3500. Пользователь видит в интерфейсе «+$847 прибыль», закрывает позицию — и получает меньше, чем если бы просто держал ETH. Это и есть impermanent loss. Задача системы — показать эту разницу чётко, до и после, с прогнозом при разных ценовых сценариях.
Математика IL — где ошибаются реализации
Формула для Uniswap V2 (constant product)
Impermanent loss как функция ценового отношения k = P_current / P_initial:
IL = 2 * sqrt(k) / (1 + k) - 1
При k=1 (цена не изменилась) — IL=0. При k=4 (цена выросла в 4 раза) — IL≈-5.72%. При k=0.25 (цена упала в 4 раза) — тот же -5.72% (симметрично).
Реализация в JavaScript/TypeScript через BigNumber или decimal.js — обязательна для точности. Использование Math.sqrt(k) на обычных float-числах даёт погрешность при очень больших или малых значениях k. При k=0.000001 (99.9999% падение) нативный float потеряет значимые цифры.
Concentrated liquidity (Uniswap V3) — другая математика
Для V3 позиции с диапазоном [Pa, Pb] и текущей ценой P формула IL значительно сложнее. Она зависит от того, находится ли P внутри диапазона или вышел за его пределы:
P внутри [Pa, Pb]:
value_LP = liquidity * (sqrt(P) - sqrt(Pa)) + liquidity * (1/sqrt(P) - 1/sqrt(Pb))
value_hodl = amount0_initial * P + amount1_initial
IL = value_LP / value_hodl - 1
P < Pa (вышел ниже диапазона): вся позиция конвертирована в token1 (USDC), IL рассчитывается как если бы LP продал весь token0 по цене Pa в момент выхода из диапазона и держал token1 до текущего момента.
P > Pb: вся позиция в token0 (ETH), аналогично.
Это нетривиальная логика, которую многие калькуляторы IL игнорируют и считают по упрощённой формуле V2 — давая неверные результаты для V3 позиций на 40-70%.
Учёт накопленных fees
IL — это разница между hodl и LP стратегией. Но LP также зарабатывает торговые комиссии. Правильная метрика: net P&L = fees collected - impermanent loss.
Для исторического расчёта: запросить события Collect(tokenId, recipient, amount0, amount1) из The Graph или Uniswap V3 subgraph, суммировать по позиции. Сравнить с IL рассчитанным по историческим ценам на момент открытия позиции.
Ошибка в расчёте: многие берут текущий баланс позиции и сравнивают с initial deposit по текущим ценам — это не учитывает уже снятые fees и уже пройденный ценовой путь. Нужно reconstruction исторического состояния: начальный депозит → каждый collect → текущее состояние.
Архитектура системы
Источники данных
On-chain через The Graph — Uniswap V3 subgraph на mainnet (и L2: Arbitrum, Optimism, Polygon) содержит все события по позициям: positions, positionSnapshots, collects, transactions. GraphQL запрос по tokenId возвращает полную историю.
Chainlink Historical Prices — для исторических цен на момент открытия/закрытия используем Chainlink getRoundData(roundId). Нужно найти roundId, соответствующий нужному timestamp — через бинарный поиск по latestRoundData и getRoundData.
Альтернатива: CoinGecko API /coins/{id}/market_chart для историческиx OHLCV данных — проще, но добавляет внешнюю зависимость и ограничения rate limit.
Uniswap V3 SDK — Position.fromAmounts(), Position.token0PriceLower, Position.token1PriceUpper для расчёта текущего состояния позиции по tick и liquidity данным из контракта.
Прогнозный расчёт
Пользователь хочет увидеть: «если ETH вырастет до $5000, мой IL составит X, fees Y, net P&L Z».
Алгоритм:
- Из текущей позиции: liquidity, tickLower, tickUpper, accumulated fees
- Задать целевую цену как параметр
- Рассчитать новое распределение token0/token1 при целевой цене через Uniswap V3 SDK
- Рассчитать IL = (value_at_target - hodl_value_at_target) / hodl_value_at_target
- Для fees: экстраполяция через исторические данные объёма торгов в пуле (The Graph) умноженные на fee rate
Честный прогноз fees: fees зависят от объёма торгов и от того, остаётся ли позиция in-range. Если при целевой цене позиция выходит за диапазон — fees перестают начисляться. Это часто упускают.
Визуализация
Ключевые графики:
- IL vs Price chart: кривая IL как функция от цены для current position + comparison с hodl. Для V3 — с маркерами границ диапазона.
- Break-even price: при какой цене накопленные fees покрывают IL. Горизонтальная линия net P&L = 0.
- Historical P&L timeline: по дням, с разбивкой fees vs IL.
Стек: React + recharts или Victory. Данные через собственный API (Node.js + PostgreSQL для кэширования исторических данных) + прямые calls к The Graph GraphQL.
| Компонент | Источник данных | Обновление |
|---|---|---|
| Текущая позиция | Uniswap V3 NonfungiblePositionManager | При каждом запросе |
| Исторические цены | Chainlink / CoinGecko | Кэш 1 час |
| Accumulated fees | The Graph subgraph | Кэш 5 мин |
| Исторические снапшоты | The Graph positionSnapshots | Кэш 1 час |
Процесс работы
Аналитика (1 день). Определяем: только Uniswap V3 или нужен V2/Curve/Balancer (у каждого своя математика IL). Какие сети: mainnet + L2.
Разработка (3-5 дней). Математические функции → data fetching слой → API → frontend charts. TypeScript + Zod для валидации данных из The Graph (subgraph может вернуть null для молодых позиций).
Ориентиры по срокам
Калькулятор для V2 позиций с историческим расчётом — 3 дня. Полная система с V3 concentrated liquidity, прогнозным калькулятором и визуализацией — 5-7 дней.
Стоимость рассчитывается индивидуально.