Смарт-аккаунты Ethereum: UserOperation, bundler и спонсирование газа

Обычный внешний аккаунт (EOA) подтверждает контроль подписью закрытого ключа, а nonce задаёт порядок транзакций. Модель проста, но обычно одним ключом разрешаются все действия.

В транзакции EOA есть одно действие верхнего уровня, однако вызванный контракт может выполнить и другие внутренние вызовы.

Руководство по ожидающим транзакциям Ethereum описывает этот путь EOA, отличный от ERC-4337.

Смарт-аккаунт — контракт, который может хранить активы и выполнять вызовы. Его проверка может требовать одну подпись, порог нескольких подписей или разрешения с истекающим сроком.

ERC-4337 задаёт интерфейс для подтверждения и выполнения операций, а не конкретный кошелёк или политику восстановления.

Ethereum.org описывает резервные ключи и спонсирование газа как возможные функции, а не обязательные возможности каждого кошелька.

Название «смарт-кошелёк» не говорит само по себе, кто им управляет. Проверьте контракт с активами, код и EntryPoint, которым доверяет аккаунт, а также подписантов, способных разрешать вызовы.

Если логику можно обновлять, права администратора и порядок изменений тоже влияют на контроль активов.

UserOperation описывает намерение смарт-аккаунта. Обычно в ней есть адрес аккаунта-отправителя, его nonce, данные вызова, подпись, лимиты газа и условия комиссий.

Дополнительно могут передаваться данные фабрики для создания аккаунта или данные paymaster для спонсирования. Точный набор полей зависит от версии EntryPoint.

Кошелёк не отправляет этот объект в сеть обычным способом eth_sendTransaction, а передаёт bundler или relay с ERC-4337 RPC, например eth_sendUserOperation. Запрос проходит через отдельный пул UserOperation, а не пул транзакций EOA.

Хэш UserOperation идентифицирует запрос; у созданной bundler транзакции в сети отдельные хэш и квитанция. ERC-7769 задаёт RPC для отправки и проверки результатов.

Ответ bundler может означать, что запрос прошёл его проверки и попал в его пул.

Он не доказывает включение в блок или успех действия приложения. Передача запроса другим bundler зависит от инфраструктуры и политики. Различайте подтверждение провайдера и результат в блокчейне.

Получив UserOperation, bundler проверяет совместимость с версией EntryPoint и моделирует проверку аккаунта и paymaster. Он проверяет подпись, доверие к EntryPoint, nonce, газ и условия спонсирования.

Запрос, нарушающий правила или не прошедший симуляцию, могут отклонить. Руководство ERC-4337 по bundler описывает симуляцию и отправку пакета.

Затем bundler выбирает одну или несколько операций, прошедших проверки, и создаёт обычную транзакцию Ethereum с вызовом handleOps у EntryPoint. Включение этой транзакции в блок по-прежнему зависит от производства блоков и состояния сети.

Возвращённый хэш UserOperation не доказывает исполнение в канонической цепи. Пул UserOperation отличается от пула EOA; разные провайдеры могут видеть разные запросы.

Bundler может отклонить операцию или оставить её ждать, а поддерживаемые сети, версии EntryPoint и правила отличаются. Проверяя статус, отделяйте интерфейс кошелька, квитанцию операции и сетевую квитанцию пакетной транзакции.

EntryPoint получает вызов handleOps от bundler и вызывает функцию проверки каждого смарт-аккаунта.

Аккаунт проверяет доверенный EntryPoint, подпись и собственные правила доступа. Nonce ERC-4337 включает 192-битный ключ и 64-битную последовательность.

EntryPoint проверяет и увеличивает последовательность для каждой пары аккаунта и ключа; аккаунт может задать ключу особый смысл или дополнительные правила. Необязательный paymaster также проверяет, будет ли он спонсировать операцию.

После успешной проверки EntryPoint вызывает функцию исполнения аккаунта, выполняет действие из callData и рассчитывает стоимость. EntryPoint — общий контракт, позволяющий строить потоки смарт-аккаунтов без изменения протокола для каждого кошелька.

Руководство ERC-4337 по EntryPoint подробнее описывает проверку и расчёт. Проверяйте фактический адрес, версию и сеть. Симуляция — полезный предварительный просмотр, но не обещание включения.

Пока запрос ждёт, могут измениться состояние цепи, комиссии, окно действительности или внешний контракт. Даже при успешной проверке вызов приложения может завершиться ошибкой или откатом.

Само включение в блок не доказывает, что перевод или действие прошли успешно.

Если UserOperation содержит данные paymaster, EntryPoint спрашивает этот контракт, готов ли он взять расходы на себя. Приложение может оплатить комиссию или дать пользователю начать без ETH на аккаунте.

В некоторых схемах возможна оплата токеном или другие требования, зависящие от кошелька и paymaster. Спонсирование не устраняет стоимость. Paymaster может ограничить приложения, пользователей, число операций или сумму, проверить запрос и отказать.

Его депозит в EntryPoint используется для оплаты. Если правила требуют отдельный stake, это залог, а не тот же доступный остаток для газа.

Руководство ERC-4337 по paymaster и EIP-4337 описывают проверку и расчёт.

Нулевая комиссия в интерфейсе приложения не означает отсутствия затрат. Спонсор может сначала заплатить, а затем получить компенсацию через подписку, токен или условия сервиса.

Проверьте, кто в итоге несёт расходы, какие действуют лимиты и может ли неудачная операция всё равно потребовать оплату газа.

Если кошелёк поддерживает такой режим, одна UserOperation может содержать одобрение приложения и обмен. Оба действия проходят через EntryPoint как одна операция.

Это отличается от одной обычной транзакции EOA и от объединения bundler нескольких отдельных UserOperation в одну транзакцию сети. Проверьте предварительный просмотр кошелька.

Условный пример: фактическая стоимость газа для одобренной спонсируемой операции составляет 0,0012 ETH. Её могут списать из депозита paymaster в EntryPoint, а не из баланса пользователя. Это число приведено для примера, а не как текущая котировка.

Реальная стоимость зависит от использованного газа, условий комиссии и сети. Объединение не всегда дешевле или безопаснее. Атомарность нескольких вызовов зависит от обработки сбоев конкретным аккаунтом.

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

Руководство по комиссиям Ethereum объясняет поля комиссии.

В аккаунте могут быть резервные подписанты или процесс, при котором доверенные guardians заменяют ключ после достижения порога. Некоторые схемы дают время на возражение со старого ключа. Если же всегда нужна одна подпись, потеря ключа может закрыть доступ.

ERC-4337 позволяет аккаунту задавать собственные правила, но не включает резервные ключи или социальное восстановление автоматически. Малое число guardians или слабые правила замены ключа могут открыть путь атаке.

Слишком много guardians или строгие требования могут задержать владельца. Проверьте порог, задержку, право отмены и хранение ключей восстановления. Эти правила определяют, кто может не только подтвердить, но и блокировать операцию.

Контрактный кошелёк не является автоматически кастодиальным или некастодиальным. Контроль зависит от держателей ключей, прав администратора или обновления, а также полномочий внешнего подписанта или службы восстановления.

Проверяйте контракт с активами отдельно от ключей и служб управления. Руководство по восстановлению seed-фразы посвящено другому типу восстановления.

В предварительном просмотре кошелька проверьте сеть, адрес аккаунта, целевые контракты, данные вызова, пределы одобрения токенов и число вызовов. Подпись может разрешить больше, чем действие, выделенное интерфейсом.

Если данные непонятны, прочитайте официальную документацию приложения и кошелька. Чтобы понять спонсирование, прочитайте условия допуска, лимиты использования, альтернативные способы оплаты и правила оплаты при сбое, а не полагайтесь лишь на имя paymaster.

Активная отметка спонсирования не означает безусловную бесплатность, и paymaster всё ещё может отклонить запрос. Загрузка сети и задержка блока — отдельные факторы.

Если UserOperation долго ждёт, не применяйте автоматически «ускорение» или «отмену» для транзакций EOA. Сначала найдите хэш и квитанцию операции. Если известен хэш транзакции bundler, проверьте также квитанцию блока и результат исполнения.

RPC-квитанции могут отличать реальную стоимость и успех операции от квитанции всего пакета.