Кастомизация форка DeFi-протокола
Uniswap v2 был форкнут больше 200 раз. Большинство форков умерли не потому что код плохой — он достаточно хорошо проверен. Умерли из-за того, что форк скопировали как есть, не разобравшись в механике, и сломали при первой же попытке что-то изменить. Storage collision при апгрейде, неправильно откалиброванные параметры fee, сломанный механизм ценообразования из-за неправильной инициализации пулов — вот почему «просто форкнуть Uniswap» не работает без понимания внутренностей.
Что значит кастомизация форка на практике
Аудит исходного протокола перед изменениями
Первый шаг — понять, что именно мы форкаем. Uniswap v2, Uniswap v3, Curve, Aave v3, Compound v3, Balancer v2 — каждый имеет свою архитектуру и ограничения на кастомизацию.
Uniswap v2 форк — самый простой. AMM-логика в UniswapV2Pair, роутер отдельно. Кастомизируют: fee структуру (v2 фиксированные 0.3%), токеномику LP-токенов, whitelist торговых пар. Добавляют: buyback механику из protocol fee, staking rewards для LP.
Aave v3 форк — сложнее. Протокол модульный, 20+ контрактов. Кастомизируют: список поддерживаемых активов, LTV/liquidation threshold параметры, interest rate strategy, включение/выключение isolation mode для новых активов. Не стоит трогать: core математику InterestRateModel без глубокого понимания, механику aToken.
Curve форк — нишевая задача для stable swap. Параметр A (amplification) критичен: слишком высокий — пул не ребалансируется при depeg, слишком низкий — высокий slippage. Значение A для существующих пулов Curve подбиралось экспериментально месяцами.
Распространённые ошибки при форках
Неправильный fee calculation. В Uniswap v2 fee снимается через amountIn * 997 / 1000 (0.3%). Если изменить fee без пересчёта константы — сломается invariant k = x * y. Транзакции будут проходить, баланс пула будет некорректным, LP потеряет деньги.
Storage layout при апгрейде форка. Если взяли Aave v3 с proxy архитектурой и добавили переменную в середину storage — следующий апгрейд сломает storage. Aave v3 использует свой ReserveData struct в storage slot N. Добавление поля до него сдвинет все последующие данные.
Oracle configuration. Aave v3 использует Chainlink aggregators с конкретными heartbeat и deviation threshold параметрами под каждый asset. Форк на новом чейне требует либо Chainlink поддержки на этом чейне, либо замены на другой оракул. Использование оракула без anti-manipulation защиты (TWAP, circuit breaker) — прямой вектор к oracle manipulation атаке.
Технический процесс кастомизации
Diff-based анализ
Берём оригинальный протокол из официального GitHub, делаем fork в приватный репозиторий. Все изменения — только через pull request с описанием причины и impact. Это позволяет в любой момент сделать git diff против оригинала и понять полный объём изменений.
Типичный размер diff для «лёгкой» кастомизации Uniswap v2 с дополнительным fee механизмом — 200-400 строк. Если diff >1000 строк — это уже не кастомизация, это новый протокол.
Параметризация через конфиги
Хорошие форки выносят изменяемые параметры в admin-controlled конфиги, а не хардкодят в контракты. Uniswap v2 с изменяемым fee: uint256 public swapFee = 30; // basis points с onlyOwner сеттером и timelock. Это позволяет калибровать параметры после деплоя без апгрейда контракта.
Тестирование изменённой логики
Fork-тесты в Foundry — основной инструмент проверки. Берём реальные исторические транзакции оригинального протокола, воспроизводим их против нашего форка, сравниваем результаты. Расхождение в балансах — индикатор ошибки в математике.
Invariant тесты: для AMM — k должен только расти (не уменьшаться) с каждым свапом. Для lending — totalDebt никогда не превышает totalSupply. Echidna запускаем на 100k+ итераций.
| Протокол | Сложность форка | Типичное время кастомизации | Основные риски |
|---|---|---|---|
| Uniswap v2 | Низкая | 3-7 дней | Fee math, oracle |
| Uniswap v3 | Высокая | 2-4 недели | Tick math, concentrated liquidity |
| Aave v3 | Высокая | 2-4 недели | Oracle setup, risk parameters |
| Curve StableSwap | Средняя | 1-2 недели | Параметр A, pool init |
| Balancer v2 | Средняя | 1-2 недели | Vault архитектура, pool math |
Процесс работы
Анализ исходного протокола (2-3 дня). Изучаем архитектуру, составляем список компонентов для изменения. Оцениваем риски каждого изменения.
Разработка и тестирование (5-10 дней). Все изменения в изолированных PR. Fork-тесты + invariant тесты на каждое изменение. Документирование diff.
Деплой скрипты. Форки крупных протоколов требуют сложной инициализации: правильный порядок деплоя контрактов, настройка параметров, инициализация оракулов. Скрипты через forge script с воспроизводимыми результатами.
Внутренний аудит. Особый фокус на изменённые части. Оригинальный код считаем относительно безопасным (он уже прошёл аудиты), новый код — проверяем как новый контракт.
Ориентиры по срокам
Лёгкая кастомизация Uniswap v2 (fee механика, whitelist) — 1-2 недели. Кастомизация Aave v3 с новыми рынками и параметрами — 2-4 недели. Сроки зависят от объёма изменений и сложности целевого протокола.
Стоимость рассчитывается после review оригинального протокола и технического задания на изменения.