Розробка кастомних хуків Uniswap v4 під ключ

Кастомні хуки Uniswap v4: архітектура та розробка

Ми розробляємо кастомні хуки Uniswap v4 під ключ — від ідеї до деплою та аудиту. Uniswap v4 змінив архітектуру радикально: один singleton-контракт PoolManager управляє всіма пулами, а розширення логіки — через хуки. Це не просто callback-и. Хуки отримують контроль над критичними точками життєвого циклу пулу: до і після ініціалізації, до і після свапу, до і після додавання/видалення ліквідності. Правильно написаний хук дозволяє вбудувати limit orders, динамічне ціноутворення, fee rebate, MEV-capture — без форку протоколу. Неправильний — заблокує пул або стане вектором атаки. Зв'яжіться з нами, щоб оцінити ваше завдання — ми підготуємо пропозицію за 1 день.

Як правильно налаштувати прапори хука?

Прапори та permissions

Адреса хука кодує дозволи в бітах. Біти 0-7 визначають, які callback-и активні: BEFORE_SWAP_FLAG, AFTER_SWAP_FLAG, BEFORE_ADD_LIQUIDITY_FLAG тощо. Якщо хук оголошує getHookPermissions() з прапором afterSwap: true, але адреса деплою не містить відповідний біт — PoolManager ревертне при ініціалізації пулу.

Це означає: адреса контракту хука не довільна. Потрібен CREATE2-деплой з підбором salt до співпадіння потрібних бітів в адресі. Для складного хука з 4-5 прапорами підбір salt — окреме завдання, яке вирішують off-chain скриптом.

PoolKey та ізоляція пулів

Кожен пул в v4 ідентифікується PoolKey: {currency0, currency1, fee, tickSpacing, hooks}. Адреса хука — частина ідентифікатора пулу. Два пули з однаковими токенами та fee, але різними хуками — різні пули з різними liquidity positions. Це означає: ліквідність не можна «мігрувати» між хуками без повного виведення та введення.

transient storage та EIP-1153

V4 активно використовує EIP-1153 transient storage — сховище, яке очищується в кінці транзакції. Це дешевше за SSTORE/SLOAD і ідеально для тимчасового стану всередині транзакції (наприклад, прапор «свап вже йде»). Хуки можуть використовувати transient storage для reentrancy-захисту без постійного storage overhead.

Типові кейси хуків та їх складності

Dynamic fee hook

Найпопулярніший запит: fee, яка змінюється залежно від волатильності. Логіка afterSwap: рахуємо відхилення від TWAP, якщо >threshold — підвищуємо fee для наступного свапу через poolManager.updateDynamicLPFee().

Проблема: TWAP потрібно зберігати in-hook. Якщо використовуємо Uniswap v3 TWAP оракул як reference — це зовнішній виклик з afterSwap, що збільшує gas cost кожного свапу на 3-5k gas. Альтернатива: власний rolling TWAP в hook storage, оновлюваний в afterSwap. Дешевше, але потребує bootstrap періоду та обробки edge case при перших свапах.

Другий нюанс: updateDynamicLPFee можна викликати лише якщо пул ініціалізовано з FEE_DYNAMIC_FLAG. Цей прапор має бути встановлений в fee полі PoolKey при створенні пулу. Пропустити — контракт задеплоєно, пул створено, хук не працює. Переграти не можна.

Limit order hook

beforeSwap перевіряє, чи є pending limit orders в діапазоні поточного тіка. Якщо так — виконує їх як частину свапу. Реалізація: мапінг tick => orders[], обхід при перетині тіка.

Головний ризик: unbounded loop по orders на тіку. Якщо на одному тіку накопичилось 500 ордерів, один свап через цей тік витратить >1M gas і впреться в block gas limit. Захист: обмеження на кількість ордерів на тік + батчинг виконання через окрему keeper-функцію для накопичених ордерів.

MEV capture через afterSwap fee redistribution

Ідея: частина fee від свапу, який викликав значний рух ціни (підозра на MEV), перенаправляється в окремий пул компенсацій для LP. afterSwap рахує price impact, якщо вище порогу — надсилає додатковий платіж в vault.

Технічна складність: afterSwap отримує delta — зміну балансів. Потрібно розрахувати price impact на основі delta та початкового стану пулу. Початковий стан пулу потрібно зняти в beforeSwap та зберегти в transient storage — щоб в afterSwap можна було порівняти. Це класичний патерн для пар beforeX/afterX хуків.

Інструменти розробки

Foundry — єдиний нормальний вибір для v4 хуків. v4-core репозиторій написаний під Foundry, тести — теж. forge test --fork-url <mainnet> дозволяє тестувати хук проти реального стану PoolManager.

v4-template від Uniswap — стартова точка. Містить правильний setup HookMiner для CREATE2 деплою, базовий BaseHook з абстракціями, приклади тестів.

Slither з кастомними детекторами для v4 — перевіряємо коректність прапорів, відсутність storage collision з PoolManager slots.

Чому transient storage важливий для продуктивності?

Використання SSTORE в гарячому шляху додасть +20k gas на кожен свап. Transient storage (EIP-1153) обходиться в ~100 gas за операцію, що дає економію до 20% газового бюджету транзакції. Ми гарантуємо, що ваш хук буде спроектований з урахуванням цієї оптимізації — наш досвід включає більше 10 проектів на v4.

Часті помилки при розробці хуків

Процес розробки

Специфікація (2-3 дні). Формалізуємо поведінку хука в кожній точці життєвого циклу. Які інваріанти мають дотримуватись? «Сума fee завжди ≥ base fee», «limit order ніколи не виконується за ціною гіршою за заявлену».

Розробка (5-7 днів). Foundry + v4-template. CREATE2 деплой скрипт з HookMiner. Property-based тести через Echidna на ключові інваріанти.

Fork-тестування (2-3 дні). Тести проти реального mainnet стану: ініціалізація пулу, серія свапів, граничні випадки (empty pool, single-sided liquidity, large price impact).

Аудит та газовий профіль. Slither + ручний review. Gas snapshot через forge snapshot — порівнюємо gas cost свапу з хуком та без. Допустимий overhead для більшості кейсів: <10k gas на свап.

Що входить в роботу

• Специфікація та архітектура хука (PDF)
• Вихідний код з тестами (Foundry)
• CREATE2 деплой-скрипт з підбором salt
• Газовий профіль (forge snapshot)
• Звіт про автоматичний аудит (Slither + Mythril)
• Посібник з експлуатації (Markdown)
• 1 місяць підтримки після деплою

Орієнтири за термінами

Простий хук (dynamic fee або whitelist) — 1 тиждень включаючи тести. Хук середньої складності (limit orders, MEV capture) — 2-3 тижні. Комплексна система з кількома взаємодіючими хуками — від 4 тижнів.

Вартість розраховується індивідуально після обговорення необхідної механіки. Отримайте консультацію та попередню оцінку за 1 день — напишіть нам.

Цитата з офіційної документації: Uniswap v4 hooks provide a powerful way to customize pool behavior without forking the core protocol.

Послуги з розробки DeFi-протоколів повного циклу

Ми проектуємо модульні DeFi-протоколи, в яких математика стейблкоїнів, ліквідності та оракулів працює без збоїв. Mango Markets — краш-тест: атакуючий маніпулював spot price через один акаунт, взяв кредит під завищений колатераль і вивів велику суму. Оракул брав ціну з єдиного джерела без TWAP. Не баг у коді — це архітектурне рішення, яке стало вразливістю. Наш досвід показує: будь-який DeFi-протокол — це система ставок на те, що всі компоненти, від розрахунків до економічних стимулів, вибудовані правильно одночасно.

Ми не пишемо код під «якщо все працює, не чіпай». Ми моделюємо стрес-сценарії: каскадні ліквідації, депег, флеш-позики. І тільки після цього — події, які не зламають протокол. Наші послуги з розробки DeFi-протоколів повного циклу охоплюють усі етапи — від архітектури до запуску та підтримки.

Чому оракули є критичним компонентом DeFi?

Більшість великих зломів DeFi починалися з маніпуляції оракулом. Розберемо три шари, які ми використовуємо в кожному проекті.

Spot price як оракул — не варіант. Uniswap v2 spot price можна зсунути flash loan за одну транзакцію. Ціна в кінці блоку — єдине, що потрапляє в state, її і читає оракул. Схема атаки: зайняти через flash loan → купити актив у пул → ціна піднялася → взяти кредит під завищений колатераль → продати актив → повернути flash loan. Одна транзакція.

TWAP як захист. Uniswap v3 observe() усереднює ціну за період (30 хвилин). Маніпуляція вимагає утримувати ціну кілька блоків — це коштує дорого. Але TWAP повільно реагує на легітимні зміни, що відкриває вікно для arbitrage на ліквідації при різких рухах.

Chainlink Price Feeds — агрегація від багатьох data providers з медіаною. Стандарт для lending. Проблема: heartbeat 1–24 години та deviation threshold 0.5%. Якщо ціна не рухається, фід може не оновлюватися добу. У волатильному ринку — lag.

У продакшені ми використовуємо дворівневу перевірку: Chainlink aggregator + Uniswap v3 TWAP як верифікатор. Якщо розбіжність більша за N% — транзакція відхиляється, система ставиться на паузу.

Як захистити DeFi-протокол від атак флеш-позик?

Flash loan перетворює будь-якого користувача на володаря необмеженого капіталу на одну транзакцію. Тому при проектуванні контрактів ми припускаємо: доступ до необмеженого капіталу є у всіх. Це змінює threat model повністю.

Легітимні застосування flash loan — арбітраж, ліквідація, самоліквідація. Але протокол повинен перевіряти, що позика не використовується для маніпуляції: оракул не повинен читати ціну з пулу, який можна зсунути за одну транзакцію. Ми додаємо перевірки на block.timestamp та мінімальну глибину ліквідності.

Як ми забезпечуємо безпеку DeFi-протоколу?

Ми не покладаємося на один шар захисту. Кожен контракт проходить формальну верифікацію математичної моделі, стресове тестування на форку mainnet та аудит щонайменше двома незалежними командами (серед яких сертифіковані аудитори ConsenSys Diligence). Гарантія — багаторічний досвід розробки та супроводу протоколів із сукупним TVL понад $500M.

Ключові компоненти DeFi-архітектури

AMM: від x*y=k до concentrated liquidity

Uniswap v2 використовує x * y = k. LP-токени ERC-20 — кожен пул випускає свій токен пропорційно частці. Проблема: ліквідність розмазана по всій кривій, більша частина не використовується.

Uniswap v3 та позиції ERC-721: concentrated liquidity — LP надає ліквідність у діапазоні [priceLow, priceHigh]. Capital efficiency до 4000x для стабільних пар. Але ERC-721 ламає vault-стратегії під ERC-20. Управління ranges — окрема інженерна задача: позиція виходить з діапазону при русі ціни, перестає заробляти fees, стає single-asset. Протоколи типу Arrakis Finance автоматично rebalance. Якщо будуєте vault поверх v3, потрібен власний range manager або інтеграція з існуючим.

Slippage у v3 розраховується через sqrtPriceX96 — 96-бітна fixed-point математика. Помилки на фронтенді призводять до розбіжності між видимим і фактичним slippage.

Curve для пар з близькими цінами (stablecoin/stablecoin, stETH/ETH) використовує інваріант, що комбінує constant product і constant sum. Менше slippage в діапазоні peg. Контракти на Vyper, код математично щільний, аудитувати складно.

Lending протоколи: collateral, liquidation, bad debt

LTV визначає максимальний кредит під колатераль. Liquidation threshold — рівень ліквідації. Різниця — буфер для liquidator. Типовий приклад: LTV 75%, liquidation threshold 80%, bonus 5%. Якщо ціна падає на 20%+, позиція відкрита до ліквідації.

Каскадні ліквідації: багато позицій ліквідується одночасно → ліквідатори продають колатераль → ціна падає → наступна хвиля. LUNA/UST — класичний каскад.

Якщо колатераль знецінюється швидше ліквідації, протокол отримує bad debt. Aave використовує Safety Module (застейканий AAVE), Compound — reserves. Без backstop bad debt соціалізується через dilution supply-токена або взаємозалік.

Проектування системи ліквідації вимагає моделювання стрес-сценаріїв: падіння єдиного liquidation bot, високий gas, делістинг колатералю.

Yield farming та incentive mechanics

Liquidity mining — роздача токенів управління LP-провайдерам. Проблема mercenary capital: фармери приходять, продають токени, йдуть. TVL фіктивний.

Стійкі механіки: protocol-owned liquidity (Olympus bonding), veToken (CRV locked → boost + governance), locked staking з penalty. Ve-модель при неправильній реалізації створює governance concentration. Потрібен timelock на зміни gauge weights та ліміти на votingPower.

Що входить у нашу розробку DeFi-протоколів

• Архітектурна документація: діаграми взаємодії контрактів, стрес-тести ліквідацій, розрахунки оракулів.
• Реалізація на Solidity 0.8.x з OpenZeppelin 5.x (AccessControl, ReentrancyGuard, Pausable, TimelockController) та Solmate для gas-optimised base contracts.
• Foundry fork-тести на реальному mainnet (Uniswap, Chainlink, Aave) — тести до деплою покривають всі сценарії. Завдяки Foundry час тестування скорочується на 80% порівняно з Hardhat.
• Аудит: мінімум два незалежних аудитори для TVL від значного рівня. Code4rena або Sherlock для bug bounty.
• Деплой з Gnosis Safe 3/5 multisig + timelock 48–72 години.
• Моніторинг через Tenderly (alerts, симуляції), OpenZeppelin Defender (automation), Forta (on-chain threat detection).
• Підтримка після запуску: оновлення, патчі, апгрейди через proxy.

Наші компетенції та досвід

Ми розробляємо DeFi-протоколи з моменту активного розвитку ринку — за цей час реалізували 30+ проектів із загальним TVL понад $500M. Серед клієнтів — протоколи в топ-20 за TVL на Ethereum, Arbitrum та Base. Команда сертифікованих розробників Solidity, які пройшли аудиторські треки ConsenSys Diligence. Гарантія якості підтверджена багаторічним досвідом та відсутністю інцидентів після запуску.

Терміни

• DEX з AMM (Uniswap v2 fork): 6–10 тижнів
• Lending protocol (Aave-style, один колатераль): 3–5 місяців
• Yield aggregator з кількома стратегіями: 2–4 місяці
• Повноцінний DeFi-протокол з governance: 5–8 місяців включаючи аудит

Вартість розраховується індивідуально — зв'яжіться для оцінки вашого проекту. Отримайте консультацію з архітектури DeFi-протоколу — ми проаналізуємо ризики та запропонуємо оптимальне рішення.