Zelcore

Архитектура ERC-4337: EntryPoint, бандлеры и пеймастеры без слёз

8 мин чтения
Архитектура ERC-4337: EntryPoint, бандлеры и пеймастеры без слёз

У абстракции аккаунтов в Ethereum есть два канонических адреса, которые стоит запомнить. EntryPoint v0.6 расположен по адресу 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789. EntryPoint v0.7, развернутый в начале 2024 года, — по адресу 0x0000000071727De22E5E9d8BAf0edAc6f37da032. Все транзакции ERC-4337 в основной сети, Arbitrum, Optimism, Base, Polygon и большинстве других EVM-сетей проходят через один из этих двух одиночных контрактов. Если вы понимаете, что делают эти контракты и какие пять ролей их окружают, значит, вы понимаете ERC-4337.

Это вторая часть нашей серии о смарт-аккаунтах. В первой части мы рассказали, почему EOA — плохой вариант по умолчанию. Теперь заглянем под капот: разберём шесть ролей, структуру UserOperation, то, что происходит при обмене токена со смарт-аккаунта, изменения между v0.6 и v0.7, пеймастеров, публичные альтернативные мемпулы и приватных бандлеров, а также ожидаемые дополнительные расходы.

Шесть ролей на одной схеме

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

Запомните этот состав участников. Остальная часть статьи посвящена их взаимодействию.

Структура UserOperation

UserOperation — это набор полей в формате, удобном для JSON-RPC. После подписания он выражает намерение, но пока не отправляет его в L1. В структуре v0.7 предусмотрено 11 логических полей:

Схему подписи выбирает кошелёк. Часто используется ECDSA на secp256k1, но за тем же интерфейсом могут работать проверка P-256/passkey, мультиподпись, пороговые схемы социального восстановления и подписанты с ключами сессии. В этом и заключается вся суть гибкости.

От начала до конца: как смарт-аккаунт обменивает USDC на ETH

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

  1. Пользователь нажимает «Обмен» в интерфейсе кошелька. Кошелёк формирует UserOperation: sender = 0xUserSafe, callData = swapUSDCforETH(amount) с вызовом Uniswap.
  2. Оценка газа. Кошелёк вызывает eth_estimateUserOperationGas через RPC бандлера. Бандлер симулирует операцию относительно EntryPoint и возвращает три лимита газа.
  3. Пользователь подписывает операцию. Кошелёк хеширует UserOp с адресом EntryPoint и идентификатором сети, предлагает пользователю подписать операцию (с помощью passkey, аппаратного ключа или другого способа) и добавляет подпись.
  4. Отправка. Подписанный UserOp отправляется через eth_sendUserOperation одному или нескольким бандлерам. Он попадает в альтернативный мемпул — отдельную P2P-сеть, не связанную с обычным мемпулом транзакций Ethereum.
  5. Симуляция бандлером. Бандлер повторно симулирует операцию с помощью eth_call относительно simulateValidation. Он проверяет правила ERC-7562 для доступа к хранилищу: при проверке UserOp может обращаться только к собственному хранилищу, иначе бандлер рискует стать жертвой атаки.
  6. Объединение операций. Бандлер объединяет этот UserOp с числом других операций до ~10 и отправляет их одним вызовом handleOps([...userOps], beneficiary) в EntryPoint.
  7. Выполнение в блокчейне. EntryPoint перебирает операции: для каждой вызывает validateUserOp отправителя, списывает предварительно внесённую сумму, а затем выполняет callData. Обмен через Uniswap происходит со смарт-аккаунта.
  8. Возврат средств. EntryPoint возвращает отправителю (или пеймастеру) средства за неиспользованный газ и выплачивает вознаграждение на адрес бенефициара бандлера.

Если на шаге 5 возникает ошибка, бандлер отбрасывает операцию, а пользователь видит код ошибки AAxx. Чаще всего это AA21 (не внесена предварительная оплата), AA23 (ошибка подписи), AA25 (недопустимое значение nonce), AA33 (откат пеймастера) и AA40 (превышен лимит газа на проверку). Запомните эту таблицу — вы будете встречать эти ошибки.

EntryPoint v0.6 и v0.7

Версия v0.6 вышла в марте 2023 года по адресу 0x5FF1…2789. Она работала, но у неё было три досадных недостатка: единый блок paymasterAndData, объединявший три вида газа; неудобная упаковка initCode; и расчёт газа, из-за которого с отправителей списывали больше положенного. В v0.7 исправили все три проблемы.

Основные изменения v0.7:

v0.6 всё ещё работает, и её по-прежнему используют: многие кошельки выпустили совместимые с v0.7 модули лишь в течение 2024 года. На большинстве сетей обе версии EntryPoint работают параллельно годами.

Пеймастеры: кто оплачивает газ

Пеймастер — это контракт, который хранит стейк в ETH в EntryPoint и соглашается оплачивать газ за UserOp, соответствующие его правилам. Преобладают три типа:

Функция validatePaymasterUserOp пеймастера выполняется на этапе проверки EntryPoint. Если она откатывается, вы получаете AA33. Если стейка пеймастера становится недостаточно, EntryPoint списывает его, а убытки несёт бандлер. Поэтому бандлеры ведут списки репутации пеймастеров. ERC-7562 закрепляет эти правила репутации, чтобы мемпул бандлеров оставался устойчивым к спаму. Те же базовые механизмы объясняют, почему одобрения в DeFi и правила безопасности при использовании мультиподписи так же применимы в мире ERC-4337: угрозы те же, меняется лишь оболочка.

Публичный alt-mempool и приватный бандлер

Есть два способа включить UserOp в блокчейн.

Публичный alt-mempool: бандлеры, совместимые с ERC-7562, распространяют UserOp по сети libp2p. Вашу операцию может подобрать любой, кто запустит узел Pimlico, Stackup, Alchemy, Etherspot или Voltaire. Такой подход не требует разрешений и устойчив к цензуре, но здесь действуют те же риски MEV, что и для обычных транзакций в Ethereum: поисковые боты могут увидеть вашу операцию до её включения в блок.

Приватный бандлер: вы отправляете eth_sendUserOperation напрямую через RPC одного провайдера. Провайдер моделирует выполнение, формирует пакет и отправляет его приватно (часто через Flashbots). Это быстрее и защищает от MEV, но вы доверяете бандлеру и рассчитываете, что он не будет цензурировать вашу операцию или опережать её. В 2026 году большинство потребительских кошельков по умолчанию используют приватных бандлеров.

Этот компромисс похож на выбор между публичным мемпулом и Flashbots Protect для обычных транзакций. Если со времён L1 вы не знакомились с жизненным циклом транзакции, этот обзор объясняет, что меняется, когда в процесс включается бандлер.

Агрегаторы, распространение и стоимость

Агрегаторы — это контракты, которые проверяют пакет операций за один раз, используя одну проверку подписи. Типичный пример — BLS: вы собираете 50 UserOp, подписанных с помощью BLS, объединяете подписи в одну операцию проверки pairing и экономите около 95% газа на подписях. Технология распространяется медленно: создавать кошельки с поддержкой подписей BLS сложно, а экономия на газе становится заметной только при большом объёме операций. По состоянию на середину 2026 года агрегаторы используются менее чем в 1% UserOp в основной сети.

Данные о распространении (Q1 2026, по данным bundlebear.com): в общей сложности около 380 миллионов UserOp во всех сетях; основная часть приходится на Base, Polygon и Arbitrum. На основную сеть приходится около 6–8% — это наименьшая доля по объёму, но наибольшая по стоимости переводимых активов. На потребительском рынке преобладают Coinbase Smart Wallet, Farcaster и Argent.

Дополнительные расходы: UserOp версии v0.7 требует примерно на 30,000–40,000 газа больше, чем эквивалентная транзакция EOA. В эти расходы входят цикл EntryPoint, валидация и обслуживание пакета. В основной сети при цене 20 gwei это составляет доли доллара за операцию. При первом развёртывании аккаунта данные factoryData добавляют ещё около 250,000 газа. В сетях L2, где основная часть расходов связана с calldata, накладные расходы составляют менее 10%. Если dApp оплачивает UserOp за пользователя, расходы ложатся на приложение. Поэтому в потребительских приложениях транзакции бывают бесплатными, а в серьёзных DeFi-приложениях — нет. В более подробном обзоре комиссий за транзакции объясняется, как эти расходы влияют на комиссии в разных сетях.

Кратко: ERC-4337 — это шесть ролей (отправитель, UserOp, бандлер, EntryPoint, пеймастер, агрегатор), одна структура данных, два адреса EntryPoint, которые стоит запомнить, и примерно 30–40 тыс. газа дополнительных расходов в обмен на поддержку произвольных схем подписей, оплату газа за пользователя, пакетную обработку и параллельные nonce. В третьей части серии речь пойдёт о EIP-7702 — параллельном направлении развития Pectra, которое позволяет существующему EOA использовать ту же инфраструктуру без смены адреса.


Читайте также

Кошельки, комиссия за газ и разрешения: три основы DeFi, которые важно понимать каждому пользователю

Кошельки, комиссия за газ и разрешения: три основы DeFi, которые важно понимать каждому пользователю

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

6 мин чтения
Аккаунты, контракты и EVM: как на самом деле работает Ethereum

Аккаунты, контракты и EVM: как на самом деле работает Ethereum

В Ethereum вместо UTXO-модели Bitcoin используется большая таблица аккаунтов и стековая машина с учётом газа. Разберёмся, как устроены состояние сети и коды операций и как выполняется перевод ERC-20.

10 мин чтения
Схема комиссий в Ethereum: EIP-1559, чаевые валидаторам и комиссии за blob после Dencun

Как устроены комиссии в Ethereum: EIP-1559, чаевые валидаторам и комиссии за blob после Dencun

Как на самом деле устроены комиссии в Ethereum в 2026 году: аукцион базовой комиссии EIP-1559, чаевые за приоритетную обработку и отдельный рынок blob, появившийся после Dencun и расширенный в Pectra.

8 мин чтения

Подпишитесь на рассылку

Раз в месяц — короткое письмо от нас. Никакого спама, только последние новости Zelcore.

Подпишитесь на рассылку