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

Транзакция Ethereum завершилась ошибкой: как прочитать receipt

Различи null receipt, status 0 и status 1 в Ethereum. Проверь сеть, gasUsed и результат контракта, прежде чем решать, повторять ли действие.

Материал подготовлен с помощью ИИ; документация Ethereum проверена редакцией ZASLON 6 ноября 2026 года. Хеши и данные синтетические.

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

Transaction hash в Ethereum позволяет искать исполнение, но сам по себе не означает, что контракт выполнил нужное действие. Сначала убедись, что смотришь правильную сеть, затем получи receipt и различай три результата: receipt пока нет (null), транзакция включена и завершилась с status: 0x0, либо включена с status: 0x1. Статус 0 не раскрывает причину ошибки.

Шаг 1. Проверь сеть и hash

Сопоставь chain ID приложения с сетью в explorer или RPC. Один и тот же формат хеша используется в разных сетях; неверная сеть может показать «не найдено». Проверь, что скопировал полный hash без пробелов, и повтори чтение у провайдера этой сети. Не публикуй адреса, если они раскрывают нежелательную историю; никогда не передавай seed phrase или private key.

Для проверки сети сначала выполни read-only eth_chainId на том же RPC и сравни полученное значение с сетью приложения. Для Ethereum Mainnet это 0x1; другие EVM-сети имеют собственные ID. Затем запроси receipt. Шаблон ниже содержит обозначение хеша: замени всю строку на настоящий hash из своей операции, не добавляя приватных ключей. Методы и поля описаны в Ethereum JSON-RPC:

{"jsonrpc":"2.0","id":1,"method":"eth_getTransactionReceipt","params":["0x<SYNTHETIC_TRANSACTION_HASH>"]}

Официальная спецификация допускает null, когда receipt недоступен, например пока транзакция ожидает включения. Но это не единственное объяснение: провайдер мог не видеть неизвестный hash, запрос мог уйти в другую сеть, либо индексатор/RPC ещё не обновился. Сверь chain ID, transaction pool/статус отправителя и другой надёжный RPC. Не считай null доказательством ни успеха, ни окончательного отказа.

Шаг 2. Если receipt есть — прочитай статус

Receipt содержит block number, sender, адрес назначения, использованный газ и status. Условный ответ может выглядеть так:

{
  "transactionHash":"0x<SYNTHETIC_TRANSACTION_HASH>",
  "status":"0x0",
  "blockNumber":"0x123456",
  "gasUsed":"0x7530",
  "effectiveGasPrice":"0x3b9aca00"
}

Здесь status: 0x0 означает, что выполнение транзакции завершилось неуспешно. gasUsed не ноль: вычисления были выполнены, и комиссия за использованный газ списывается, хотя изменения состояния, сделанные внутри откатившейся транзакции, не сохраняются. В учебном ответе 0x7530 = 30 000 единиц газа, 0x3b9aca00 = 1 000 000 000 wei за единицу (1 gwei). Их произведение — 30 000 000 000 000 wei, то есть 0,00003 ETH. Это расчёт исполнения обычной транзакции Ethereum по синтетическим значениям, не текущая рыночная комиссия. Не путай gasUsed с лимитом газа. Объяснение списания и единиц есть в Ethereum: gas and fees.

status: 0x1 говорит об успешном завершении EVM-вызова, но не гарантирует, что пользователь получил ожидаемый результат: например, контракт мог успешно обработать альтернативную ветку, а интерфейс — неверно прочитать событие. Сверь адрес to, событие/изменение состояния и отображение в приложении.

Шаг 3. Не угадывай причину revert

Receipt обычно не содержит человекочитаемого текста причины. Проверь transaction input, контракт и события, а также диагностические данные приложения. Историческая трассировка конкретной транзакции может показать внутреннее исполнение; её доступность зависит от узла и сохранённых данных. Новая симуляция на текущем состоянии — другая проверка и может дать иной результат. Не подменяй ею историческое доказательство; ограничения RPC описаны в go-ethereum. Не выводи причину только из status: 0x0.

Перед повтором сверь nonce, ожидаемое состояние и историю действий: не был ли уже создан объект, исполнен другой шаг или отправлен отдельный платёж. Не запускай вторую транзакцию вслепую. Для синтетического примера с неудачным вызовом контракта сначала фиксируются hash, сеть, адрес назначения, nonzero gasUsed и отсутствие ожидаемого результата в состоянии приложения; затем изучается ошибка dapp или запрашивается поддержка. Повтор возможен лишь после понимания, какое действие будет выполнено снова.

Короткая таблица диагностики

Наблюдение Что проверить Чего не заключать сразу
Receipt null Hash, chain ID, RPC, подтверждение/ожидание Что транзакция точно pending или точно не существует
status: 0x0 input, контракт, trace/error, расход газа Причину ошибки по одному статусу
status: 0x1 ожидаемое событие и изменение состояния Что интерфейсное действие завершено как задумано

ИИ можно дать обезличенный receipt и попросить объяснить поля, но не доступ к кошельку или секреты. Попроси явно перечислить несколько возможных причин null и отметить, что status 0 не сообщает revert reason. Итог диагностики должен опираться на правильную сеть и данные приложения/контракта, а не на догадку модели.

Если операция ещё ожидает включения, см. отдельный разбор зависшей транзакции и nonce.

Материал подготовлен с помощью ИИ; документация Ethereum и go-ethereum проверена редакцией 6 ноября 2026 года. Все хеши и значения в примерах синтетические; транзакции не выполнялись.