NFTfi P2P-кредитование: смарт-контракты, офферы и мониторинг

Интеграция с 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 раз проще для аналитики.

Почему выбирают NFTfi для P2P-займов?

NFTfi — один из старейших протоколов в этой нише с аудированными смарт-контрактами и большой документацией. Off-chain офферы снижают газ для кредитора (не нужно отправлять транзакцию для создания). Поддерживаются ETH, USDC, DAI и другие одобренные ERC-20. Интеграция через SDK @nftfi/js ускоряет разработку, но для полного контроля над gas estimation лучше работать с ABI напрямую. Средняя транзакция acceptOffer на Ethereum стоит около $50 газа, на Polygon — менее $1. При использовании SDK экономия на разработке может достигать 30-50%. Наша команда занимается DeFi-интеграциями с 2019 года, реализовала более 15 проектов с NFTfi. Закажите интеграцию 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 через один аккаунт, взял кредит под завышенный 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 aggregator + Uniswap v3 TWAP как верификатор. Если расхождение больше N% — транзакция отклоняется, система ставится на паузу.

Как защитить DeFi-протокол от flash loan атак?

Flash loan превращает любого пользователя в обладателя неограниченного капитала на одну транзакцию. Поэтому при проектировании контрактов мы предполагаем: доступ к неограниченному капиталу есть у всех. Это меняет threat model полностью.

Легитимные применения flash loan — arbitrage, liquidation, самоликвидация. Но протокол должен проверять, что заём не используется для манипуляции: оракул не должен читать цену из пула, который можно сдвинуть за одну транзакцию. Мы добавляем проверки на block.timestamp и минимальную глубину ликвидности.

Ключевые компоненты 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 определяет максимальный кредит под 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-протокола — мы проанализируем риски и предложим оптимальное решение.