Розробка автоматичного менеджера LP-позицій (Uniswap v3)

Розробка автоматичного менеджера LP-позицій (Uniswap v3)

Uniswap v3 зробив провайдерів ліквідності значно効率ніше по капіталу — та значно більш вимогливими до активного управління. Позиція у діапазоні $1800-$2200 за ETH заробляє комісії тільки поки ціна ETH у цьому діапазоні. Як тільки ціна йде за границю — позиція перестає заробляти та перетворюється на утримання одного з двох токенів. Без автоматичного ребалансувача більшість LP-позицій у v3 працюють неефективно.

Механіка концентрованої ліквідності

Як считаються fee у v3

У Uniswap v3 ліквідність додається у конкретний діапазон тиків. Tick — дискретна одиниця ціни, кожен тік ≈ 0.01% зміна ціни. Діапазон [tickLower, tickUpper] визначає, при яких цінах позиція активна.

Накопичені комісії зберігаються через глобальні змінні feeGrowthGlobal0X128 та feeGrowthGlobal1X128. Для конкретної позиції — різниця між поточними значеннями та снапшотом у момент створення, скоригована на тики поза діапазоном. Це O(1) розрахунок — без ітерації по всіх позиціях.

Сбір комісій: NonfungiblePositionManager.collect() переводить накопичені fee0 та fee1 на адресу власника. Вызов collect без закриття позиції — нормальна операція, зазвичай вигідна при накопичених комісіях > gas cost.

Impermanent loss у v3

У v2 impermanent loss — функція від співвідношення цін. У v3 — функція від співвідношення цін та від вибраного діапазону. Вузький діапазон дає більше комісій при перебуванні у діапазоні, але експоненціально зростаючий IL при виходу з нього. Широкий діапазон — менше комісій, менше IL.

Оптимальна ширина діапазону залежить від волатильності конкретної пари. Для пари USDC/USDT на тіку 1 — діапазон у кілька тиків. Для ETH/USDC з денною волатильністю 3-5% — потрібен діапазон ±20-30% від поточної ціни щоб не ребалансувати занадто часто.

Архітектура автоматичного менеджера

Стратегія ребалансировки

Є кілька підходів:

Fixed-width rebalance — найпростіше. При виходу ціни з діапазону створити нову позицію навколо поточної ціни з тією ж шириною. Проблема: частий ребаланс при боковому русі близько границі — кожен ребаланс коштує газу та платить slippage при своп для вирівнювання співвідношення.

Bollinger Bands — динамічна ширина діапазону на основі 20-денного стандартного відхилення ціни. При високій волатильності — широкий діапазон, при низькій — вузький. Реалізується off-chain: keeper-бот розраховує оптимальний діапазон по історичним даним та викликає ребаланс тільки коли поточний діапазон значно гірше оптимального.

Asymmetric ranges — якщо є погляд на напрям ринку, можна робити несиметричний діапазон. Bullish — більше діапазону вверх. Але це вже активна торгова стратегія, не просто менеджмент ліквідності.

On-chain компоненти

Смарт-контракт менеджера реалізує:

interface ILPManager {
    // Створення позиції
    function mint(
        address token0, address token1, uint24 fee,
        int24 tickLower, int24 tickUpper,
        uint256 amount0Desired, uint256 amount1Desired
    ) external returns (uint256 tokenId);
    
    // Сбір комісій
    function collectFees(uint256 tokenId) external returns (uint256 amount0, uint256 amount1);
    
    // Ребалансировка
    function rebalance(
        uint256 tokenId,
        int24 newTickLower, int24 newTickUpper,
        uint256 swapAmountIn, bytes calldata swapData
    ) external;
}

swapData у rebalance() — calldata для своп через Uniswap v3 Router або 1inch для вирівнювання співвідношення токенів перед створенням нової позиції. Конкретний маршрут розраховується off-chain та передається у транзакцію.

ERC-721 ownership: NFT позиції Uniswap v3 можуть знаходитися або у користувача напрямо, або у контракті менеджера. Якщо у менеджера — потрібна система обліку «хто володіє чим». Якщо у користувача — потрібен approve менеджеру для управління. Другий підхід простіше аудируется.

Off-chain keeper

TypeScript-бот мониторит позиції кожні N блоків:

1. Отримати поточну ціну через slot0() пулу
2. Для кожної managed позиції — перевірити знаходиться ли ціна у діапазоні
3. Якщо поза діапазоном — розрахувати новий оптимальний діапазон
4. Розрахувати необхідний своп для вирівнювання співвідношення токенів
5. Оцінити cost/benefit: газ + IL на своп vs очікувані комісії у новому діапазоні
6. Якщо прибутково — вызвати rebalance()

Важливо: порівнювати expectedAnnualizedFees - rebalanceCost > holdCost. Немає смислу ребалансувати позицію на $1000 якщо газ $50 та своп втрачає ще $30.

Сбір та реінвестування комісій

Автоматичне reinvesting — auto-compound: сбір комісій, додавання їх назад у позицію. Це збільшує ліквідність та майбутні комісії. Але кожен compound — транзакція з газом. Оптимально compound при накопичених комісіях > gas_cost * 10.

Протоколи типу Arrakis Finance та Gamma автоматизують це та беруть % від комісій як fee. При розробці власного менеджера — вирішити: брати management fee (% TVL щорічно) чи performance fee (% від комісій)?

Орієнтири за часом

Смарт-контракт менеджера з базовою стратегією ребалансировки — 1-2 тижні. Keeper-бот + мониторинг + UI для управління позиціями — додає 1-2 тижні. Просунута стратегія з Bollinger Bands та симуляцією — від 4 тижнів.

Вартість розраховується після обговорення стратегії та вимог.