Розробка системи fee distribution для протоколу

Розробка системи 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 систем.

Збір fees та конвертація

Як конвертувати fees без втрат?

Протоколи генерують 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 йде тільки стейкерам. Типова схема:

Пропорції задаються через 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 системи — отримайте консультацію з архітектури.

Процес роботи та орієнтири за термінами

Проектування (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 через один акаунт, взяв кредит під завищений колатераль і вивів велику суму. Оракул брав ціну з єдиного джерела без 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-протоколу — ми проаналізуємо ризики та запропонуємо оптимальне рішення.