حرق الرموز

ما الذي يفعله الحرق؟

حرق الرموز يقلل بشكل دائم من رصيد حساب رمزي ويقلل إجمالي المعروض من سك العملة بنفس المقدار.

كيفية حرق الرموز

حرق الرموز يستخدم تعليمة Burn أو BurnChecked من Token Program.

الأمثلة أدناه تستخدم BurnChecked، والتي تتطلب من المستدعي توفير الكسور العشرية لسك العملة حتى تتمكن التعليمة من التحقق من دقة الرمز المتوقعة قبل الحرق.

سك العملة الأصلي لا يدعم الحرق. استخدم CloseAccount بدلاً من ذلك.

مالك حساب الرمز أو مفوض معتمد يوقع على المعاملة. في Token Extension Program، يمكن لمفوض دائم لسك العملة أيضاً تفويض الحرق إذا كان سك العملة يحتوي على إضافة المفوض الدائم مفعلة.

مرجع المصدر

العنصرالوصفToken ProgramToken Extension Program
Mintحالة سك العملة تخزن إجمالي المعروض من الرموز.المصدرالمصدر
Accountحالة حساب الرمز تخزن رصيد الرمز الذي يتم تقليله عن طريق الحرق.المصدرالمصدر
Burnتعليمة حرق تقلل رصيد حساب رمزي ومعروض سك العملة دون الحاجة إلى أن يوفر المستدعي الكسور العشرية لسك العملة.المصدرالمصدر
BurnCheckedتعليمة حرق تتطلب من المستدعي توفير الكسور العشرية لسك العملة وتتحقق من تلك القيمة قبل تقليل رصيد حساب الرمز ومعروض سك العملة.المصدرالمصدر
process_burnمنطق معالج مشترك لحرق الرموز.المصدرالمصدر

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
.burnChecked({
account: tokenAccount, // Token account holding the tokens to burn.
mint: mint.address, // Mint for the token being burned.
authority: client.payer, // Owner or delegate approving the burn.
amount: 25n, // Token amount in base units.
decimals: 2 // Decimals defined on the mint account.
})
.sendTransaction();
const mintAccount = await client.token.accounts.mint.fetch(mint.address);
const tokenAccountData = await client.token.accounts.token.fetch(tokenAccount);
console.log("Mint Address:", mint.address);
console.log("Mint Account:", mintAccount.data);
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 { Connection, Keypair, LAMPORTS_PER_SOL } from "@solana/web3.js";
import {
createAssociatedTokenAccount,
burnChecked,
createMint,
getAccount,
getMint,
mintToChecked,
TOKEN_PROGRAM_ID
} from "@solana/spl-token";
const result = await burnChecked(
connection, // Connection to the local validator.
feePayer, // Account paying transaction fees.
associatedTokenAccount, // Token account holding the tokens to burn.
mintPubkey, // Mint for the token being burned.
feePayer, // Owner or delegate approving the burn.
25, // Token amount in base units.
2, // Decimals defined on the mint account.
[], // Additional multisig signers.
{
commitment: "confirmed" // Confirmation options for the transaction.
},
TOKEN_PROGRAM_ID // Token program to invoke.
);
const mintAccount = await getMint(
connection,
mintPubkey,
"confirmed",
TOKEN_PROGRAM_ID
);
const tokenAccountData = await getAccount(
connection,
associatedTokenAccount,
"confirmed",
TOKEN_PROGRAM_ID
);
console.log("Mint Address:", mintPubkey.toBase58());
console.log("Mint Account:", mintAccount);
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::{burn_checked, 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 burn_amount = 25;
let transaction = Transaction::new_signed_with_payer(
&[
burn_checked(
&token_program_id(), // Token program to invoke.
&associated_token_address, // Token account holding the tokens to burn.
&mint.pubkey(), // Mint for the token being burned.
&fee_payer.pubkey(), // Owner or delegate approving the burn.
&[], // Additional multisig signers.
burn_amount, // Token amount in base units.
decimals, // Decimals defined on the mint account.
)?,
],
Some(&fee_payer.pubkey()),
&[&fee_payer],
latest_blockhash,
);
let transaction_signature = client.send_and_confirm_transaction(&transaction).await?;
let mint_account = client.get_account(&mint.pubkey()).await?;
let mint_data = Mint::unpack(&mint_account.data)?;
let token_account = client.get_account(&associated_token_address).await?;
let token_data = Account::unpack(&token_account.data)?;
println!("Mint Address: {}", mint.pubkey());
println!("Mint Account: {:#?}", mint_data);
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 (
burn_checked,
BurnCheckedParams,
create_associated_token_account,
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
AMOUNT_TO_BURN = 25
async def main():
rpc = AsyncClient("http://localhost:8899")
async with rpc:
burn_tokens_instruction = burn_checked(
BurnCheckedParams(
program_id=TOKEN_PROGRAM_ID, # Token program to invoke.
mint=mint.pubkey(), # Mint for the token being burned.
account=token_account_address, # Token account whose balance decreases.
owner=fee_payer.pubkey(), # Account that owns the token account and signs the transaction.
amount=AMOUNT_TO_BURN, # Token amount in base units.
decimals=DECIMALS, # Decimals defined on the mint account.
)
)
latest_blockhash = await rpc.get_latest_blockhash()
transaction = Transaction(
[fee_payer],
Message([burn_tokens_instruction], fee_payer.pubkey()),
latest_blockhash.value.blockhash,
)
result = await rpc.send_transaction(transaction)
mint_info = await token.get_mint_info()
token_account_info = await token.get_account_info(token_account_address)
mint_account = {
key: str(value) if isinstance(value, Pubkey) else value
for key, value in mint_info._asdict().items()
}
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("Mint Account:")
print(json.dumps(mint_account, indent=2))
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 مؤسسة سولانا.
جميع الحقوق محفوظة.
تواصل معنا