---
title: "user operationsとは?"
description: "定義、パラメータ、仕組み"
---

# user operationsとは?

ユーザーオペレーションは、送信者のスマートコントラクトアカウントに代わって実行されるトランザクションの詳細を含むオブジェクトです。ユーザーオペレーションは疑似トランザクションオブジェクトであり、[ERC-4337](https://www.alchemy.com/overviews/what-is-account-abstraction)をサポートするEthereumおよびレイヤー2ブロックチェーンにおいて、コンセンサスレイヤーの変更を必要とせずにAccount Abstractionを機能させます。

スマートコントラクトウォレット\(SCW\)を開発する、あるいは分散型アプリケーションをSCWと互換性を持たせるためには、ユーザーオペレーションを定義するパラメータ、ユーザーオペレーション構築プロセス中にユーザーオペレーションの各フィールドがどのように設定されるか、ユーザーオペレーションがBundlerによってどのようにバンドルされるか、そしてペイマスターによってどのように検証・実行されるかを理解しておくことが有益です。

<CalloutBlock>
  Embedded AccountsとAccount Abstractionインフラストラクチャを使用して、新規ユーザー向けに[埋め込み型のメールおよびパスキーウォレットを作成](https://www.alchemy.com/smart-wallets)できるようにしましょう！
</CalloutBlock>

## 動画で見る: Solidityでユーザーオペレーションを構築・実行する

<ExternalVideo
  url="https://youtu.be/NM04uxcCOEw?si=GP-JehvonrZ_6qtJ"
  provider="youtube"
  providerUid="NM04uxcCOEw"
/>

## **ユーザーオペレーションに含まれるフィールドとは？**

ユーザーオペレーション\(UO\)には、通常のトランザクションと似たフィールド\(sender、to、calldata、maxFeePerGas、maxPriorityFee、signature、nonceなど\)が含まれますが、それに加えてcallGasLimit、verificationGasLimit、preVerificationGas、paymasterAndDataといった、ユーザーオペレーション構造体特有の新しいフィールドも持ちます。

UOフィールドの定義は[ERC-4337の公式仕様書](https://eips.ethereum.org/EIPS/eip-4337)に記載されています。以下に要約します。

- **callGasLimit** - メインの実行呼び出しに使用されるガス
- **verificationGasLimit** - 検証ステップを完了するために使用されるガス
- **preVerificationGas** - 事前検証の実行およびcalldataコストをカバーするためにBundlerへ支払うガス
- **paymasterAndData** - スポンサーとなるペイマスターのアドレスと、そのペイマスターに送信するデータ

[ユーザーオペレーションの設計とアーキテクチャ](https://www.alchemy.com/overviews/what-is-account-abstraction)についての説明は、AlchemyのAAインフラチームのエンジニアである**David Philipson**が執筆した「You Could Invented Account Abstraction」シリーズのパート1で読むことができます。

次に、ユーザーオペレーションのフィールドを正しく設定するための標準的なワークフローを見ていきましょう。

## **ユーザーオペレーションを送信する流れとは？**

[Bundler](https://www.alchemy.com/overviews/what-is-a-bundler)へユーザーオペレーション\(ユーザーオペ\)を送信する典型的な流れは、複数のステップから構成されます。

1. sender、nonce、initCode、callDataを入力した部分的なユーザーオペを構築する
1. eth_estimateUserOperationGasを通じて、部分的なユーザーオペのガスをBundler RPCへ見積もる
1. preVerificationGas、verificationGasLimit、callGasLimitを設定する
1. ユーザーオペの内容に依存しないペイマスター\(例えば[ERC20](https://www.alchemy.com/overviews/erc20-solidity)ペイマスターなど\)を使用する場合、この段階でpaymasterAndDataを設定できる
1. オペレーションに必要なガス手数料を見積もり、maxFeePerGasとmaxPriorityFeePerGasを設定する
1. \(任意\)署名のためにユーザーオペをスポンサーとなるペイマスターへ送信し、paymasterAndDataを設定する
1. ペイマスターの署名には上記のすべてのフィールドが設定されている必要があるため、このステップで行う必要がある
1. ユーザーオペに署名し、signatureを設定してから、eth_sendUserOperationを通じてBundlerへユーザーオペを送信する

開発者はネイティブの[ethers.js](https://www.alchemy.com/dapps/ethers-js)を使って各ユーザーオペレーションフィールドの値を取得することもできますが、UO構築をより簡単にするweb3開発者向けツールがいくつか存在します。

## **開発者はユーザーオペレーションの構築にどんなツールを使えるか？**

AlchemyのオープンソースAA SDKのようなユーザーオペレーション構築ツールを使うと、ネイティブのethers.jsでユーザーオペを作成するよりも簡単にユーザーオペレーションを構築できます。

### **AlchemyのAA SDK**

AlchemyのAA SDKはviemをベースに構築されており、開発者に軽量なバンドルを提供します。[GitHub上のaa-sdk](https://github.com/alchemyplatform/aa-sdk)は、aa-ethersライブラリを通じてethers.jsのSignerおよびProviderもサポートしています。

aa-sdkを使ってユーザーオペレーションを構築する主な利点の1つは、次の2つのユーティリティメソッドです。

1. **sendUserOperation** - ガス見積もり、paymasterAndDataのリクエスト、署名などを処理する
1. **sendTransaction** - トランザクションオブジェクトのデータ\(from、to、data、value\)をユーザーオペレーションに変換する

ユーザーオペレーション構築の処理順序は複雑ですが、AlchemyのAA-SDKは**getDummyPaymasterData**、**estimateGas**によるガス見積もり、続いて**getFeeData**、そして最後に**getPaymasterAndData**という一連の処理を実行することでUO構築を簡略化します。

ユーザーオペのフィールドの値を取得した後、target、callData、そして任意のvalueを使ってユーザーオペレーションを構築し、署名します。その後、Bundlerへユーザーオペを送信し、ユーザーオペのハッシュを受け取ります。

Alchemyのペイマスター、別のペイマスターを使用したい場合、あるいは独自のSmartAccountsのサポートを追加する予定がある場合は、UOを簡単に作成する方法の完全な説明について[Alchemy AA SDKのドキュメント](https://www.alchemy.com/docs/wallets/reference/aa-sdk/core)をお読みください。

<ExternalVideo
  url="https://youtu.be/7aJ5bonMSyQ?si=P6ZANXn3HQYUssJr"
  provider="youtube"
  providerUid="7aJ5bonMSyQ"
/>

## **ユーザーオペレーションはどのようにユーザーオペmempoolへ追加されるか？**

ユーザーオペがmempoolへ追加される前に、ERC-4337仕様書に示された期待される動作に従っていることを確認するための一連のチェックに合格する必要があります。ユーザーオペはまた、有効であり、そのガス代を\(送信者のウォレットまたはペイマスターのスポンサーシップポリシーを通じて\)支払えることを確認するための検証シミュレーションチェックにも合格する必要があります。

### **1. ユーザーオペの有効性がチェックされる**

最初の一連のチェックは、ERC-4337仕様書の「Client behavior upon receiving a UserOperation」セクションで説明されており、以下に要約します。

- 送信者が既存のコントラクトであるか、\(コントラクトを作成するために使用される\)initCodeが空でないか\(ただし両方が同時に成り立つことはない\)
- **initCode**が空でない場合\(ユーザーオペがアカウントを作成するため\)、factoryがステークされているかどうかを判定する
- **verificationGasLimit**が十分に低い\(**MAX_VERIFICATION_GAS**以下である\)
- **preVerificationGas**がcalldataガスおよびオーバーヘッドガス手数料を支払うのに十分な高さである
- **paymasterAndData**が空であるか、ペイマスターのアドレスで始まっている
- ペイマスターが存在する場合、それはオンチェーン上に空でないコードを持ち、ユーザーオペの支払いに必要な資金を持ち、かつ禁止されていない
- **callgas**が、非ゼロ値を持つ**CALL**のコスト以上である
- **maxFeePerGas**と**maxPriorityFeePerGas**が、クライアントが受け入れる最小値を上回っている
- 送信者がプール内に別のユーザーオペを持っていない\(または、そのユーザーオペが既存のエントリを置き換えるために構築されている\)

これらのチェックに影響を与えうるルールは数多くあり、仕様書で詳しく説明されています。

このユーザーオペレーションの入門記事では、ユーザーオペの有効性を判定するために行われる高レベルのチェックについて説明するにとどめます。

### **2. ユーザーオペレーションがシミュレートされる**

ユーザーオペがこれらの基本的なチェックに合格すると、クライアントはユーザーオペレーションをシミュレートし、そのユーザーオペが自身の資金またはペイマスターを使って実行費用を支払えることを検証する必要があります。

ユーザーオペをシミュレートするために、Bundlerは**simulateValidation\(\)**メソッドを呼び出します。このメソッドは、送信者のアカウントの**validateUserOp**関数を呼び出すか、あるいはユーザーオペの実行にかかるガス手数料をスポンサーするためにペイマスターが使用される場合は、ペイマスターのコントラクトアカウントの**validatePaymasterUserOp**を呼び出します。

**simulateValidation\(\)**メソッドが呼び出されると、**ValidationResult**レスポンスと共にリバートします。この関数がリバートすることは意図された動作であり、これは成功した結果とみなされます。

**ValidationResult**が別のエラーでリバートした場合、そのユーザーオペは検証シミュレーションに合格しなかったことになり、mempoolには追加されません。**sigFail**を返すユーザーオペはmempoolから除外され、また**validUntil**レスポンスが期限切れになった場合もUOはmempoolから除外されることがあります。

**注:** ユーザーオペにinitCodeが存在する場合、アカウントファクトリによってアカウントが作成され、その後、新しく作成されたアカウントを使ってシミュレーションプロセスが進められます。

ユーザーオペレーションが構築され、チェックされ、シミュレートされ、mempoolへ追加されたので、次はentry pointコントラクトへ送信され、検証と実行が行われます！

### **ユーザーオペレーションはどのように検証・実行されるか？**

ユーザーオペレーション内のトランザクションの詳細がオンチェーンで公開されるためには、entry pointコントラクトがそのユーザーオペレーションを検証する必要があります。UOが検証に合格すると、entry pointコントラクトがトランザクションを実行し、その後Bundlerへガス手数料を払い戻します。

**ユーザーオペの検証と実行の基本的なステップは以下の通りです。**

1. BundlerがhandleOps\(\)メソッドを通じて、単一のentry pointコントラクトへユーザーオペを送信する
1. 各オペについて、entry pointがそのオペの送信者ウォレットに対してvalidateOpを呼び出す\*
1. いずれかのオペが検証ステップに失敗した場合、それらは破棄される
1. 次に、各オペの送信者ウォレットに対してexecuteOpを呼び出し、使用されたガス量を記録する
1. 各オペの実行に使用されたガスを支払うため、送信者のウォレットまたはペイマスターからBundlerへETHを送金する

\*すべての検証が実行され、それが完了して初めて、検証済みのユーザーオペのすべての実行が行われます。

以下は、送信者のスマートコントラクトウォレットに代わってentry pointコントラクトがユーザーオペレーションをどのように検証・実行するかを示す図です。

<ImageBlock
  src="https://media.alchemy.com/1703862507-user-operations-validations-executions.png"
  alt="ユーザーオペレーションがどのように検証・実行されるか"
  width={960}
  height={540}
/>

ユーザーオペレーションは、スマートコントラクトウォレットがEthereumおよび同等のL2上でユーザーのプライマリウォレットとして機能することを可能にする疑似トランザクションオブジェクトです。スマートコントラクトウォレットは[web3のUX上の利点](https://www.alchemy.com/overviews/smart-contract-wallet-benefits)をもたらし、ブロックチェーンをより身近なものにしますが、それを可能にしているのが[EthereumおよびL2上のAAインフラストラクチャプロバイダー](https://www.alchemy.com/account-abstraction)です。

あなたの[web3プロダクトがスマートコントラクトウォレットをサポートする](https://www.alchemy.com/docs/how-to-make-your-dapp-compatible-with-smart-contract-wallets)のであれば、Ethereum、Polygon、Arbitrum、Optimism、そしてSepoliaなどの人気のテストネット向けに、Gas Manager APIやBundler APIを含むAlchemyのAAインフラストラクチャをぜひご覧ください！