Интеграция 1inch API: агрегатор ликвидности DEX для вашего dApp

Пользователи теряют до 10% на спреде при ручном поиске по пулам. Интеграция 1inch API (v6) решает это за 2–3 дня: протокол сплитует ордер по 200+ источникам ликвидности и находит лучший курс. Мы берём на себя интеграцию, настройку slippage, обработку approve и тестирование — вы получаете агрегатор с минимальным временем выхода на рынок. Наш опыт: 5+ лет в DeFi, 20+ проектов по интеграции DEX-агрегаторов.

Почему интеграция критична для DeFi-продукта?

Пользователи ожидают лучший курс без ручного поиска по пулам. Интеграция через 1inch обеспечивает быстрый роутинг: собственная реализация потребовала бы недель, тогда как готовое решение — дни. Экономия времени и средств существенна: вы получаете проверенный агрегатор без затрат на разработку и отладку собственного роутинга.

Устаревший quote и slippage при исполнении

GET /v6.0/1/quote возвращает toAmount — ожидаемое количество токенов на выходе. Между моментом получения quote и исполнением транзакции проходит время. На волатильном рынке за 10–30 секунд цена может сдвинуться на 0.5–2%.

Если передавать в POST /v6.0/1/swap параметр slippage=1 (1%), при реальном движении рынка на 1.5% транзакция зареверсируется — пользователь заплатил газ и ничего не получил. Правильно: динамически устанавливать slippage на основе волатильности пары: 0.5% для stable‑пар, 1–3% для волатильных.

Ещё одна проблема: toAmount из /quote не совпадает с toAmount из /swap. Это нормально — /swap строит финальный calldata с учётом текущего состояния пулов. Показывать пользователю цифру из /quote, а подписывать транзакцию с /swap — правильная практика.

Approve и permit: два паттерна

1inch Aggregation Router v6 принимает tokens через стандартный ERC-20.approve. Но для лучшего UX поддерживается также permit (EIP-2612) — gasless approve через подпись. Если токен реализует EIP-2612 (DAI, USDC на Ethereum, большинство современных ERC-20), нужно использовать /approve/transaction endpoint только как fallback.

Проверка поддержки permit: вызвать token.nonces(address) — если не reverting, permit поддерживается.

Второй тип approve — 1inch Permit2 (аналог Uniswap Permit2). Если пользователь уже дал approve в Permit2 для другого протокола, повторный approve не нужен. Это улучшает UX при частых свопах.

Как интегрировать 1inch API в dApp?

Структура запросов

Базовый флоу для swap виджета:

1. GET /v6.0/{chainId}/tokens — кешируем список поддерживаемых токенов (раз в час достаточно)
2. GET /v6.0/{chainId}/quote?src=...&dst=...&amount=... — получаем quote, показываем пользователю
3. GET /v6.0/{chainId}/approve/allowance?tokenAddress=...&walletAddress=... — проверяем текущий allowance
4. Если allowance < amount: GET /v6.0/{chainId}/approve/transaction → подписываем approve
5. POST /v6.0/{chainId}/swap → получаем calldata, отправляем транзакцию

Для мультичейн поддержки используем chainId в URL. 1inch API описывает все эндпоинты.

Обработка ошибок API

1inch v6 возвращает HTTP 400 с JSON body при любой ошибке бизнес-логики. Типичные коды:

Rate limiting нужно обрабатывать через exponential backoff, не слать запросы повторно немедленно.

Classic vs Fusion: что выбрать?

Для простой интеграции (swap виджет, агрегатор в dApp) — Classic mode через REST API. Для продвинутого UX с gasless transactions — Fusion.

Проверка calldata

Перед отправкой транзакции пользователем — всегда симулировать через eth_call. Это позволяет поймать revert до трат газа. В wagmi/viem:

const { data } = await publicClient.call({
  account: userAddress,
  to: swapData.tx.to,
  data: swapData.tx.data,
  value: BigInt(swapData.tx.value),
});

Если call reverting — показываем пользователю ошибку, не транзакцию.

Что входит в интеграцию

• Разработка API-слоя с типизацией запросов
• React-хуки для состояния swap (quote, approve, отправка)
• Обработка ошибок и rate limiting
• Поддержка мультичейн (до 7 сетей)
• Тестирование на тестнете (Sepolia)
• Документация и примеры кода
• Гарантированная поддержка после запуска (2 недели)

Технический стек

viem + wagmi для TypeScript/React приложений — нативная поддержка TypeScript, tree-shaking, хорошая интеграция с WalletConnect и MetaMask. Альтернатива — ethers.js v6 для Node.js бэкенда. Для кеширования quote данных — React Query с staleTime: 10_000 (10 секунд).

Процесс работы

Анализ требований (0.5 дня). Какие чейны, какие токены, Classic или Fusion, нужен ли собственный UI или embed виджет.

Разработка (2–3 дня). API слой с типизацией, React хуки для quote/swap flow, обработка allowance, error handling.

Тестирование (0.5–1 день). Тесты на testnet, проверка edge cases: нет ликвидности, insufficient balance, expired quote.

Ориентиры по срокам

Базовая интеграция swap функциональности в существующий dApp: 2–3 дня. Полноценный swap виджет с мультичейн поддержкой, историей транзакций и Fusion mode: 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-протокола — мы проанализируем риски и предложим оптимальное решение.