Реализация свопа токенов (Token Swap) в мобильном криптокошельке
Встроенный своп — конкурентное преимущество кошелька. Пользователь меняет токены, не выходя из приложения. Но за простым UI скрывается нетривиальная цепочка: котировка → slippage → approve → swap → трекинг. Каждый шаг с потенциальными потерями для пользователя при некорректной реализации.
Получение котировки
Котировка — это сколько токенов B получит пользователь за N токенов A с учётом комиссии пула. Источники:
1inch Aggregation Protocol API — наиболее популярный вариант для мультичейн кошельков. GET /v5.2/{chainId}/quote?src={tokenIn}&dst={tokenOut}&amount={amount} возвращает toAmount, estimatedGas и маршрут.
Uniswap V3 QuoterV2 — onchain-котировка через eth_call. Подходит если кошелёк работает только с одной сетью и не хочет зависеть от сторонних API.
0x API (/swap/v1/quote) — хорошая альтернатива 1inch для EVM-сетей, особенно для Ethereum и Polygon.
Котировка устаревает быстро — обновлять каждые 15–30 секунд, показывать пользователю таймер обратного отсчёта. После истечения — автоматически запросить новую.
Slippage и amountOutMinimum
Slippage — максимально допустимое отклонение от котировки. amountOutMinimum = quotedAmount * (1 - slippage/100). Если реальный output меньше — транзакция ревертится.
// Android — расчёт amountOutMinimum
val slippageBips = 50 // 0.5% в basis points
val amountOutMinimum = quotedAmountOut.multiply(BigInteger.valueOf(10000 - slippageBips))
.divide(BigInteger.valueOf(10000))
Показывать пользователю: «Минимум получите X.XX TOKEN». Это честно и снижает претензии при высокой волатильности.
Для стейблкоин-пар (USDC → USDT) — 0.1% slippage достаточно. Для мем-токенов с низкой ликвидностью — нужен ручной контроль до 5–10%, с явным предупреждением о рисках.
Approve: одобрение токена перед свопом
ERC-20 требует approve(spenderAddress, amount) перед тем, как роутер возьмёт токены. Если approve уже достаточен (allowance >= amountIn) — пропустить.
Проверка allowance: ERC20.allowance(ownerAddress, spenderAddress) через eth_call.
Два подхода к сумме approve:
- Точная сумма (approve на amountIn) — безопаснее, но требует approve при каждом свопе.
- Max approve (
uint256.max) — одна транзакция навсегда, но риск при компрометации роутера.
В 2023–2024 несколько роутеров были взломаны, и пользователи с max approve потеряли средства. Рекомендую точный approve с опцией «запомнить разрешение» для power users.
Трекинг и история свопов
После отправки транзакции — показать статус pending с txHash. Polling eth_getTransactionReceipt каждые 5 секунд. При статусе status: 0 (revert) — показать причину: декодировать revertReason из receipt или сделать eth_call с теми же параметрами для получения ошибки.
Хранить историю свопов локально: токен A → токен B, суммы, txHash, timestamp, итоговый статус. Пользователь должен видеть прошлые операции без интернета.
Сроки: 5 дней: интеграция котировочного API, расчёт slippage, flow approve → swap, трекинг транзакции, история. Мультичейн своп (ETH + BSC + Polygon) — +2–3 дня.