トークンアカウントのフリーズの効果
トークンアカウントをフリーズすると、所有者、ミント、残高は同じままですが、トークンアカウントが解凍されるまで、トークンの転送やバーンができなくなります。
フリーズされたアカウントは、トークン残高がゼロの場合、クローズすることができます。
フリーズ権限を持つミントのみが、トークンアカウントをフリーズできます。ミントのフリーズ権限が取り消された場合、そのミントのアカウントはフリーズできなくなります。
トークンアカウントのフリーズ方法
トークンアカウントのフリーズには、Token Programの FreezeAccount
命令を使用します。
FreezeAccount
命令は、トークンアカウントがミントに属していること、署名者がミントのフリーズ権限であることを検証し、トークンアカウントの状態を初期化済みからフリーズ済みに変更します。
ネイティブトークンアカウントは、フリーズをサポートしていません。
ソースリファレンス
| 項目 | 説明 | Token Program | Token Extensions Program |
|---|---|---|---|
Mint | ミント状態には、トークンアカウントをフリーズするために使用されるオプションのフリーズ権限が格納されています。 | ソース | ソース |
AccountState | Initialized と Frozen を含むトークンアカウントの状態。 | ソース | ソース |
FreezeAccount | トークンアカウントをフリーズ状態に変更するinstruction。 | ソース | ソース |
process_toggle_freeze_account | トークンアカウントのフリーズと解凍のための共有プロセッサロジック。 | ソース | ソース |
Typescript
以下のKitの例は、@solana/kitを使用した推奨アプローチを示しています。
@solana/web3.jsを使用したレガシー例も参考として含まれています。
Kit
import { generateKeyPairSigner } from "@solana/kit";import { createLocalClient } from "@solana/kit-client-rpc";import {findAssociatedTokenPda,tokenProgram,TOKEN_PROGRAM_ADDRESS} from "@solana-program/token";const client = await createLocalClient().use(tokenProgram());const mint = await generateKeyPairSigner();const [tokenAccount] = await findAssociatedTokenPda({mint: mint.address,owner: client.payer.address,tokenProgram: TOKEN_PROGRAM_ADDRESS});const result = await client.token.instructions.freezeAccount({account: tokenAccount, // Token account to freeze.mint: mint.address, // Mint for the token account being frozen.owner: client.payer // Freeze authority approving this change.}).sendTransaction();const tokenAccountData = await client.token.accounts.token.fetch(tokenAccount);console.log("Mint Address:", mint.address);console.log("\nToken Account Address:", tokenAccount);console.log("Token Account:", tokenAccountData.data);console.log("\nTransaction Signature:", result.context.signature);
Console
Click to execute the code.
Web3.js
import {createAssociatedTokenAccount,freezeAccount,createMint,getAccount,mintToChecked,TOKEN_PROGRAM_ID} from "@solana/spl-token";import { Connection, Keypair, LAMPORTS_PER_SOL } from "@solana/web3.js";const result = await freezeAccount(connection, // Connection to the local validator.feePayer, // Account paying transaction fees.associatedTokenAccount, // Token account to freeze.mintPubkey, // Mint for the token account being frozen.feePayer, // Freeze authority approving this change.[], // Additional multisig signers.{commitment: "confirmed" // Confirmation options for the transaction.},TOKEN_PROGRAM_ID // Token program to invoke.);const tokenAccountData = await getAccount(connection,associatedTokenAccount,"confirmed",TOKEN_PROGRAM_ID);console.log("Mint Address:", mintPubkey.toBase58());console.log("\nAssociated Token Account Address:",associatedTokenAccount.toBase58());console.log("Associated Token Account:", tokenAccountData);console.log("\nTransaction Signature:", result);
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::{program_pack::Pack,signature::{Keypair, Signer},transaction::Transaction,};use solana_system_interface::instruction::create_account;use spl_associated_token_account_interface::{address::get_associated_token_address, instruction::create_associated_token_account,};use spl_token_interface::{id as token_program_id,instruction::{freeze_account, initialize_mint, mint_to_checked},state::{Account, Mint},};#[tokio::main]async fn main() -> Result<()> {let client = RpcClient::new_with_commitment(String::from("http://localhost:8899"),CommitmentConfig::confirmed(),);let transaction = Transaction::new_signed_with_payer(&[freeze_account(&token_program_id(), // Token program to invoke.&associated_token_address, // Token account to freeze.&mint.pubkey(), // Mint for the token account being frozen.&fee_payer.pubkey(), // Freeze authority approving this change.&[], // Additional multisig signers.)?,],Some(&fee_payer.pubkey()),&[&fee_payer],latest_blockhash,);let transaction_signature = client.send_and_confirm_transaction(&transaction).await?;let token_account = client.get_account(&associated_token_address).await?;let token_data = Account::unpack(&token_account.data)?;println!("Mint Address: {}", mint.pubkey());println!("\nAssociated Token Account Address: {}",associated_token_address);println!("Associated Token Account: {:#?}", token_data);println!("\nTransaction Signature: {}", transaction_signature);Ok(())}
Console
Click to execute the code.
Python
Python
#!/usr/bin/env python3import asyncioimport jsonfrom solana.rpc.async_api import AsyncClientfrom solders.keypair import Keypairfrom solders.message import Messagefrom solders.pubkey import Pubkeyfrom solders.system_program import create_account, CreateAccountParamsfrom solders.transaction import Transactionfrom spl.token.async_client import AsyncTokenfrom spl.token.instructions import (create_associated_token_account,freeze_account,FreezeAccountParams,get_associated_token_address,initialize_mint,InitializeMintParams,mint_to_checked,MintToCheckedParams,)from spl.token.constants import MINT_LEN, TOKEN_PROGRAM_IDDECIMALS = 2AMOUNT_TO_MINT = 100async def main():rpc = AsyncClient("http://localhost:8899")async with rpc:freeze_account_instruction = freeze_account(FreezeAccountParams(program_id=TOKEN_PROGRAM_ID, # Token program to invoke.account=token_account_address, # Token account to freeze.mint=mint.pubkey(), # Mint for the token account being frozen.authority=fee_payer.pubkey(), # Freeze authority approving the freeze.))latest_blockhash = await rpc.get_latest_blockhash()transaction = Transaction([fee_payer],Message([freeze_account_instruction], fee_payer.pubkey()),latest_blockhash.value.blockhash,)result = await rpc.send_transaction(transaction)token_account_info = await token.get_account_info(token_account_address)token_account = {key: str(value) if isinstance(value, Pubkey) else valuefor key, value in token_account_info._asdict().items()}print("Mint Address:", mint.pubkey())print("\nToken Account Address:", token_account_address)print("Token Account:")print(json.dumps(token_account, indent=2))print("\nTransaction Signature:", result.value)if __name__ == "__main__":asyncio.run(main())
Console
Click to execute the code.
Is this page helpful?