【完全保存版】LayerZeroでチェーン間のトークン移動を行おう！

０　はじめに

本日は、Layer Zeroを使用した、チェーン間のトークン移動を見ていきたいと思います。

１　実行してみよう

実際にやってみましょう。

準備として、下の記事の第１章第３節までを実施してください。

できましたら、下のコードで、テストを行います。

npx hardhat test test/contracts/oft/BasedOFT.test.js

結果は下のようになりました。

３種類のコントラクトがデプロイされ、６種類のメソッドが実行されました。

２　コードを見ていこう

１　はじめに

まずは、今回のテストは下の４つになります。

では、こちらから中身を見ていきましょう。

２　チェーンID等の設定

まずはチェーンIDや総供給量などを指定しています。

なお、「parseUnits」関数では、「1,000,000 Ether」をweiの単位に変換しています。

注
イメージしやすいように、Ether、weiの単位で上は記載しました。

３　ownerの設定

次に、「before」でテスト前の処理を行っています。

なお、「before」が一度だけ行われる処理、「beforeEach」は各テスト毎に毎回事前に行われる処理です。

ここでは、「getSigners」でowner用の署名者を取得しています。

４　コントラクトファクトリの設定

そして、コントラクトをデプロイするために、コントラクトファクトリをあらかじめ作っています。

５　エンドポイントのデプロイ

次に、「beforeEach」を見てみましょう。

まずは、「LzEndpointMock」のコントラクトがデプロイされています。

このようになりました。

６　エンドポイントのチェーンの確認

こちらで、設定したチェーンIDが正しいかを確認しています。

７　トークンコントラクトのデプロイ

次に、実際に実行するコントラクトを作成します。

８　目的先エンドポイントの設定

次に、「setDestLzEndpoint」関数で、目的先をmappingで設定しています。

このようになりました。

９　信頼できるリモートコントラクトの設定

次に、「setTrustedRemote」関数で、信頼関係のあるコントラクトを設定します。

下のようになりました。

１０　setUseCustomAdapterParamsの設定について

次に、こちらを確認します。

「setUseCustomAdapterParams」をtrueにしています。

その名の通り、アダプタのパラメータを設定するようにしています。

少し探ってみようと思います。

まず、こちらの「ExampleBaseOFT」コントラクトからスタートします。

このようになっていることがわかりました。

さらに、「BaseOFT」コントラクトを見てみると「OFT」を継承していました。

こんな感じですね。

同様に、「OFT」コントラクトを確認すると、下のように、３つ継承していました。

こんな感じですね。

そして、「OFTCore」抽象コントラクトを確認すると、ようやく「setUseCustomAdapterParams」関数がありました。

ただ、あまり詳しいことはここから読み取れないので、一旦スルーします。

内容的には、ここにあったのですね。

３　一番目のテストについて

次に、テスト部分を見てみましょう。

まずはこちらの「it」からテストケースが開始されています。

１　残高の確認

まずは、下の部分で、残高の確認が行われています。

初期状態ですので、こちらを確認しています。

２　送付量の設定

次に、「amount」に「parseUnits」関数を使って、100トークンを設定しています。

３　setUseCustomAdapterParamsの設定

そして、「setUseCustomAdapterParams」関数を「false」に設定しています。

つまり、ここではアダプタのパラメータはデフォルトを使用します。

４　推定される手数料の取得

こちらで、送付時にかかる、推定された手数料を取得します。

なお、「estimateSendFee」関数は「OFTCore」抽象コントラクトにありました

こちらにあったのですね。

一方、実際には、「lzEndpoint」の「estimateFees」関数が使用されています。

なお、こちらにあるように、「nativeFee」は下の３つから構成されていました。

なお、今回のケースの場合、「oracleFee」は下のように定められていました。

５　送付の実施

そして、「sendFrom」関数でトークンの送付を行っています。

例えば、下の部分では、目的先のチェーンやアドレス、量を指定しています。

こちらでは、手数料やアダプターのパラメータを設定しています。

なお、「setUseCustomAdapterParams」を「false」にしているので、「0x」 として、デフォルト値を設定しています。

６　残高のチェック

最後に、下のように、それぞれの残高が正しいかを確認しています。

このように、100トークンが送付されたことが確認できました。

４　２番目のテストについて

１　はじめに

では、２番目のテストについても見ていきましょう。

違いだけ見ていきます。

違いとしては、アダプタのパラメータを設定しています。

２　パケットタイプについて

まず、下の部分を見てみましょう。

まず、「PT_SEND」はパケットタイプです。

このようになっています。

３　最小ガスの設定

次に、「setMinDstGas」を確認しましょう。

下のように、Mappingを使用しています。

ここでは、目的先のチェーンIDとパケットタイプの組み合わせごとに最小となるガスの値を設定しています。

４　adapterParamの設定について

ここで、アダプタのパラメータを設定しています。

パラメータについては、「PingPong」コントラクトが参考になりました

下のように、バージョンとガス代を設定していることがわかりました。

その上で、送付時のパラメータとして設定していました。

５　３番目のテストについて

３番目のテストも見ていきましょう。

下のように、エラーが発生することを見込んでいます。

理由としては、下の「setMinDstGas」関数が抜けているためです。

このように、「adapterParams」を設定する場合には、「setMinDstGas」で最小のガスも設定しなければならないとわかります。

６　４番目のテストについて

最後のテストについてです。

ここでもエラーが出ることが想定されています。

こちらは、下のように、設定した最小ガス（250,000）を下回るガス量(225,000)を指定しているため、エラーが発生しています。

今回は以上です。

ぜひやってみてください。