クリーム色の背景、色付き表示、高コントラスト、大きな文字のほうが読みやすいですか?配色と文字を選ぶと、すべてのページに一度で反映されます。

無料レッスン

ERC-4337 の仕組みとバンドラー

このレッスンのあとで: 1つの UserOperation を、署名から EntryPoint のイベントまでたどることができる。

70分のレッスンコマンド3件アカウント抽象化ラボ:スマートアカウント、ERC-4337、ペイマスター、EIP-7702 をローカルチェーンで

アカウントが自分で確かめる取引

ERC-4337 は、チェーン自体のルールを変えずに、Ethereum にスマートアカウントをもたらす標準です。トランザクションの代わりに UserOperation に署名し、バンドラーがそれを EntryPoint というコントラクトに運びます。

新しいスマートアカウントの多くはこの方式です。流れが分かれば、どれでも読めるようになります。

このレッスンのゴール

メモ

1つの UserOperation を、署名から EntryPoint のイベントまでたどることができる。

キーワード

ことばいみ
UserOperationスマートアカウントにさせたいことを書いた、署名つきの依頼
バンドラーUserOperation をチェーンに送るサーバー
EntryPointUserOperation を確かめて実行する、ただ1つのコントラクト
検証アカウントが許すか拒むかを答える段階
実行アカウントが呼び出しを行う段階
預け入れガス代のために EntryPoint が預かる ETH

学生が入力するセルは、このプレビューでは空白です。

ERC-4337 で誰が何をするか

  1. ユーザーが、自分のスマートアカウントの UserOperation に署名します。
  2. バンドラーが UserOperation を集めます。それを1つの普通のトランザクションで EntryPoint に送り、handleOps を呼びます。
  3. EntryPoint が、それぞれのアカウントに操作を検証させます。
  4. 次にすべての操作を実行し、アカウントの預け入れからバンドラーに払い戻します。

バンドラーは先にトランザクションのガス代を払うので、払い戻しを求めます。

UserOperation の中身

UserOperation には、送り手であるスマートアカウントが書かれています。nonce、実行する callData、3つのガスの上限も入っています。さらに、ガス1単位に払う最高額、任意のペイマスター、署名も入っています。

アカウントは、署名以外のすべての項目のハッシュに署名します。ハッシュには EntryPoint のアドレスとチェーン ID も含まれます。そのため、ほかの場所では使い回せません。

UserOperation を1つ送る

コマンド
docker exec chain ./steps/userop.sh

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

例: ラボの表示

段階ラボの表示
前のカウント0
EntryPoint の nonce0
アレックスが署名したハッシュ0x8806a321... (16進で64桁)
handleOps のトランザクションガス 133003
UserOperationEventsuccess true、ガス 114672、費用 0.000114672 ETH
あとのカウント1

学生が入力するセルは、このプレビューでは空白です。

先に検証、次に実行

EntryPoint は、バンドルの操作をどれか1つ実行する前に、すべてを検証します。検証では nonce を確かめ、アカウントに署名を確かめさせ、操作にかかりうる最大額を取っておきます。

1つでも検証に失敗すると、バンドル全体が取り消され、バンドラーは無駄にガス代を払います。そこでバンドラーは先にバンドルを試し、失敗しそうな操作を外します。

検証が拒むものを見る

コマンド
docker exec chain ./steps/refused.sh

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

3回の試しと3つの答え

試しバンドラーの表示
アレックスではなくマロリーが署名simulation failed, not sent: AA24 signature error
アレックスが署名sent handleOps、success true
同じ操作をもう一度simulation failed, not sent: AA25 invalid account nonce

学生が入力するセルは、このプレビューでは空白です。

よくある間違い

注意

バンドラーはユーザーの依頼を書き換えられる、と考える人が多くいます。それはできません。署名はすべての項目を覆うので、何かを変えれば検証が AA24 で失敗し、アカウントは何もしません。

バンドラーへの払い戻し

実行の前に、EntryPoint は操作にかかりうる最大額を取っておきます。すべてのガスの上限の合計に、最高の手数料を掛けた額です。実行のあとで実際に使った分だけを請求し、残りはアカウントの預け入れに戻します。

preVerificationGas は、EntryPoint が測れない作業の分をバンドラーに払います。低すぎるとバンドラーが損をします。ラボでは 0.000018331 ETH の持ち出しでした。

試そう: かかりうる最大額

コード: python
GWEI = 10 ** 9
call_gas = 100000
verify_gas = 100000
pre_gas = 21000
max_fee = 1 * GWEI

most = (call_gas + verify_gas + pre_gas) * max_fee
used = 114672 * GWEI
print("先に取る額:", most, "wei")
print("実際に使った額:", used, "wei")
print("預け入れに戻る額:", most - used, "wei")
# call_gas を 50000 に変えましょう。先に取る額はいくらになりますか。

ラボの EntryPoint は教材用

本物の EntryPoint はバージョン0.7か0.8です。ガスの項目を詰めて持ち、nonce の列を複数持てて、実行のあとでペイマスターをもう一度呼べます。検証のルール ERC-7562 は、試しでは通ってチェーン上で失敗する操作を防ぎます。

ラボは形だけを残し、それらを省いています。バンドラーは、試してから送るシェルの関数です。エラーコードを読んでみましょう。

EntryPoint のエラーコードを見る

コマンド
docker exec chain grep -n "AA[0-9]" src/EntryPoint.sol

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

このラボとソースについて: アカウント抽象化ラボ:スマートアカウント、ERC-4337、ペイマスター、EIP-7702 をローカルチェーンで

授業で使いますか?このモジュールを学生に割り当てると、教員用ガイド、自動採点つきの課題、学生ごとのラボを使えます。