Solana Developer Hub Online #3 https://lu.ma/5gudil3t

1. 解説: Token Extensions
Solana Developer Hub #3

2. Kouta Ozaki / k-kinzal
Token 大好きおじさん

4. Token Programがパワーアップしました
何ができるようになったのか見てみましょう

5. その前に用語の確認
トークンはSolanaチェーン上に1つだけ存在して、トークンの供給量などを管理（Mint Token）
トークンアカウントは無数に存在し、ユーザーがどれだけのトークンを持っているか管理（Associated Token Account）
どちらもアカウントで紛らわしいので注意
(Mint)
Token
(Associated)
Token Account

6. Token Extensions概要

7. Mint Close Authority
Non-Transferable
Permanent Delegate
Metadata
Con
fi
dential Transfers
Required Memo on Transfer
Default Account State
Transfer Fees
Interest-Bearing
Transfer Hook
Metadata Pointer
Immutable Owner
CPI Guard
全13種類の機能がトークンプログラムに入った

8. トークンプログラムとアドレスは違う
Token Program: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
Token-2022 Program: TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb

9. それぞれの機能

10. Mint Close Authority

11. 作成したトークンを削除できるようになりました
これにより不要になったトークンのlamportsを取り返せるようになりました
※ 供給量が0のときのみ実行可能です
$ export TOKEN_PROGRAM_ADDRESS=TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
$ spl-token --program-id ${TOKEN_PROGRAM_ADDRESS} create-token --enable-close
TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
Address: 9FWmoGyri8sHurXXwb3rJdesBMr2zcS8PTMCjcPdzbca
Decimals: 9
Signature: xxx
$ spl-token close-mint 9FWmoGyri8sHurXXwb3rJdesBMr2zcS8PTMCjcPdzbca
Signature: xxx

12. TokenにClose Authorityが追加される

13. Transfer Fees

14. トークンの転送時にfeeを設定できるようになりました
これまでも擬似的に行えていた転送時のfeeを完全な形で実現できるようになりました
$ export TOKEN_PROGRAM_ADDRESS=TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
$ spl-token --program-id ${TOKEN_PROGRAM_ADDRESS} create-token --transfer-fee 50 5000
Creating token FobtB1Kudg5Z2rpKirfmiGG7KSNcKazVM4ahSLBTPPuQ under program
TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
Address: FobtB1Kudg5Z2rpKirfmiGG7KSNcKazVM4ahSLBTPPuQ
Decimals: 9
Signature: xxx
$ spl-token transfer --fund-recipient FobtB1Kudg5Z2rpKirfmiGG7KSNcKazVM4ahSLBTPPuQ 1000
5xRNLejHaQn3ZXfQ2VhZHbzyQ23ncuMjpaXWRWTmsVto
Transfer 1000 tokens
Sender: 379DLcxC9H5MJsoQYg5crtdgiUtfozkvgHDJ1eq5YEh4
Recipient: 5xRNLejHaQn3ZXfQ2VhZHbzyQ23ncuMjpaXWRWTmsVto
Recipient associated token account: HecKEnrdpvUTcXy4D9iJ8r59dNnH3d4EmhrWHUM8yQhs
Funding recipient: HecKEnrdpvUTcXy4D9iJ8r59dNnH3d4EmhrWHUM8yQhs
Signature: xxx

15. TokenにTransfer Fee Con
fi
gが追加される

16. feeは相手のトークンアカウントに保持される
引き出しは専用のインストラクションを持って行われる
$ spl-token withdraw-withheld-tokens 379DLcxC9H5MJsoQYg5crtdgiUtfozkvgHDJ1eq5YEh4
HecKEnrdpvUTcXy4D9iJ8r59dNnH3d4EmhrWHUM8yQhs
Signature: xxx

17. トークンアカウントで現在の徴収可能額が見れる

18. Non-Transferable

19. トークンの転送を禁止できるようになりました
魂に縛り付けられたトークンを作ることができます
※ Freezeとは違いBurnは可能
$ export TOKEN_PROGRAM_ADDRESS=TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
$ spl-token --program-id $TOKEN_PROGRAM_ADDRESS create-token --enable-non-transferable
Creating token EP1sVZhpb71hKe57AvBsfBTQDgNKTNj4VExHK5HUC2cp under program
TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
Address: EP1sVZhpb71hKe57AvBsfBTQDgNKTNj4VExHK5HUC2cp
Decimals: 9
Signature:xxx
$ spl-token transfer --fund-recipient EP1sVZhpb71hKe57AvBsfBTQDgNKTNj4VExHK5HUC2cp 50
5xRNLejHaQn3ZXfQ2VhZHbzyQ23ncuMjpaXWRWTmsVto
Transfer 50 tokens
Sender: GEwuHopL35dX9G97ba5gYT3A2qUgXRDmfV6Njh8xEKez
Recipient: 5xRNLejHaQn3ZXfQ2VhZHbzyQ23ncuMjpaXWRWTmsVto
Recipient associated token account: BvxtZSp5LfEx8GwkdihuHDYQYxmyiE2uA1fsmsRcSs6C
Funding recipient: BvxtZSp5LfEx8GwkdihuHDYQYxmyiE2uA1fsmsRcSs6C
...
"Program log: Transfer is disabled for this mint"

20. TokenにNon-Transferableが追加される

21. Ownerも転送できないので注意
mintのさいに割り当てるトークンアカウントアドレスを指定することでオーナー以外にも渡せる
ただし、相手もトークンアカウントを作っていないと渡せないので注意
InstructionのInitializeAccount2/InitializeAccount3を
使うことでオーナーから相手のトークンアカウントを作れそうに見れるが未検証

22. Interest-Bearing Tokens

23. トークンに金利を設定して金利付き金額を取得できるようになりました
利息はネットワークのタイムスタンプに基づいて複利計算されます
※ あくまでも見かけ上の金利であり実際にmintはされません
$ export TOKEN_PROGRAM_ADDRESS=TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
$ spl-token --program-id $TOKEN_PROGRAM_ADDRESS create-token --interest-rate 9999999
Creating token CLDEebMAouMF1TeC8k86xiM37V5VnVFPDHw8g96FTNtM under program
TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
Address: CLDEebMAouMF1TeC8k86xiM37V5VnVFPDHw8g96FTNtM
Decimals: 9
Signature: xxx

24. TokenにInterest-Bearingが追加される

25. Permanent Delegate

26. ミントしたトークンに関する操作を委譲できるようになりました
トークンアカウントに対して流出時の強制移動、焼却などを行えるようになりました
※ 委譲した許可の取り消し、別の人への委譲は委譲先のアカウントのみで可能
$ spl-token --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb create-token --enable-
permanent-delegate
Creating token 2RpBCMw9h9egDCEV9zxzzWj61ynF5E289VdvVTqSvTaQ under program
TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
Address: 2RpBCMw9h9egDCEV9zxzzWj61ynF5E289VdvVTqSvTaQ
Decimals: 9
Signature: xxxx
$ spl-token authorize 7KBJDzMKkQZ8ogWyQGEocLDzygvxxfqnzqnMupWbwTAh permanent-delegate
5xRNLejHaQn3ZXfQ2VhZHbzyQ23ncuMjpaXWRWTmsVto
Updating 7KBJDzMKkQZ8ogWyQGEocLDzygvxxfqnzqnMupWbwTAh
Current permanent-delegate: BdWx4rjtN23d4GcWzpKfxmnmVzN5jSdmETmgwwfCCf8m
New permanent-delegate: 5xRNLejHaQn3ZXfQ2VhZHbzyQ23ncuMjpaXWRWTmsVto
Signature: xxx

27. TokenにPermanent Delegateが追加される

28. Transfer Hook

29. トークンを操作したさいに特定のプログラムを呼び出せるようになりました
例えばNFTで移転するさいに発行者にロイヤリティを送付する、
DAOで承認があったときのみトークンの転送を許可するなどがやりやすくなります
$ spl-token --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb create-token
--transfer-hook 7N4HggYEJAtCLJdnHGCtFqfxcB5rhQCsQTze3ftYstVj
Creating token HFg1FFaj4PqFHmkYrqbZsarNJEZT436aXAXgQFMJihwc under program
TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
Address: HFg1FFaj4PqFHmkYrqbZsarNJEZT436aXAXgQFMJihwc
Decimals: 9
Signature: xxx

30. Instructions
• Execute
• InitializeExtraAccountMetaList
• UpdateExtraAccountMetaList
プログラムの作り方は通常のものと変わらないが、Instructionsが専用のものになる。
トークンが転送されたときのInstructionはExecuteになる。

31. 詳細はこちらを参照
https://github.com/solana-labs/solana-program-library/blob/master/token/transfer-hook/
interface/README.md

32. Metadata

33. トークン自体にメタデータを付与できるようになりました
基本情報としてトークン名、シンボル、URLを設定できるように
また、追加情報として独自の形式の保存も可能になりました
$ spl-token --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb create-token
--enable-metadata
Creating token 8rY8mBjDDmAvpVnFoJUPhaabR1ZDbG1Ur1rrUp6gEM1y under program
TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
To initialize metadata inside the mint, please run `spl-token initialize-metadata
8rY8mBjDDmAvpVnFoJUPhaabR1ZDbG1Ur1rrUp6gEM1y <YOUR_TOKEN_NAME> <YOUR_TOKEN_SYMBOL>
<YOUR_TOKEN_URI>`, and sign with the mint authority.
Address: 8rY8mBjDDmAvpVnFoJUPhaabR1ZDbG1Ur1rrUp6gEM1y
Decimals: 9
Signature: xxx

34. TokenにMetadataが追加される

35. Metadata Pointer

36. トークンにメタデータの参照を設定できるようになりました
トークン自体にメタデータを設定するのではなく
トークンから他のメタデータを参照するように設定することができるようになりました
$ spl-token --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb create-token --metadata-
address 8rY8mBjDDmAvpVnFoJUPhaabR1ZDbG1Ur1rrUp6gEM1y
Creating token B9HAH8qFdSCXYhBcYVGZENr3Lxdhg8VUYhbBgMnbLwAc under program
TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
Address: B9HAH8qFdSCXYhBcYVGZENr3Lxdhg8VUYhbBgMnbLwAc
Decimals: 9
Signature: xxx

37. TokenにMetadataが追加される

38. Con
fi
dential Transfers

39. まだ有効になっていない
ドキュメントやspl-tokenコマンドには反映されています
"Transaction simulation failed: Attempt to load a program that does not exist"
実行すると上記のようなエラーが出るのに注意

40. Immutable Owner

41. トークンアカウントのオーナーが変更不可になりました
Token-2022ではデフォルトで変更不可です
※ spl-tokenからは変更可にする方法はない
$ spl-token create-account GNj8ivcoD7yDp9ZTZUppJExhxDPqxPcjxruxGin4iE4o --immutable
Creating account DwRU3LeNkG9UJnoyqVxv2pyZBg6kZ8zokrFtE7QnQ1EN
Note: --immutable specified, but Token-2022 ATAs are always immutable, ignoring
Signature: xxx

42. TokenAccountにImmutable Ownerが追加される

43. Required Memo on Transfer

44. トークンの転送でメモの付与を必須にできるようになりました
メモを必須にしているトークンアカウントへの送付はメモをつけないと送れないようになります
付与するメモの内容の制限は特にありません
$ spl-token enable-required-transfer-memos FT2yDkBHtt4u5BfHXn5yS8nADHJPPfkbdY45Wy3z4E7n
Signature: xxx
$ spl-token transfer --fund-recipient Gk4Ho3f4voiHq6j3VDEWqKGZd6faoRhBPAKB95Jdv9pP 10
BdWx4rjtN23d4GcWzpKfxmnmVzN5jSdmETmgwwfCCf8m
Transfer 10 tokens
Sender: 6RqxfXeXshkTVUNw36FPRRFcTnRCQaWbW2Qp4qGbEvBD
Recipient: BdWx4rjtN23d4GcWzpKfxmnmVzN5jSdmETmgwwfCCf8m
Recipient associated token account: FT2yDkBHtt4u5BfHXn5yS8nADHJPPfkbdY45Wy3z4E7n
Error: "Error: Recipient expects a transfer memo, but none was provided. Provide a memo using `--
with-memo`."

45. TokenAccountにRequire Memo on Incoming Transfersが追加される

46. CPI Guard

47. トークンアカウントでCPIで特定の操作を禁止できるようになりました
有効にすると下記のCPIの操作を禁止します
• Transfer: the signing authority must be the account delegate
• Burn: the signing authority must be the account delegate
• Approve: prohibited
• Close Account: the lamport destination must be the account owner
• Set Close Authority: prohibited unless unsetting
• Set Owner: always prohibited, including outside CPI
$ spl-token enable-cpi-guard 379DLcxC9H5MJsoQYg5crtdgiUtfozkvgHDJ1eq5YEh4
Signature: 5QanSxurh1FRqUQ6L4J7vRRgYGov8FWyrmbf8o6x7KgzXmfHEjTApe3b9bmioWrpa7Ds1WD8BGiGHzhNpXCafr

48. Client Program
Other
Program
Instruction
Tx1 Tx2
Instruction
Tx3
×
ユーザーからはTx3が事前に見えないから危ない
Tx3でトークンに関わる操作を禁止するのがCPI Guard
※ CPI Guardで利便性と安全性のバランスがどうなるかはわかっていない

49. TokenAccountにCPI Guardが追加される

50. Default Account State

51. トークンアカウントを作成時のデフォルトの状態を指定できるようになりました
例えばトークンアカウントを作成したさいに必ず凍結しておきたい
というようなユースケースができるようになりました
※ spl-tokenコマンドではinitializedとfrozenの2つがサポート
$ spl-token --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb create-token
--enable-freeze --default-account-state frozen
Creating token 7EiVoHiFHmLTQ66TGpD48dEqBp8zJQXKpDL9iH9f1Hbu under program
TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
Address: 7EiVoHiFHmLTQ66TGpD48dEqBp8zJQXKpDL9iH9f1Hbu
Decimals: 9
Signature: xxx

52. 注意点

53. 組み合わせによっては意味がないものがある
例えばトークンの転送禁止と転送フックなど
容量が無駄に増えて手数料を取られるので組み合わせは注意しよう

54. まとめ

55. Token Extensions楽しい！

56. 参考資料
• https://spl.solana.com/token-2022/extensions
• https://solana.com/ja/developers/guides?tags=token+extensions&tags=token+2022
• https://www.youtube.com/playlist?list=PLilwLeBwGuK6imBuGLSLmzMEyj6yVHGDO
• https://www.youtube.com/watch?
v=CEuKahqOYbs&list=PLilwLeBwGuK7MVdX1GbZwUeALfNCXWH̲8

57. おわり