<p>この記事は Ethereum Advent Calendar 2023 における20日目の記事です。<br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__602f6be561b89" src="https://embed.zenn.studio/card#zenn-embedded__602f6be561b89" data-content="https%3A%2F%2Fqiita.com%2Fadvent-calendar%2F2023%2Fethereum" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://qiita.com/advent-calendar/2023/ethereum" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://qiita.com/advent-calendar/2023/ethereum</a></p>
<h2 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h2>
<p>こんにちは、クリプトやってます、kai(<a href="https://twitter.com/dikxs118" target="_blank" rel="nofollow noopener noreferrer">@dikxs118</a>)です。<br>
12/8-12/10でETHIndiaというEthereumのハッカソンに出てきたので、そこで出したものについて書いていこうと思います！<br>
ハッカソンなどは疲れるのであまりでないのですが、今回はお誘いいただいたので出ることにしました。<br>
ちなみに3人で行ったのですが、色々あり各々がSOLOで参加するというストロングスタイルでやることになりました。いやあ疲れた。<br>
結果としては私のプロダクトは諸々のPool Prizeと、<br>
Scrollから Best Prize をいただきました〜！🏆</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/e2e9f8623d08-20231218.jpg" loading="lazy" class="md-img"></p>
<p>プロジェクトの詳細やコードなどの実態は下記にあります。<br>
死ぬほどタイポしているのとコードは適当ですが、ハッカソンということでそこはご愛嬌です。(2徹した)<br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__d11667549c392" src="https://embed.zenn.studio/card#zenn-embedded__d11667549c392" data-content="https%3A%2F%2Fdevfolio.co%2Fprojects%2Fmulti-tenant-account-a8eb" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://devfolio.co/projects/multi-tenant-account-a8eb" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://devfolio.co/projects/multi-tenant-account-a8eb</a></p>
<p>一緒に行った2人もそれぞれ SafeとScrollで Best Prize を獲り、全勝ということでみんなハッピーに終われたのが何よりよかったですw</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/d8ffb4e9a9ef-20231218.jpg" loading="lazy" class="md-img"></p>
<p>今回の話ですが、前提となる知識があるので、下記の順序で解説していきます。(抜粋)</p>
<ol>
<li>Multi Tenant Accountの概要</li>
<li>デモ</li>
<li>ERC7546について</li>
<li>Multi Tenant Accountの詳細</li>
<li>デモ解説</li>
</ol>
<h2 id="multi-tenant-account-%E6%A6%82%E8%A6%81">
<a class="header-anchor-link" href="#multi-tenant-account-%E6%A6%82%E8%A6%81" aria-hidden="true"></a> Multi Tenant Account 概要</h2>
<p>さて、まずは Multi Tenant Account について概要を説明していきます。<br>
Multi Tenant Account は ERC7546: Upgradeable Clone(後述) に基づき実装された、既存はもちろん、後発で開発されたContract Accountの実装をデプロイなしで自由に取り込めるようになる最強のUpgradeabilityをもったContract Accountです。</p>
<p>要は好きなContarct Accountの実装を自由に取り込んで何にでも対応するContract Accountを作成することもできるし、仕様変更の可能性があるContract Accountを取り込んだとしても、いつでも柔軟に実装の変更対応できる可用性、保守性の高いContract Accountを作ることができるのが Multi Tenant Account です。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/37ea91a313ec-20231218.png" loading="lazy" class="md-img"></p>
<h3 id="%E3%83%87%E3%83%A2">
<a class="header-anchor-link" href="#%E3%83%87%E3%83%A2" aria-hidden="true"></a> デモ</h3>
<p>Multi Tenant Accountの一例として、<br>
Multi Tenant Accountが、 LightAccountImpl(AA) と SafeImpl(Multisig)<br>
の実装を取り込むことで、MultisigやAAとして機能していることを証明します。(ETHIndiaの動画尺の関係で早めに操作しているので、わからなかったら止めてください🙏)</p>
<aside class="msg message"><span class="msg-symbol">!</span><div class="msg-content">
<p>デモを理解するためには前提知識としてSafeとAAの理解が必要です</p>
</div></aside>
<p>手順としては下記です。</p>
<ol>
<li>
<strong>AAとして機能:</strong> handleOpsを呼び出し、entrypointを経由して、Multi Tenant AccountがLightAccountImplを呼び出すことでEOAに送金する</li>
<li>
<strong>Multisigとして機能:</strong> execTransactionを呼び出し、Multi Tenant AccountがSafeImplを呼び出すことでEOAに送金する</li>
</ol>
<p><span class="embed-block embed-youtube"><iframe src="https://www.youtube-nocookie.com/embed/_Dj2s6zKXJo" allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen loading="lazy"></iframe></span><a href="https://youtu.be/_Dj2s6zKXJo?si=IGsJYP19Iec2NV73" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://youtu.be/_Dj2s6zKXJo?si=IGsJYP19Iec2NV73</a></p>
<p>もしこのデモを見てもチンプンカンプンだとしても（というより補足ないし多分よくわからないですよね)以降で詳しく解説した後、再度デモ解説をするのでご安心ください。</p>
<h2 id="erc7546">
<a class="header-anchor-link" href="#erc7546" aria-hidden="true"></a> ERC7546</h2>
<p>Multi Tenant Account 動作する基盤となる ERC7546 について詳細を見ていきます。<br>
これから書く内容は私の噛み砕いた理解なので、正確にキャッチアップしたい方は公式ドキュメントを見てください。<br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-github"><iframe id="zenn-embedded__842f1e6a2c94e" src="https://embed.zenn.studio/github#zenn-embedded__842f1e6a2c94e" data-content="https%3A%2F%2Fgithub.com%2Fethereum%2FERCs%2Fblob%2F9d1e9da45bf21212dc7de63483da967b96fadd7e%2FERCS%2Ferc-7546.md" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/ethereum/ERCs/blob/9d1e9da45bf21212dc7de63483da967b96fadd7e/ERCS/erc-7546.md" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/ethereum/ERCs/blob/9d1e9da45bf21212dc7de63483da967b96fadd7e/ERCS/erc-7546.md</a></p>
<p>ERC7546は <a href="https://twitter.com/shogochiai" target="_blank" rel="nofollow noopener noreferrer">@shogochiai</a>, <a href="https://twitter.com/kai_hiroi" target="_blank" rel="nofollow noopener noreferrer">@kai_hiroi</a> によって2023/11月に proposal された<strong>新たなデザインパターン</strong>です。私も近くにいるので、これについては少しわかっていて、将来性を強く感じたので、これを使ってプロダクトを作ることにしました。</p>
<span class="embed-block zenn-embedded zenn-embedded-tweet"><iframe id="zenn-embedded__613446681a2bd" src="https://embed.zenn.studio/tweet#zenn-embedded__613446681a2bd" data-content="https%3A%2F%2Ftwitter.com%2Fshogochiai%2Fstatus%2F1717083152311849323" frameborder="0" scrolling="no" loading="lazy"></iframe></span>
<span class="embed-block zenn-embedded zenn-embedded-tweet"><iframe id="zenn-embedded__f9aa583962e55" src="https://embed.zenn.studio/tweet#zenn-embedded__f9aa583962e55" data-content="https%3A%2F%2Ftwitter.com%2Fkai_hiroi%2Fstatus%2F1717536046370750889" frameborder="0" scrolling="no" loading="lazy"></iframe></span>
<p>Upgradeable Clone が何かということを一言で表すならば、 <strong>Beacon Proxy と Diamond Standard を組み合わせたデザインパターン</strong>で、Beacon Proxyのように、紐づくProxyの一括のアップグレードが可能で、 Beacon の代わりに Dictionary というリゾルバで管理し、Diamond Standardのように関数毎の登録が可能で has many impls として振る舞います。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/52272623be7b-20231218.png" loading="lazy" class="md-img"></p>
<p>上記の図から全体の処理の流れをまとめると、</p>
<ol>
<li>Dictionaryに関数を登録
<ul>
<li>setImplementation というメソッドで登録したい関数のセレクター(bytes4)と、その実装のアドレスをマッピングして登録します</li>
</ul>
</li>
<li>ERC7546Proxyに呼びたいメソッドをcall
<ul>
<li>ユーザーがProxyに呼び出したいメソッドをcallします</li>
</ul>
</li>
<li>Dicitonaryから関数を持っている実装コントラクトのアドレスを取得
<ul>
<li>Proxyは fallback し、 getImplementation というメソッドを呼び、呼び出された関数の実装コントラクトアドレスを取得します</li>
</ul>
</li>
<li>そのアドレスにdelegatecall
<ul>
<li>実装コントラクトアドレスにdelegatecallすることで機能します</li>
</ul>
</li>
</ol>
<p>となります。</p>
<p>管理と振る舞いという点で分割して切り離してみてみるとわかりやすいです。</p>
<h3 id="%E6%8C%AF%E3%82%8B%E8%88%9E%E3%81%84">
<a class="header-anchor-link" href="#%E6%8C%AF%E3%82%8B%E8%88%9E%E3%81%84" aria-hidden="true"></a> 振る舞い</h3>
<p>点線で囲っている部分はまさに Diamond Standard のように振る舞います。<br>
つまり、複数の実装を同時に参照し、呼び出された関数に応じて適切な実装をdelegatecallすることができます。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/18508303e864-20231218.png" loading="lazy" class="md-img"></p>
<h3 id="%E7%AE%A1%E7%90%86">
<a class="header-anchor-link" href="#%E7%AE%A1%E7%90%86" aria-hidden="true"></a> 管理</h3>
<p>管理という表現が適切かは分かりませんが、点線で囲っている部分が Beacon Proxy のようにManageします。Beaconでは、設定されている固定の実装のアドレスを返し、Proxyがそのアドレスにdelegatecallしますが、Dictionaryでは、関数のセレクターと実装のアドレスをマッピングを永続化することで、都度返却するアドレスを解決しています。<br>
<img src="https://storage.googleapis.com/zenn-user-upload/39ea06092bc6-20231218.png" loading="lazy" class="md-img"></p>
<h2 id="multi-tenant-account-%E8%A9%B3%E7%B4%B0">
<a class="header-anchor-link" href="#multi-tenant-account-%E8%A9%B3%E7%B4%B0" aria-hidden="true"></a> Multi Tenant Account 詳細</h2>
<p>さて、ERC7546について理解した上で、Multi Tenant Accountを利用するメリットとモチベーションについて解説していきます！</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/bfc8a57171e7-20231218.png" loading="lazy" class="md-img"></p>
<p>一つずつ見ていきましょう。</p>
<h3 id="%E8%87%AA%E5%9C%A8%E3%81%AA%E3%82%A2%E3%83%83%E3%83%97%E3%82%B0%E3%83%AC%E3%83%BC%E3%83%89">
<a class="header-anchor-link" href="#%E8%87%AA%E5%9C%A8%E3%81%AA%E3%82%A2%E3%83%83%E3%83%97%E3%82%B0%E3%83%AC%E3%83%BC%E3%83%89" aria-hidden="true"></a> 自在なアップグレード</h3>
<p>先述した通り、 Multi Tenant Account では、自由自在に他のContract Accountの実装を取り込むことができ、デプロイなしで適応できます。これにより、仕様の変更にもシームレスに対応できます。</p>
<p>例えば、ERC4337(AA)が発表されたとき、AA対応しようと思ったら既存のAccount(Proxy)は捨てるしかなかったですよね？<br>
また、せっかくAA対応してもERC4337の仕様が今後ドラスティックに変わっていく可能性は高いでしょう。辛いですね。マイグレーションは非常にセンシティブで、疲れるのでできるだけやりたくない作業です。</p>
<p>Multi Tenant Accountの機能の一つとして、AAの実装を取り込んでおけば、そのようなマイグレーション作業は不要になります。</p>
<h3 id="%E4%B8%80%E6%8B%AC%E3%82%A2%E3%83%83%E3%83%97%E3%82%B0%E3%83%AC%E3%83%BC%E3%83%89">
<a class="header-anchor-link" href="#%E4%B8%80%E6%8B%AC%E3%82%A2%E3%83%83%E3%83%97%E3%82%B0%E3%83%AC%E3%83%BC%E3%83%89" aria-hidden="true"></a> 一括アップグレード</h3>
<p>Multi Tenant AccountのBaseになるERC7546にはDictionaryというリゾルバが存在していましたね。</p>
<p>そのため、紐づくProxyがいくつあったとしても新しい Contract Accountの実装を取り込み直せば、<br>
全てのProxyが一括でアップデートできます。</p>
<h3 id="%E9%96%A2%E6%95%B0%E3%83%AC%E3%83%99%E3%83%AB%E3%81%AE%E3%82%A2%E3%83%83%E3%83%97%E3%82%B0%E3%83%AC%E3%83%BC%E3%83%89">
<a class="header-anchor-link" href="#%E9%96%A2%E6%95%B0%E3%83%AC%E3%83%99%E3%83%AB%E3%81%AE%E3%82%A2%E3%83%83%E3%83%97%E3%82%B0%E3%83%AC%E3%83%BC%E3%83%89" aria-hidden="true"></a> 関数レベルのアップグレード</h3>
<p>例えば、完全にマルチシグとして振る舞おうと思えば、SafeImplに存在するpublicとexternalの関数を全て登録すれば良いですが、関数の一部だけ更新したり登録したりしたい場面もあると思います。</p>
<p>ここがBeacon Proxyとは異なるところで、Multi Tenant Account(ERC7546)では、関数単位のアップグレードが可能なため、コントラクト全体ではなく、特定の関数のみアップデートすることが可能です。<br>
つまり、元のコントラクトに影響を与えることなく影響範囲を局所化することができます。</p>
<h3 id="%E4%BD%8E%E3%82%B3%E3%82%B9%E3%83%88%E3%83%87%E3%83%97%E3%83%AD%E3%82%A4">
<a class="header-anchor-link" href="#%E4%BD%8E%E3%82%B3%E3%82%B9%E3%83%88%E3%83%87%E3%83%97%E3%83%AD%E3%82%A4" aria-hidden="true"></a> 低コストデプロイ</h3>
<p>Proxyについてですが、SolidityではなくHuffという低級言語で書かれているため、デプロイのコストがSolidityで書くのに比べて6割ほど削減されています。（すごい！)</p>
<h3 id="%E3%83%87%E3%83%A2%E8%A7%A3%E8%AA%AC">
<a class="header-anchor-link" href="#%E3%83%87%E3%83%A2%E8%A7%A3%E8%AA%AC" aria-hidden="true"></a> デモ解説</h3>
<p>それでは、最後に再度デモを見てみましょう！<br>
まずはやりたいことをおさらいします。<br>
やりたいことはただのProxyが、 LightAccountImpl(AA) と  SafeImpl(Multisig)<br>
の実装を取り込むことで、MultisigやAAとして機能していることを証明します。</p>
<p>手順としては下記です。</p>
<ol>
<li>
<strong>AAとして機能:</strong> handleOpsを呼び出し、entrypointを経由して、Multi Tenant AccountがLightAccountImplを呼び出すことでEOAに送金する</li>
<li>
<strong>Multisigとして機能:</strong> execTransactionを呼び出し、Multi Tenant AccountがSafeImplを呼び出すことでEOAに送金する</li>
</ol>
<p><span class="embed-block embed-youtube"><iframe src="https://www.youtube-nocookie.com/embed/_Dj2s6zKXJo" allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen loading="lazy"></iframe></span><a href="https://youtu.be/_Dj2s6zKXJo?si=IGsJYP19Iec2NV73" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://youtu.be/_Dj2s6zKXJo?si=IGsJYP19Iec2NV73</a></p>
<p>デモ動画で、やっていることを詳細に順序立てて噛み砕きます。</p>
<ol>
<li>ERC7546Proxyをデプロイ(ガス代節約のためデモ動画ではすでにデプロイ済みのアドレスを利用してます) 0:02~</li>
<li>Proxyにガス代を送金 0:30~</li>
<li>ただのProxyなので、AAのsendUserOperationできるわけないよね、を明示 1:00~</li>
<li>sendUserOperation(コントラクトレベルでは handleOps)を呼び出すために必要な関数をDictionaryに登録 1:24~
<ul>
<li>LightAccountのexternal, publicの関数を全て登録すれば、完全なLightAccountとして機能しますが、今回はデモなのでhandleOpsを行うための最小限のメソッドを登録してます</li>
</ul>
</li>
<li>LightAccountのInitializeを行う 2:00~
<ul>
<li>これによりLightAccountの初期状態がProxyのStorageに書き込まれ、LightAccountとして機能するようになります</li>
</ul>
</li>
<li>sendUserOperationを行う 2:18~
<ul>
<li>動画では割愛されていましたが、きちんとentrypointを経由してMulti Tenant Accountが呼ばれています</li>
</ul>
</li>
<li>Multisigとして機能しないことを明示 3:20~</li>
<li>execTransactionを呼び出すために必要な関数をDictionaryに登録 3:30~
<ul>
<li>Safeのexternal, publicの関数を全て登録すれば、完全なSafeとして機能しますが、今回はデモなのでexecTransactionを行うための最小限のメソッドを登録してます</li>
</ul>
</li>
<li>safeのsetupを呼び出しInitializeを行う</li>
<li>execTransactionを行う</li>
</ol>
<h2 id="specialthanks">
<a class="header-anchor-link" href="#specialthanks" aria-hidden="true"></a> SpecialThanks</h2>
<p>これを形にするまでに、様々なアドバイスやアイデアをいただいたのでここに記載させていただきます！<br>
ありがとうございました🏆🏆🏆</p>
<p><a href="https://github.com/0xhaku" target="_blank" rel="nofollow noopener noreferrer">@0xHaku</a>(DeFiGeek, DeFiの神)<br>
<a href="https://twitter.com/kai_hiroi" target="_blank" rel="nofollow noopener noreferrer">@kai_hiroi</a>(Ecdysis, ERC7546の神)<br>
<a href="https://twitter.com/shogochiai" target="_blank" rel="nofollow noopener noreferrer">@shogochiai</a>(Ecdysis, クリプトの神)<br>
<a href="https://twitter.com/m0t0k1ch1" target="_blank" rel="nofollow noopener noreferrer">@m0t0k1ch1</a>(SIVIRA, AAの神）</p>


Multi Tenant Account from ETHIndia

solidity

Discussion