تجميد الحساب

ما الذي يفعله تجميد حساب الرمز المميز؟

يحافظ تجميد حساب الرمز المميز على نفس المالك والسك والرصيد، لكنه يمنع حساب الرمز المميز من تحويل أو حرق الرموز المميزة حتى يتم إلغاء تجميد حساب الرمز المميز.

لا يزال بإمكان إغلاق الحساب المجمد إذا كان الحساب المجمد يحتوي على رصيد رمز مميز صفري.

يمكن فقط لعملية سك لا تزال تمتلك صلاحية التجميد أن تقوم بتجميد حسابات الرموز المميزة. إذا تم إلغاء صلاحية التجميد الخاصة بالسك، فلن يمكن بعد ذلك تجميد الحسابات الخاصة بتلك السك.

كيفية تجميد حساب الرمز المميز

يستخدم تجميد حساب الرمز المميز تعليمات FreezeAccount الخاصة ببرنامج الرموز المميزة.

تتحقق تعليمات FreezeAccount من أن حساب الرمز المميز ينتمي إلى السك وأن الموقّع هو صلاحية التجميد الخاصة بالسك، ثم تغير حالة حساب الرمز المميز من مهيأ إلى مجمد.

حسابات الرموز المميزة الأصلية لا تدعم التجميد.

المرجع المصدري

العنصرالوصفToken ProgramToken Extensions Program
Mintتخزن حالة السك صلاحية التجميد الاختيارية المستخدمة لتجميد حسابات الرموز المميزة.SourceSource
AccountStateحالات حساب الرمز المميز، بما في ذلك Initialized و Frozen.SourceSource
FreezeAccountتعليمات تغير حساب الرمز المميز إلى الحالة المجمدة.SourceSource
process_toggle_freeze_accountمنطق المعالج المشترك لتجميد وإلغاء تجميد حسابات الرموز المميزة.SourceSource

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 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 مؤسسة سولانا.
جميع الحقوق محفوظة.
تواصل معنا