TON Explorer: как читать транзакции вручную

Научишься читать адрес, транзакцию и сообщение в публичном эксплорере TON и сверять их с данными из API.

Зачем эксплорер разработчику

Эксплорер — UI поверх тех же ончейн-данных, что ты читаешь через API. Нужен, чтобы глазами проверить деплой, bounce, сумму, opcode и цепочку сообщений, когда тест или бэкенд ведут себя странно.

Популярные mainnet-интерфейсы: tonviewer.com и tonscan.org. У каждого свой testnet-хост — не открывай mainnet-ссылку, если деплоил в testnet.

Разбор адреса и транзакции

Открой адрес контракта (пример mainnet) и сверь поля с API:

text

https://tonviewer.com/EQCD39VS5jcptHL8vMjEXrzGaRcCVYto7HUn4bpAOg8xqB2N

Что смотреть на карточке аккаунта:

Поле в UI	Что это значит
Balance	Нативный баланс (GRAM)
Status / State	`active`, `uninit`, `frozen`
Contract / Interfaces	Распознанный тип (wallet, jetton wallet, …)
Transactions	Список tx по этому адресу

Открой одну транзакцию и зафиксируй:

text

tx hash     — идентификатор транзакции
lt / now    — логическое время и unix-время
in_msg      — входящее сообщение (откуда, value, body)
out_msgs    — исходящие (часто несколько в одной tx)
compute     — exit code фазы вычисления (0 = ok)
action      — результат отправки исходящих

Сверка с Toncenter (тот же адрес):

bash

# Toncenter API v2
curl -s "https://toncenter.com/api/v2/getTransactions?address=EQCD39VS5jcptHL8vMjEXrzGaRcCVYto7HUn4bpAOg8xqB2N&limit=5" \
  -H "X-API-Key: $TONCENTER_API_KEY"

Hash из UI должен совпасть с полем транзакции в JSON. Если exit code ≠ 0 — смотри справочник exit codes и тело сообщения.

Как это работает

Эксплорер ходит в индексёр/API и рисует те же account / transaction / message.
Одна «операция» пользователя часто = цепочка tx (wallet → contract → jetton wallet). В UI это trace / graph.
Bounce видно по флагу и обратному сообщению с остатком value — типичная причина «деньги вернулись».
User-friendly адрес с разным bounceable-битом — тот же аккаунт; raw (0:hex) удобнее для логов и вебхуков.

Частые ошибки

Смотришь mainnet, а деплой был в testnet → «контракта нет». Переключи сеть в эксплорере или открой testnet-хост.

Ищешь «событие Transfer» как в Etherscan logs → в TON нет единых logs. Смотри body сообщения, opcode и выходные сообщения; для UX-ленты — TonAPI events.

Путаешь hash сообщения и hash транзакции → разные идентификаторы. Для отладки деплоя обычно нужен transaction hash или trace id.

Что дальше

Внутренние и внешние сообщения — что именно видно в in/out
Toncenter API — те же данные из кода
Мониторинг событий контракта — автоматизировать то, что сейчас смотришь руками

Материалы gramdocs.tech носят образовательный характер и не являются финансовой, юридической или инвестиционной рекомендацией. Работа с блокчейном TON и токеном Gram связана с рисками потери средств. Правовая информация