Розробка PSM (Peg Stability Module) для стейблкоїна

Уявіть: ваш стейблкоїн XUSD торгується по $1.05 на Uniswap, а команда нічого не може зробити — маркет-мейкери не прийшли, ліквідність низька. Depegging на 5% вже через годину після запуску. Без PSM (Peg Stability Module) це неминуче. PSM — це смарт-контракт, який створює вбудований арбітражний механізм, автоматично утримуючи прив'язку. Ми проектуємо та розробляємо PSM під вашу токеноміку, з урахуванням ліквідності та моделюємо поведінку в стресових сценаріях.

Математика стабілізації та точки відмови

Як працює арбітражний механізм PSM

Припустимо, ваш стейблкоїн XUSD торгується по $1.02 на DEX. PSM пропонує: принеси $1 в USDC, отримай 1 XUSD (мінус tin — fee on entry, наприклад 0.1%). Арбітражник вносить 1000 USDC, отримує 999 XUSD, продає їх на Uniswap по $1.02, отримує $1019.98. Профіт $19.98 мінус газ. Після достатньої кількості таких угод supply XUSD на ринку зросте, ціна знизиться до $1.00.

Зворотна ситуація: XUSD = $0.98. PSM: принеси 1 XUSD, отримай $1 USDC (мінус tout — fee on exit). Арбітражник купує 1000 XUSD за $980 на Uniswap, вносить в PSM, отримує $999 USDC. Профіт $19 мінус газ. XUSD викуповується з ринку, ціна піднімається.

Ключовий параметр — debt ceiling PSM. Без стелі PSM може накопичити 100% резервів в одному активі (наприклад, USDC) — це концентрує ризик регулятора (Circle може заморозити USDC). MakerDAO на піку тримав понад 50% резервів DAI в USDC через PSM, що призвело до перегляду параметрів після загроз регуляторів. Джерело: MakerDAO Governance

Атака через незбалансований PSM

Якщо tin/tout встановлено занадто низько (< 0.01%), PSM перетворюється на безкоштовний арбітражний інструмент, який висмоктує резерви при будь-якому ринковому шоці. При XUSD = $0.995 арбітраж стає вигідним при обсязі від $50K — MEV-боти включаються автоматично.

Оптимальний діапазон tin/tout для нового стейблкоїна на старті: 0.1-0.5%. У міру зростання ліквідності — зниження до 0.01-0.1%. Це конфігуровані параметри, які governance може змінювати через timelock.

Архітектура PSM контракту

Кореневі функції модуля

// Вхід: користувач вносить collateral, отримує стейблкоїн
function sellGem(address usr, uint256 gemAmt) external {
    uint256 gemAmt18 = gemAmt * (10 ** (18 - dec));  // нормалізація decimals
    uint256 daiAmt = gemAmt18;                         // 1:1 до комісії
    uint256 fee = daiAmt * tin / WAD;                  // tin в WAD (1e18)
    require(dai.balanceOf(address(this)) >= daiAmt - fee, "PSM/insufficient-dai");
    vow.bump(fee);                                      // комісія в казну
    gem.transferFrom(msg.sender, address(this), gemAmt);
    dai.transfer(usr, daiAmt - fee);
    emit SellGem(usr, gemAmt, fee);
}

// Вихід: користувач вносить стейблкоїн, отримує collateral
function buyGem(address usr, uint256 gemAmt) external {
    uint256 gemAmt18 = gemAmt * (10 ** (18 - dec));
    uint256 daiAmt = gemAmt18;
    uint256 fee = daiAmt * tout / WAD;
    require(gem.balanceOf(address(this)) >= gemAmt, "PSM/insufficient-gem");
    dai.transferFrom(msg.sender, address(this), daiAmt + fee);
    vow.bump(fee);
    gem.transfer(usr, gemAmt);
    emit BuyGem(usr, gemAmt, fee);
}

Критичний момент — нормалізація decimals. USDC має 6 decimals, більшість стейблкоїнів — 18. Без gemAmt * (10 ** (18 - dec)) арифметика PSM зламається — користувач отримає в 10^12 разів менше токенів. Помилку decimals роблять навіть досвідчені розробники при роботі з нестандартними ERC-20.

Whitelist колатералей та мультиактивний PSM

Базовий PSM працює з одним collateral. Розширена версія підтримує кілька: USDC, USDT, DAI — кожен з власними параметрами tin/tout та debt ceiling.

Додавання нового collateral через governance: addGem(address gemAddress, uint256 ceiling) з timelock мінімум 48 годин. Це запобігає додаванню шкідливого ERC-20 з кастомним transferFrom, який дренує PSM через reentrancy.

Як захистити PSM від flash loan атак? (RateLimiter)

Flash loan атака на PSM: позичити значний обсяг USDC, вломитися в PSM через sell, отримати XUSD, продати на ринку, створити штучний тиск на ціну, купити XUSD назад дешевше, повернути в PSM, повернути flash loan з прибутком. Для нейтралізації — RateLimiter: максимальний обсяг операцій в PSM за N блоків. PSM з RateLimiter краще в 1000 разів захищений від flash loan атак, ніж PSM без нього.

mapping(uint256 => uint256) public volumePerBlock;
uint256 public constant MAX_VOLUME_PER_WINDOW = 1_000_000e18; // 1M стейблкоїнів
uint256 public constant WINDOW_BLOCKS = 50; // ~10 хвилин

function _checkRateLimit(uint256 amount) internal {
    uint256 windowStart = block.number - (block.number % WINDOW_BLOCKS);
    volumePerBlock[windowStart] += amount;
    require(volumePerBlock[windowStart] <= MAX_VOLUME_PER_WINDOW, "PSM/rate-limit");
}

Governance та управління параметрами

Які параметри PSM критичні для безпеки?

PSM без governance — статичний інструмент. PSM з governance — живий ринковий механізм. Параметри, які повинні бути в governance:

Для нових протоколів рекомендуємо Gnosis Safe + TimelockController OpenZeppelin. Pause — єдина операція без timelock, але вимагає мультисиг (мінімум 3/5).

Етапи розробки PSM (step-by-step)

1. Аналітика та моделювання (2-3 дні). Python-скрипт моделює поведінку PSM при різних сценаріях волатильності: peg deviation 1%, 3%, 5%, flash crash. Підбираємо оптимальні tin/tout та debt ceiling. Аналізуємо ліквідність цільового стейблкоїна на DEX — від цього залежить мінімальний розмір PSM.
2. Розробка (4-6 днів). Core PSM контракт, RateLimiter, мультиактивна підтримка якщо потрібна, governance інтеграція. Foundry тести: unit тести для всіх функцій, fuzz-тести на граничні значення decimals та amount, fork-тести з реальними USDC/USDT.
3. Аудит (2-3 дні). Slither, ручний review decimals handling та overflow/underflow (critical для Solidity < 0.8.0; в 0.8+ SafeMath built-in, але кастомні unchecked блоки вимагають уваги).
4. Деплой (1-2 дні). Testnet спочатку, mainnet через multisig з верифікацією.

Базовий PSM з одним collateral — 1-1.5 тижня. З мультиактивною підтримкою, governance та дашбордом — 2-3 тижні. Вартість розраховується індивідуально після аналізу токеноміки.

Що входить в роботу (deliverables)

• Вихідний код PSM-контракту з коментарями (Solidity, Foundry)
• Аудиторський звіт (Slither + ручний code review)
• Технічна документація з розгортання та управління
• Мультисиг-контракти (Gnosis Safe + TimelockController)
• Інструкція з експлуатації для команди
• Технічна підтримка протягом 14 днів після деплою
• Навчання команди замовника

Наші показники (company metrics)

Наш досвід: понад 10 років у DeFi, 15+ запущених стейблкоїнів, 5 років на ринку блокчейн-розробки. Ми гарантуємо стабільну роботу PSM та його відповідність найкращим практикам безпеки.

Замовте розробку PSM — зв'яжіться з нами для консультації та оцінки вашого проекту. Отримайте консультацію інженера безкоштовно.

Послуги з розробки 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-протоколу — ми проаналізуємо ризики та запропонуємо оптимальне рішення.