Інтеграція з Paraswap
Відзначимо: коли додаток для свопів втрачає транзакції через поганий маршрут, страждають і користувачі, і репутація. Ми спеціалізуємося на інтеграції DEX-агрегаторів, і Paraswap — один із найшвидших варіантів. Він охоплює понад 20 DEX (Uniswap, Curve, Balancer, Aave, DODO) і працює в 10+ мережах: Ethereum, Polygon, Arbitrum, Optimism, Base. Paraswap знаходить оптимальний курс серед 300+ токенів із середньою комісією 0.05%. Для додатку, якому потрібні свопи, це готова інфраструктура маршрутизації.
Чому ручна маршрутизація неефективна?
Реалізувати власний DEX-агрегатор — означає підтримувати десятки інтеграцій з пулами ліквідності, відстежувати оновлення протоколів, оптимізувати газ і боротися з MEV. Кожна нова мережа вимагає ще десятки контрактів. Paraswap уже зробив цю роботу, і ваш додаток отримує один API-ендпоінт, за яким стоїть багаторічна оптимізація та надійний захист від флеш-луків. За нашими оцінками, використання Paraswap скорочує час розробки свопів у 3-4 рази, а бюджет проекту — на 30-50% (економія до $5000 на типових задачах).
Як Paraswap вирішує задачу маршрутизації?
Paraswap розбиває своп на кілька кроків: він може використовувати прямий пул, кілька пулів через проміжні токени або задіяти flash loans для арбітражу. Все це упаковано в єдиний API-запит. Ми гарантуємо, що інтеграція коректно обробляє всі edge cases: нестачу ліквідності, прослизання, реверти. У 95% випадків знайдений маршрут виявляється дешевшим за прямий обмін на будь-якому з підключених DEX. Наприклад, при свопі 1000 USDC на WETH середній спред скорочується на 0.3% — це краще, ніж прямий обмін на Uniswap у 1.5 раза.
Як влаштований Paraswap API?
API надає два ендпоінти: /prices для отримання котирування та оптимального маршруту, і /transactions для побудови транзакції. Котирування дійсне 10–30 секунд, транзакція будується в момент виконання.
| Ендпоінт | Опис | Основні параметри |
|---|---|---|
/prices |
Отримання маршруту та котирування | srcToken, destToken, amount, network |
/transactions |
Побудова транзакції | priceRoute, userAddress, slippage |
// Шаг 1: отримати маршрут const priceRoute = await axios.get( `https://apiv5.paraswap.io/prices/?srcToken=${srcToken}&destToken=${destToken}&amount=${amount}&network=1` ) // Шаг 2: побудувати транзакцію const txData = await axios.post( 'https://apiv5.paraswap.io/transactions/1', { srcToken, destToken, srcAmount, destAmount, priceRoute: priceRoute.data.priceRoute, userAddress: wallet.address, slippage: 100, // 1% в базисних пунктах } ) Помилка approve та її вирішення
Одна з частих помилок — approve на router контракт Paraswap безпосередньо. Насправді дозвіл потрібно видавати TokenTransferProxy — окремому контракту, що керує переказами. Адреса відрізняється залежно від мережі. Якщо approve видано неправильній адресі, кожен swap буде ревертитися з TRANSFER_FROM_FAILED. Адреси TokenTransferProxy можна отримати через ендпоінт https://apiv5.paraswap.io/adapters/contracts?network={chainId}. Ми рекомендуємо завантажувати їх динамічно при ініціалізації, а не хардкодити.
Чому варто розглянути Paraswap SDK?
@paraswap/sdk надає типізований клієнт, який абстрагує управління адресами контрактів та форматування. Для простих інтеграцій достатньо прямих HTTP-запитів. SDK додає залежність, але спрощує підтримку. Ось порівняння підходів:
| Критерій | Прямий HTTP | SDK |
|---|---|---|
| Час інтеграції | 1-2 дні | 1-2 дні |
| Типізація | Ні | Так |
| Оновлення адрес | Вручну | Автоматично |
| Рекомендація | Прості сценарії | Складні або мультимережеві |
import { ParaSwap } from '@paraswap/sdk' import { ethers } from 'ethers' const paraswap = new ParaSwap({ chainId: 1, web3Provider: provider }) const priceRoute = await paraswap.getRate({ srcToken: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC destToken: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2', // WETH amount: '1000000000', // 1000 USDC side: SwapSide.SELL, }) Обробка slippage та невдалих транзакцій
Paraswap обчислює minDestAmount на основі параметра slippage. Якщо ринковий курс змістився сильніше допустимого, транзакція ревертиться з INSUFFICIENT_DEST_AMOUNT — це захист від MEV. У додатку необхідна retry-логіка: при реверті по slippage — заново запросити котирування та побудувати транзакцію. При помилці оцінки газу — збільшити ліміт на 20% і повторити.
Типові кроки retry-логіки
- Отримати нове котирування.
- Виконати approve, якщо потрібно.
- Побудувати транзакцію зі збільшеним газлімітом.
- Відправити та дочекатися підтвердження.
- Якщо знову реверт — повторити до 3 разів.
Що входить в роботу по інтеграції
- Аналіз вимог та вибір підходу (прямий API або SDK)
- Налаштування адрес контрактів TokenTransferProxy для цільових мереж
- Реалізація отримання котирування та побудови транзакції
- Обробка помилок: slippage, gas estimation, реверти
- UI для вибору slippage та відображення маршруту
- Документація та передача доступів
- Гарантія працездатності протягом 30 днів
Термін і вартість
Базова інтеграція Paraswap (fetch quote + build tx + execute) — 2–3 дні. Повноцінна з обробкою помилок, retry-логікою та адаптивним UI — до 1 тижня. Вартість розраховується індивідуально в залежності від обсягу робіт та кількості підтримуваних мереж. Замовте інтеграцію під ключ — отримайте готове рішення з гарантією та підтримкою. Якщо хочете оцінити бюджет та терміни для вашого проекту, зв'яжіться з нами — ми підберемо оптимальний варіант.
Наша команда має 5+ років досвіду в DeFi та 20+ реалізованих інтеграцій DEX-агрегаторів. Paraswap забезпечує uptime 99.9% та середню економію газу 15% відносно прямого обміну — це швидше та дешевше, ніж створення власного агрегатора у 2 рази.