【完全保存版】thirdwebによる分割配布コントラクトの作成とソースコードの確認について
0 はじめに
この記事では、「thirdweb」でトークンを分割配布する「split」コントラクトを作成・実行します。
その後、後半で、そのコントラクトのソースコードを読んでみます。
なお、こちらの資料は、2023年のHRハッカソンの勉強会で使う事を予定しています。
1 Splitコントラクトを作成する
まずは、thirdwebでコントラクトを作ってみましょう。
「Go to Dashboard」でダッシュボードに行きます。
「Browse contracts」を選択
「Split」を選択
「Deploy now」を選択
「Name」や「Symbol」に任意の値を入れます。
また、「Split Settings」に任意のアドレスと%を合計100%になるように入れます。
できたら、「Deploy Now」
これで、コントラクトができました。
2 分割配布を実行する
こちらがコントラクトアドレスになります。
まず、準備として、メタマスクなどから、こちらのアドレスに配布用のトークンを送付しておきます。
このように、約0.1Astrをコントラクトに送付しました。
では、事前に登録してあるアドレスに分割してみましょう。
「Explorer」の「Write」の「distribute」から「Execute」で実行します。
しばらくすると、このようになり、実行が完了したことが示されました。
実際に分割先のアドレスを見ると、下のように指定した割合に応じて分割していることが確認できました。
3 ソースコードを確認する
1 確認方法について
では、ソースコードを確認してみましょう。
この画面で確認ができます。
「Sources」から「Split.sol」を開きます。
2 distribute関数について
本日、確認してみたいのが、こちらの「distribute」関数です。
大まかには、「payeeCount」という関数で、支払い先のアカウント数を取得して
その個数分、「_release」関数で配布を行なっていそうです。
3 payeeCount関数について
では、まずは、「payeeCount」関数を確認してみましょう。
「PaymentSplitterUpgradable.sol」を確認します。
すると、下のように、関数が確認できました。
どうやら、「_payees」の長さを返しているようです。
「_payees」を見ると、アドレスの配列であることが確認できます。
デプロイ時に設定したアドレスのリストであることが推測できます。
4 _release関数について
次に、「_release」関数も見てみましょう
まずは、「shares」という関数を使っているようです。
配布先の人がいるかどうかを確認しているようですね。
5 shares関数について
「PaymentSplitterUpgradable.sol」に下のように関数がありました。
「_shares」のmappingの値を返しているようです。
「_shares」はこのようになっていました。
次に、こちらを見てみましょう。
「address(this).balance」でこのコントラクト自身の残高と「totalReleased」関数の結果を合計しているようです。
今までコントラクトとして受け取った全額を取得しているようです。
6 totalReleased関数について
「PaymentSplitterUpgradable.sol」に下のように関数がありました。
「_totalReleased」の値を返しているようです。
「_totalReleased」は下のように定められていました。
7 _pendingPayment関数について
次に、「_pendingPayment」関数を確認してみましょう。
これは、今から支払う予定の額を求めているようです。
「PaymentSplitterUpgradable.sol」に下のように関数がありました。
どうやら、計算を行っているようですね。
8 released関数について
「_pendingPayment」の引数として用いている、「released」関数もこちらにありました。
「_released」のmappingの値を返しているようです。
「_released」はこちらにありました。
その下では、支払額が0の時、0を返しているようです。
次に、mappingの値を更新しています。
9 AddressUpgradableライブラリについて
次に、下の部分を見てみましょう。
「AddressUpgradable」ライブラリの「sendValue」関数を使っているようです。
「AddressUpgradable.sol」の中にライブラリがあることが確認できました。
「sendValue」関数がこちらにあります。
残高を確認したのち、call関数で送っているようです。
なお、call関数が関連する、「fallback」関数については、こちらをご参照ください。
10 PaymentReleasedイベントについて
最後に、「PaymentReleased」というイベントを発火しています。
イベントはこちらにありました。
今回は、以上です。
thirdwebのコードを確認することで、いい勉強になるのではと思っています。
よかったらやってみてください。
サポートをしていただけたらすごく嬉しいです😄 いただけたサポートを励みに、これからもコツコツ頑張っていきます😊