アカウント抽象化ラボ:スマートアカウント、ERC-4337、ペイマスター、EIP-7702 をローカルチェーンで

このラボでは、生徒ひとりひとりに専用のローカルなテスト用チェーン、Foundry の anvil を渡します。スマートアカウント、EntryPoint、ペイマスター、呼び出し用のカウンター、2つの EIP-7702 のデリゲートが、はじめからデプロイしてあります。8本の短いスクリプトが、それぞれ1つの考え方を見せます。普通のアカウントとスマートアカウントの比較、バンドラーが運ぶ UserOperation、検証が拒むもの、空のアカウントの分を払うペイマスター、支払いの上限があるセッションキー、委任の設定と取り消し、署名した委任でアカウントが空になる様子、そして同じ支払いの3つの方法です。どのスクリプトもチェーンを始めの状態に戻してから動くので、毎回同じ結果を表示します。

ここにはお金はありません。チェーンは生徒のコピーの中だけで動き、鍵は Foundry のどの解説にも載っている公開のテスト用の鍵です。どのコピーも、インターネットにも、公開のチェーンにも、ほかの生徒にもつながりません。コインの価格や売買は一切出てきません。

生徒が学ぶこと

秘密鍵が1つだけだと弱い理由です。鍵をなくすと普通のアカウントは使えなくなり、漏れると空にされ、ガス代も自分で払う必要があります。ERC-4337 の仕組みも学びます。ユーザーが UserOperation に署名し、バンドラーがそれを EntryPoint に送り、EntryPoint はすべての操作を検証してから実行します。ラボでは1つの操作がガス 114672 でカウンターを0から1にし、悪い署名と使い回した nonce は AA24 と AA25 で拒否されます。ペイマスターが ETH のないアカウントの分を払い、知らない人や高すぎる操作を断ること、セッションキーがお店に2回払って上限で拒否されること、EIP-7702 の委任が普通のアカウントにコードを与え、0xef0100 とアドレスで表されることも見ます。ブロックチェーン、セキュリティ、ソフトウェア工学の講座に向いています。正確な文言は、お使いの資格団体の単元で確認してください。ここには引用していません。

ブラウザーで実行する

ラボは chain というサービスをひとつ起動します。このサービスは、コントラクト、そのコンパイル済みのコード、aa.sh、スクリプトをホームフォルダーに書き出し、anvil を起動してデプロイします。何もダウンロードしません。ウェブページはなく、ターミナルがラボです。ターミナルには専用の cast がないので、docker exec chain に続けて、中で実行するコマンドを書きます。

  1. コンテナーのページを開く. バーの「つくる」を開き、「コンテナーを実行」を選びます。ページは誰でも開けて、Git ラボと SQL ラボはアカウントなしで起動できます。ほかのラボには無料アカウントが必要です。アカウントを作成してサインインし、「起動」を押します。
  2. ラボを探す. 「サンプルラボ」のカードにすべてのサンプルが並んでいます。スマートアカウント:ERC-4337、ペイマスター、EIP-7702 を探します。
  3. 「起動」を押す. 「起動」はそのまま1回の操作で実行します。「先にファイルを編集」は compose ファイルを開くので、起動する前に変更できます。
  4. 開く. ラボのページで「ターミナルを開く」を押し、docker exec chain ./steps/userop.sh と入力すると、UserOperation が1つ署名され、バンドラーが送り、EntryPoint が実行する様子が表示されます。コントラクトは src にあるので、docker exec chain cat src/SmartAccount.sol でスマートアカウントを読めます。

生徒に提出してもらうもの

自分で変えて実行したスクリプト1つについて数行を書いてもらいます。たとえば上限の違うセッションキーや、上限を下げたペイマスターです。何が表示されたかと、分かったことを自分の言葉で1、2文添えてもらいます。自動では採点されません。この文が、理解できたかどうかを示します。さらに力を見たいときは、フィッシングのスクリプトで、署名の前にウォレットが何を表示すべきだったかを説明してもらいます。

このラボの基本レッスン

Smart Account Basics は、このラボで進める小さなレッスンです。生徒は普通のアカウントとスマートアカウントを比べ、バンドラーを通して UserOperation を1つ送り、ペイマスターに空のアカウントの分を払ってもらい、セッションキーで上限まで払い、EIP-7702 で普通のアカウントを委任します。

無料の個人アカウントでは「ホーム」にある Basics モジュールに入っていて、どの学校もライブラリーの Basics フォルダーからコピーできます。あえて小さくしてあり、ラボで進めるレッスンがどういうものかを先生に見せる役目です。あとはラボが受け持ちます。変更したいときは、自分のモジュールにコピーしてください。大学向けモジュール「スマートアカウント: ローカルチェーンで学ぶアカウント抽象化」も、同じラボで進めます。

GitHub のコード

compose ファイルには Dockerfile がありません。公開されている既存のイメージ、Foundry 自身のものをひとつだけ使い、リリースのタグに固定し、権限のない専用アカウントとメモリ 256 MB で動かします。イメージのライセンスは MIT または Apache-2.0 で、私たちは再配布していません。起動のたびに、固定の文章からコントラクトとスクリプトをすべて書き出します。ラボにはコンパイラーがなく、何もダウンロードしないので、コントラクトは私たちがコンパイルしたものをソースと並べて置いています。限界もあります。EntryPoint は本物と同じ形を持つ簡略化した教材用のモデルで、本物の安全策は入っていません。バンドラーは、バンドルを試してから送るシェルの関数です。EIP-7702 は本物で、anvil の Prague のルールで動きます。ラボを止めると何も残りません。

課題として出す

何を提出するかを課題に書いておきます。

  1. ラボを作る. モジュールで課題を追加し、「コンテナーラボ」のカードを選んでから「GitHub リポジトリ」を選びます。https://github.com/mitsurutech/lab-aa-lab とブランチ main を指定します。compose ファイルは既定の compose.yaml です。変更したい場合は、たとえばペイマスターの上限やセッションキーの上限を変えるときは、先にリポジトリをフォークしてください。
  2. 公開して試す. 「公開」すると、確認したコミットに固定されるので、あとでリポジトリを変更しても、すでに出したラボは変わりません。まず自分のコピーを起動してください。
  3. 配布する. ほかの課題と同じように配布します。期限を付けることもでき、課題には何をするか、何を提出するかを書いておきます。
  4. 提出物を採点する. 生徒のコピーを開いて提出された内容を確認し、採点します。足りない場合は理由を書いて差し戻します。

このラボを試す、そして費用

無料の個人アカウントで、このラボの基本レッスンに取り組めます。毎月、ほとんどのレッスンに足りる無料クレジットがあり、カードは要りません。クラスで使う場合、学校は最初の365日間、生徒50人まで無料で、その後は生徒1人あたりの年額です。すべてのラボが含まれ、教職員は無料です。

よくある質問

これは本物のお金ですか。
いいえ。チェーンは生徒自身のコピーの中にあるローカルなテスト用チェーン anvil で、鍵はよく知られたテスト用の鍵です。ラボはインターネットにも公開のチェーンにもつながりません。これらの鍵は、ほかの場所では決して使わないでください。
ターミナルで docker exec chain を使うのはなぜですか。
ラボのターミナルにはいくつかのクライアントが入っていますが、cast はありません。docker exec chain は、anvil と cast のあるラボのコンテナーの中でコマンドを実行します。
これは本物の EntryPoint とバンドラーですか。
いいえ。本物の EntryPoint (バージョン0.7か0.8) と本物のバンドラーには、ラボにない道具が要ります。ラボの EntryPoint は、検証、実行、バンドラーへの支払いという同じ形と、同じエラーコードを持ちます。バンドラーは aa.sh のシェルの関数です。実際に使うものには、監査済みの EntryPoint を使ってください。
どのスクリプトも毎回同じ結果を表示するのはなぜですか。
どのスクリプトも、まずチェーンを、コントラクトのデプロイ時に保存したスナップショットに戻します。鍵もガスの価格もすべて固定です。そのため、どの順番で実行しても、レッスンに書いたとおりの結果を表示します。