> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tenderly.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Запуск бандлера и paymaster Pimlico в Virtual Environment

> Запустите бандлер ERC-4337 Alto и mock paymaster Pimlico в Docker с Virtual Environment, чтобы тестировать смарт-аккаунты, спонсирование газа и EIP-7702.

Чтобы тестировать смарт-аккаунты ERC-4337 в [Virtual Environment](https://docs.tenderly.co/virtual-environments/overview.md), запустите в Docker [Alto](https://github.com/pimlicolabs/alto), бандлер с открытым исходным кодом от Pimlico, вместе с mock paymaster от Pimlico и укажите обоим URL RPC вашей Virtual Environment. Контракты EntryPoint и фабрики аккаунтов, задеплоенные в родительской сети, входят в состояние форка, а каждый бандл является транзакцией, которую можно открыть в [Virtual Environment Explorer](https://docs.tenderly.co/virtual-environments/explorer.md).

В этом руководстве 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.

Полный пример находится в репозитории [tenderly-pimlico-bundler](https://github.com/Tenderly/tenderly-pimlico-bundler) на GitHub. Помимо настройки с этой страницы, в нём есть paymaster с правилами спонсирования, примеры для EntryPoint 0.7 и 0.8 и smoke-тест, который запускает все примеры.

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

У Virtual Environment есть URL **Public RPC** и URL **[Admin RPC](https://docs.tenderly.co/virtual-environments/admin-rpc.md)**. Alto работает через Public RPC. Задание пополнения, mock paymaster и тестовый код, который пополняет аккаунты, используют Admin RPC.

```mermaid theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
flowchart TB
  app["Ваше приложение или тесты"]
  subgraph docker["Docker Compose"]
    alto["Бандлер Alto<br/>localhost:4337"]
    funder["задача funder"]
    pm["Mock paymaster<br/>localhost:3000"]
  end
  subgraph ve["Virtual Environment"]
    pub["Public RPC"]
    adm["Admin RPC"]
  end
  app -- "UserOperations" --> alto
  app -- "запросы на спонсирование" --> pm
  app -- "чтение" --> pub
  alto -- "симулирует и отправляет бандлы" --> pub
  funder -- "пополняет ключи Alto" --> adm
  pm -- "деплоит paymaster-контракты" --> adm
```

| Сервис | Подключается к | Почему |
| - | - | - |
| `funder` | Admin RPC | Одноразовое задание, которое пополняет ключи Alto до запуска Alto. Оно отправляет неподписанные переводы через [`eth_sendTransaction`](https://docs.tenderly.co/virtual-environments/admin-rpc#eth_sendtransaction) с заранее пополненных аккаунтов Virtual Environment. |
| Alto | Public RPC | Симулирует UserOperations и отправляет бандлы стандартными методами JSON-RPC. |
| Mock paymaster | Admin RPC, Alto | При запуске деплоит свои контракты paymaster и пополняет свой аккаунт деплойера с помощью `anvil_setBalance`, который Admin RPC принимает, а Public RPC отклоняет. |
| Ваше приложение или тесты | Public RPC, Alto, mock paymaster | Запросы на чтение идут в Virtual Environment, UserOperations идут в Alto, а запросы на спонсирование идут к paymaster. Скрипты на этой странице также пополняют тестовые аккаунты через Admin RPC. |

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

* Virtual Environment, форкнутая от сети, в которой задеплоены контракты EntryPoint ERC-4337, например Ethereum Mainnet, Base, OP Mainnet или Arbitrum One. Она может сохранить chain ID родительской сети или использовать пользовательский. Чтобы создать её, следуйте [быстрому старту Virtual Environment](https://docs.tenderly.co/virtual-environments/quickstart.md).
* URL **Public RPC** и **Admin RPC** этой Virtual Environment, указанные в карточке **Integrate Virtual RPC** на вкладке **Home** (см. [справочник по панели](https://docs.tenderly.co/virtual-environments/dashboard.md))
* Docker с Docker Compose
* Node.js 20.6 или новее и npm
* `jq` для [примера со снимком](#сброс-состояния-между-запусками-тестов)

## Запуск Alto и mock paymaster

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

Команда создаёт папку проекта и файл `.env` с тремя новыми приватными ключами для бандлера.

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
mkdir pimlico-virtual-environment && cd pimlico-virtual-environment

cat > .env <<EOF
TENDERLY_PUBLIC_RPC_URL=https://YOUR-PUBLIC-RPC-URL-HERE
TENDERLY_ADMIN_RPC_URL=https://YOUR-ADMIN-RPC-URL-HERE
ALTO_UTILITY_PRIVATE_KEY=0x$(openssl rand -hex 32)
ALTO_EXECUTOR_PRIVATE_KEYS=0x$(openssl rand -hex 32),0x$(openssl rand -hex 32)
ALTO_CHAIN_TYPE=default
EOF
```

Откройте `.env`, замените два URL-заполнителя на URL Public RPC и Admin RPC вашей Virtual Environment и задайте `ALTO_CHAIN_TYPE` для родительской сети:

| Родительская сеть | `ALTO_CHAIN_TYPE` |
| - | - |
| Ethereum Mainnet | `default` |
| Base, OP Mainnet | `op-stack` |
| Arbitrum One | `default` |

> [!WARNING]
>
> Генерируйте новые ключи. Не используйте общеизвестные тестовые ключи, например ключи по умолчанию из Anvil или Hardhat. На форках действующих сетей адреса этих ключей делегированы через EIP-7702 на контракт, который пересылает любой полученный ими ETH, поэтому на них никогда не остаётся баланса.

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

До запуска Alto нужен ETH на его ключах. Utility-ключ деплоит контракты симуляции Alto при первом запуске, а executor-ключи оплачивают транзакции бандлов.

В Virtual Environment изначально есть заранее пополненные аккаунты, которые возвращает `eth_accounts`. Admin RPC принимает неподписанные запросы [`eth_sendTransaction`](https://docs.tenderly.co/virtual-environments/admin-rpc#eth_sendtransaction), поэтому скрипт пополняет каждый ключ переводом с одного из этих аккаунтов.

Сохраните скрипт как `fund-accounts.mjs`:

```js title="fund-accounts.mjs" theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
// Tops up accounts with ETH from the Virtual Environment's pre-funded accounts.
//
// Every Tenderly Virtual Environment starts with funded accounts, which
// eth_accounts returns. The Admin RPC accepts unsigned eth_sendTransaction
// requests, so a plain transfer from one of them is all it takes.
//
//   RPC_URL            Admin RPC URL of the Virtual Environment
//   FUND_PRIVATE_KEYS  comma-separated private keys whose addresses get funded
//   FUND_ADDRESSES     comma-separated extra addresses (optional)
//   FUND_AMOUNT_ETH    balance each address is topped up to (default 10)
//
// Runs inside the Alto image to reuse the viem copy bundled there.
import { createPublicClient, formatEther, http, parseEther, toHex } from "viem"
import { privateKeyToAccount } from "viem/accounts"

const list = (value) =>
    (value ?? "")
        .split(",")
        .map((item) => item.trim())
        .filter(Boolean)

if (!process.env.RPC_URL) throw new Error("RPC_URL is not set")
const client = createPublicClient({ transport: http(process.env.RPC_URL, { timeout: 60_000 }) })
const amount = parseEther(process.env.FUND_AMOUNT_ETH || "10")
const targets = [
    ...list(process.env.FUND_PRIVATE_KEYS).map((key) => privateKeyToAccount(key).address),
    ...list(process.env.FUND_ADDRESSES)
]

// The pre-funded account that currently holds the most ETH.
const richestAccount = async () => {
    const accounts = await client.request({ method: "eth_accounts" })
    if (accounts.length === 0) throw new Error("eth_accounts returned no pre-funded accounts")
    const balances = await Promise.all(accounts.map((address) => client.getBalance({ address })))
    const index = balances.indexOf(balances.reduce((a, b) => (a > b ? a : b)))
    return { address: accounts[index], balance: balances[index] }
}

for (const to of targets) {
    const balance = await client.getBalance({ address: to })
    if (balance >= amount) {
        console.log(`ok      ${to} ${formatEther(balance)} ETH`)
        continue
    }

    const value = amount - balance
    const from = await richestAccount()
    if (from.balance < value) throw new Error(`No pre-funded account holds ${formatEther(value)} ETH`)

    const hash = await client.request({
        method: "eth_sendTransaction",
        params: [{ from: from.address, to, value: toHex(value) }]
    })
    const receipt = await client.waitForTransactionReceipt({ hash })
    if (receipt.status !== "success") throw new Error(`Funding ${to} reverted (${hash})`)
    console.log(`funded  ${to} ${formatEther(amount)} ETH (${hash})`)
}
```

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

Сохраните файл как `docker-compose.yml`:

```yaml title="docker-compose.yml" theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
services:
  # One-shot job: funds the bundler keys from the Virtual Environment's
  # pre-funded accounts. Unsigned transfers need the Admin RPC.
  funder:
    image: ghcr.io/pimlicolabs/alto:v1.2.8
    entrypoint: ["node", "/app/src/fund-accounts.mjs"]
    volumes:
      - ./fund-accounts.mjs:/app/src/fund-accounts.mjs:ro
    environment:
      RPC_URL: ${TENDERLY_ADMIN_RPC_URL}
      FUND_PRIVATE_KEYS: ${ALTO_UTILITY_PRIVATE_KEY},${ALTO_EXECUTOR_PRIVATE_KEYS}

  alto:
    image: ghcr.io/pimlicolabs/alto:v1.2.8
    entrypoint: ["node", "src/lib/cli/alto.js", "run"]
    ports: ["4337:4337"]
    environment:
      ALTO_RPC_URL: ${TENDERLY_PUBLIC_RPC_URL}
      # EntryPoint 0.6, 0.7 and 0.8
      ALTO_ENTRYPOINTS: 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789,0x0000000071727De22E5E9d8BAf0edAc6f37da032,0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108
      ALTO_UTILITY_PRIVATE_KEY: ${ALTO_UTILITY_PRIVATE_KEY}
      ALTO_EXECUTOR_PRIVATE_KEYS: ${ALTO_EXECUTOR_PRIVATE_KEYS}
      ALTO_SAFE_MODE: "false"
      ALTO_CHAIN_TYPE: ${ALTO_CHAIN_TYPE:-default}
      ALTO_PORT: "4337"
      ALTO_PUBLIC_CLIENT_LOG_LEVEL: error
      ALTO_WALLET_CLIENT_LOG_LEVEL: error
    depends_on:
      funder:
        condition: service_completed_successfully
    healthcheck:
      test: ["CMD", "wget", "-qO-", "http://127.0.0.1:4337/health"]
      interval: 2s
      timeout: 2s
      retries: 60

  mock-paymaster:
    image: ghcr.io/pimlicolabs/mock-verifying-paymaster@sha256:df79a80c01d8d9bef5c1c9a938dd10cb466f3c0a00bee6c953432c5e9435273a
    ports: ["3000:3000"]
    environment:
      ALTO_RPC: http://alto:4337
      # The variable is named for Anvil. Point it at the Admin RPC.
      ANVIL_RPC: ${TENDERLY_ADMIN_RPC_URL}
    depends_on:
      alto:
        condition: service_healthy
    restart: on-failure:3
```

| Параметр | Почему он задан именно так |
| - | - |
| `ALTO_RPC_URL` | URL Public RPC. Alto использует только стандартные методы JSON-RPC. |
| `ALTO_SAFE_MODE: "false"` | В безопасном режиме Alto трассирует каждую валидацию пользовательским JavaScript-трассировщиком через метод `debug_traceCall`, который RPC Virtual Environment не обслуживают. При выключенном безопасном режиме Alto не применяет правила валидации ERC-7562 (ограничения на опкоды и доступ к хранилищу), поэтому аккаунт или paymaster, который проходит валидацию в Virtual Environment, всё равно может быть отклонён production-бандлером. |
| `ANVIL_RPC` | URL Admin RPC. Переменная названа по имени Anvil. С URL Public RPC mock paymaster завершает работу при запуске. |
| Версии образов | Оба образа зафиксированы на версиях, с которыми проверено это руководство. |

> [!NOTE]
>
> Mock paymaster предназначен только для тестирования. Он спонсирует каждый запрос и подписывает публично известным ключом.

**4. Запустите стек**

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
docker compose up -d
```

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

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

Запросите у бандлера список его EntryPoint:

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
curl -s http://localhost:4337 -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_supportedEntryPoints","params":[]}'
```

```json theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{"jsonrpc":"2.0","id":1,"result":["0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789","0x0000000071727De22E5E9d8BAf0edAc6f37da032","0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108"]}
```

Затем отправьте ping-запрос к paymaster:

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
curl -s http://localhost:3000/ping
```

```json theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{"message":"pong"}
```

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

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

| Контракт | Адрес |
| - | - |
| Paymaster для EntryPoint 0.6 | `0x20a2ED5AAdc0d87488dbc238A5Eb83A6955BD598` |
| Paymaster для EntryPoint 0.7 | `0x38aef040CEB057B62E1598F5C265946A4E4BaB4C` |
| Paymaster для EntryPoint 0.8 | `0xe276558647476dC0f409B25a1AFCbCed730128D9` |
| Тестовый токен ERC-20 для оплаты газа | `0x68e13372AE8FAaDDaf32cC08ee44C5ef5A002c69` |

Каждый paymaster получает депозит 50 ETH в своём EntryPoint.

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

**1. Установите viem и permissionless**

Выполните команды в папке проекта, чтобы установить [viem](https://viem.sh) и [permissionless](https://github.com/pimlicolabs/permissionless.js):

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
npm init -y
npm pkg set type=module
npm install permissionless@0.5.0 viem@2.57.7
npm install --save-dev tsx
```

**2. Создайте setup.ts**

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

```ts title="setup.ts" theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import { createPublicClient, createWalletClient, defineChain, http } from "viem"

const PUBLIC_RPC_URL = process.env.TENDERLY_PUBLIC_RPC_URL!
const ADMIN_RPC_URL = process.env.TENDERLY_ADMIN_RPC_URL!

export const BUNDLER_URL = "http://localhost:4337"
export const PAYMASTER_URL = "http://localhost:3000"
export const RECIPIENT = "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

// Read the chain ID from the Virtual Environment, so this works with the
// parent network's chain ID and with a custom one.
const id = await createPublicClient({ transport: http(PUBLIC_RPC_URL) }).getChainId()

export const chain = defineChain({
  id,
  name: "Tenderly Virtual Environment",
  nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
  rpcUrls: { default: { http: [PUBLIC_RPC_URL] } },
})

// Reads go to the Virtual Environment, never to the bundler.
export const publicClient = createPublicClient({ chain, transport: http(PUBLIC_RPC_URL) })

// A wallet for one of the Virtual Environment's pre-funded accounts. The
// Admin RPC accepts its transactions unsigned. Use it to fund accounts in tests.
export const getFundedWallet = async () => {
  const transport = http(ADMIN_RPC_URL)
  const [account] = await createWalletClient({ chain, transport }).getAddresses()
  return createWalletClient({ account, chain, transport })
}
```

**3. Создайте sponsored.ts**

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

```ts title="sponsored.ts" theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import { createSmartAccountClient } from "permissionless"
import { toSimpleSmartAccount } from "permissionless/accounts"
import { createPimlicoClient } from "permissionless/clients/pimlico"
import { http } from "viem"
import { entryPoint07Address } from "viem/account-abstraction"
import { generatePrivateKey, privateKeyToAccount } from "viem/accounts"
import { BUNDLER_URL, PAYMASTER_URL, RECIPIENT, chain, publicClient } from "./setup"

const entryPoint = { address: entryPoint07Address, version: "0.7" } as const

// Bundler methods go to Alto. Paymaster methods go to the mock paymaster.
const bundlerClient = createPimlicoClient({ chain, transport: http(BUNDLER_URL), entryPoint })
const paymasterClient = createPimlicoClient({ chain, transport: http(PAYMASTER_URL), entryPoint })

// A new smart account. It isn't deployed yet and holds no ETH.
const account = await toSimpleSmartAccount({
  client: publicClient,
  owner: privateKeyToAccount(generatePrivateKey()),
  entryPoint,
})

const smartAccountClient = createSmartAccountClient({
  account,
  chain,
  bundlerTransport: http(BUNDLER_URL),
  paymaster: paymasterClient,
  userOperation: {
    estimateFeesPerGas: async () => (await bundlerClient.getUserOperationGasPrice()).fast,
  },
})

const hash = await smartAccountClient.sendUserOperation({
  calls: [{ to: RECIPIENT, value: 0n, data: "0x1234" }],
})
const { success, receipt, paymaster } = await smartAccountClient.waitForUserOperationReceipt({ hash })

console.log({
  account: account.address,
  success,
  transaction: receipt.transactionHash,
  paymaster,
  accountBalance: await publicClient.getBalance({ address: account.address }),
})
```

**4. Запустите скрипт**

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
npx tsx --env-file=.env sponsored.ts
```

```js theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
  account: '0x592Be1302b3Cd4aABa548A44DB850D10e73E47Dc',
  success: true,
  transaction: '0x5fe5336fe2e1b1f71eae7d06f84b7a16a29d8ffd3fb8d672bf1be278ba453c7e',
  paymaster: '0x38aef040CEB057B62E1598F5C265946A4E4BaB4C',
  accountBalance: 0n
}
```

Аккаунт был задеплоен и выполнил свой вызов в одной UserOperation, и на нём по-прежнему нет ETH. Чтобы увидеть полную трассировку бандла, выполните поиск по хешу транзакции в [Virtual Environment Explorer](https://docs.tenderly.co/virtual-environments/explorer.md).

Чтобы использовать другую версию EntryPoint, измените константу `entryPoint`, например на `{ address: entryPoint08Address, version: "0.8" }`. Alto настроен для EntryPoint 0.6, 0.7 и 0.8, а mock paymaster деплоит paymaster для каждого из них.

> [!NOTE]
>
> Не смешивайте три эндпоинта. 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.

```ts title="self-funded.ts" theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import { createSmartAccountClient } from "permissionless"
import { toSimpleSmartAccount } from "permissionless/accounts"
import { createPimlicoClient } from "permissionless/clients/pimlico"
import { formatEther, http, parseEther } from "viem"
import { entryPoint07Address } from "viem/account-abstraction"
import { generatePrivateKey, privateKeyToAccount } from "viem/accounts"
import { BUNDLER_URL, RECIPIENT, chain, getFundedWallet, publicClient } from "./setup"

const entryPoint = { address: entryPoint07Address, version: "0.7" } as const
const bundlerClient = createPimlicoClient({ chain, transport: http(BUNDLER_URL), entryPoint })

const account = await toSimpleSmartAccount({
  client: publicClient,
  owner: privateKeyToAccount(generatePrivateKey()),
  entryPoint,
})

// Fund the account's address. It pays for its own deployment and gas.
const fundedWallet = await getFundedWallet()
await publicClient.waitForTransactionReceipt({
  hash: await fundedWallet.sendTransaction({ to: account.address, value: parseEther("0.01") }),
})

const smartAccountClient = createSmartAccountClient({
  account,
  chain,
  bundlerTransport: http(BUNDLER_URL),
  userOperation: {
    estimateFeesPerGas: async () => (await bundlerClient.getUserOperationGasPrice()).fast,
  },
})

const hash = await smartAccountClient.sendUserOperation({
  calls: [{ to: RECIPIENT, value: parseEther("0.001") }],
})
const { success, receipt, actualGasCost } = await smartAccountClient.waitForUserOperationReceipt({ hash })

console.log({
  account: account.address,
  success,
  transaction: receipt.transactionHash,
  gasCost: `${formatEther(actualGasCost)} ETH`,
  accountBalance: `${formatEther(await publicClient.getBalance({ address: account.address }))} ETH`,
})
```

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

Mock paymaster принимает собственный тестовый токен в качестве оплаты за газ. Любой может заминтить этот токен с помощью `sudoMint`.

```ts title="erc20.ts" theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import { createSmartAccountClient } from "permissionless"
import { toSimpleSmartAccount } from "permissionless/accounts"
import { createPimlicoClient } from "permissionless/clients/pimlico"
import { prepareUserOperationForErc20Paymaster } from "permissionless/experimental/pimlico"
import { type Address, formatEther, http, parseAbi, parseEther } from "viem"
import { entryPoint07Address } from "viem/account-abstraction"
import { generatePrivateKey, privateKeyToAccount } from "viem/accounts"
import { BUNDLER_URL, PAYMASTER_URL, RECIPIENT, chain, getFundedWallet, publicClient } from "./setup"

// The mock paymaster's test token, and the address that collects the fees.
const TOKEN = "0x68e13372AE8FAaDDaf32cC08ee44C5ef5A002c69"
const TREASURY = "0xD8Baa107006C93a030d1455A2eF43261b384F21c"
const tokenAbi = parseAbi([
  "function sudoMint(address to, uint256 amount)",
  "function balanceOf(address owner) view returns (uint256)",
])

const entryPoint = { address: entryPoint07Address, version: "0.7" } as const
const bundlerClient = createPimlicoClient({ chain, transport: http(BUNDLER_URL), entryPoint })
const paymasterClient = createPimlicoClient({ chain, transport: http(PAYMASTER_URL), entryPoint })

const fundedWallet = await getFundedWallet()
const tokenBalance = (owner: Address) =>
  publicClient.readContract({ address: TOKEN, abi: tokenAbi, functionName: "balanceOf", args: [owner] })
const mint = async (to: Address, amount: bigint) =>
  publicClient.waitForTransactionReceipt({
    hash: await fundedWallet.writeContract({
      address: TOKEN,
      abi: tokenAbi,
      functionName: "sudoMint",
      args: [to, amount],
    }),
  })

// Once per Virtual Environment: give the treasury a token balance. See the
// note below.
if ((await tokenBalance(TREASURY)) === 0n) await mint(TREASURY, 1n)

const account = await toSimpleSmartAccount({
  client: publicClient,
  owner: privateKeyToAccount(generatePrivateKey()),
  entryPoint,
})
await mint(account.address, parseEther("100"))

const smartAccountClient = createSmartAccountClient({
  account,
  chain,
  bundlerTransport: http(BUNDLER_URL),
  paymaster: paymasterClient,
  userOperation: {
    estimateFeesPerGas: async () => (await bundlerClient.getUserOperationGasPrice()).fast,
    // Fetches a token quote and adds the token approval to the UserOperation.
    prepareUserOperation: prepareUserOperationForErc20Paymaster(paymasterClient),
  },
})

const hash = await smartAccountClient.sendUserOperation({
  calls: [{ to: RECIPIENT, value: 0n, data: "0x1234" }],
  paymasterContext: { token: TOKEN },
})
const { success, receipt } = await smartAccountClient.waitForUserOperationReceipt({ hash })

console.log({
  account: account.address,
  success,
  transaction: receipt.transactionHash,
  tokenBalance: formatEther(await tokenBalance(account.address)),
  ethBalance: await publicClient.getBalance({ address: account.address }),
})
```

> [!NOTE]
>
> Перед первым платежом скрипт минтит 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.

```ts title="eip7702.ts" theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import { createSmartAccountClient } from "permissionless"
import { to7702SimpleSmartAccount } from "permissionless/accounts"
import { createPimlicoClient } from "permissionless/clients/pimlico"
import { http } from "viem"
import { entryPoint08Address } from "viem/account-abstraction"
import { generatePrivateKey, privateKeyToAccount } from "viem/accounts"
import { BUNDLER_URL, PAYMASTER_URL, RECIPIENT, chain, publicClient } from "./setup"

// Simple7702Account, deployed at the same address on every network.
const SIMPLE_7702_ACCOUNT = "0xe6Cae83BdE06E4c305530e199D7217f42808555B"

const entryPoint = { address: entryPoint08Address, version: "0.8" } as const
const bundlerClient = createPimlicoClient({ chain, transport: http(BUNDLER_URL), entryPoint })
const paymasterClient = createPimlicoClient({ chain, transport: http(PAYMASTER_URL), entryPoint })

// A plain EOA. It holds no ETH, so the mock paymaster sponsors it.
const owner = privateKeyToAccount(generatePrivateKey())
const account = await to7702SimpleSmartAccount({ client: publicClient, owner })

const smartAccountClient = createSmartAccountClient({
  account,
  chain,
  bundlerTransport: http(BUNDLER_URL),
  paymaster: paymasterClient,
  userOperation: {
    estimateFeesPerGas: async () => (await bundlerClient.getUserOperationGasPrice()).fast,
  },
})

// Sign the authorization for the Virtual Environment's chain ID and the
// EOA's nonce.
const authorization = await owner.signAuthorization({
  address: SIMPLE_7702_ACCOUNT,
  chainId: chain.id,
  nonce: await publicClient.getTransactionCount({ address: owner.address }),
})

const hash = await smartAccountClient.sendUserOperation({
  calls: [{ to: RECIPIENT, value: 0n, data: "0x1234" }],
  authorization,
})
const { success, receipt } = await smartAccountClient.waitForUserOperationReceipt({ hash })

console.log({
  eoa: owner.address,
  success,
  transaction: receipt.transactionHash,
  code: await publicClient.getCode({ address: owner.address }),
})
```

После первой UserOperation код EOA состоит из `0xef0100` и следующего за ним адреса имплементации. Последующим UserOperations с того же аккаунта поле `authorization` не нужно.

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

Чтобы возвращать Virtual Environment в известное состояние между запусками тестов, создайте снимок с помощью [`evm_snapshot`](https://docs.tenderly.co/virtual-environments/admin-rpc#evm_snapshot), откатывайтесь к нему с помощью [`evm_revert`](https://docs.tenderly.co/virtual-environments/admin-rpc#evm_revert) через Admin RPC и перезапускайте Alto после каждого отката. В примере используется `jq`.

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
source .env

# Take the snapshot after the stack is up, so the contracts that Alto and the
# mock paymaster deployed are part of it.
SNAPSHOT=$(curl -s "$TENDERLY_ADMIN_RPC_URL" -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"evm_snapshot","params":[]}' | jq -r .result)

# ...run your tests...

curl -s "$TENDERLY_ADMIN_RPC_URL" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"evm_revert\",\"params\":[\"$SNAPSHOT\"]}"

docker compose restart alto
```

К одному и тому же снимку можно откатываться столько раз, сколько вам нужно. Об откате из панели и ограничении дистанции отката см. [Откат состояния Virtual Environment](https://docs.tenderly.co/virtual-environments/develop/revert-state.md).

> [!WARNING]
>
> Перезапускайте 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`](https://docs.tenderly.co/virtual-environments/admin-rpc#evm_increasetime) временные метки блоков опережают часы машины (см. [Работа с временными метками в Virtual Environments](https://docs.tenderly.co/virtual-environments/develop/timestamps.md)).
* После `evm_revert` временные метки блоков продолжают отсчёт от временной метки снимка, поэтому они отстают от часов машины на время, прошедшее с момента снимка.

Mock paymaster подписывает каждое спонсирование на 60 000 секунд по часам машины. Если вы сдвигаете время вперёд больше чем на это значение, его спонсирования оказываются уже истёкшими ончейн: UserOperation никогда не подтверждается, а Alto продолжает повторно отправлять неуспешный бандл, пока вы не перезапустите Alto. Для тестов, которые сдвигают время дальше, отправляйте UserOperations без paymaster или [используйте собственный сервис 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 не нужен.

[Paymaster с правилами спонсирования](https://github.com/Tenderly/tenderly-pimlico-bundler/tree/main/policy-paymaster) из репозитория с примером выполняет все три условия и спонсирует только те UserOperations, которые проходят проверку API-ключа, списков разрешённых отправителей и целей и лимита расходов на отправителя.

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

| Симптом | Причина | Решение |
| - | - | - |
| `docker compose up` сообщает `dependency failed to start`, а в логе сервиса, завершившегося с ошибкой, появляется `The request took too long to respond` | Запрос к Virtual Environment превысил время ожидания, пока сервис отправлял стартовую транзакцию. | Снова выполните `docker compose up -d`. Запуск можно безопасно повторять: каждый сервис пропускает то, что уже задеплоено и пополнено. |
| `Bundler used an invalid aggregator for handling aggregated User Operations` с `debug_traceCall` в строке `Details:` | Alto работает в безопасном режиме. viem показывает это сообщение для любого неудачного запроса от Alto к Virtual Environment, а причина указана в строке `Details:`. | Задайте `ALTO_SAFE_MODE: "false"`. |
| Та же ошибка с `gasEstimateL1Component` в строке `Details:` | `ALTO_CHAIN_TYPE` имеет значение `arbitrum`. В этом режиме Alto запрашивает L1-составляющую газа у контракта `NodeInterface` сети Arbitrum. | Задайте `ALTO_CHAIN_TYPE=default` для Arbitrum One. |
| Alto завершает работу с ошибкой `insufficient funds for gas * price + value` после `Failed to deploy PimlicoSimulations contract` | На utility-ключе Alto нет ETH. | Проверьте, что funder завершил работу, с помощью `docker compose logs funder`, а также что в `TENDERLY_ADMIN_RPC_URL` указан URL Admin RPC. |
| Mock paymaster завершает работу с ошибкой `Access forbidden by access rules, try Admin RPC URL` | В `ANVIL_RPC` задан URL Public RPC. Mock paymaster вызывает `anvil_setBalance` при запуске. | Задайте для `TENDERLY_ADMIN_RPC_URL` в `.env` значение URL Admin RPC. |
| `AA50 postOp reverted` при оплате газа тестовым токеном | В казначействе paymaster нет этого токена. | Заминтьте 1 wei токена на адрес `0xD8Baa107006C93a030d1455A2eF43261b384F21c` один раз для каждой Virtual Environment, как это делает `erc20.ts`. |
| `The method "eth_call" does not exist / is not available` | Запрос на чтение был отправлен на URL бандлера. Та же ошибка для `pm_getPaymasterStubData` означает, что клиент paymaster указывает на Alto. | Создайте публичный клиент с URL Public RPC, используйте URL бандлера только как `bundlerTransport` и создайте клиент paymaster с URL paymaster. |
| UserOperations завершаются ошибкой `AA10 ... Another deployment operation for this sender is already being processed` или никогда не подтверждаются после `evm_revert` | Alto хранит состояние из блоков, которые удалил откат. | Выполните `docker compose restart alto`. См. [Сброс состояния между запусками тестов](#сброс-состояния-между-запусками-тестов). |
| Спонсируемые UserOperations никогда не подтверждаются после `evm_increaseTime` | Спонсирование от mock paymaster истекло ончейн. | Перезапустите Alto, чтобы сбросить зависшую UserOperation. См. [Перемещение во времени и окна действительности paymaster](#перемещение-во-времени-и-окна-действительности-paymaster). |
| `UserOperation expires too soon` с собственным сервисом paymaster | Сервис подписал `validUntil` по временной метке блока, в то время как часы Virtual Environment отстают. | Подписывайте по более позднему из показаний двух часов. См. [Использование собственного сервиса paymaster](#использование-собственного-сервиса-paymaster). |
| Адрес никогда не получает ETH, который вы на него отправляете | Адрес принадлежит общеизвестному тестовому ключу. На форках действующих сетей эти адреса пересылают любой полученный ими ETH. | Сгенерируйте новый ключ. |

## См. также

* [tenderly-pimlico-bundler](https://github.com/Tenderly/tenderly-pimlico-bundler) на GitHub: полный пример с paymaster с правилами спонсирования и smoke-тестом
* [Справочник Admin RPC](https://docs.tenderly.co/virtual-environments/admin-rpc.md) для `eth_sendTransaction`, `evm_snapshot`, `evm_revert` и `evm_increaseTime`
* [Откат состояния Virtual Environment](https://docs.tenderly.co/virtual-environments/develop/revert-state.md) с помощью снимков или панели
* [Работа с временными метками в Virtual Environments](https://docs.tenderly.co/virtual-environments/develop/timestamps.md)
* [Viem](https://docs.tenderly.co/virtual-environments/libraries/viem.md) в Virtual Environment: пользовательские цепочки и пользовательские RPC-методы
* [Отладка транзакций](https://docs.tenderly.co/virtual-environments/develop/debug-transactions.md) для пошагового прохождения транзакции бандла


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.