Que fait le gel d'un compte de jetons ?
Le gel d'un compte de jetons conserve le même propriétaire, la même frappe et le même solde, mais empêche le compte de jetons de transférer ou de détruire des jetons jusqu'à ce que le compte soit dégelé.
Un compte gelé peut toujours être fermé si le compte gelé a un solde de jetons nul.
Seule une frappe qui possède encore une autorité de gel peut geler des comptes de jetons. Si l'autorité de gel d'une frappe est révoquée, les comptes pour cette frappe ne peuvent plus être gelés.
Comment geler un compte de jetons
Le gel d'un compte de jetons utilise l'instruction FreezeAccount du Token
Program.
L'instruction FreezeAccount vérifie que le compte de jetons appartient à
la frappe et que le signataire est l'autorité de gel de la frappe, puis change
l'état du compte de jetons d'initialisé à gelé.
Les comptes de jetons natifs ne prennent pas en charge le gel.
Référence source
| Élément | Description | Token Program | Token Extensions Program |
|---|---|---|---|
Mint | L'état de la frappe stocke l'autorité de gel optionnelle utilisée pour geler les comptes de jetons. | Source | Source |
AccountState | Les états du compte de jetons, y compris Initialized et Frozen. | Source | Source |
FreezeAccount | Une instruction qui change un compte de jetons en état gelé. | Source | Source |
process_toggle_freeze_account | Logique de processeur partagée pour le gel et le dégel des comptes de jetons. | Source | Source |
Typescript
Les exemples Kit ci-dessous montrent l'approche recommandée utilisant
@solana/kit. Les exemples hérités utilisant @solana/web3.js sont inclus à
titre de référence.
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);
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);
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(())}
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())
Is this page helpful?