> ## Documentation Index
> Fetch the complete documentation index at: https://www.zkcompression.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Burn Light Tokens
> Rust client guide to burn Light Tokens. Includes step-by-step implementation and full code examples.
export const lightBurnRustCode = ["use light_token::instruction::Burn;", "", "let ix = Burn {", " source,", " mint,", " amount,", " authority: payer.pubkey(),", " max_top_up: None,", " fee_payer: None,", "}", ".instruction()?;"].join("\n");
export const splBurnRustCode = ["use spl_token::instruction::burn;", "", "let ix = burn(", " &spl_token::id(),", " &source,", " &mint,", " &authority,", " &[],", " amount,", ")?;"].join("\n");
export const CodeCompare = ({firstCode = "", secondCode = "", firstLabel = "Light Token", secondLabel = "SPL", language = "javascript"}) => {
const [sliderPercent, setSliderPercent] = useState(100);
const [isDragging, setIsDragging] = useState(false);
const [isAnimating, setIsAnimating] = useState(false);
const [copied, setCopied] = useState(false);
const containerRef = useRef(null);
const animationRef = useRef(null);
const firstPreRef = useRef(null);
const secondPreRef = useRef(null);
const [containerHeight, setContainerHeight] = useState(null);
const showingFirst = sliderPercent > 50;
const handleCopy = async () => {
const codeToCopy = showingFirst ? firstCode : secondCode;
await navigator.clipboard.writeText(codeToCopy);
setCopied(true);
setTimeout(() => setCopied(false), 2000);
};
const highlightCode = code => {
let escaped = code.replace(/&/g, "&").replace(//g, ">");
if (language === "rust") {
const rustPattern = /(\/\/.*$)|(["'])(?:(?!\2)[^\\]|\\.)*?\2|\b(use|let|mut|pub|fn|struct|impl|enum|mod|const|static|trait|type|where|for|in|if|else|match|loop|while|return|self|Self|true|false|Some|None|Ok|Err|Result|Option|vec!)\b|::([a-zA-Z_][a-zA-Z0-9_]*)|&([a-zA-Z_][a-zA-Z0-9_]*)|\b([a-zA-Z_][a-zA-Z0-9_]*)\s*(?=\()|(\?)/gm;
return escaped.replace(rustPattern, (match, comment, stringQuote, keyword, pathSegment, reference, func, questionMark) => {
if (comment) return `${match}`;
if (stringQuote) return `${match}`;
if (keyword) return `${match}`;
if (pathSegment) return `::${pathSegment}`;
if (reference) return `&${reference}`;
if (func) return `${match}`;
if (questionMark) return `?`;
return match;
});
}
const pattern = /(\/\/.*$)|(["'`])(?:(?!\2)[^\\]|\\.)*?\2|\b(const|let|var|await|async|import|from|export|return|if|else|function|class|new|throw|try|catch)\b|\.([a-zA-Z_][a-zA-Z0-9_]*)\b|\b([a-zA-Z_][a-zA-Z0-9_]*)\s*(?=\()/gm;
return escaped.replace(pattern, (match, comment, stringQuote, keyword, property, func) => {
if (comment) return `${match}`;
if (stringQuote) return `${match}`;
if (keyword) return `${match}`;
if (property) return `.${property}`;
if (func) return `${match}`;
return match;
});
};
const animateTo = target => {
if (animationRef.current) cancelAnimationFrame(animationRef.current);
setIsAnimating(true);
const start = sliderPercent;
const startTime = performance.now();
const duration = 400;
const animate = currentTime => {
const elapsed = currentTime - startTime;
const progress = Math.min(elapsed / duration, 1);
const eased = 1 - Math.pow(1 - progress, 3);
const current = start + (target - start) * eased;
setSliderPercent(current);
if (progress < 1) {
animationRef.current = requestAnimationFrame(animate);
} else {
setSliderPercent(target);
setIsAnimating(false);
animationRef.current = null;
}
};
animationRef.current = requestAnimationFrame(animate);
};
const handleToggle = () => {
animateTo(showingFirst ? 0 : 100);
};
const handleMouseDown = e => {
if (isAnimating) {
cancelAnimationFrame(animationRef.current);
setIsAnimating(false);
}
e.preventDefault();
setIsDragging(true);
};
const handleMouseUp = () => {
setIsDragging(false);
};
const handleMouseMove = e => {
if (!isDragging || !containerRef.current) return;
const rect = containerRef.current.getBoundingClientRect();
const x = e.clientX - rect.left;
const percent = Math.max(0, Math.min(100, x / rect.width * 100));
setSliderPercent(percent);
};
const handleTouchMove = e => {
if (!containerRef.current) return;
if (isAnimating) {
cancelAnimationFrame(animationRef.current);
setIsAnimating(false);
}
const rect = containerRef.current.getBoundingClientRect();
const x = e.touches[0].clientX - rect.left;
const percent = Math.max(0, Math.min(100, x / rect.width * 100));
setSliderPercent(percent);
};
const handleKeyDown = e => {
if (e.key === "ArrowLeft") {
setSliderPercent(p => Math.max(0, p - 5));
} else if (e.key === "ArrowRight") {
setSliderPercent(p => Math.min(100, p + 5));
}
};
useEffect(() => {
if (isDragging) {
document.addEventListener("mousemove", handleMouseMove);
document.addEventListener("mouseup", handleMouseUp);
return () => {
document.removeEventListener("mousemove", handleMouseMove);
document.removeEventListener("mouseup", handleMouseUp);
};
}
}, [isDragging]);
useEffect(() => {
return () => {
if (animationRef.current) cancelAnimationFrame(animationRef.current);
};
}, []);
useEffect(() => {
const activeRef = showingFirst ? firstPreRef : secondPreRef;
if (activeRef.current) {
setContainerHeight(activeRef.current.scrollHeight);
}
}, [showingFirst]);
return <>
{}
{showingFirst ? firstLabel : secondLabel}
{}
") for architecture
- Task subagent with Grep/Read/WebFetch for parallel lookups
- TaskList to check remaining work`}
```text theme={null}
---
description: Burn Light Tokens
allowed-tools: Bash, Read, Write, Edit, Glob, Grep, WebFetch, AskUserQuestion, Task, TaskCreate, TaskGet, TaskList, TaskUpdate, TaskOutput, mcp__deepwiki, mcp__zkcompression
---
## Burn Light Tokens
Context:
- Guide: https://zkcompression.com/light-token/cookbook/burn
- Skills and resources index: https://zkcompression.com/skill.md
- SPL to Light reference: https://zkcompression.com/api-reference/solana-to-light-comparison
- Crates: light-token-client (actions), light-token (instructions), light-client (RPC)
SPL equivalent: spl_token::instruction::burn → Light Token: Burn
### 1. Index project
- Grep `light_token::|light_token_client::|solana_sdk|Keypair|async|Burn|burn` across src/
- Glob `**/*.rs` for project structure
- Identify: RPC setup, existing token ops, entry point for burn
- Check Cargo.toml for existing light-* dependencies and solana-sdk version
- Task subagent (Grep/Read/WebFetch) if project has multiple crates to scan in parallel
### 2. Read references
- WebFetch the guide above — follow the Rust Client tab
- WebFetch skill.md — check for a dedicated skill and resources matching this task
- TaskCreate one todo per phase below to track progress
### 3. Clarify intention
- AskUserQuestion: what is the goal? (new feature, migrate existing SPL code, add alongside existing)
- AskUserQuestion: does the project already have burn operations to extend, or is this greenfield?
- AskUserQuestion: action-level API (high-level, fewer lines) or instruction-level API (low-level, full control)?
- Summarize findings and wait for user confirmation before implementing
### 4. Create plan
- Based on steps 1–3, draft an implementation plan: which files to modify, what code to add, dependency changes
- Verify existing Rpc/signer setup is compatible with the cookbook prerequisites (light_client::rpc::Rpc, solana_sdk::signature::Keypair)
- If anything is unclear or ambiguous, loop back to step 3 (AskUserQuestion)
- Present the plan to the user for approval before proceeding
### 5. Implement
- Add deps if missing: Bash `cargo add light-token-client light-token light-client --features light-client/v2`
- Follow the cookbook guide and the approved plan
- Write/Edit to create or modify files
- TaskUpdate to mark each step done
### 6. Verify
- Bash `cargo check`
- Bash `cargo test` if tests exist
- TaskUpdate to mark complete
### Tools
- mcp__zkcompression__SearchLightProtocol("") for API details
- mcp__deepwiki__ask_question("Lightprotocol/light-protocol", "") for architecture
- Task subagent with Grep/Read/WebFetch for parallel lookups
- TaskList to check remaining work
```
Find [a full code example at the end](#full-code-example).
### Build Account Infos and CPI the Light Token Program
Use `invoke` for external signers or `invoke_signed` when the authority is a PDA.
```rust theme={null}
use light_token::instruction::BurnCpi;
BurnCpi {
source: source.clone(),
mint: mint.clone(),
amount,
authority: authority.clone(),
system_program: system_program.clone(),
fee_payer: None,
max_top_up: None,
}
.invoke()
```
```rust theme={null}
use light_token::instruction::BurnCpi;
BurnCpi {
source: source.clone(),
mint: mint.clone(),
amount,
authority: authority.clone(),
system_program: system_program.clone(),
fee_payer: None,
max_top_up: None,
}
.invoke_signed(&[signer_seeds])
```
# Full Code Example
View the [source code](https://github.com/Lightprotocol/light-protocol/blob/main/sdk-libs/token-sdk/src/instruction/burn.rs) and [full example](https://github.com/Lightprotocol/examples-light-token/tree/main/programs/anchor/basic-instructions/burn) with shared test utilities.
```rust lib.rs theme={null}
#![allow(unexpected_cfgs, deprecated)]
use anchor_lang::prelude::*;
use light_token::instruction::BurnCpi;
declare_id!("2TXVn8AqjfyeJvmFBD3kHJmh6fWkC4HNB5T76BmLKV5c");
#[program]
pub mod light_token_anchor_burn {
use super::*;
pub fn burn(ctx: Context, amount: u64) -> Result<()> {
BurnCpi {
source: ctx.accounts.source.to_account_info(),
mint: ctx.accounts.mint.to_account_info(),
amount,
authority: ctx.accounts.authority.to_account_info(),
system_program: ctx.accounts.system_program.to_account_info(),
fee_payer: ctx.accounts.fee_payer.to_account_info(),
}
.invoke()?;
Ok(())
}
}
#[derive(Accounts)]
pub struct BurnAccounts<'info> {
/// CHECK: Light token program for CPI
pub light_token_program: AccountInfo<'info>,
/// CHECK: Validated by light-token CPI
#[account(mut)]
pub source: AccountInfo<'info>,
/// CHECK: Validated by light-token CPI
#[account(mut)]
pub mint: AccountInfo<'info>,
pub authority: Signer<'info>,
#[account(mut)]
pub fee_payer: Signer<'info>,
pub system_program: Program<'info, System>,
}
```
```rust test.rs theme={null}
use anchor_lang::{InstructionData, ToAccountMetas};
use light_program_test::Rpc;
use light_token::instruction::LIGHT_TOKEN_PROGRAM_ID;
use light_token_anchor_burn::{accounts, instruction::Burn, ID};
use anchor_lang::system_program;
use solana_sdk::{instruction::Instruction, signer::Signer};
use test_utils::{mint_tokens, setup_test_env};
#[tokio::test]
async fn test_burn() {
let mut env = setup_test_env("light_token_anchor_burn", ID).await;
// Mint tokens first
let mint_amount = 1_000_000u64;
mint_tokens(&mut env.rpc, &env.payer, env.mint_pda, env.associated_token_account, mint_amount).await;
// Call the anchor program to burn tokens
let burn_amount = 250_000u64;
let ix = Instruction {
program_id: ID,
accounts: accounts::BurnAccounts {
light_token_program: LIGHT_TOKEN_PROGRAM_ID,
source: env.associated_token_account,
mint: env.mint_pda,
authority: env.payer.pubkey(),
fee_payer: env.payer.pubkey(),
system_program: system_program::ID,
}
.to_account_metas(Some(true)),
data: Burn { amount: burn_amount }.data(),
};
let sig = env
.rpc
.create_and_send_transaction(&[ix], &env.payer.pubkey(), &[&env.payer])
.await
.unwrap();
println!("Tx: {}", sig);
}
```
{`---
description: Add burn CPI to an Anchor program
allowed-tools: Bash, Read, Write, Edit, Glob, Grep, WebFetch, AskUserQuestion, Task, TaskCreate, TaskGet, TaskList, TaskUpdate, TaskOutput, mcp__deepwiki, mcp__zkcompression
---
## Add burn CPI to an Anchor program
Context:
- Guide: https://zkcompression.com/light-token/cookbook/burn
- Skills and resources index: https://zkcompression.com/skill.md
- SPL to Light reference: https://zkcompression.com/api-reference/solana-to-light-comparison
- Crate: light-token (BurnCpi)
- Example: https://github.com/Lightprotocol/examples-light-token/tree/main/programs/anchor/basic-instructions/burn
Key CPI struct: \`light_token::instruction::BurnCpi\`
### 1. Index project
- Grep \`declare_id|#\[program\]|anchor_lang|Account<|Pubkey|invoke|burn|destroy|supply\` across src/
- Glob \`**/*.rs\` and \`**/Cargo.toml\` for project structure
- Identify: program ID, existing instructions, account structs, token accounts
- Read Cargo.toml — note existing dependencies and framework version
- Task subagent (Grep/Read/WebFetch) if project has multiple crates to scan in parallel
### 2. Read references
- WebFetch the guide above — review the Program tab CPI code samples
- WebFetch skill.md — check for a dedicated skill and resources matching this task
- TaskCreate one todo per phase below to track progress
### 3. Clarify intention
- AskUserQuestion: what is the goal? (add burn to existing program, new program from scratch, migrate from SPL burn)
- AskUserQuestion: should the authority be an external signer or a PDA? (determines invoke vs invoke_signed)
- Summarize findings and wait for user confirmation before implementing
### 4. Create plan
- Based on steps 1–3, draft an implementation plan: which files to modify, what code to add, dependency changes
- Follow the guide's step order: Build BurnCpi struct → call .invoke() or .invoke_signed()
- If anything is unclear or ambiguous, loop back to step 3 (AskUserQuestion)
- Present the plan to the user for approval before proceeding
### 5. Implement
- Add deps if missing: Bash \`cargo add light-token anchor-lang@0.31\`
- Follow the guide and the approved plan
- Write/Edit to create or modify files
- TaskUpdate to mark each step done
### 6. Verify
- Bash \`anchor build\`
- Bash \`anchor test\` if tests exist
- TaskUpdate to mark complete
### Tools
- mcp__zkcompression__SearchLightProtocol("") for API details
- mcp__deepwiki__ask_question("Lightprotocol/light-protocol", "") for architecture
- Task subagent with Grep/Read/WebFetch for parallel lookups
- TaskList to check remaining work`}
```text theme={null}
---
description: Add burn CPI to an Anchor program
allowed-tools: Bash, Read, Write, Edit, Glob, Grep, WebFetch, AskUserQuestion, Task, TaskCreate, TaskGet, TaskList, TaskUpdate, TaskOutput, mcp__deepwiki, mcp__zkcompression
---
## Add burn CPI to an Anchor program
Context:
- Guide: https://zkcompression.com/light-token/cookbook/burn
- Skills and resources index: https://zkcompression.com/skill.md
- SPL to Light reference: https://zkcompression.com/api-reference/solana-to-light-comparison
- Crate: light-token (BurnCpi)
- Example: https://github.com/Lightprotocol/examples-light-token/tree/main/programs/anchor/basic-instructions/burn
Key CPI struct: `light_token::instruction::BurnCpi`
### 1. Index project
- Grep `declare_id|#\[program\]|anchor_lang|Account<|Pubkey|invoke|burn|destroy|supply` across src/
- Glob `**/*.rs` and `**/Cargo.toml` for project structure
- Identify: program ID, existing instructions, account structs, token accounts
- Read Cargo.toml — note existing dependencies and framework version
- Task subagent (Grep/Read/WebFetch) if project has multiple crates to scan in parallel
### 2. Read references
- WebFetch the guide above — review the Program tab CPI code samples
- WebFetch skill.md — check for a dedicated skill and resources matching this task
- TaskCreate one todo per phase below to track progress
### 3. Clarify intention
- AskUserQuestion: what is the goal? (add burn to existing program, new program from scratch, migrate from SPL burn)
- AskUserQuestion: should the authority be an external signer or a PDA? (determines invoke vs invoke_signed)
- Summarize findings and wait for user confirmation before implementing
### 4. Create plan
- Based on steps 1–3, draft an implementation plan: which files to modify, what code to add, dependency changes
- Follow the guide's step order: Build BurnCpi struct → call .invoke() or .invoke_signed()
- If anything is unclear or ambiguous, loop back to step 3 (AskUserQuestion)
- Present the plan to the user for approval before proceeding
### 5. Implement
- Add deps if missing: Bash `cargo add light-token anchor-lang@0.31`
- Follow the guide and the approved plan
- Write/Edit to create or modify files
- TaskUpdate to mark each step done
### 6. Verify
- Bash `anchor build`
- Bash `anchor test` if tests exist
- TaskUpdate to mark complete
### Tools
- mcp__zkcompression__SearchLightProtocol("") for API details
- mcp__deepwiki__ask_question("Lightprotocol/light-protocol", "") for architecture
- Task subagent with Grep/Read/WebFetch for parallel lookups
- TaskList to check remaining work
```
## Related Guides
***
## Didn't find what you were looking for?
Reach out! [Telegram](https://t.me/swen_light) | [email](mailto:support@lightprotocol.com) | [Discord](https://discord.com/invite/7cJ8BhAXhu)