Інтеграція з Arrakis Finance (управління ліквідністю)
Uniswap v3 з концентрованою ліквідністю вимагає активного управління позиціями. LP, який виставив ліквідність у діапазон $1800-$2200 для ETH/USDC, заробляє комісію тільки поки ціна всередину діапазону. Коли ETH уходит на $2500 — позиція конвертується цілком в USDC, комісія не нараховується. Ребалансувати вручну на mainnet при кожному русі — дорого і нереалістично.
Arrakis Finance (раніше G-UNI) вирішує це: vault-контракт тримає позицію Uniswap v3 та ребалансує автоматично за стратегією. LP депонує токени в Arrakis vault, отримує ERC-20 представлення позиції, vault управляє тиками. Інтеграція Arrakis в власний DeFi-продукт — способ запропонувати пасивне LP без операційних витрат користувачів.
Архітектура Arrakis v2
Arrakis v2 побудована на трьох компонентах:
ArrakisV2 vault — ERC-20 токен, який представляє долю в позиції. Кожен vault привязаний до конкретної пари токенів. Vault може тримати кілька позицій Uniswap v3 одночасно (multi-range), а не одну.
Manager — адреса (або контракт), якому дозволено викликати rebalance. Це може бути multisig, Gelato automated executor, або кастомний стратегічний контракт. Менеджер визначає, коли і як ребалансувати.
ArrakisV2Resolver — вспомогательний контракт для розрахунку: скільки токенів потрібно депонувати для отримання заданої кількості shares, який діапазон оптимален для поточної волатильності.
Ключові методи для інтеграції
mint(uint256 mintAmount, address receiver) — депозит ліквідності. Перед вызовом потрібно approve обидва токена пари на адреса vault. Кількість токенів для заданого mintAmount розраховується через getMintAmounts в Resolver.
burn(uint256 burnAmount, address receiver) — вивід ліквідності. Vault спалює shares, повертає пропорційну долю обох токенів.
rebalance(...) — доступно тільки manager'у. Приймає нові діапазони та розподіл ліквідності між ними. Типова стратегія: широкий діапазон (базова позиція, 80% ліквідності) + вузький діапазон навколо поточної ціни (активна позиція, 20%).
Типічна помилка: approve одного токена
getMintAmounts(uint256 amount0Max, uint256 amount1Max) повертає (amount0, amount1, mintAmount) — скільки конкретно кожного токена буде використано. Інтегратори іноді роблять approve тільки одного токена або неправильної суми, що призводить до revert в mint. Потрібно approve обох токенів на amount0 та amount1 відповідно, не amount0Max.
Другий нюанс: vault може містити «idle» токени (не розміщені в позиції Uniswap). Розрахунок getMintAmounts це враховує — пропорції можуть бути нелінійними.
Сценарії використання в продукті
Протокол з treasury ліквідністю. DAO або протокол розміщує treasury токени в Arrakis vault замість прямого Uniswap v3. Автоматична ребалансування зберігає ліквідність у робочому діапазоні без ручного управління.
Користувальське LP через упрощений інтерфейс. Ваш frontend показує одну кнопку «Додати ліквідність» — під капотом депозит в Arrakis vault. Користувач не вибирає тики, не думає про ребалансування.
Пари токенів протоколу. Якщо у вас є власний токен, Arrakis vault для пари Token/USDC забезпечить стійку ліквідність навіть при волатильності.
Інтеграція через SDK
Arrakis надає TypeScript SDK для розрахунків та формування транзакцій. Для прямої інтеграції достатньо ABI vault та Resolver. Приклад flow на viem:
// 1. Отримуємо потрібні суми токенів
const { amount0, amount1, mintAmount } = await resolver.read.getMintAmounts([
vaultAddress, amount0Max, amount1Max
])
// 2. Approve обидва токена
await token0.write.approve([vaultAddress, amount0])
await token1.write.approve([vaultAddress, amount1])
// 3. Mint shares
await vault.write.mint([mintAmount, userAddress])
Процес розробки
Аналіз vault'а (1 день). Вивчаємо конкретний Arrakis vault: стратегія менеджера, історія ребалансування, поточні діапазони, APR із комісій.
Інтеграція контрактів (1-2 дні). Якщо потрібна on-chain інтеграція (наприклад, ваш контракт депонує в Arrakis) — пишемо адаптер.
Frontend та UX (1-2 дні). Форма депозиту/вивід, відображення поточної позиції, накопичених комісій.
Оцінки за часом
Базова інтеграція існуючого Arrakis vault в frontend — 2-4 дні. Розробка кастомного vault з власною стратегією ребалансування — 1-2 тижні.