Розробка системи розрахунку 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 для історичних 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 як функція ціни для поточної позиції + порівняння з 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.
| Компонент | Джерело даних | Оновлення |
|---|---|---|
| Поточна позиція | 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 днів.
Вартість рахується індивідуально.