Інтеграція 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 через один акаунт, взяв кредит під завищений колатераль і вивів велику суму. Оракул брав ціну з єдиного джерела без 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-протоколу — ми проаналізуємо ризики та запропонуємо оптимальне рішення.