Для проверки перевода 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, реальный ответ узла или рекомендация отправлять транзакцию.
Безопасная последовательность сверки
- Запиши сеть, адрес token contract, recipient, amount и
txIDиз кошелька. Проверь, что используешь именно Tron mainnet или ту тестовую сеть, где отправлял. - Запроси transaction body по
txID. СверьTriggerSmartContract, адрес контракта и ABI-параметры вызова. Не путай это с успешным переводом. - Запроси
GetTransactionInfoByIdпо тому жеtxID. Если endpoint возвращает пустое тело/{}, это означает, что запись сейчас не найдена у этого источника; проверь full/solidified endpoint и повтори позже, не создавая дубликат. - Дождись нужного состояния подтверждения. Для операций смарт-контракта используй solidified/confirmed receipt и проверяй и результат транзакции, и
receipt.resultсогласно официальному API flow. - Сверь событие
Transferс trusted token contract, отправителем, адресом получателя и точным количеством. Если данных нет или они противоречат ожиданию — остановись и уточни статус у кошелька/провайдера. - Сверь фактическую комиссию и ресурсы с полями receipt.
fee_limitиз body — потолок Energy бюджета для вызова, а не чек о списании и не сумма комиссии.
Не публикуй seed, приватный ключ или полный набор личных адресов. Если нужно передать результат поддержке, отправь сеть, transaction ID и только необходимые поля. Для причины, почему вызову TRC20 нужны Energy/Bandwidth, смотри объяснение ресурсов для USDT TRC20.
