跳转到主要内容
要在 Virtual Environment 上测试 ERC-4337 智能账户,请在 Docker 中运行 Pimlico 的开源 bundler Alto 和 Pimlico 的 mock paymaster,并将两者都指向该 Virtual Environment 的 RPC URL。部署在父网络上的 EntryPoint 合约和账户工厂都包含在 fork 出的状态中,每个 bundle 都是一笔您可以在 Virtual Environment Explorer 中打开的交易。 本指南以四种方式发送 UserOperations:由 paymaster 赞助、由账户支付、以 ERC-20 代币支付,以及从 EIP-7702 账户发送。本指南使用 Alto 1.2.8、permissionless 0.5.0 和 viem 2.57.7,在从 Ethereum Mainnet、Base、OP Mainnet 和 Arbitrum One fork 出的 Virtual Environment 上,配合 EntryPoint 0.6、0.7 和 0.8 进行了测试。

各服务使用哪个 RPC URL

每个 Virtual Environment 都有一个 Public RPC URL 和一个 Admin RPC URL。Alto 在 Public RPC 上运行。注资任务、mock paymaster 以及为账户注资的测试代码使用 Admin RPC。

开始之前

  • 一个从已部署 ERC-4337 EntryPoint 合约的网络(例如 Ethereum Mainnet、Base、OP Mainnet 或 Arbitrum One)fork 出的 Virtual Environment。它可以保留父网络的链 ID,也可以使用自定义的链 ID。要创建 Virtual Environment,请按照 Virtual Environment 快速入门操作。
  • 该 Virtual Environment 的 Public RPC 和 Admin RPC URL,它们列在 Home 选项卡的 Integrate Virtual RPC 卡片中(参见仪表板参考)
  • Docker 及 Docker Compose
  • Node.js 20.6 或更高版本以及 npm
  • jq,用于快照示例

运行 Alto 和 mock paymaster

1

创建项目及其 .env 文件

以下命令会创建一个项目文件夹和一个 .env 文件,该文件包含供 bundler 使用的三个新私钥。
打开 .env,将两个占位符 URL 替换为该 Virtual Environment 的 Public RPC 和 Admin RPC URL,并根据父网络设置 ALTO_CHAIN_TYPE:
请生成新密钥。不要使用众所周知的测试密钥,例如 Anvil 或 Hardhat 的默认密钥。在实时网络的 fork 上,这些密钥的地址已通过 EIP-7702 委托给一个合约,该合约会转走它们收到的任何 ETH,因此这些地址始终不持有余额。
2

添加注资脚本

Alto 启动之前,其密钥需要持有 ETH。utility 密钥在首次启动时部署 Alto 的模拟合约,executor 密钥支付 bundle 交易的费用。每个 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

检查 bundler 和 paymaster

向 bundler 查询其 EntryPoints:
然后 ping paymaster:

Mock paymaster 合约地址

mock paymaster 在一个 Virtual Environment 上首次启动时,会部署下面的合约。这些地址在每个网络上都相同。 每个 paymaster 都会在其 EntryPoint 中获得 50 ETH 的存款。

发送受赞助的 UserOperation

1

安装 viem 和 permissionless

在项目文件夹中运行以下命令,安装 viem 和 permissionless:
2

创建 setup.ts

setup.ts 包含本页所有脚本共用的客户端和常量。
setup.ts
3

创建 sponsored.ts

该脚本会创建一个不持有 ETH 的智能账户,并发送一个由 mock paymaster 付费的 UserOperation。
sponsored.ts
4

运行脚本

该账户在一个 UserOperation 中完成了部署并执行了调用,而且仍然不持有 ETH。要查看该 bundle 的完整 trace,请在 Virtual Environment Explorer 中搜索该交易哈希。
要使用其他 EntryPoint 版本,请更改 entryPoint 常量,例如改为 { address: entryPoint08Address, version: "0.8" }。Alto 已针对 EntryPoint 0.6、0.7 和 0.8 进行配置,mock paymaster 会为每个版本部署一个 paymaster。
请将这三个端点区分开。Alto 只响应 bundler 方法:如果您向它发送 eth_call 这样的读取请求,viem 会报告 The method "eth_call" does not exist / is not available。pm_getPaymasterStubData 这样的 paymaster 方法发往 paymaster URL。

其他支付 gas 的方式

下面的每个脚本都是完整的,并复用 setup.ts。运行方式与 sponsored.ts 相同,例如 npx tsx --env-file=.env erc20.ts。

用账户余额支付 gas

没有 paymaster 时,账户在其第一个 UserOperation 之前需要 ETH。getFundedWallet 通过 Admin RPC 从预先注资的账户向其发送 ETH。
self-funded.ts

用 ERC-20 代币支付 gas

mock paymaster 接受用它自己的测试代币支付 gas。任何人都可以使用 sudoMint 铸造该代币。
erc20.ts
该脚本会在第一次支付之前,向 paymaster 的金库铸造 1 wei 的该代币。如果不这样做,新 Virtual Environment 上的第一个 ERC-20 UserOperation 会失败并报错 AA50 postOp reverted。Alto 以 1 wei 的费用测量 paymaster 的 postOp gas,此时代币费用舍入为零。使用实际费用时,向空金库的第一笔转账所需的 gas 比 Alto 测得的多约 22,600,postOp 会耗尽 gas。

从 EIP-7702 账户发送 UserOperation

外部拥有账户(EOA)可以通过委托给 Simple7702Account 实现来充当智能账户。这需要 EntryPoint 0.8。第一个 UserOperation 携带已签名的授权,Alto 会在一笔 EIP-7702 交易中提交它。
eip7702.ts
第一个 UserOperation 之后,该 EOA 的代码为 0xef0100 后跟实现地址。同一账户后续的 UserOperations 不需要 authorization 字段。

在测试运行之间重置状态

要在测试运行之间将 Virtual Environment 恢复到已知状态,请使用 evm_snapshot 创建快照,通过 Admin RPC 使用 evm_revert 回滚到该快照,并在每次回滚后重启 Alto。该示例使用 jq。
您可以根据需要多次回滚到同一个快照。有关仪表板中的流程和回滚距离限制,请参见回滚 Virtual Environment 状态。
每次 evm_revert 之后都要重启 Alto。Alto 在内存中保存已提交的 bundle、待处理的账户部署和最近的收据,回滚之后,这些状态描述的是已不存在的区块。如果不重启,UserOperations 可能会失败并报错 AA10 ... Another deployment operation for this sender is already being processed、始终无法确认,或者返回已被回滚的 UserOperations 的收据。使用 debug_bundler_clearState 清空 Alto 的内存池不能代替重启。

时间旅行和 paymaster 有效时间窗口

paymaster 签名通常带有有效时间窗口,并且有两个时钟会检查它:EntryPoint 将其与区块时间戳进行比较,Alto 将其与运行它的机器的时钟进行比较。在 Virtual Environment 上,这两者可能不同: mock paymaster 为每次赞助签署的有效期为 60,000 秒,从机器的时钟起算。如果您将时间向前推进超过这个时长,它的赞助在链上就已经过期:UserOperation 始终无法确认,Alto 会不断重新提交失败的 bundle,直到您重启它。对于向前跳得更远的测试,请发送不带 paymaster 的 UserOperations,或者使用您自己的 paymaster 服务。

使用您自己的 paymaster 服务

要测试您自己的赞助规则,请针对同一个 Virtual Environment 运行您的 paymaster 服务,并将其 URL 传给 paymaster 客户端,以代替 PAYMASTER_URL。任何实现了 ERC-7677(pm_getPaymasterStubData 和 pm_getPaymasterData)的服务都可以配合本页的脚本使用。 有三点是 Virtual Environment 特有的:
  • 通过 Admin RPC 为 paymaster 注资。 paymaster 合约需要在 EntryPoint 中有存款,部署该合约的账户需要 ETH。请像 getFundedWallet 那样,从预先注资的账户发送这两笔资金。
  • 以两个时钟中较晚的一个为准签署有效时间窗口。 以最新区块时间戳和服务自身时钟中较晚的一个为基准计算 validUntil。当 Virtual Environment 的时钟落后时,仅基于区块时间戳的签名会失败:Alto 会以 UserOperation expires too soon 拒绝该 UserOperation。
  • 为该服务提供 Public RPC URL。 读取链数据和发送已签名的交易不需要 Admin RPC。

故障排除

相关内容