Token Metadata 是旧版程序。仍受支持,但不建议用于新项目。 请改用Core。
功能
Token Metadata 上的 SPL Token-2022
SPL Token-2022 是 Solana 区块链上最新的代币程序,可用于创建同质化和非同质化代币。它支持与 SPL Token 程序相同的功能和结构,但还包括一组扩展以添加新功能。
为了支持向 Token-2022 mint 账户添加元数据信息,一组 Token Metadata 指令已更新以允许指定所需的代币程序。例如,Token Metadata 可以初始化 Token-2022 mint,使用 Create 和 Mint 指令创建元数据并铸造代币,同时指定 SPL Token-2022 作为要使用的代币程序。
1import {
2 generateSigner,
3 percentAmount,
4 publicKey,
5} from '@metaplex-foundation/umi';
6import {
7 createV1,
8 TokenStandard,
9} from '@metaplex-foundation/mpl-token-metadata';
10
11// Assuming umi is set up
12
13const SPL_TOKEN_2022_PROGRAM_ID = publicKey(
14 'TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb'
15);
16
17const mint = generateSigner(umi);
18
19// Create NFT with Token-2022 program
20await createV1(umi, {
21 mint,
22 authority,
23 name: 'My NFT',
24 uri: 'https://example.com/my-nft.json',
25 sellerFeeBasisPoints: percentAmount(5.5),
26 splTokenProgram: SPL_TOKEN_2022_PROGRAM_ID,
27 tokenStandard: TokenStandard.NonFungible,
28}).sendAndConfirm(umi);
29
30console.log('NFT created with Token-2022:', mint.publicKey);
1import { generateKeyPairSigner } from '@solana/kit';
2import {
3 getCreateV1InstructionAsync,
4 TokenStandard,
5 SPL_TOKEN_2022_PROGRAM_ADDRESS,
6} from '@metaplex-foundation/mpl-token-metadata-kit';
7
8// Assuming rpc, rpcSubscriptions, sendAndConfirm, and authority are set up
9
10const mint = await generateKeyPairSigner();
11
12// Create NFT with Token-2022 program
13const createIx = await getCreateV1InstructionAsync({
14 mint,
15 authority,
16 payer: authority,
17 name: 'My NFT',
18 uri: 'https://example.com/my-nft.json',
19 sellerFeeBasisPoints: 550, // 5.5%
20 splTokenProgram: SPL_TOKEN_2022_PROGRAM_ADDRESS,
21 tokenStandard: TokenStandard.NonFungible,
22});
23
24await sendAndConfirm({
25 instructions: [createIx],
26 payer: authority,
27});
28
29console.log('NFT created with Token-2022:', mint.address);
1use mpl_token_metadata::{
2 instructions::CreateV1Builder,
3 types::{PrintSupply, TokenStandard},
4};
5use solana_rpc_client::rpc_client::RpcClient;
6use solana_sdk::{
7 message::Message,
8 transaction::Transaction,
9};
10
11// 1. client is a reference to the initialized RpcClient
12// 2. every account is specified by their pubkey
13
14let client = ...;
15
16let create_ix = CreateV1Builder::new()
17 .metadata(metadata)
18 .master_edition(Some(master_edition))
19 .mint(mint.pubkey(), true)
20 .authority(payer.pubkey())
21 .payer(payer.pubkey())
22 .update_authority(payer.pubkey(), false)
23 .spl_token_program(spl_token_2022::id())
24 .name(String::from("My NFT"))
25 .uri(uri)
26 .seller_fee_basis_points(550)
27 .token_standard(TokenStandard::NonFungible)
28 .print_supply(PrintSupply::Zero)
29 .instruction();
30
31let message = Message::new(
32 &[create_ix],
33 Some(&payer.pubkey()),
34);
35
36let blockhash = client.get_latest_blockhash()?;
37let mut tx = Transaction::new(&[mint, payer], message, blockhash);
38client.send_and_confirm_transaction(&tx)?;
1import { publicKey } from '@metaplex-foundation/umi';
2import { mintV1, TokenStandard } from '@metaplex-foundation/mpl-token-metadata';
3import { findAssociatedTokenPda } from '@metaplex-foundation/mpl-toolbox';
4
5// Assuming umi is set up and mint was created with Token-2022
6
7const SPL_TOKEN_2022_PROGRAM_ID = publicKey(
8 'TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb'
9);
10
11// Derive the associated token account for Token-2022
12const token = findAssociatedTokenPda(umi, {
13 mint: mint.publicKey,
14 owner: umi.identity.publicKey,
15 tokenProgramId: SPL_TOKEN_2022_PROGRAM_ID,
16});
17
18// Mint the token using Token-2022
19await mintV1(umi, {
20 mint: mint.publicKey,
21 token,
22 authority,
23 amount: 1,
24 tokenOwner: umi.identity.publicKey,
25 splTokenProgram: SPL_TOKEN_2022_PROGRAM_ID,
26 tokenStandard: TokenStandard.NonFungible,
27}).sendAndConfirm(umi);
28
29console.log('Token minted with Token-2022');
1import {
2 getMintV1InstructionAsync,
3 findMetadataPda,
4 findAssociatedTokenPda,
5 TokenStandard,
6 SPL_TOKEN_2022_PROGRAM_ADDRESS,
7} from '@metaplex-foundation/mpl-token-metadata-kit';
8
9// Assuming rpc, rpcSubscriptions, sendAndConfirm, authority, and mint are set up
10// mint is the NFT created with Token-2022
11
12const mintAddress = mint.address;
13
14// Derive the associated token account for Token-2022
15const [tokenAddress] = await findAssociatedTokenPda({
16 mint: mintAddress,
17 owner: authority.address,
18 tokenProgram: SPL_TOKEN_2022_PROGRAM_ADDRESS,
19});
20
21// Mint the token using Token-2022
22const [metadataAddress] = await findMetadataPda({ mint: mintAddress });
23
24const mintIx = await getMintV1InstructionAsync({
25 mint: mintAddress,
26 token: tokenAddress,
27 authority,
28 payer: authority,
29 metadata: metadataAddress,
30 amount: 1,
31 tokenOwner: authority.address,
32 splTokenProgram: SPL_TOKEN_2022_PROGRAM_ADDRESS,
33 tokenStandard: TokenStandard.NonFungible,
34});
35
36await sendAndConfirm({
37 instructions: [mintIx],
38 payer: authority,
39});
40
41console.log('Token minted with Token-2022:', tokenAddress);
1use mpl_token_metadata::instructions::MintV1Builder;
2use solana_rpc_client::rpc_client::RpcClient;
3use solana_sdk::{
4 message::Message,
5 transaction::Transaction,
6};
7
8// 1. client is a reference to the initialized RpcClient
9// 2. every account is specified by their pubkey
10
11let client = ...;
12
13let mint_ix = MintV1Builder::new()
14 .token(token)
15 .token_owner(Some(token_owner))
16 .metadata(metadata)
17 .master_edition(Some(master_edition))
18 .mint(mint)
19 .authority(update_authority)
20 .payer(payer)
21 .spl_token_program(spl_token_2022::id())
22 .amount(1)
23 .instruction();
24
25let message = Message::new(
26 &[mint_ix],
27 Some(&payer.pubkey()),
28);
29
30let blockhash = client.get_latest_blockhash()?;
31let mut tx = Transaction::new(&[update_authority, payer], message, blockhash);
32client.send_and_confirm_transaction(&tx)?;
可以通过检查账户的 owner 属性来确定 mint 账户的代币程序。
类似的方法可用于其他指令,例如 Burn、Delegate、Lock、Print、Revoke、Transfer、Unlock、Unverify、Update 和 Verify。这些指令可以验证来自 SPL Token-2022 的 mint 和 token 账户。在任何需要代币程序的指令(例如 Delegate)中必须使用相应的代币程序:如果 mint 和 token 账户来自 Token-2022,那么 Delegate 指令将验证是否指定了正确的代币程序。
默认情况下,如果 mint 和 token 账户不存在,Create 和 Mint 将创建 SPL Token mint 和 token 账户。要使用 Token-2022 账户,您需要指定 SPL Token-2022 作为要使用的代币程序。
支持的扩展
虽然 Token-2022 提供了多个扩展,但大多数扩展专注于同质化代币。例如,confidential transfer 可用于隐藏转移的代币数量。虽然这与同质化代币相关,因为金额在不同转移之间可能变化,但它不适用于非同质化代币,因为它们的供应量始终为 1,小数位始终为 0。因此,非同质化代币的转移金额始终为 1。
Token Metadata 根据 Token Standard 对 mint 和 token 账户上可以存在的扩展类型强制执行限制。对于同质化资产(Fungible 和 FungibleAsset 标准),不设置限制 - 唯一的限制是提供元数据信息的程序。对于非同质化资产(NonFungible 和 ProgrammableNonFungible 标准),Token Metadata 验证启用了哪些扩展并限制可以使用的扩展集。
Mint 账户扩展
这些是可以在 SPL Token-2022 的 mint 账户上启用的扩展。
confidential transfers:在转移期间隐藏金额。资产 同质化 非同质化 允许 ✅ ❌ 详情 -- 不适用,因为非同质化代币的供应量为 1
transfer fees:允许配置从转移金额中派生的转移费用。资产 同质化 非同质化 允许 ✅ ❌ 详情 -- 不适用,因为非同质化代币的供应量为 1
closing mint:当供应量达到0时允许关闭 mint 账户。
| 资产 | 同质化 | 非同质化 |
|---|---|---|
| 允许 | ✅ | ❌ |
| 详情 | 必须将 Metadata 账户指定为关闭权限 | 创作者可能重新创建相同的 mint 和 metadata 账户组 |
interest-bearing tokens:允许更改代币 UI 金额的显示方式。资产 同质化 非同质化 允许 ✅ ❌ 详情 -- 不适用,因为非同质化代币的供应量为 1
non-transferable tokens:允许"灵魂绑定"代币,无法转移到任何其他地址。资产 同质化 非同质化 允许 ✅ ✅ 详情 -- --
permanent delegate:允许为 mint 的任何 token 账户指定永久账户委托。资产 同质化 非同质化 允许 ✅ ❌ 详情 -- 这改变了所有权的概念
transfer hook:允许在转移期间调用第三方程序。资产 同质化 非同质化 允许 ✅ ❌ 详情 -- Token Metadata 指定转移的逻辑
metadata pointer:允许添加描述规范元数据的地址。资产 同质化 非同质化 允许 ✅ ✅ 详情 必须指向 Metadata地址必须指向 Metadata地址
metadata:允许直接向 mint 账户添加元数据。资产 同质化 非同质化 允许 ❌ ❌ 详情 元数据信息由 Token Metadata 添加 元数据信息由 Token Metadata 添加
Token 账户扩展
这些是可以在 SPL Token-2022 的 token 账户上启用的扩展。
memo required:转移时需要备注。资产 同质化 非同质化 允许 ✅ ❌ 详情 -- 不适用
immutable ownership:禁用更改 token 账户所有权的能力。资产 同质化 非同质化 允许 ✅ ✅ 详情 -- --
default account state:允许配置默认的 token 账户状态。资产 同质化 非同质化 允许 ✅ ❌ 详情 -- Token Metadata 验证账户状态
CPI guard:防止跨程序调用内的某些操作(例如转移)。资产 同质化 非同质化 允许 ✅ ❌ 详情 -- Token Metadata 指定转移的逻辑
每个扩展的全面概述可以在 SPL Token-2022 程序文档中找到。
默认扩展
当 mint 账户不存在时,Create 指令将初始化一个。如果使用的代币程序是 SPL Token-2022,mint 将使用 closing mint 和 metadata pointer 扩展进行初始化。
关联代币账户 (ATAs) 默认始终使用 immutable ownership 扩展进行初始化。
