Мы интегрируем торговых ботов с STON.fi SDK для автоматизированной торговли на DEX в блокчейне TON. TON принципиально отличается от EVM: асинхронная модель сообщений, actor model и свои fee-механики. Наш опыт в блокчейн-разработке (5+ лет, более 10 проектов на TON) позволяет учесть все нюансы и построить надежного бота под ключ.
Почему TON сложнее EVM для бота?
Асинхронная модель транзакций
В Ethereum транзакция либо выполнилась, либо ревертнулась — всё синхронно в одном блоке. В TON контракты общаются через асинхронные сообщения. Отправив swap-сообщение на STON.fi router, вы не знаете результат немедленно. Нужно слушать входящие сообщения на адрес кошелька (transfer notification от jetton) или polling состояния через TON API.
Это означает: бот должен иметь state machine для каждой операции. Отправили swap → ждём подтверждения → если нет за N секунд → retry или алерт. Простая send-and-forget логика приводит к потере транзакций.
Каждое сообщение в TON кодируется как Bag of Cells (BoC). Для парсинга входящих уведомлений требуется декодировать BoC и извлекать поля, такие как jetton amount и sender. STON.fi SDK предоставляет типы для этого, но интеграция требует настройки TON listener.
Официальная документация STON.fi SDK рекомендует использовать queryId для отслеживания операций — он включается в ответные сообщения и позволяет сопоставить запрос с результатом.
Как интегрировать бота с STON.fi SDK?
Установка и конфигурация
import { DEX, pTON } from "@ston-fi/sdk"; import TonWeb from "tonweb"; const tonweb = new TonWeb( new TonWeb.HttpProvider("https://toncenter.com/api/v2/jsonRPC", { apiKey: process.env.TONCENTER_API_KEY }) ); const router = tonweb.open( new DEX.v1.Router("EQB3ncyBUTjZUA5EnFKR5_EnOMI9V1tTEAAPaiU71gc4TiUt") ); STON.fi SDK v2 поддерживает DEX v1 и v2 пулы. Для нового кода используем v2 router — он поддерживает более сложные routing сценарии и лучшую интеграцию с API.
Получение котировок
const pool = await router.getPool({ token0: "EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c", // TON token1: USDT_JETTON_ADDRESS }); const data = await pool.getData(); // data.reserve0, data.reserve1 — текущие резервы // Рассчитываем ожидаемый output через AMM формулу SDK предоставляет getExpectedOutputs() для расчёта слиппеджа. Важно: котировки устаревают быстро на активном рынке. Для торгового бота — кэшировать не дольше 5-10 секунд.
Выполнение свопа
const swapTxParams = await router.buildSwapTonToJettonTxParams({ userWalletAddress: wallet.address, proxyTon: new pTON.v1(), offerAmount: new TonWeb.utils.BN("1000000000"), // 1 TON в nanotons askJettonAddress: USDT_JETTON_ADDRESS, minAskAmount: expectedOutput.mul(99).div(100), // 1% slippage tolerance queryId: Date.now() // уникальный id для tracking }); await wallet.sendTransfer({ secretKey: keyPair.secretKey, toAddress: swapTxParams.to, amount: swapTxParams.gasAmount, seqno: await wallet.getSeqno(), payload: swapTxParams.payload }); queryId — критически важный параметр для tracking. Он включается в сообщения ответа и позволяет сопоставить swap-запрос с результатом в асинхронной модели.
| Аспект | EVM | TON |
|---|---|---|
| Модель | Синхронная (всё в одном блоке) | Асинхронная (сообщения) |
| Отслеживание | tx receipt | state machine + polling |
| Газ | upfront, реверт при нехватке | forward fees по цепочке |
| SLIPPAGE | менее критичен | критичен из-за задержек |
Как построить архитектуру торгового бота под TON?
Price monitor: периодический polling цен через STON.fi API (https://api.ston.fi/v1/pools) или прямые on-chain запросы. API удобнее — возвращает нормализованные данные по всем пулам. On-chain надёжнее при ненадёжном API.
Strategy engine: логика торговых решений. Для арбитражного бота — сравнение цен STON.fi с другими TON DEX (DeDust). Для трендового бота — технические индикаторы на исторических ценах из API.
Transaction manager: очередь транзакций с retry логикой. TON требует правильного seqno для кошелька — параллельная отправка приводит к ошибкам. Транзакции отправляем последовательно или через отдельные sub-wallets.
Result tracker: polling последних транзакций кошелька через TON API для подтверждения выполнения свопов. https://toncenter.com/api/v2/getTransactions?address=...
Управление газом на TON
TON использует модель gas, отличную от Ethereum. Для jetton-swap нужно отправить достаточно TON для оплаты forward fees по цепочке сообщений: router → jetton wallet → user wallet. STON.fi SDK возвращает правильный gasAmount в buildSwapTxParams — не занижайте его «из экономии». Если газа не хватит — сообщение просто не дойдёт, и funds могут зависнуть на промежуточном контракте. Оптимизация газа позволяет сэкономить до 30% на комиссиях, а фиксированная стоимость разработки исключает перерасход бюджета.
Что входит в нашу работу?
| Этап | Срок | Результат |
|---|---|---|
| Анализ требований и стратегии | 1 день | Техническое задание |
| Проектирование архитектуры | 1-2 дня | Документ архитектуры |
| Разработка интеграции SDK и логики | 2-4 дня | Рабочий бот с мониторингом |
| Тестирование (unit, integration, fuzzing) | 1-2 дня | Отчёт о тестировании |
| Развёртывание и обучение команды | 1 день | Доступы, документация, инструкции |
Все работы выполняются под ключ с гарантией 30 дней на выявленные баги. Мы используем формальную верификацию критических контрактов.
Наш опыт и гарантии
- Опыт в Web3-разработке с 2019 года, более 10 проектов на TON/STON.fi
- Гарантия безопасности: код проверяется Slither, Mythril и Echidna
- Сертифицированные инженеры (Ethereum, Solana, TON)
- Экономия на комиссиях до 30% за счёт оптимизации газа
Свяжитесь с нами для оценки вашего проекта. Мы предложим оптимальное решение под ключ за 1-2 недели. Получите консультацию по интеграции уже сегодня.
Ссылки: