各服务使用哪个 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: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
启动服务栈
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
运行脚本
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
0xef0100 后跟实现地址。同一账户后续的 UserOperations 不需要 authorization 字段。
在测试运行之间重置状态
要在测试运行之间将 Virtual Environment 恢复到已知状态,请使用evm_snapshot 创建快照,通过 Admin RPC 使用 evm_revert 回滚到该快照,并在每次回滚后重启 Alto。该示例使用 jq。
时间旅行和 paymaster 有效时间窗口
paymaster 签名通常带有有效时间窗口,并且有两个时钟会检查它:EntryPoint 将其与区块时间戳进行比较,Alto 将其与运行它的机器的时钟进行比较。在 Virtual Environment 上,这两者可能不同:- 在
evm_increaseTime之后,区块时间戳会领先于机器的时钟(参见在 Virtual Environments 上使用时间戳)。 - 在
evm_revert之后,区块时间戳会从快照的时间戳继续,因此会落后于机器的时钟,落后的时长为自快照以来经过的时间。
使用您自己的 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。
故障排除
相关内容
- Admin RPC 参考,涵盖
eth_sendTransaction、evm_snapshot、evm_revert和evm_increaseTime - 使用快照或仪表板回滚 Virtual Environment 状态
- 在 Virtual Environments 上使用时间戳
- 在 Virtual Environment 上使用 Viem:自定义链和自定义 RPC 方法
- 调试交易,用于单步执行 bundle 交易