Інтеграція з NFTfi

Ви будуєте лендінг-платформу або NFT-маркетплейс, і користувачі запитують можливість взяти позику під заставу NFT з фіксованим строком і ставкою. Без ліквідаційних оракулів або AMM — тільки peer-to-peer. NFTfi — один із найстаріших протоколів, аудований і з великою документацією. Однак інтеграція вимагає коректної роботи з EIP-712 оферами, моніторингом станів і обробкою race conditions. Ми реалізуємо повну інтеграцію: від підпису оферів до моніторингу позик через субграф.

В основі протоколу — два ключові контракти: NftfiHub (реєстр і роутер) та DirectLoanFixedOffer (позики з фіксованою ставкою). Починаючи з версії v2.1 додано DirectLoanFixedOfferRedeploy з підтримкою ERC-1155. Типовий flow: позичальник блокує NFT, отримує ETH або USDC, а при неповерненні NFT переходить кредитору. Жодних ліквідаційних оракулів — тільки чистий fixed-term loan.

Як працює протокол NFTfi?

1. Borrower викликає approve для NFT на адресу NFTfi, потім приймає офер через acceptOffer.
2. Lender створює підписаний off-chain офер (EIP-712), який зберігається в базі NFTfi або вашому backend.
3. При acceptOffer контракт переводить NFT у себе, надсилає токени позичальнику і мінтить кредитору promissory note NFT (ERC-721).
4. Після закінчення строку: payBackLoan від позичальника або liquidateOverdueLoan від кредитора.

Що таке структура офера (EIP-712)?

Інтеграція через підпис оферів — місце найчастіших помилок. Офер містить:

struct Offer {
    uint256 loanPrincipalAmount;
    uint256 maximumRepaymentAmount;
    uint256 nftCollateralId;
    address nftCollateralContract;
    uint32 loanDuration;     // в секундах
    uint16 loanAdminFeeInBasisPoints;
    address loanERC20Denomination;
    address referrer;
}

Підпис створюється через signTypedData у ethers.js або viem, використовуючи domain separator контракту NFTfi. Domain separator включає chainId — офер для Ethereum mainnet невалідний на Goerli, навіть якщо адреса контракту збігається. Детальніше в EIP-712.

Типова помилка: неправильна обробка проміжних статусів позики

Позика може перебувати в станах: Active, Repaid, Liquidated, або в edge case — коли блок із payBackLoan майниться після закінчення loanDuration, але liquidateOverdueLoan ще не викликаний. Контракт приймає обидва виклики в коротке вікно (зазвичай 2–5 блоків, у Ethereum це 30–60 секунд, у Polygon — 4–10 секунд). Якщо фронтенд не оновлює статус атомарно — користувач бачить активну позику, яка вже ліквідована.

Рекомендований підхід: слухати події LoanStarted, LoanRepaid, LoanLiquidated через ethers.js provider.on або підписку через The Graph subgraph. Subgraph кращий для UI — дозволяє робити складні запити (всі активні позики по колекції, історія позик адреси). On-chain події дають нульову затримку, але вимагають ручної фільтрації. Subgraph затримується до 30 секунд, але запити в 10 разів простіші для аналітики — це робить Subgraph кращим вибором для аналітики порівняно з on-chain подіями.

Чому обирають NFTfi для P2P-позик?

NFTfi — один із найстаріших протоколів у цій ніші з аудованими смарт-контрактами та великою документацією. Off-chain офери знижують газ для кредитора (не потрібно надсилати транзакцію для створення). Підтримуються ETH, USDC, DAI та інші схвалені ERC-20. Інтеграція через SDK @nftfi/js прискорює розробку, але для повного контролю над gas estimation краще працювати з ABI безпосередньо. Середня транзакція acceptOffer на Ethereum коштує близько $50 газу, на Polygon — менше $1. Економія на газі при використанні Polygon становить $49 за транзакцію порівняно з Ethereum. При використанні SDK економія на розробці може сягати 30-50% — це у 1.5-2 рази швидше, ніж пряма робота через ABI. Наша команда займається DeFi-інтеграціями з 2019 року (5+ років досвіду), реалізувала більше 15 успішних проєктів із NFTfi. Ми гарантуємо якісну інтеграцію з використанням сертифікованих смарт-контрактів NFTfi. Середня вартість повної інтеграції — $5000-$8000 залежно від складності. Замовте інтеграцію NFTfi для вашого проєкту — отримайте консультацію по вашому кейсу.

Що входить в інтеграцію

• SDK / бібліотека. Офіційний @nftfi/js для швидкої інтеграції або пряма робота через ABI для повного контролю над gas estimation.
• Subgraph запити. GraphQL для списку активних оферів, історії позик, даних колекції. Інтегруємо через @apollo/client або urql.
• Валюти позики. ETH, USDC, DAI та інші схвалені ERC-20. Потрібна логіка approve для кожної валюти від lender перед створенням офера.
• Referral система. Підтримка referrer address в оферах — спосіб монетизувати інтеграцію.

Чек-лист типових помилок при інтеграції

• Невірний chainId у domain separator — офер невалідний в іншій мережі.
• Відсутність approve для NFT перед acceptOffer — транзакція впаде з помилкою.
• Ігнорування події LoanLiquidated після payBackLoan — стан розсинхронізується.
• Неправильна обробка loanDuration у секундах — плутанина з хвилинами.
• Відсутність перевірки deadline — застарілі офери можуть бути прийняті.

Процес роботи

1. Вивчення ABI та тестування на тестовій мережі (1 день). Розгортаємо тестовий NFT, створюємо позику вручну через контракт, перевіряємо всі події.
2. Backend інтеграція (1-2 дні). Зберігання та трансляція оферів, webhooks на події позик.
3. Frontend компоненти (1-2 дні). Форма створення офера, відображення активних позик, flow погашення.

Орієнтири за строками

Базова інтеграція — створення та прийняття оферів, моніторинг позик — 3-5 днів. Повноцінний lending UI з аналітикою по колекціях і автоматичним створенням оферів — 1-1.5 тижня. Зв'яжіться з нами для обговорення деталей — ми підберемо оптимальний план.

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