本文へ移動
← 全コースを見る
Solana トピック

Token-2022 の transfer hook

先に実測を 2 つ。本物の Token-2022 を通すと、何もしない hook を呼ぶ mint の送金は、hook のプログラムを Anchor で書けば 12,352 CU、Pinocchio で書けば 8,169 CU です(psyto/pinocchio-bench、W7)。そして Kamino の TSLAx のリザーブ(mainnet の状態とバイナリを LiteSVM で、psyto/issuer-drill)では、発行体が hook のプログラムを設定すると、Kamino は TSLAx の預け入れ、引き出しと償還、TSLAx の借入の返済、TSLAx を担保にしたローンの清算を拒みました(UnsupportedTokenExtension)。USDC の返済と USDC の貸し出しは動いたままでした。

transfer hook の拡張を持つ Token-2022 の mint は、1 つのプログラムを指定します。送金のたびに Token-2022 は CPI でそのプログラムの Execute 命令を呼び、hook がエラーを返せば送金は失敗します。KYC のような確認を通っていないウォレットへの送金を、トークンが拒めるのはこのためです。

hook は、送金が運ぶ以上のアカウント(たとえば各ウォレットの KYC の記録)を必要とすることが多いです。それらは hook のプログラムの下、PDA ["extra-account-metas", mint] にあるアカウントに並べます。クライアントがその一覧からアカウントを求めて送金(TransferChecked)に付け、Token-2022 は一覧と照らしてから hook に渡します。項目は、たとえば固定のアドレスや、seed にほかのアカウントから読んだバイト(送り元のトークン口座の owner など)を含む PDA にできます。

mint の hook の権限者は、mint が使う hook のプログラムを差し替えたり、hook を外したりできます。トークンを持つ人や受け取る側はこの権限者に依存するので、発行体のほかの権限と並べて読む価値があります。

API の早見表

Execute: sha256("spl-transfer-hook-interface:execute")[..8] = [105, 37, 101, 197, 75, 251, 102, 26]
Token-2022 が送る 8 バイトの識別子で、その後に送金額がリトルエンディアンの u64 で続きます。
accounts: [0] source token account, [1] mint, [2] destination token account, [3] source authority, [4] extra-account-metas, then the listed extras
Execute がアカウントを受け取る順番です。princeps-solana の hook は、各ウォレットの KYC の記録を追加のアカウントとして並べ、0 番と 2 番の owner から導きます。
InitializeExtraAccountMetaList: sha256("spl-transfer-hook-interface:initialize-extra-account-metas")[..8]
mint の extra-account-metas のアカウントを作ります。princeps-solana では mint の権限者だけが実行できます。
ExtraAccountMetaList: [8-byte Execute discriminator][u32 length][u32 count][35-byte ExtraAccountMeta]…
Token-2022 が読むバイトの並びです。Execute の識別子をキーにした TLV の項目が、35 バイトの項目の PodSlice を包みます。各項目は 1 つのアカウントを表し、たとえば固定のアドレスや、seed の設定(固定のバイトや、ほかのアカウントのデータから読むバイトなど)で表す PDA です。

psyto/princeps-solana の f316295(2026-11-06)で確認: programs/psol-compliance/src/lib.rs

関連する部品

このトピックのレッスン