Заморозити рахунок

Що робить заморожування токен-акаунта?

Заморожування token account зберігає того самого власника, mint і баланс, але запобігає отриманню, переказу або спаленню токенів з token account до тих пір, поки token account не буде розморожено.

Заморожений акаунт все ще може бути закритий, якщо заморожений акаунт має нульовий баланс токенів.

Тільки mint, який все ще має повноваження на заморожування, може заморожувати токен-акаунти. Якщо повноваження на заморожування mint відкликано, акаунти для цього mint більше не можуть бути заморожені.

Як заморозити токен-акаунт

Заморожування токен-акаунта використовує інструкцію FreezeAccount Token Program.

Інструкція FreezeAccount перевіряє, що токен-акаунт належить до mint і що підписувач є повноваженням на заморожування mint, а потім змінює стан токен-акаунта з ініціалізованого на заморожений.

Нативні токен-акаунти не підтримують заморожування.

Посилання на джерело

ЕлементОписToken ProgramToken Extension Program
MintСтан mint зберігає необов'язкові повноваження на заморожування, які використовуються для заморожування токен-акаунтів.ДжерелоДжерело
AccountStateСтани токен-акаунта, включаючи Initialized та Frozen.ДжерелоДжерело
FreezeAccountІнструкція, яка переводить токен-акаунт у заморожений стан.ДжерелоДжерело
process_toggle_freeze_accountСпільна логіка процесора для заморожування та розморожування токен-акаунтів.ДжерелоДжерело

Typescript

Наведені нижче приклади Kit демонструють рекомендований підхід з використанням @solana/kit. Приклади застарілого підходу з використанням @solana/web3.js наведено для довідки.

Kit

import { createClient, generateKeyPairSigner, lamports } from "@solana/kit";
import { solanaRpc, rpcAirdrop } from "@solana/kit-plugin-rpc";
import { generatedPayer, airdropPayer } from "@solana/kit-plugin-signer";
import {
findAssociatedTokenPda,
tokenProgram,
TOKEN_PROGRAM_ADDRESS
} from "@solana-program/token";
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)))
.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 python3
import asyncio
import json
from solana.rpc.async_api import AsyncClient
from solders.keypair import Keypair
from solders.message import Message
from solders.pubkey import Pubkey
from solders.system_program import create_account, CreateAccountParams
from solders.transaction import Transaction
from spl.token.async_client import AsyncToken
from 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_ID
DECIMALS = 2
AMOUNT_TO_MINT = 100
async 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 value
for 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?

Зміст

Редагувати сторінку

Керується

© 2026 Фонд Solana.
Всі права захищені.
Залишайтеся на зв'язку