Кальтер / Блог

USDT TRC20: как отличить тело транзакции от результата вызова контракта

Как проверить перевод USDT TRC20: отличить тело транзакции от результата контракта, сверить логи, получателя, сумму и расходы ресурсов.

Материал подготовлен с помощью ИИ; первичные источники и примеры проверены редакцией ZASLON 14 ноября 2026 года. Учебные данные и результаты сторонних компаний обозначены в тексте.

Редакционная схема: Результат TRC20. Условные обозначения, не скриншот сервиса или реальной операции.
Редакционная схема: Результат TRC20. Условные обозначения, не скриншот сервиса или реальной операции.

Для проверки перевода USDT TRC20 одного transaction body недостаточно. GetTransactionById показывает raw_data и параметры вызова, то есть что транзакция просила выполнить. GetTransactionInfoById возвращает post-execution receipt с результатом вызова, фактическими комиссиями/ресурсами и логами. Сверь оба ответа в одной сети, а затем проверь адрес USDT-контракта, получателя и количество в событии токена. Не отправляй перевод повторно, пока этот путь не пройден.

TRON docs прямо разделяют body и receipt; receipt появляется после on-chain исполнения. В самой структуре raw_data параметр smart contract call — не доказательство, что токены действительно перечислены. fee_limit задаёт верхний бюджет Energy для contract call, но не является фактически списанной комиссией. GetTransactionById, GetTransactionInfoById, структура и жизненный цикл транзакции TRON, API flow подписи и broadcast.

Какие поля отвечают на разные вопросы

Слой Где смотреть На что отвечает
Идентификатор txID Какой запрос/транзакцию искать в сети
Вызов raw_data.contract[0].type, parameter.value.contract_address, parameter.value.data Какой контракт и какие закодированные параметры были вызваны
Результат контракта receipt receipt.result и поле результата вызова Успешно ли завершилось исполнение по данным TRON API
Фактические ресурсы/списания receipt.energy_usage_total, energy_fee, net_usage, net_fee, fee там, где возвращаются Какие ресурсы и фактические суммы учтены в receipt
Перемещение токена log события контракта, включая адрес token contract и параметры Transfer Есть ли событие перевода ожидаемого токена, отправителя, получателя и количества

Названия и наличие полей зависят от endpoint и node/provider. Используй текущую документацию и сохраняй исходный ответ целиком; не предполагай, что любой обозреватель одинаково декодирует данные.

Синтетический пример без живого TXID

Условный ответ GetTransactionById содержит txID = [synthetic], тип TriggerSmartContract, адрес контракта [TRC20 token] и ABI-данные вызова transfer(recipient, amount). Это означает, что в body запрошен вызов функции перевода. Само наличие recipient и amount ещё не подтверждает результат.

В условном ответе GetTransactionInfoById receipt показывает receipt.result = SUCCESS, фактические значения energy_usage_total и energy_fee, а в log есть событие от того же token contract. Декодируй Transfer и сравни адрес отправителя, recipient и сумму с ожидаемым переводом. Только если сеть, contract address и событие совпадают, можно говорить, что нужный token transfer подтверждён этим свидетельством. Если receipt.result не SUCCESS, receipt отсутствует или событие относится к другому контракту/адресу, не считай ожидаемый перевод завершённым и не создавай замену до выяснения статуса.

Для числовой сверки возьмём ещё одно учебное условие: у проверенного контракта decimals = 6, а декодированный Transfer содержит value = 2500000. Отображаемое количество равно 2500000 / 10^6 = 2,5 токена. Если ожидалось 5, совпадения статуса и адреса недостаточно — сумма не соответствует заданию. Значение decimals надо проверить у конкретного контракта, а не угадывать по названию токена.

Этот пример описывает поля и условное состояние; это не реальный TXID, реальный ответ узла или рекомендация отправлять транзакцию.

Безопасная последовательность сверки

  1. Запиши сеть, адрес token contract, recipient, amount и txID из кошелька. Проверь, что используешь именно Tron mainnet или ту тестовую сеть, где отправлял.
  2. Запроси transaction body по txID. Сверь TriggerSmartContract, адрес контракта и ABI-параметры вызова. Не путай это с успешным переводом.
  3. Запроси GetTransactionInfoById по тому же txID. Если endpoint возвращает пустое тело/{}, это означает, что запись сейчас не найдена у этого источника; проверь full/solidified endpoint и повтори позже, не создавая дубликат.
  4. Дождись нужного состояния подтверждения. Для операций смарт-контракта используй solidified/confirmed receipt и проверяй и результат транзакции, и receipt.result согласно официальному API flow.
  5. Сверь событие Transfer с trusted token contract, отправителем, адресом получателя и точным количеством. Если данных нет или они противоречат ожиданию — остановись и уточни статус у кошелька/провайдера.
  6. Сверь фактическую комиссию и ресурсы с полями receipt. fee_limit из body — потолок Energy бюджета для вызова, а не чек о списании и не сумма комиссии.

Не публикуй seed, приватный ключ или полный набор личных адресов. Если нужно передать результат поддержке, отправь сеть, transaction ID и только необходимые поля. Для причины, почему вызову TRC20 нужны Energy/Bandwidth, смотри объяснение ресурсов для USDT TRC20.