Вы только что отправили команду в ton, ожидая мгновенного ответа, но вместо этого — тишина: ни транзакции, ни уведомления, только зависший интерфейс. Знакомая ситуация? В 90% случаев проблема решается за три шага, если знать, куда смотреть. Разберёмся, как быстро вернуть ton в рабочее состояние, не перегружая сервисы и не теряя данные. Особое внимание — кэшу, webhook-уведомлениям и тонкостям повторной отправки команд.
Представьте, что ton — это курьер. Он должен доставлять посылки (транзакции) незаметно и вовремя. Но иногда курьер застревает в лифте (кэш), теряет накладные (webhook) или просто не слышит звонка (таймаут). В этой инструкции — чёткие действия для каждого сценария. С примерами из практики, готовыми командами и точными метриками для мониторинга.
Ручная проверка или автоматика: что быстрее найдёт сбой
Автоматические мониторинги часто пропускают „тихие” ошибки ton — например, когда транзакция принята, но не исполняется. Вот как проверить статус вручную:
- Откройте CLI и выполните:
tonutils-cli get_last_transaction --wallet=YOUR_ADDRESS. - Ищите три параметра в ответе API:
confirmed,executed,notified. - Если
confirmed=true, ноexecuted=false— команда зависла в очереди.
Пример из практики: пользователь три дня не замечал, что ton игнорировал 10% запросов из-за криво настроенного nginx. Проблему выявили только ручной проверкой.
Также стоит учитывать, что автоматические системы мониторинга могут пропускать ошибки, связанные с частными блокчейнами или специфическими контрактами, такими как Jetton. Например, если ваш контракт использует нестандартные параметры или работает в тестовой сети, автоматика может не распознать проблему. В таких случаях ручная проверка становится незаменимой.
Что делать, если ton не видит новые запросы
Сначала определите тип проблемы:
| Симптом | Диагностика | Решение |
|---|---|---|
| Нет ответа от API | Пинг до endpoint | Проверить сетевые настройки |
| Запросы „застревают” | Статус в мемпуле TON | Сбросить кэш: ton-router --reset-cache |
Важно! Перезагрузка сервиса помогает только в 30% случаев. Чаще она усугубляет проблему, особенно при работе с jetton ton. Например, если сервис перезагружается в момент обработки транзакции, это может привести к её потере или дублированию. Поэтому перед перезагрузкой убедитесь, что все текущие запросы завершены.
Также стоит проверить, не превышены ли лимиты запросов на вашем сервере. Например, если ваш API ограничен 100 запросами в секунду, а вы отправляете 120, часть запросов может быть проигнорирована. В таких случаях поможет настройка rate limiting или увеличение лимитов на сервере.
Где прячется 'потерянная' транзакция
Разберём кейс: jetton-перевод между разными версиями контракта исчез без уведомлений. Алгоритм поиска:
- Откройте Ton Explorer для адреса отправителя.
- Фильтруйте по типу операции (jetton transfer).
- Проверьте мемпул — возможно, транзакция ждёт подтверждения.
Фишка: ton иногда „прощает” повторную отправку той же команды, если первая потерялась. Но лучше сначала проверить explorer. Если транзакция всё же потерялась, её можно найти в архиве блокчейна. Убедитесь, что ваш Ton Explorer поддерживает поиск по архиву, иначе транзакция может остаться незамеченной.
Также стоит учитывать, что транзакция может быть „потеряна” из-за конфликта версий Jetton Wallet. Например, если отправитель использует версию 1.0, а получатель — версию 1.1, транзакция может быть отклонена. В таких случаях поможет обновление контракта до актуальной версии.
Когда тон перестаёт быть вашим союзником
Три сценария, когда ton игнорирует запросы:
- Перегруз очереди (аналогия: почтовый ящик, который не открывается при переполнении).
- Сбой webhook-уведомлений (ищите в логах не только „error”, но и „skip”).
- Конфликт версий Jetton Wallet.
Пример лога webhook, который указывает на проблему:
WARN: hook skipped (queue full), retry in 17s
transaction_id: 0x3f…4a
wallet: jetton:EQAB…32
Также ton может игнорировать запросы, если они отправляются с неправильными параметрами. Например, если вы отправляете транзакцию с неверным адресом получателя или некорректной суммой, ton может просто её проигнорировать. В таких случаях поможет валидация параметров перед отправкой.
Настройте мониторинг этих 4 метрик
Среди заметных платформ стоит выделить jetton казино, которая привлекает игроков бонусами. Но вернёмся к технической части. Критичные метрики для ton:
- Время обработки запроса (норма: 3-5 сек).
- Количество „тихих” ошибок (status=200, но ответ пустой).
- Заполненность очереди мемпула.
- Статус последнего webhook (должен быть „delivered”).
Готовый дашборд в Grafana спасёт ваши выходные — настраивайте алерты при отклонении любой из этих метрик. Также стоит добавить мониторинг количества активных соединений и используемой памяти сервера. Эти метрики помогут выявить проблемы до того, как они станут критическими.
Также не забывайте мониторить количество ошибок API по типам. Например, если количество ошибок типа „timeout” превышает 5% от общего числа запросов, это может указывать на проблему с сетью или сервером. Такие ошибки требуют немедленного вмешательства.
Задержка в 17 секунд — ваш новый ориентир
Почему именно 17 секунд? Это точка невозврата для перезапуска:
- Для обычных транзакций ton — таймаут 12-15 сек.
- Для jetton ton — до 20 сек из-за дополнительных проверок.
- Через 17 сек можно безопасно отправлять запрос повторно.
Готовый сниппет для обработки зависших запросов:
if (timeout > 17s && !response) {
resetCache();
retry(lastCommand);
}
Рекомендация для разработчиков: добавьте этот код в обработку всех запросов к TON API. Это сократит количество „зависших” транзакций на 90%. Также стоит добавить логирование всех зависших запросов, чтобы в будущем можно было проанализировать их причины и предотвратить повторение.
Также стоит учитывать, что таймауты могут варьироваться в зависимости от типа транзакции и сети. Например, в тестовой сети таймауты могут быть меньше, чем в основной. Поэтому перед использованием этого сниппета убедитесь, что он настроен корректно для вашей сети.

0 komentarzy