アカウントが自分で確かめる取引
ERC-4337 は、チェーン自体のルールを変えずに、Ethereum にスマートアカウントをもたらす標準です。トランザクションの代わりに UserOperation に署名し、バンドラーがそれを EntryPoint というコントラクトに運びます。
新しいスマートアカウントの多くはこの方式です。流れが分かれば、どれでも読めるようになります。
このレッスンのゴール
メモ
1つの UserOperation を、署名から EntryPoint のイベントまでたどることができる。
キーワード
| ことば | いみ |
|---|---|
| UserOperation | スマートアカウントにさせたいことを書いた、署名つきの依頼 |
| バンドラー | UserOperation をチェーンに送るサーバー |
| EntryPoint | UserOperation を確かめて実行する、ただ1つのコントラクト |
| 検証 | アカウントが許すか拒むかを答える段階 |
| 実行 | アカウントが呼び出しを行う段階 |
| 預け入れ | ガス代のために EntryPoint が預かる ETH |
学生が入力するセルは、このプレビューでは空白です。
ERC-4337 で誰が何をするか
- ユーザーが、自分のスマートアカウントの UserOperation に署名します。
- バンドラーが UserOperation を集めます。それを1つの普通のトランザクションで EntryPoint に送り、handleOps を呼びます。
- EntryPoint が、それぞれのアカウントに操作を検証させます。
- 次にすべての操作を実行し、アカウントの預け入れからバンドラーに払い戻します。
バンドラーは先にトランザクションのガス代を払うので、払い戻しを求めます。
UserOperation の中身
UserOperation には、送り手であるスマートアカウントが書かれています。nonce、実行する callData、3つのガスの上限も入っています。さらに、ガス1単位に払う最高額、任意のペイマスター、署名も入っています。
アカウントは、署名以外のすべての項目のハッシュに署名します。ハッシュには EntryPoint のアドレスとチェーン ID も含まれます。そのため、ほかの場所では使い回せません。
UserOperation を1つ送る
docker exec chain ./steps/userop.shここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
例: ラボの表示
| 段階 | ラボの表示 |
|---|---|
| 前のカウント | 0 |
| EntryPoint の nonce | 0 |
| アレックスが署名したハッシュ | 0x8806a321... (16進で64桁) |
| handleOps のトランザクション | ガス 133003 |
| UserOperationEvent | success 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 の持ち出しでした。
試そう: かかりうる最大額
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ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。