Documentation SolanaTokens sur SolanaPrincipes de base

Geler un compte

Geler un compte

L'instruction FreezeAccount empêche tous les transferts ou destructions de tokens depuis un token account spécifique. Une fois gelé, le compte ne peut plus envoyer de tokens, en recevoir, ou être fermé jusqu'à ce qu'il soit dégelé. Seule l'autorité de gel du mint du token peut geler des comptes. Si l'autorité de gel est révoquée (définie à null) sur le mint account, les tokens ne pourront jamais être gelés.

Le Token Program et le Token Extension Program partagent des implémentations similaires pour atteindre la même fonctionnalité.

Typescript

import {

  airdropFactory,

  appendTransactionMessageInstructions,

  createSolanaRpc,

  createSolanaRpcSubscriptions,

  createTransactionMessage,

  generateKeyPairSigner,

  getSignatureFromTransaction,

  lamports,

  pipe,

  sendAndConfirmTransactionFactory,

  setTransactionMessageFeePayerSigner,

  setTransactionMessageLifetimeUsingBlockhash,

  signTransactionMessageWithSigners

} from "@solana/kit";

import { getCreateAccountInstruction } from "@solana-program/system";

import {

  getCreateAssociatedTokenInstructionAsync,

  getInitializeMintInstruction,

  getMintSize,

  TOKEN_PROGRAM_ADDRESS,

  findAssociatedTokenPda,

  getMintToInstruction,

  getFreezeAccountInstruction

} from "@solana-program/token";



// Create Connection, local validator in this example

const rpc = createSolanaRpc("http://localhost:8899");

const rpcSubscriptions = createSolanaRpcSubscriptions("ws://localhost:8900");



// Generate keypairs for fee payer

const feePayer = await generateKeyPairSigner();



// Fund fee payer

await airdropFactory({ rpc, rpcSubscriptions })({

  recipientAddress: feePayer.address,

  lamports: lamports(1_000_000_000n),

  commitment: "confirmed"

});



// Generate keypair to use as address of mint

const mint = await generateKeyPairSigner();



// Get default mint account size (in bytes), no extensions enabled

const space = BigInt(getMintSize());



// Get minimum balance for rent exemption

const rent = await rpc.getMinimumBalanceForRentExemption(space).send();



// Get latest blockhash to include in transaction

const { value: latestBlockhash } = await rpc.getLatestBlockhash().send();



// Instruction to create new account for mint (token program)

// Invokes the system program

const createAccountInstruction = getCreateAccountInstruction({

  payer: feePayer,

  newAccount: mint,

  lamports: rent,

  space,

  programAddress: TOKEN_PROGRAM_ADDRESS

});



// Instruction to initialize mint account data

// Invokes the token program

const initializeMintInstruction = getInitializeMintInstruction({

  mint: mint.address,

  decimals: 9,

  mintAuthority: feePayer.address,

  freezeAuthority: feePayer.address

});



// Use findAssociatedTokenPda to derive the ATA address

const [associatedTokenAddress] = await findAssociatedTokenPda({

  mint: mint.address,

  owner: feePayer.address,

  tokenProgram: TOKEN_PROGRAM_ADDRESS

});



// Create instruction to create the associated token account

const createAtaInstruction = await getCreateAssociatedTokenInstructionAsync({

  payer: feePayer,

  mint: mint.address,

  owner: feePayer.address

});



// Create instruction to mint tokens

const mintToInstruction = getMintToInstruction({

  mint: mint.address,

  token: associatedTokenAddress,

  mintAuthority: feePayer.address,

  amount: 1000_000_000_000n // 1000.0 tokens with 9 decimals

});



const instructions = [

  createAccountInstruction,

  initializeMintInstruction,

  createAtaInstruction,

  mintToInstruction

];



// Create transaction message

const transactionMessage = pipe(

  createTransactionMessage({ version: 0 }),

  (tx) => setTransactionMessageFeePayerSigner(feePayer, tx),

  (tx) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx),

  (tx) => appendTransactionMessageInstructions(instructions, tx)

);



// Sign transaction message with all required signers

const signedTransaction =

  await signTransactionMessageWithSigners(transactionMessage);



// Send and confirm transaction

await sendAndConfirmTransactionFactory({ rpc, rpcSubscriptions })(

  signedTransaction,

  { commitment: "confirmed" }

);



// Get transaction signature

const transactionSignature = getSignatureFromTransaction(signedTransaction);



console.log("Mint Address:", mint.address.toString());

console.log(

  "Associated Token Account Address:",

  associatedTokenAddress.toString()

);

console.log("Transaction Signature:", transactionSignature);

console.log("Successfully minted 1000.0 tokens");



// Get a fresh blockhash for the freeze transaction

const { value: freezeBlockhash } = await rpc.getLatestBlockhash().send();



// Create instruction to freeze the token account

const freezeInstruction = getFreezeAccountInstruction({

  account: associatedTokenAddress,

  mint: mint.address,

  owner: feePayer.address

});



// Create transaction message for freezing

const freezeTxMessage = pipe(

  createTransactionMessage({ version: 0 }),

  (tx) => setTransactionMessageFeePayerSigner(feePayer, tx),

  (tx) => setTransactionMessageLifetimeUsingBlockhash(freezeBlockhash, tx),

  (tx) => appendTransactionMessageInstructions([freezeInstruction], tx)

);



// Sign transaction message with all required signers

const signedFreezeTx = await signTransactionMessageWithSigners(freezeTxMessage);



// Send and confirm transaction

await sendAndConfirmTransactionFactory({ rpc, rpcSubscriptions })(

  signedFreezeTx,

  { commitment: "confirmed" }

);



// Get transaction signature

const transactionSignature2 = getSignatureFromTransaction(signedFreezeTx);



console.log("\nSuccessfully frozen the token account");

console.log("Transaction Signature:", transactionSignature2);
Console
Click to execute the code.

Rust

use anyhow::Result;

use solana_client::nonblocking::rpc_client::RpcClient;

use solana_sdk::{

    commitment_config::CommitmentConfig,

    program_pack::Pack,

    signature::{Keypair, Signer},

    system_instruction::create_account,

    transaction::Transaction,

};

use spl_associated_token_account::{

    get_associated_token_address_with_program_id, instruction::create_associated_token_account,

};

use spl_token::{

    id as token_program_id,

    instruction::{initialize_mint, mint_to, freeze_account},

    state::Mint,

};



#[tokio::main]

async fn main() -> Result<()> {

    // Create connection to local validator

    let client = RpcClient::new_with_commitment(

        String::from("http://localhost:8899"),

        CommitmentConfig::confirmed(),

    );

    let latestBlockhash = client.get_latest_blockhash().await?;



    // Generate a new keypair for the fee payer

    let fee_payer = Keypair::new();



    // Airdrop 1 SOL to fee payer

    let airdrop_signature = client

        .request_airdrop(&fee_payer.pubkey(), 1_000_000_000)

        .await?;

    client.confirm_transaction(&airdrop_signature).await?;



    loop {

        let confirmed = client.confirm_transaction(&airdrop_signature).await?;

        if confirmed {

            break;

        }

    }



    // Generate keypair to use as address of mint

    let mint = Keypair::new();



    // Get default mint account size (in bytes), no extensions enabled

    let mint_space = Mint::LEN;

    let mint_rent = client

        .get_minimum_balance_for_rent_exemption(mint_space)

        .await?;



    // Instruction to create new account for mint (token program)

    let create_account_instruction = create_account(

        &fee_payer.pubkey(),      // payer

        &mint.pubkey(),           // new account (mint)

        mint_rent,                // lamports

        mint_space as u64,        // space

        &token_program_id(), // program id

    );



    // Instruction to initialize mint account data

    let initialize_mint_instruction = initialize_mint(

        &token_program_id(),

        &mint.pubkey(),            // mint

        &fee_payer.pubkey(),       // mint authority

        Some(&fee_payer.pubkey()), // freeze authority

        9,                         // decimals

    )?;



    // Calculate the associated token account address for fee_payer

    let associated_token_address = get_associated_token_address_with_program_id(

        &fee_payer.pubkey(),      // owner

        &mint.pubkey(),           // mint

        &token_program_id(), // program_id

    );



    // Instruction to create associated token account

    let create_ata_instruction = create_associated_token_account(

        &fee_payer.pubkey(),      // funding address

        &fee_payer.pubkey(),      // wallet address

        &mint.pubkey(),           // mint address

        &token_program_id(), // program id

    );



    // Amount of tokens to mint (1000 tokens with 9 decimals)

    let amount = 1000_000_000_000;



    // Create mint_to instruction to mint tokens to the associated token account

    let mint_to_instruction = mint_to(

        &token_program_id(),

        &mint.pubkey(),            // mint

        &associated_token_address, // destination

        &fee_payer.pubkey(),       // authority

        &[&fee_payer.pubkey()],    // signer

        amount,                    // amount

    )?;



    // Create transaction and add instructions

    let transaction = Transaction::new_signed_with_payer(

        &[

            create_account_instruction,

            initialize_mint_instruction,

            create_ata_instruction,

            mint_to_instruction,

        ],

        Some(&fee_payer.pubkey()),

        &[&fee_payer, &mint],

        latestBlockhash,

    );



    // Send and confirm transaction

    let transaction_signature = client.send_and_confirm_transaction(&transaction).await?;



    println!("Mint Address: {}", mint.pubkey());

    println!(

        "Associated Token Account Address: {}",

        associated_token_address

    );

    println!("Transaction Signature: {}", transaction_signature);

    println!("Successfully minted 1000.0 tokens");



    // Get the latest blockhash for the freeze transaction

    let latestBlockhash = client.get_latest_blockhash().await?;



    // Create freeze account instruction

    let freeze_instruction = freeze_account(

        &token_program_id(), // program id

        &associated_token_address,  // token account to freeze

        &mint.pubkey(),             // mint

        &fee_payer.pubkey(),        // freeze authority

        &[&fee_payer.pubkey()],     // signers

    )?;



    // Create transaction for freezing token account

    let transaction = Transaction::new_signed_with_payer(

        &[freeze_instruction],

        Some(&fee_payer.pubkey()),

        &[&fee_payer],

        latestBlockhash,

    );



    // Send and confirm transaction

    let transaction_signature = client.send_and_confirm_transaction(&transaction).await?;



    println!("\nSuccessfully frozen the token account");

    println!("Transaction Signature: {}", transaction_signature);



    Ok(())

}
Console
Click to execute the code.

Is this page helpful?

Précédent

Fermer un compte de token

Suivant

Dégeler un compte

Table des matières

Modifier la page

Géré par

© 2025 Fondation Solana. Tous droits réservés.
Solana
Restez connecté
© 2025 Fondation Solana. Tous droits réservés.