Какой 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 для родительской сети: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
Запустите стек
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
Запустите скрипт
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
0xef0100 и следующего за ним адреса имплементации. Последующим UserOperations с того же аккаунта поле authorization не нужно.
Сброс состояния между запусками тестов
Чтобы возвращать Virtual Environment в известное состояние между запусками тестов, создайте снимок с помощьюevm_snapshot, откатывайтесь к нему с помощью evm_revert через Admin RPC и перезапускайте Alto после каждого отката. В примере используется jq.
Перемещение во времени и окна действительности paymaster
Подписи paymaster обычно содержат окно действительности, и его проверяют по двум часам: EntryPoint сравнивает его с временной меткой блока, а Alto сравнивает его с часами машины, на которой он работает. В Virtual Environment эти часы могут расходиться:- После
evm_increaseTimeвременные метки блоков опережают часы машины (см. Работа с временными метками в Virtual Environments). - После
evm_revertвременные метки блоков продолжают отсчёт от временной метки снимка, поэтому они отстают от часов машины на время, прошедшее с момента снимка.
Использование собственного сервиса 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 не нужен.
Устранение неполадок
См. также
- Справочник Admin RPC для
eth_sendTransaction,evm_snapshot,evm_revertиevm_increaseTime - Откат состояния Virtual Environment с помощью снимков или панели
- Работа с временными метками в Virtual Environments
- Viem в Virtual Environment: пользовательские цепочки и пользовательские RPC-методы
- Отладка транзакций для пошагового прохождения транзакции бандла