Перейти к основному содержанию
Чтобы тестировать смарт-аккаунты ERC-4337 в Virtual Environment, запустите в Docker Alto, бандлер с открытым исходным кодом от Pimlico, вместе с mock paymaster от Pimlico и укажите обоим URL RPC вашей Virtual Environment. Контракты EntryPoint и фабрики аккаунтов, задеплоенные в родительской сети, входят в состояние форка, а каждый бандл является транзакцией, которую можно открыть в Virtual Environment Explorer. В этом руководстве UserOperations отправляются четырьмя способами: со спонсированием от paymaster, с оплатой самим аккаунтом, с оплатой токеном ERC-20 и с аккаунта EIP-7702. Руководство проверено с Alto 1.2.8, permissionless 0.5.0 и viem 2.57.7 в Virtual Environment, форкнутых от Ethereum Mainnet, Base, OP Mainnet и Arbitrum One, с EntryPoint 0.6, 0.7 и 0.8.

Какой URL RPC использует каждый сервис?

У Virtual Environment есть URL Public RPC и URL Admin RPC. Alto работает через Public RPC. Задание пополнения, mock paymaster и тестовый код, который пополняет аккаунты, используют Admin RPC.

Прежде чем начать

  • Virtual Environment, форкнутая от сети, в которой задеплоены контракты EntryPoint ERC-4337, например Ethereum Mainnet, Base, OP Mainnet или Arbitrum One. Она может сохранить chain ID родительской сети или использовать пользовательский. Чтобы создать её, следуйте быстрому старту Virtual Environment.
  • URL Public RPC и Admin RPC этой Virtual Environment, указанные в карточке Integrate Virtual RPC на вкладке Home (см. справочник по панели)
  • Docker с Docker Compose
  • Node.js 20.6 или новее и npm
  • jq для примера со снимком

Запуск Alto и mock paymaster

1

Создайте проект и его файл .env

Команда создаёт папку проекта и файл .env с тремя новыми приватными ключами для бандлера.
Откройте .env, замените два URL-заполнителя на URL Public RPC и Admin RPC вашей Virtual Environment и задайте ALTO_CHAIN_TYPE для родительской сети:
Генерируйте новые ключи. Не используйте общеизвестные тестовые ключи, например ключи по умолчанию из Anvil или Hardhat. На форках действующих сетей адреса этих ключей делегированы через EIP-7702 на контракт, который пересылает любой полученный ими ETH, поэтому на них никогда не остаётся баланса.
2

Добавьте скрипт пополнения

До запуска Alto нужен ETH на его ключах. Utility-ключ деплоит контракты симуляции Alto при первом запуске, а executor-ключи оплачивают транзакции бандлов.В Virtual Environment изначально есть заранее пополненные аккаунты, которые возвращает eth_accounts. Admin RPC принимает неподписанные запросы eth_sendTransaction, поэтому скрипт пополняет каждый ключ переводом с одного из этих аккаунтов.Сохраните скрипт как fund-accounts.mjs:
fund-accounts.mjs
3

Добавьте файл Compose

Сохраните файл как docker-compose.yml:
docker-compose.yml
Mock paymaster предназначен только для тестирования. Он спонсирует каждый запрос и подписывает публично известным ключом.
4

Запустите стек

Сначала запускается funder, затем Alto, затем mock paymaster. Стек обычно готов к работе менее чем за 30 секунд.
5

Проверьте бандлер и paymaster

Запросите у бандлера список его EntryPoint:
Затем отправьте ping-запрос к paymaster:

Адреса контрактов mock paymaster

При первом запуске в Virtual Environment mock paymaster деплоит перечисленные ниже контракты. Адреса одинаковы во всех сетях. Каждый paymaster получает депозит 50 ETH в своём EntryPoint.

Отправка спонсируемой UserOperation

1

Установите viem и permissionless

Выполните команды в папке проекта, чтобы установить viem и permissionless:
2

Создайте setup.ts

setup.ts содержит клиенты и константы, общие для всех скриптов на этой странице.
setup.ts
3

Создайте sponsored.ts

Скрипт создаёт смарт-аккаунт, на котором нет ETH, и отправляет UserOperation, которую оплачивает mock paymaster.
sponsored.ts
4

Запустите скрипт

Аккаунт был задеплоен и выполнил свой вызов в одной UserOperation, и на нём по-прежнему нет ETH. Чтобы увидеть полную трассировку бандла, выполните поиск по хешу транзакции в Virtual Environment Explorer.
Чтобы использовать другую версию EntryPoint, измените константу entryPoint, например на { address: entryPoint08Address, version: "0.8" }. Alto настроен для EntryPoint 0.6, 0.7 и 0.8, а mock paymaster деплоит paymaster для каждого из них.
Не смешивайте три эндпоинта. Alto отвечает только на методы бандлера: если вы отправляете ему запрос на чтение, например eth_call, viem сообщает The method "eth_call" does not exist / is not available. Методы paymaster, например pm_getPaymasterStubData, отправляются на URL paymaster.

Другие способы оплаты газа

Каждый скрипт ниже приведён полностью и повторно использует setup.ts. Запускайте его так же, как sponsored.ts, например npx tsx --env-file=.env erc20.ts.

Оплата газа с баланса аккаунта

Без paymaster аккаунту нужен ETH до его первой UserOperation. getFundedWallet отправляет ETH с заранее пополненного аккаунта через Admin RPC.
self-funded.ts

Оплата газа токеном ERC-20

Mock paymaster принимает собственный тестовый токен в качестве оплаты за газ. Любой может заминтить этот токен с помощью sudoMint.
erc20.ts
Перед первым платежом скрипт минтит 1 wei токена в казначейство paymaster. Без этого первая UserOperation с оплатой токеном ERC-20 в новой Virtual Environment завершается ошибкой AA50 postOp reverted. Alto измеряет газ postOp у paymaster при комиссиях в 1 wei, при которых комиссия в токене округляется до нуля. При реальных комиссиях первому переводу в пустое казначейство требуется примерно на 22 600 единиц газа больше, чем измерил Alto, и в postOp заканчивается газ.

Отправка UserOperation с аккаунта EIP-7702

Аккаунт с внешним владельцем (EOA) может действовать как смарт-аккаунт путём делегирования на имплементацию Simple7702Account. Для этого требуется EntryPoint 0.8. Первая UserOperation содержит подписанную авторизацию, и Alto отправляет её в транзакции EIP-7702.
eip7702.ts
После первой UserOperation код EOA состоит из 0xef0100 и следующего за ним адреса имплементации. Последующим UserOperations с того же аккаунта поле authorization не нужно.

Сброс состояния между запусками тестов

Чтобы возвращать Virtual Environment в известное состояние между запусками тестов, создайте снимок с помощью evm_snapshot, откатывайтесь к нему с помощью evm_revert через Admin RPC и перезапускайте Alto после каждого отката. В примере используется jq.
К одному и тому же снимку можно откатываться столько раз, сколько вам нужно. Об откате из панели и ограничении дистанции отката см. Откат состояния Virtual Environment.
Перезапускайте Alto после каждого evm_revert. Alto хранит в памяти отправленные бандлы, ожидающие деплои аккаунтов и недавние квитанции, и после отката это состояние описывает блоки, которых больше не существует. Без перезапуска UserOperations могут завершаться ошибкой AA10 ... Another deployment operation for this sender is already being processed, никогда не подтверждаться или возвращать квитанции для UserOperations, которые были откачены. Очистка mempool Alto с помощью debug_bundler_clearState не заменяет перезапуск.

Перемещение во времени и окна действительности paymaster

Подписи paymaster обычно содержат окно действительности, и его проверяют по двум часам: EntryPoint сравнивает его с временной меткой блока, а Alto сравнивает его с часами машины, на которой он работает. В Virtual Environment эти часы могут расходиться:
  • После evm_increaseTime временные метки блоков опережают часы машины (см. Работа с временными метками в Virtual Environments).
  • После evm_revert временные метки блоков продолжают отсчёт от временной метки снимка, поэтому они отстают от часов машины на время, прошедшее с момента снимка.
Mock paymaster подписывает каждое спонсирование на 60 000 секунд по часам машины. Если вы сдвигаете время вперёд больше чем на это значение, его спонсирования оказываются уже истёкшими ончейн: UserOperation никогда не подтверждается, а Alto продолжает повторно отправлять неуспешный бандл, пока вы не перезапустите Alto. Для тестов, которые сдвигают время дальше, отправляйте UserOperations без paymaster или используйте собственный сервис paymaster.

Использование собственного сервиса paymaster

Чтобы протестировать собственные правила спонсирования, запустите свой сервис paymaster с той же Virtual Environment и передайте его URL клиенту paymaster вместо PAYMASTER_URL. Любой сервис, реализующий ERC-7677 (pm_getPaymasterStubData и pm_getPaymasterData), работает со скриптами на этой странице. Три момента специфичны для Virtual Environment:
  • Пополняйте paymaster через Admin RPC. Контракту paymaster нужен депозит в EntryPoint, а аккаунту, который его деплоит, нужен ETH. Отправьте и то и другое с заранее пополненного аккаунта, как это делает getFundedWallet.
  • Подписывайте окна действительности по более позднему из показаний двух часов. Вычисляйте validUntil от более позднего из двух значений: временной метки последнего блока и собственных часов сервиса. Подпись, основанная только на временной метке блока, не проходит проверку, когда часы Virtual Environment отстают: Alto отклоняет UserOperation с ошибкой UserOperation expires too soon.
  • Передайте сервису URL Public RPC. Для чтения данных цепочки и отправки подписанных транзакций Admin RPC не нужен.

Устранение неполадок

См. также