Разработка системы fee distribution для протокола
Представьте: ваш DeFi-протокол генерирует $100k комиссий в день, но держатели токена не получают ничего. Uniswap V3 столкнулся с этим до включения fee switch — governance перенаправил часть fees на treasury, потребовалась надёжная система сбора, аккумуляции и распределения. Мы разрабатываем такие системы под ключ с учётом gas optimization и безопасности. Synthetix StakingRewards — эталонный паттерн, который мы адаптируем под вашу архитектуру.
Два паттерна распределения: push vs pull
Почему pull distribution выгоднее push?
Push distribution — рассылка всем. Контракт накапливает fees и периодически вызывает distribute(), которая пробегает по списку стейкеров и переводит каждому долю. Просто в понимании, сложно в реализации: unbounded loop — классический gas griefing вектор. При 10 000 стейкерах транзакция превысит block gas limit (потребуется ~3 млн газа вместо типичных 150 тыс.).
Допустимо только для систем с явным cap на количество участников и batch обработкой (pagination). В большинстве случаев — неправильный выбор. Pull distribution сокращает газовые затраты на claim в 4 раза, что критично при масштабировании до тысяч стейкеров.
Pull distribution — пользователь сам забирает. Контракт ведёт rewardPerTokenStored — накопленный reward на единицу стейка с момента запуска. При каждом deposit/withdraw/claim обновляет userRewardPerTokenPaid для конкретного пользователя. Награда = (rewardPerTokenStored - userRewardPerTokenPaid) * balance.
Это математика из Synthetix StakingRewards — одного из самых скопированных паттернов в DeFi. Ключевое свойство: Gas-complexity O(1) для claim, не зависит от количества стейкеров.
function earned(address account) public view returns (uint256) {
return (
(balanceOf[account] * (rewardPerToken() - userRewardPerTokenPaid[account])) / 1e18
) + rewards[account];
}
Этот паттерн мы используем как базу для большинства fee distribution систем.
| Характеристика |
Push distribution |
Pull distribution |
| Gas на claim |
~200 000 + O(N) |
~50 000 O(1) |
| Проблема при 10 000 стейкерах |
Превышение limit |
Незначительный рост |
| Сложность бага |
Высокая (повторы, frontrun) |
Средняя (математика) |
| Масштабируемость |
Плохая |
Отличная |
Сбор fees и конвертация
Как конвертировать fees без потерь?
Protocols генерируют fees в разных токенах — swap fees в торгуемых токенах, lending fees в debt-токенах. Прежде чем распределить стейкерам, нужно конвертировать в один target token (обычно protocol token или USDC).
FeeCollector контракт — агрегирует fees со всех source контрактов. Периодически вызывается keeper (Chainlink Automation, Gelato) или любым пользователем.
Конвертация через DEX — swap accumulated fees в target token через Uniswap V3. Важно: конвертация большого объёма за раз создаёт price impact и MEV-возможности. Решение: конвертировать малыми частями через TWAP-ориентированные свопы или использовать Cow Protocol для MEV-защищённых свопов. Это снижает проскальзывание на 20-30%.
Распределение в нескольких токенах — иногда правильнее не конвертировать, а распределять в оригинальных fee-токенах. Curve распределяет 3CRV LP-токены (корзина стейблкоинов) вместо конвертации. Это дороже в реализации (multi-reward staking), но сохраняет ценность без slippage.
Многоканальное распределение
Редко весь fee идёт только стейкерам. Типичная схема:
| Получатель |
Доля |
Механизм |
| Стейкеры токена |
40-60% |
Pull-distribution, rewardPerToken |
| Treasury |
20-30% |
Прямой перевод на multisig |
| Insurance fund |
10-20% |
Накопление для покрытия bad debt |
| Burn |
5-10% |
token.burn() |
Пропорции задаются через governance-управляемые параметры с timelock. FeeDistributor контракт читает актуальные пропорции при каждом вызове distribute().
veToken модель (vote-escrowed)
Curve ввела модель, где для получения fees нужно залочить CRV на срок до 4 лет. Чем дольше lock — тем больше veCRV, тем больше доля fees. Это выравнивает интересы: долгосрочные держатели получают больше. Реализация сложнее базового staking — нужен decay расчёт voting power, периодические checkpoints, интеграция с gauge voting.
Если нужна veToken механика — это отдельный scope работ поверх базового fee distribution.
Что входит в работу
- Аудит существующей архитектуры и выбор оптимального паттерна (pull/push/hybrid).
- Разработка смарт-контрактов: FeeCollector, FeeDistributor, Staking (с учётом reentrancy-защиты, проверки на OpenZeppelin).
- Интеграция с DEX для конвертации (Uniswap V3, Cow Protocol).
- Написание тестов (Foundry, fuzz, fork-тесты) с покрытием edge cases.
- Деплой и верификация контрактов в Etherscan.
- Документация для governance и аудиторов.
- Поддержка после запуска (мониторинг, горячие исправления).
Гарантируем отсутствие reentrancy и frontrunning-уязвимостей. Опыт команды: 7+ лет в блокчейне, 50+ смарт-контрактов, 5 лет на рынке. Свяжитесь с нами для аудита вашей архитектуры — оценим проект за 1 день. Закажите разработку fee distribution системы — получите консультацию по архитектуре.
Какие риски скрывает push distribution?
Push distribution при большом числе стейкеров может превысить block gas limit, а также подвержен frontrunning-атакам на момент вызова distribute(). Для крупных протоколов pull distribution безопаснее.
Процесс работы и ориентиры по срокам
Проектирование (2-3 дня). Определяем source контракты, target token, пропорции распределения, keeper механизм для периодической конвертации.
Разработка (5-8 дней). FeeCollector + FeeDistributor + Staking контракт. Тесты с Foundry: корректность расчёта earned() при изменении total supply, корректная обработка deposit/withdraw в том же блоке что distribute().
Интеграционные тесты. Fork-тест с реальным Uniswap V3 pool для проверки конвертации fees. Fuzz-тесты на математику распределения — edge cases при очень маленьких или очень больших балансах.
Базовая система (pull-distribution, один reward token, periodic collect) — 1 неделя. С конвертацией через DEX и multi-reward — 1.5-2 недели. veToken механика — дополнительные 2-3 недели. Стоимость рассчитывается индивидуально в зависимости от сложности и требуемого аудита.
Разработка 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 |
Медиана от независимых провайдеров |
Высокая (децентрализация) |
До 24 ч при 0% движения |
| Uniswap v3 TWAP |
Средняя цена за N блоков |
Высокая (сложно удерживать) |
30 мин — 1 ч |
| Pyth Network |
Cross-chain low-latency |
Средняя (зависимость от publisher) |
Секунды |
В продакшене мы используем двухуровневую проверку: Chainlink aggregator + Uniswap v3 TWAP как верификатор. Если расхождение больше N% — транзакция отклоняется, система ставится на паузу.
Как защитить DeFi-протокол от flash loan атак?
Flash loan превращает любого пользователя в обладателя неограниченного капитала на одну транзакцию. Поэтому при проектировании контрактов мы предполагаем: доступ к неограниченному капиталу есть у всех. Это меняет threat model полностью.
Легитимные применения flash loan — arbitrage, liquidation, самоликвидация. Но протокол должен проверять, что заём не используется для манипуляции: оракул не должен читать цену из пула, который можно сдвинуть за одну транзакцию. Мы добавляем проверки на block.timestamp и минимальную глубину ликвидности.
Ключевые компоненты DeFi-архитектуры
| Тип протокола |
Основная механика |
Главный риск |
| DEX (AMM) |
x*y=k или concentrated liquidity |
impermanent loss, oracle manipulation |
| Lending |
collateral ratio, liquidation |
bad debt при каскадных ликвидациях |
| Yield aggregator |
автокомпаундинг стратегий |
rug через strategy upgrade |
| Derivatives / Perps |
funding rate, mark price |
liquidation cascades, socialized losses |
| Liquid staking |
stETH-style rebasing |
depegging при mass unstake |
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-протокола — мы проанализируем риски и предложим оптимальное решение.
