Создаём DEX в Telegram Mini App на TON
Экосистема TON взлетела: Mini Apps получили доступ к 900 млн пользователям, блокчейн вошёл в топ-5 по активности в DeFi, а суммарная ликвидность в пулах превысила 300 млн TON. Многие команды пытались портировать привычный Uniswap-интерфейс, но столкнулись с сюрпризом — DEX на TON кардинально отличается от Ethereum-аналогов. Мы специализируемся на таких приложениях и знаем каждый подводный камень: от асинхронных сообщений до ограничений webview. Типичный DEX на TON — это не Uniswap-клон, архитектура строится на actor-модели, где каждый контракт — независимый процесс, обменивающийся сообщениями через очередность. Telegram Mini App сверху накладывает свои ограничения: маленький экран, жесты, темы.
Рассмотрим ключевые особенности обмена токенами.
Как работает своп в TON-версии?
В Ethereum swap() — атомарная операция: или всё исполнилось, или откат. В TON каждый контракт — отдельный actor, сообщения между ними асинхронны. Swap на StonFi выглядит так:
- Пользователь отправляет jetton transfer с op-code
0xf8a7ea5к LP Pool. - LP Pool обрабатывает сообщение, отправляет output jetton обратно.
- Если что-то пошло не так — bounced message возвращает исходные токены.
Этот флоу занимает 3-5 секунд и несколько блоков. UI должен это отражать: не спиннер 5 секунд, а явное состояние «транзакция отправлена, ожидаем подтверждения». Мы используем polling статуса транзакции через TON API (/v2/transactions/{hash}) с интервалом 1-2 секунды. Средняя стоимость транзакции составляет 0.05 TON — на порядок ниже, чем на Ethereum.
Какие ограничения накладывает Telegram Mini App?
Mini App работает в webview с ограниченным пространством — ширина обычно 375px, высота до 600px. Вот три паттерна, которые мы внедряем в каждом проекте.
MainButton — нативная кнопка Telegram внизу экрана. Используем для основного действия (Swap, Confirm), не рендерим собственную кнопку поверх.
WebApp.MainButton.setText('Подтвердить своп'); WebApp.MainButton.onClick(() => executeSwap()); WebApp.MainButton.show(); HapticFeedback — при успешной транзакции: WebApp.HapticFeedback.notificationOccurred('success'). При ошибке: 'error'. Мелочь, но заметно улучшает ощущение приложения.
Тема: WebApp.themeParams возвращает цвета текущей темы Telegram. Приложение должно подстраиваться под тёмную/светлую тему пользователя, не фиксировать свою.
BackButton: при навигации вглубь (детали транзакции, выбор токена) — показываем WebApp.BackButton, при возврате — прячем.
Как TON Connect превосходит встроенный кошелёк?
TON Connect — протокол подключения кошелька, аналог WalletConnect для TON. В контексте Telegram Mini App есть нюанс: Tonkeeper, MyTonWallet и встроенный Telegram Wallet все реализуют TON Connect, но с разными возможностями. Встроенный Telegram Wallet (доступен через window.Telegram.WebApp.openInvoice) работает только для TON transfers, не для jetton операций. Для DEX свопов нужен внешний кошелёк через @tonconnect/ui-react. TON Connect в 5 раз удобнее для Jetton-свопов: он поддерживает любые децентрализованные переводы, а не только TON. Это означает deep link в мобильное приложение кошелька — дополнительный UX шаг, который мы объясняем пользователю через подсказку.
Архитектура Mini App
Технический стек
| Компонент | Инструмент |
|---|---|
| Frontend Framework | React 18 + TypeScript + Tailwind |
| Wallet Connection | @tonconnect/ui-react |
| Blockchain API | @ton/ton + TonCenter API v2 |
| DEX Integration | @ston-fi/sdk или DeDust message builders |
| Charts | TradingView Lightweight Charts |
Jetton адреса и Friendly Address формат
В TON нет глобального адреса токена — каждый пользователь имеет собственный jetton wallet адрес (derived от master jetton contract + owner address). Прежде чем отображать баланс или делать swap, нужно получить jetton wallet address пользователя:
const jettonMaster = Address.parse(USDT_MASTER_ADDRESS); const jettonWalletAddress = await tonClient.runMethod( jettonMaster, 'get_wallet_address', [{ type: 'slice', cell: beginCell().storeAddress(userAddress).endCell() }] ); Это async вызов на каждый токен, который мы кешируем. Без кеша UI тормозит при загрузке балансов — типичная ошибка начинающих.
Графики цен
Для отображения price chart внутри Mini App используем TradingView Lightweight Charts (минимальный bundle ~50KB). Данные: OHLCV из StonFi subgraph или TON API historical prices. Обновление через WebSocket если нужен realtime, polling каждые 30 секунд если достаточно near-realtime. Важно: графики не интерактивны в мобильном webview — pinch-to-zoom конфликтует с нативным scroll Telegram. Реализуем только статичный chart с тапом для просмотра конкретной свечи.
Управление ликвидностью
Если Mini App включает LP функциональность (add/remove liquidity), отображаем текущую долю пула и impermanent loss. IL рассчитывается off-chain:
IL% = 2 * sqrt(price_ratio) / (1 + price_ratio) - 1 Отметим: где price_ratio = current_price / entry_price. При IL > 5% — предупреждение пользователю.
Процесс работы
| Этап | Длительность | Что делаем |
|---|---|---|
| Дизайн и прототип | 3-5 дней | Figma, определение операций (swap/LP/history), user flow |
| Frontend разработка | 1.5-2 недели | Wallet connection, token list, swap interface, transaction history |
| Blockchain интеграция | 1 неделя | StonFi/DeDust message building, transaction submission, status polling |
| Тестирование | 3-5 дней | На реальных устройствах iOS/Android, TON testnet |
| Деплой | 1 день | Статика на Vercel/Netlify + домен, регистрация через BotFather |
Что входит в разработку
- Интеграция TON Connect и поддержка нескольких кошельков (Tonkeeper, MyTonWallet).
- Полноценный интерфейс свопа с маршрутизацией через StonFi и DeDust.
- Отображение графиков цен (TradingView Lightweight Charts).
- Механизм кеширования jetton wallet адресов для быстрой загрузки балансов.
- Обработка асинхронных транзакций с polling статуса и bounced messages.
- Адаптив под темы Telegram (тёмная/светлая) и нативные элементы (MainButton, HapticFeedback).
- Техническая документация и обучение команды.
Мы разрабатываем DeFi-сервисы более 10 лет, реализовали 30+ проектов на Ethereum, Solana и TON. Каждый код проходит аудит с использованием Slither и Mythril. Гарантируем стабильную работу смарт-контрактов и соблюдение сроков. Свяжитесь с нами для оценки вашего проекта — мы предложим оптимальное решение с учётом ваших бизнес-требований. Закажите разработку DEX Mini App и получите консультацию инженера.







