Разработка кастомных хуков 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 через один аккаунт, взял кредит под завышенный collateral и вывел $114 млн. Оракул брал цену с единственного источника без TWAP. Не баг в коде — это архитектурное решение, которое стало уязвимостью. Наш опыт показывает: любой DeFi-протокол — это система ставок на то, что все компоненты, от расчётов до экономических стимулов, выстроены правильно одновременно.

Мы не пишем код под «если всё работает, не трогай». Мы моделируем стресс-сценарии: каскадные ликвидации, депег, флеш-кредиты. И только после этого — события, которые не сломают протокол.

Почему оракулы — критический компонент DeFi?

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

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

TWAP как защита. Uniswap v3 observe() усредняет цену за период (30 минут). Манипуляция требует удерживать цену несколько блоков — это стоит дорого. Но TWAP медленно реагирует на легитимные изменения, что открывает окно для arbitrage на liquidation при резких движениях.

Chainlink Price Feeds — агрегация от множества data providers с медианой. Стандарт для lending. Проблема: heartbeat 1–24 часа и deviation threshold 0.5%. Если цена не двигается, фид может не обновляться сутки. В волатильном рынке — lag.

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

Как защитить DeFi-протокол от flash loan атак?

Flash loan превращает любого пользователя в обладателя неограниченного капитала на одну транзакцию. Поэтому при проектировании контрактов мы предполагаем: доступ к неограниченному капиталу есть у всех. Это меняет threat model полностью.

Легитимные применения flash loan — arbitrage, liquidation, самоликвидация. Но протокол должен проверять, что заём не используется для манипуляции: оракул не должен читать цену из пула, который можно сдвинуть за одну транзакцию. Мы добавляем проверки на block.timestamp и минимальную глубину ликвидности.

Ключевые компоненты 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 определяет максимальный кредит под collateral. Liquidation threshold — уровень ликвидации. Разница — буфер для liquidator. Типичный пример: LTV 75%, liquidation threshold 80%, bonus 5%. Если цена падает на 20%+, позиция открыта к ликвидации.

Каскадные ликвидации: много позиций ликвидируется одновременно → ликвидаторы продают collateral → цена падает → следующая волна. LUNA/UST 2022 — классический каскад.

Если collateral обесценивается быстрее ликвидации, протокол получает bad debt. Aave использует Safety Module (застейканный AAVE), Compound — reserves. Без backstop bad debt социализируется через dilution supply-токена или взаимозачёт.

Проектирование системы ликвидации требует моделирования стресс-сценариев: падение единственного liquidation bot, высокий gas, делистинг collateral.

Yield farming и incentive mechanics

Liquidity mining — раздача governance-токенов 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) — тесты до деплоя покрывают все сценарии.
• Аудит: минимум два независимых аудитора для TVL от $1M. Code4rena или Sherlock для bug bounty.
• Деплой с Gnosis Safe 3/5 multisig + timelock 48–72 часа.
• Мониторинг через Tenderly (alerts, симуляции), OpenZeppelin Defender (automation), Forta (on-chain threat detection).
• Поддержка после запуска: обновления, патчи, апгрейды через proxy.

Наши компетенции и опыт

Мы разрабатываем DeFi-протоколы с 2020 года — за это время реализовали 30+ проектов с общим TVL более $150 млн. Среди клиентов — протоколы в топ-20 по TVL на Ethereum, Arbitrum и Base. Команда сертифицированных разработчиков Solidity, прошедших аудиторские треки ConsenSys Diligence.

DeFi на Wikipedia — базовые принципы, которые мы применяем на практике.

Сроки

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

Стоимость рассчитывается индивидуально — свяжитесь для оценки вашего проекта.

Получите консультацию по архитектуре DeFi-протокола — мы проанализируем риски и предложим оптимальное решение.