Интеграция с 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.
| Контракт | Версия | Назначение |
|---|---|---|
| NftfiHub | v2.0+ | Реестр и роутер для всех типов займов |
| DirectLoanFixedOffer | v2.0 | Фиксированные займы с ERC-721 |
| DirectLoanFixedOfferRedeploy | v2.1 | Поддержка ERC-1155 и обновлённая логика |
Как работает протокол NFTfi?
- Borrower вызывает approve для NFT на адрес NFTfi, затем принимает оффер через acceptOffer.
- Lender создаёт подписанный off-chain оффер (EIP-712), который хранится в базе NFTfi или вашем backend.
- При acceptOffer контракт переводит NFT в себя, отправляет токены заёмщику и минтит кредитору promissory note NFT (ERC-721).
- По истечении срока: 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 раз проще для аналитики.
| Метод мониторинга | Задержка | Сложность запросов | Надёжность |
|---|---|---|---|
| On-chain events (ethers) | Реальное время | Низкая — нужна ручная фильтрация | Высокая (нет зависимости от инфраструктуры) |
| The Graph subgraph | ~30 секунд | Высокая — GraphQL с агрегациями | Средняя (зависит от узла) |
Почему выбирают 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 — устаревшие офферы могут быть приняты.
Процесс работы
- Изучение ABI и тестирование на тестовой сети (1 день). Разворачиваем тестовый NFT, создаём займ вручную через контракт, проверяем все события.
- Backend интеграция (1-2 дня). Хранение и трансляция офферов, webhooks на события займов.
- Frontend компоненты (1-2 дня). Форма создания оффера, отображение активных займов, flow погашения.
Ориентиры по срокам
Базовая интеграция — создание и принятие офферов, мониторинг займов — 3-5 дней. Полноценный lending UI с аналитикой по коллекциям и автоматическим созданием офферов — 1-1.5 недели. Свяжитесь с нами для обсуждения деталей — мы подберём оптимальный план.