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

ERC-4337: как отличить отправленный UserOperation от исполненной операции

Как проверить результат ERC-4337 UserOperation: отличить ответ bundler, включение в bundle и успешное исполнение конкретной операции.

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

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

Статус submitted обычно подтверждает лишь передачу UserOperation в bundler или принятие запроса его интерфейсом. Чтобы понять, исполнено ли конкретное действие smart account, сверяй userOpHash, receipt именно этой операции, внешнюю транзакцию bundle, её статус и логи/эффект контракта. Успешная внешняя транзакция bundle не обязательно означает успешное выполнение каждого вложенного UserOperation.

В ERC-7769 описан eth_getUserOperationReceipt: ответ может быть null, если операция ещё не включена в блок; когда receipt есть, в нём есть отдельное поле success, а вложенный receipt относится ко всей внешней транзакции bundle. ERC-7769 — Draft, и поддержка метода зависит от bundler/RPC-провайдера. Проверь endpoint, сеть и конкретный ответ поставщика. null сам по себе не означает, что операция потеряна. ERC-7769: JSON-RPC API, спецификация ERC-4337.

Четыре разных этапа

  1. Запрос отправлен. Кошелёк передал UserOperation в bundler. Запиши userOpHash из ответа; не подменяй его transaction hash.
  2. Bundler принял или обрабатывает запрос. Это состояние транспортного уровня/мемпула. Оно ещё не подтверждает включение в блок.
  3. Операция включена в bundle. Получи receipt конкретного userOpHash, если метод поддерживается, и сохрани внешний transactionHash.
  4. Проверь два уровня результата. receipt.status внешней транзакции показывает, завершилась ли bundle-транзакция на уровне EVM. success в UserOperation receipt показывает результат конкретной операции. Затем проверь логи и ожидаемое изменение состояния.

Имена и доступность API зависят от версии ERC-7769 и провайдера. Не смешивай поле конкретной реализации UI с полями стандарта. Для проверки используй документированный endpoint провайдера и привязанный им userOpHash.

Учебный пример: bundle успешен, отдельная операция — нет

Пусть один bundle содержит несколько UserOperation. Внешняя Ethereum-транзакция получает receipt.status = 1, то есть сама транзакция bundle выполнена без общего revert. Но ответ для интересующего userOpHash сообщает success = false. Это возможный сценарий: успех контейнера не равен успеху каждого действия внутри него. Не объявляй перевод успешным по одному внешнему status; проверь причину отказа, логи именно этой операции и состояние токена/контракта.

Проверка Результат в примере Что он подтверждает
userOpHash совпадает с кошельком Да Мы смотрим на ту операцию, о которой говорит UI
Внешний transactionHash найден в нужной сети Да Bundle включён в сеть; сохранена связь с транзакцией
receipt.status внешней транзакции 1 Внешний bundle не завершился общим revert
success для данного UserOperation false Именно эта операция не завершила исполнение успешно
Ожидаемый токен/event/state Не обнаружен Нельзя считать исходное действие выполненным

Все значения — учебные, не live-транзакция. Если receipt null, проверь, что запрос сделан к правильному bundler/chain и поддерживает ERC-7769, затем повтори read-only запрос после задержки. Сохрани исходный userOpHash, время, chain ID и ответ RPC. Не создавай новый UserOperation с тем же намерением до того, как выяснишь, не включена ли первая операция другим endpoint.

Минимальная запись для поддержки

Передай chain ID, адрес smart account, userOpHash, ответ bundler, время отправки и transaction hash/receipt, если они появились. Исключи подписи, seed phrase и секреты. Если разные провайдеры показывают несовместимые состояния, приостанови повторное действие и проверь события/состояние контракта на надёжном обозревателе.

Так ты разделишь передачу, включение и результат операции, не выводя успех из одного статуса. Статья о sponsored gas в ERC-4337 описывает оплату газа, а не доказательство выполнения UserOperation.