永久的な委任者

永続デリゲートとは?

Token Extensions Programの*rsPermanentDelegate*ミント拡張機能は、ミント自体にデリゲート権限を割り当てます。

永続デリゲートは、そのミントの任意のtoken accountに対して転送と焼却を承認できるミントレベルの権限です。これはミントのすべてのtoken accountに対するグローバルデリゲートとして機能し、token accountの所有者は自分のtoken accountから永続デリゲートを取り消すことはできません。

ミント権限は、*rsAuthorityType::PermanentDelegateを使用して、後でrsSetAuthority*で永続デリゲートをローテーションすることもできます。

永続デリゲートの作成と使用方法

永続デリゲートを作成して使用するには:

  1. ミントと*rsPermanentDelegate*拡張機能に必要なmint accountのサイズとrentを計算します。
  2. *rsCreateAccount*でmint accountを作成し、*rsPermanentDelegate*を初期化し、*rsInitializeMint*でミントを初期化します。
  3. 永続デリゲートによって署名された*rsTransferCheckedまたはrsBurnChecked*を送信します。Token Programは、token accountの所有者が署名した場合と同じ方法でこれらのinstructionsを処理します。

アカウントサイズの計算

ベースミントと*rsPermanentDelegate拡張機能のmint accountサイズを計算します。これはrsCreateAccount*で使用されるサイズです。

rentの計算

ミントと*rsPermanentDelegate*拡張機能に必要なサイズを使用してrentを計算します。

mint accountの作成

計算されたスペースとlamportを使用してmint accountを作成します。

PermanentDelegateの初期化

ミントに*rsPermanentDelegate*拡張機能を初期化します。

ミントの初期化

同じトランザクション内で*rsInitializeMint*を使用してミントを初期化します。

token accountの作成とトークンのミント

所有者と受取人のtoken accountを作成し、所有者のtoken accountにトークンをミントします。

permanent delegateによる転送

permanent delegateによって署名された*rsTransferChecked*を使用してトークンを転送します。

アカウントサイズの計算

ベースミントと*rsPermanentDelegate拡張機能のmint accountサイズを計算します。これはrsCreateAccount*で使用されるサイズです。

rentの計算

ミントと*rsPermanentDelegate*拡張機能に必要なサイズを使用してrentを計算します。

mint accountの作成

計算されたスペースとlamportを使用してmint accountを作成します。

PermanentDelegateの初期化

ミントに*rsPermanentDelegate*拡張機能を初期化します。

ミントの初期化

同じトランザクション内で*rsInitializeMint*を使用してミントを初期化します。

token accountの作成とトークンのミント

所有者と受取人のtoken accountを作成し、所有者のtoken accountにトークンをミントします。

permanent delegateによる転送

permanent delegateによって署名された*rsTransferChecked*を使用してトークンを転送します。

Example
const client = await createClient()
.use(generatedPayer())
.use(
solanaRpc({
rpcUrl: "http://localhost:8899",
rpcSubscriptionsUrl: "ws://localhost:8900"
})
)
.use(rpcAirdrop())
.use(airdropPayer(lamports(1_000_000_000n)));
const mint = await generateKeyPairSigner();
const owner = await generateKeyPairSigner();
const delegate = await generateKeyPairSigner();
const recipient = await generateKeyPairSigner();
const permanentDelegateExtension = extension("PermanentDelegate", {
delegate: delegate.address
});
const mintSpace = BigInt(getMintSize([permanentDelegateExtension]));

命令の順序

_rsInitializePermanentDelegate_は_rsInitializeMint_よりも前に実行される必要があります。 CreateAccountInitializePermanentDelegate、および_rsInitializeMint_は同じトランザクションに含める必要があります。

ソースリファレンス

項目説明ソース
PermanentDelegateミントのすべてのtoken accountに対して権限を持つデリゲートを保存するミント拡張機能。ソース
InitializePermanentDelegate*rsInitializeMint*の前にpermanent delegateを初期化する命令。ソース
SetAuthorityデリゲートをローテーションするために*rsAuthorityType::PermanentDelegate*と共に使用される基本トークン命令。ソース
AuthorityType::PermanentDelegateミント上のpermanent delegateをローテーションするために*rsSetAuthority*と共に使用される権限識別子。ソース
process_initialize_permanent_delegatepermanent delegate拡張機能をミントに書き込むプロセッサロジック。ソース
process_set_authority*rsAuthorityType::PermanentDelegate*が使用された際にpermanent delegateを検証およびローテーションするプロセッサロジック。ソース

Typescript

以下のKitの例では、生成された命令を直接使用しています。@solana/web3.js@solana/spl-tokenを使用したレガシーな例も参考として含まれています。

Kit

Instructions
import {
lamports,
createClient,
generateKeyPairSigner,
unwrapOption
} from "@solana/kit";
import { solanaRpc, rpcAirdrop } from "@solana/kit-plugin-rpc";
import { generatedPayer, airdropPayer } from "@solana/kit-plugin-signer";
import { getCreateAccountInstruction } from "@solana-program/system";
import {
extension,
fetchMint,
fetchToken,
findAssociatedTokenPda,
getCreateAssociatedTokenInstructionAsync,
getInitializeMintInstruction,
getInitializePermanentDelegateInstruction,
getMintSize,
getMintToCheckedInstruction,
getTransferCheckedInstruction,
isExtension,
TOKEN_2022_PROGRAM_ADDRESS
} from "@solana-program/token-2022";
const client = await createClient()
.use(generatedPayer())
.use(
solanaRpc({
rpcUrl: "http://localhost:8899",
rpcSubscriptionsUrl: "ws://localhost:8900"
})
)
.use(rpcAirdrop())
.use(airdropPayer(lamports(1_000_000_000n)));
const mint = await generateKeyPairSigner();
const owner = await generateKeyPairSigner();
const delegate = await generateKeyPairSigner();
const recipient = await generateKeyPairSigner();
const permanentDelegateExtension = extension("PermanentDelegate", {
delegate: delegate.address
});
const mintSpace = BigInt(getMintSize([permanentDelegateExtension]));
const mintRent = await client.rpc
.getMinimumBalanceForRentExemption(mintSpace)
.send();
await client.sendTransaction([
getCreateAccountInstruction({
payer: client.payer, // Account funding the new mint account.
newAccount: mint, // New mint account to create.
lamports: mintRent, // Lamports funding the mint account rent.
space: mintSpace, // Account size in bytes for the mint plus PermanentDelegate.
programAddress: TOKEN_2022_PROGRAM_ADDRESS // Program that owns the mint account.
}),
getInitializePermanentDelegateInstruction({
mint: mint.address, // Mint account that stores the PermanentDelegate extension.
delegate: delegate.address // Permanent delegate authorized for all token accounts for the mint.
}),
getInitializeMintInstruction({
mint: mint.address, // Mint account to initialize.
decimals: 0, // Number of decimals for the token.
mintAuthority: client.payer.address, // Authority allowed to mint new tokens.
freezeAuthority: client.payer.address // Authority allowed to freeze token accounts.
})
]);
const [sourceToken] = await findAssociatedTokenPda({
mint: mint.address,
owner: owner.address,
tokenProgram: TOKEN_2022_PROGRAM_ADDRESS
});
const [destinationToken] = await findAssociatedTokenPda({
mint: mint.address,
owner: recipient.address,
tokenProgram: TOKEN_2022_PROGRAM_ADDRESS
});
await client.sendTransaction([
await getCreateAssociatedTokenInstructionAsync({
payer: client.payer, // Account funding the associated token account creation.
mint: mint.address, // Mint for the associated token account.
owner: owner.address // Owner of the source token account.
}),
await getCreateAssociatedTokenInstructionAsync({
payer: client.payer, // Account funding the associated token account creation.
mint: mint.address, // Mint for the associated token account.
owner: recipient.address // Owner of the destination token account.
}),
getMintToCheckedInstruction({
mint: mint.address, // Mint account that issues the tokens.
token: sourceToken, // Token account receiving the newly minted tokens.
mintAuthority: client.payer, // Signer authorized to mint new tokens.
amount: 1n, // Token amount in base units.
decimals: 0 // Decimals defined on the mint.
})
]);
await client.sendTransaction([
getTransferCheckedInstruction({
source: sourceToken, // Token account sending the transfer.
mint: mint.address, // Mint with the permanent delegate configuration.
destination: destinationToken, // Token account receiving the transfer.
authority: delegate, // Permanent delegate signing the transfer.
amount: 1n, // Token amount in base units.
decimals: 0 // Decimals defined on the mint.
})
]);
const destinationAccount = await fetchToken(client.rpc, destinationToken);
const mintAccount = await fetchMint(client.rpc, mint.address);
const permanentDelegate = (
unwrapOption(mintAccount.data.extensions) ?? []
).find((item) => isExtension("PermanentDelegate", item));
console.log("Mint Address:", mint.address);
console.log("Destination Amount:", destinationAccount.data.amount);
console.log("Permanent Delegate Extension:", permanentDelegate);
Console
Click to execute the code.

Web3.js

Instructions
import {
Connection,
Keypair,
sendAndConfirmTransaction,
SystemProgram,
Transaction,
LAMPORTS_PER_SOL
} from "@solana/web3.js";
import {
ASSOCIATED_TOKEN_PROGRAM_ID,
createAssociatedTokenAccountInstruction,
createInitializeMintInstruction,
createInitializePermanentDelegateInstruction,
createMintToCheckedInstruction,
createTransferCheckedInstruction,
ExtensionType,
getAccount,
getAssociatedTokenAddressSync,
getMint,
getMintLen,
getPermanentDelegate,
TOKEN_2022_PROGRAM_ID
} from "@solana/spl-token";
const connection = new Connection("http://localhost:8899", "confirmed");
const latestBlockhash = await connection.getLatestBlockhash();
const feePayer = Keypair.generate();
const owner = Keypair.generate();
const delegate = Keypair.generate();
const recipient = Keypair.generate();
const airdropSignature = await connection.requestAirdrop(
feePayer.publicKey,
5 * LAMPORTS_PER_SOL
);
await connection.confirmTransaction({
blockhash: latestBlockhash.blockhash,
lastValidBlockHeight: latestBlockhash.lastValidBlockHeight,
signature: airdropSignature
});
const extensions = [ExtensionType.PermanentDelegate];
const mint = Keypair.generate();
const mintLength = getMintLen(extensions);
const mintRent = await connection.getMinimumBalanceForRentExemption(mintLength);
const sourceToken = getAssociatedTokenAddressSync(
mint.publicKey,
owner.publicKey,
false,
TOKEN_2022_PROGRAM_ID,
ASSOCIATED_TOKEN_PROGRAM_ID
);
const destinationToken = getAssociatedTokenAddressSync(
mint.publicKey,
recipient.publicKey,
false,
TOKEN_2022_PROGRAM_ID,
ASSOCIATED_TOKEN_PROGRAM_ID
);
const createMintAccountInstruction = SystemProgram.createAccount({
fromPubkey: feePayer.publicKey, // Account funding the new mint account.
newAccountPubkey: mint.publicKey, // New mint account to create.
space: mintLength, // Account size in bytes for the mint plus PermanentDelegate.
lamports: mintRent, // Lamports funding the mint account rent.
programId: TOKEN_2022_PROGRAM_ID // Program that owns the mint account.
});
const initializePermanentDelegateInstruction =
createInitializePermanentDelegateInstruction(
mint.publicKey, // Mint account that stores the PermanentDelegate extension.
delegate.publicKey, // Permanent delegate authorized for all token accounts for the mint.
TOKEN_2022_PROGRAM_ID // Token program that owns the mint.
);
const initializeMintInstruction = createInitializeMintInstruction(
mint.publicKey, // Mint account to initialize.
0, // Number of decimals for the token.
feePayer.publicKey, // Authority allowed to mint new tokens.
feePayer.publicKey, // Authority allowed to freeze token accounts.
TOKEN_2022_PROGRAM_ID // Program that owns the mint account.
);
await sendAndConfirmTransaction(
connection,
new Transaction().add(
createMintAccountInstruction,
initializePermanentDelegateInstruction,
initializeMintInstruction
),
[feePayer, mint],
{
commitment: "confirmed"
}
);
await sendAndConfirmTransaction(
connection,
new Transaction().add(
createAssociatedTokenAccountInstruction(
feePayer.publicKey, // Account funding the associated token account creation.
sourceToken, // Associated token account address to create.
owner.publicKey, // Owner of the source token account.
mint.publicKey, // Mint for the associated token account.
TOKEN_2022_PROGRAM_ID, // Token program that owns the token account.
ASSOCIATED_TOKEN_PROGRAM_ID // Associated Token Program that creates the account.
),
createAssociatedTokenAccountInstruction(
feePayer.publicKey, // Account funding the associated token account creation.
destinationToken, // Associated token account address to create.
recipient.publicKey, // Owner of the destination token account.
mint.publicKey, // Mint for the associated token account.
TOKEN_2022_PROGRAM_ID, // Token program that owns the token account.
ASSOCIATED_TOKEN_PROGRAM_ID // Associated Token Program that creates the account.
),
createMintToCheckedInstruction(
mint.publicKey, // Mint account that issues the tokens.
sourceToken, // Token account receiving the newly minted tokens.
feePayer.publicKey, // Signer authorized to mint new tokens.
1, // Token amount in base units.
0, // Decimals defined on the mint.
[], // Additional multisig signers.
TOKEN_2022_PROGRAM_ID // Token program that owns the mint and token account.
)
),
[feePayer],
{
commitment: "confirmed"
}
);
await sendAndConfirmTransaction(
connection,
new Transaction().add(
createTransferCheckedInstruction(
sourceToken, // Token account sending the transfer.
mint.publicKey, // Mint with the permanent delegate configuration.
destinationToken, // Token account receiving the transfer.
delegate.publicKey, // Permanent delegate signing the transfer.
1, // Token amount in base units.
0, // Decimals defined on the mint.
[], // Additional multisig signers.
TOKEN_2022_PROGRAM_ID // Token program that processes the transfer.
)
),
[feePayer, delegate],
{
commitment: "confirmed"
}
);
const destinationAccount = await getAccount(
connection,
destinationToken,
"confirmed",
TOKEN_2022_PROGRAM_ID
);
const mintAccount = await getMint(
connection,
mint.publicKey,
"confirmed",
TOKEN_2022_PROGRAM_ID
);
const permanentDelegate = getPermanentDelegate(mintAccount);
console.log("Mint Address:", mint.publicKey.toBase58());
console.log("Destination Amount:", destinationAccount.amount.toString());
console.log("Permanent Delegate Extension:", permanentDelegate);
Console
Click to execute the code.

Rust

Rust
use anyhow::Result;
use solana_client::nonblocking::rpc_client::RpcClient;
use solana_commitment_config::CommitmentConfig;
use solana_sdk::{
signature::{Keypair, Signer},
transaction::Transaction,
};
use solana_system_interface::instruction::create_account;
use spl_associated_token_account_interface::{
address::get_associated_token_address_with_program_id,
instruction::create_associated_token_account,
};
use spl_token_2022_interface::{
extension::{
permanent_delegate::PermanentDelegate, BaseStateWithExtensions, ExtensionType,
StateWithExtensions,
},
instruction::{
initialize_mint, initialize_permanent_delegate, mint_to_checked, transfer_checked,
},
state::{Account, Mint},
ID as TOKEN_2022_PROGRAM_ID,
};
#[tokio::main]
async fn main() -> Result<()> {
let client = RpcClient::new_with_commitment(
String::from("http://localhost:8899"),
CommitmentConfig::confirmed(),
);
let fee_payer = Keypair::new();
let owner = Keypair::new();
let delegate = Keypair::new();
let recipient = Keypair::new();
let airdrop_signature = client
.request_airdrop(&fee_payer.pubkey(), 5_000_000_000)
.await?;
loop {
let confirmed = client.confirm_transaction(&airdrop_signature).await?;
if confirmed {
break;
}
}
let mint = Keypair::new();
let mint_space =
ExtensionType::try_calculate_account_len::<Mint>(&[ExtensionType::PermanentDelegate])?;
let mint_rent = client
.get_minimum_balance_for_rent_exemption(mint_space)
.await?;
let create_mint_account_instruction = create_account(
&fee_payer.pubkey(), // Account funding the new mint account.
&mint.pubkey(), // New mint account to create.
mint_rent, // Lamports funding the mint account rent.
mint_space as u64, // Account size in bytes for the mint plus PermanentDelegate.
&TOKEN_2022_PROGRAM_ID, // Program that owns the mint account.
);
let initialize_permanent_delegate_ix = initialize_permanent_delegate(
&TOKEN_2022_PROGRAM_ID, // Token program that owns the mint.
&mint.pubkey(), // Mint account that stores the PermanentDelegate extension.
&delegate.pubkey(), // Permanent delegate authorized for all token accounts for the mint.
)?;
let initialize_mint_instruction = initialize_mint(
&TOKEN_2022_PROGRAM_ID, // Program that owns the mint account.
&mint.pubkey(), // Mint account to initialize.
&fee_payer.pubkey(), // Authority allowed to mint new tokens.
Some(&fee_payer.pubkey()), // Authority allowed to freeze token accounts.
0, // Number of decimals for the token.
)?;
let create_mint_transaction = Transaction::new_signed_with_payer(
&[
create_mint_account_instruction,
initialize_permanent_delegate_ix,
initialize_mint_instruction,
],
Some(&fee_payer.pubkey()),
&[&fee_payer, &mint],
client.get_latest_blockhash().await?,
);
client
.send_and_confirm_transaction(&create_mint_transaction)
.await?;
let source_token = get_associated_token_address_with_program_id(
&owner.pubkey(),
&mint.pubkey(),
&TOKEN_2022_PROGRAM_ID,
);
let destination_token = get_associated_token_address_with_program_id(
&recipient.pubkey(),
&mint.pubkey(),
&TOKEN_2022_PROGRAM_ID,
);
let create_token_accounts_transaction = Transaction::new_signed_with_payer(
&[
create_associated_token_account(
&fee_payer.pubkey(), // Account funding the associated token account creation.
&owner.pubkey(), // Owner of the source token account.
&mint.pubkey(), // Mint for the associated token account.
&TOKEN_2022_PROGRAM_ID, // Token program that owns the token account.
),
create_associated_token_account(
&fee_payer.pubkey(), // Account funding the associated token account creation.
&recipient.pubkey(), // Owner of the destination token account.
&mint.pubkey(), // Mint for the associated token account.
&TOKEN_2022_PROGRAM_ID, // Token program that owns the token account.
),
mint_to_checked(
&TOKEN_2022_PROGRAM_ID, // Token program that owns the mint and token account.
&mint.pubkey(), // Mint account that issues the tokens.
&source_token, // Token account receiving the newly minted tokens.
&fee_payer.pubkey(), // Signer authorized to mint new tokens.
&[&fee_payer.pubkey()], // Additional multisig signers.
1, // Token amount in base units.
0, // Decimals defined on the mint.
)?,
],
Some(&fee_payer.pubkey()),
&[&fee_payer],
client.get_latest_blockhash().await?,
);
client
.send_and_confirm_transaction(&create_token_accounts_transaction)
.await?;
let transfer_transaction = Transaction::new_signed_with_payer(
&[
transfer_checked(
&TOKEN_2022_PROGRAM_ID, // Token program that processes the transfer.
&source_token, // Token account sending the transfer.
&mint.pubkey(), // Mint with the permanent delegate configuration.
&destination_token, // Token account receiving the transfer.
&delegate.pubkey(), // Permanent delegate signing the transfer.
&[&delegate.pubkey()], // Additional multisig signers.
1, // Token amount in base units.
0, // Decimals defined on the mint.
)?,
],
Some(&fee_payer.pubkey()),
&[&fee_payer, &delegate],
client.get_latest_blockhash().await?,
);
client
.send_and_confirm_transaction(&transfer_transaction)
.await?;
let destination_account = client.get_account(&destination_token).await?;
let destination_state =
StateWithExtensions::<Account>::unpack(&destination_account.data)?;
let mint_account = client.get_account(&mint.pubkey()).await?;
let mint_state = StateWithExtensions::<Mint>::unpack(&mint_account.data)?;
let permanent_delegate = mint_state.get_extension::<PermanentDelegate>()?;
println!("Mint Address: {}", mint.pubkey());
println!(
"Destination Amount: {}",
u64::from(destination_state.base.amount)
);
println!("Permanent Delegate Extension: {:?}", permanent_delegate);
Ok(())
}
Console
Click to execute the code.

Is this page helpful?

目次

ページを編集

管理運営

© 2026 Solana Foundation.
無断転載を禁じます。
つながろう