【完全保存版】初めてのTransfer Hook(Solana)
０ はじめに
本日は、SolanaのTransfer Hookを扱っていきます。
トークンの送付時に、別の処理を行うことで、今回は、簡単なメッセージを表示します。
とはいえ、いきなり全てを理解するのは大変なので、この記事ではどのような処理を行っているのかの流れを掴んでいきたいと思います。
１ 処理の実行
まずは、こちらのリンクから処理を行ってみましょう。
１ テストトークンの取得
初めて行う場合は、こちらの第２章第１節までを元に、テストトークンを取得してください。
２ デプロイの実行
では、プログラムをデプロイしてみましょう。
「Build」を実行します。
その後、「Deploy」を行います。
このようになれば成功です。
３ テストの実行
こちらのボタンを押すと、テストができます。
下のようになれば成功です。
今回は、ここで行ったテストが、何をやっていたのかの概要を、以下で見ていきます。
２ TransferHook付きのミントアカウントの作成
ここでは、TransferHook付きのミントアカウントを作ります。
１ アカウントの作成
まずは、「createAccount」で通常のミントアカウントを作ります。
２ TransferHookプログラムの結び付け
まず、事前に「TransferHook」プログラムを準備します。
「createInitializeTransferHookInstruction」を使用し、このプログラムをミントに結びつけます。
３ 基礎情報の設定
最後に、「createInitializeMintInstruction」を使い、基本的な情報を設定します。
小数点以下の桁数やミント権限のあるウォレットの指定などを行います。
３ 送付元・送付先の作成
１ 送付元トークンアカウントの作成
ミントアカウントのトークンを取得するには、そのためのトークンアカウントが必要です。
「createAssociatedTokenAccountInstruction」を使い、自身のトークンアカウントを作成します。
２ 送付先トークンアカウントの作成
同様にして、送付先のトークンアカウントを作成します。
３ 送付元トークンアカウントへのミント
最後に、送付元トークンアカウントに「createMintToInstruction」で100トークンをミントします。
これにより、送る準備ができました。
４ ExtraAcountMetaListの初期化
ここでは、まず、何をやりたいのかを考えましょう。
１ 概要
例えば今回、送付時に、その一部を手数料として、別のアカウントに送りたいとします。
そのように、「送付処理」に直接関係がないアカウントが出てくることがあり、そのアカウントを保管する必要があります。
それを保管するために作るのが、「ExtraAccountMetaList」です。
２ PDAの導出
では、作っていきましょう。
まずは、「Mintアカウント」と「extra-account-metas」という文字からPDAを導きます。
今回作成した、「transfer_hook」というプログラムから派生したPDA（プログラム派生アドレス）です。
この時点では、アドレスを見つけただけで、アカウントが作成されていません。
３ アカウントの初期化
今回作成した、「transfer_hook」内の「initializeExtraAccountMetaList」を使って初期化します。
今回は、送付時にメッセージを表示するだけで、別のアカウントは必要ないので、今回はこのリストにアカウントは含まれません。
５ Transfer Hook付きの送付
１ 送付の実行
では、最後に、「createTransferCheckedWithTransferHookInstruction」を使って、Transfer Hook付きの送付を行います。
２ コードの確認（参考）
この辺りの処理は、コードを見た方が結局わかりやすいと思うので、見ていきたいと思います。
ポイントは、TransferHook用の何かを渡しているわけではなく、通常必要な情報のみを渡しています。
その上で、「createTransferCheckedInstruction」でInstructionを作成しています。
その上で、ミント情報から、「Transfer Hook」を取り出しています。
「Transfer Hook」が存在すれば、「addExtraAccountMetasForExecute」で追加していることがわかります。
このように、汎用的な仕組みをとっているのはとても良いと思いました。
３ fallback関数の実行
そして、この「createTransferCheckedWithTransferHook」が実行されるタイミングで、「fallback」関数が実行されます。
今回は中身まで見ないですが、ここで、「transfer_hook」という関数がよばれ、「Hello Transfer Hook!」が実行されることになります。
６ トランザクションを確認しよう
では、流れが理解できたので、トランザクションを確認してみましょう。
実際の送付は最後のみで行われていたので、こちらをSolscanで見てみましょう。
まずは、このように送付が行われたことが確認できました。
そして、こちらの「Program Logs」でメッセージが表示されていることが確認できます。
今回は以上です。
サポートをしていただけたらすごく嬉しいです😄 いただけたサポートを励みに、これからもコツコツ頑張っていきます😊