← До списку документів
Лупа над порожньою квитанцією, бурштиновий кристал, зачинена коралова й відчинена бірюзова брами

Ресурси надійшли, але переказ не вдався: як читати квитанцію TRON

Знайдіть txID самого переказу та розрізняйте трансляцію, остаточне підтвердження й виконання контракту. Перевірте REVERT, OUT_OF_ENERGY або невизначений результат перед повторною оплатою.

Lunaria Miri Energy

Надходження ресурсів не підтверджує переказ

Енергія, яку видно на рахунку відправника, показує ресурси на момент запиту, але не доводить успішність переказу USDT TRC-20. Надання орендованих ресурсів і переказ токена — різні події. Перевіряйте ідентифікатор самого переказу (txID), а не запис оплати чи делегування ресурсів.

У надійному гаманці або оглядачі перевірте мережу, відправника та потрібний переказ токена. Нижче наведено назви полів із документації TRON без припущень про конкретні кнопки гаманця чи платформи.

Підтвердьте транзакцію, потім перевірте виконання

Відповідь трансляції result: true означає лише, що виклик не повідомив про помилку. Це не доказ підтвердження чи успішного виконання контракту. GetTransactionById повертає тіло транзакції; GetTransactionInfoById — комісії, використання ресурсів, статус і журнали після виконання.

Для остаточного підтвердження використовуйте дані остаточно підтвердженого ланцюга: /walletsolidity/gettransactionbyid для тіла транзакції, а для контрактної транзакції також /walletsolidity/gettransactioninfobyid для квитанції. Методи /wallet показують найновіший стан вузла, який ще може бути неостаточним. Надійна підтримка гаманця може пояснити ці стани; запит не потребує підпису чи переказу.

Оберіть дію за результатом

  • Квитанції або ключового результату немає: позначте результат як невизначений і далі перевіряйте початковий txID. Одна порожня відповідь не доводить невдачу. Спочатку перевірте наявність тіла транзакції в остаточно підтвердженому ланцюзі; не платіть повторно одразу.
  • Якщо є остаточна квитанція контракту, перевірте, що result верхнього рівня не має значення FAILED, а потім прочитайте receipt.result. SUCCESS означає успішне виконання контракту. Для підтвердження переказу токена також звірте токен, одержувача, суму й відповідні журнали переказу.
  • REVERT означає відкат виконання, можливо, через невиконану умову контракту. Перевірте contractResult і деталі помилки. Повернені дані можуть не містити читабельного пояснення; не припускайте нестачу енергії.
  • OUT_OF_ENERGY означає нестачу енергії під час виконання. Повторіть оцінку з урахуванням тодішніх ресурсів, TRX і fee_limit. Інші помилки потребують окремої діагностики; додаткова енергія не є універсальним рішенням.

Збережіть докази перед новою спробою

У приватних записах збережіть час запиту, мережу, початковий txID, остаточний статус, receipt.result, помилку та спожиті ресурси. Приховуйте чутливі дані на знімках і не публікуйте повні адреси чи платіжні дані у відкритих групах. Для запиту квитанції не потрібні фраза відновлення чи приватний ключ.

Навчальний приклад: зараз енергії достатньо, але початкова квитанція містить REVERT. Перевірте умови контракту, а не просто додавайте енергію. За невизначеного результату продовжуйте перевіряти початкову транзакцію. Нову розглядайте лише після підтвердження невдачі та усунення причини. Пізніше надходження ресурсів не змінює результат уже виконаної транзакції; невдала спроба також може споживати ресурси або спричиняти комісії.

Джерела