> ## 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.
# Freeze and Thaw Light Token Accounts
> Rust client guide to freeze and thaw Light Token accounts. Includes step-by-step implementation and full code examples.
export const lightThawRustCode = ["use light_token::instruction::Thaw;", "", "let ix = Thaw {", " token_account: ata,", " mint,", " freeze_authority: payer.pubkey(),", "}", ".instruction()?;"].join("\n");
export const splThawRustCode = ["use spl_token::instruction::thaw_account;", "", "let ix = thaw_account(", " &spl_token::id(),", " &account,", " &mint,", " &freeze_authority,", " &[],", ")?;"].join("\n");
export const lightFreezeRustCode = ["use light_token::instruction::Freeze;", "", "let ix = Freeze {", " token_account: ata,", " mint,", " freeze_authority: payer.pubkey(),", "}", ".instruction()?;"].join("\n");
export const splFreezeRustCode = ["use spl_token::instruction::freeze_account;", "", "let ix = freeze_account(", " &spl_token::id(),", " &account,", " &mint,", " &freeze_authority,", " &[],", ")?;"].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: Freeze and thaw Light Token accounts
allowed-tools: Bash, Read, Write, Edit, Glob, Grep, WebFetch, AskUserQuestion, Task, TaskCreate, TaskGet, TaskList, TaskUpdate, TaskOutput, mcp__deepwiki, mcp__zkcompression
---
## Freeze and thaw Light Token accounts
Context:
- Guide: https://zkcompression.com/light-token/cookbook/freeze-thaw
- 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)
- Freeze: prevents all transfers or token burns from a specific Light Token account
- Thaw: re-enables transfers on a frozen Light Token account
- Only the freeze authority (set at mint creation) can freeze or thaw accounts
SPL equivalent: spl_token::instruction::freeze_account / thaw_account → Light Token: Freeze / Thaw
### 1. Index project
- Grep `light_token::|light_token_client::|solana_sdk|Keypair|async|Freeze|Thaw|freeze_account|thaw_account` across src/
- Glob `**/*.rs` for project structure
- Identify: RPC setup, existing token ops, entry point for freeze/thaw
- 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 freeze/thaw 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::FreezeCpi;
FreezeCpi {
token_account: ctx.accounts.token_account.to_account_info(),
mint: ctx.accounts.mint.to_account_info(),
freeze_authority: ctx.accounts.freeze_authority.to_account_info(),
}
.invoke()?;
```
```rust theme={null}
use light_token::instruction::FreezeCpi;
let signer_seeds = authority_seeds!(bump);
FreezeCpi {
token_account: token_account.clone(),
mint: mint.clone(),
freeze_authority: freeze_authority.clone(),
}
.invoke_signed(&[signer_seeds])
```
### 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::ThawCpi;
ThawCpi {
token_account: ctx.accounts.token_account.to_account_info(),
mint: ctx.accounts.mint.to_account_info(),
freeze_authority: ctx.accounts.freeze_authority.to_account_info(),
}
.invoke()?;
```
```rust theme={null}
use light_token::instruction::ThawCpi;
let signer_seeds = authority_seeds!(bump);
ThawCpi {
token_account: token_account.clone(),
mint: mint.clone(),
freeze_authority: freeze_authority.clone(),
}
.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/freeze.rs) and [full example](https://github.com/Lightprotocol/examples-light-token/tree/main/programs/anchor/basic-instructions/freeze) with shared test utilities.
```rust lib.rs theme={null}
#![allow(unexpected_cfgs, deprecated)]
use anchor_lang::prelude::*;
use light_token::instruction::FreezeCpi;
declare_id!("JBMzMJX4sqCQfNVbosP2oqP1KZ5ZDWiwYTrupk687qXZ");
#[program]
pub mod light_token_anchor_freeze {
use super::*;
pub fn freeze(ctx: Context) -> Result<()> {
FreezeCpi {
token_account: ctx.accounts.token_account.to_account_info(),
mint: ctx.accounts.mint.to_account_info(),
freeze_authority: ctx.accounts.freeze_authority.to_account_info(),
}
.invoke()?;
Ok(())
}
}
#[derive(Accounts)]
pub struct FreezeAccounts<'info> {
/// CHECK: Light token program for CPI
pub light_token_program: AccountInfo<'info>,
/// CHECK: Validated by light-token CPI
#[account(mut)]
pub token_account: AccountInfo<'info>,
/// CHECK: Validated by light-token CPI
pub mint: AccountInfo<'info>,
pub freeze_authority: Signer<'info>,
}
```
```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_freeze::{accounts, instruction::Freeze, ID};
use solana_sdk::{instruction::Instruction, signer::Signer};
use test_utils::{mint_tokens, setup_test_env_with_freeze};
#[tokio::test]
async fn test_freeze() {
let mut env = setup_test_env_with_freeze("light_token_anchor_freeze", ID).await;
// Mint tokens first
mint_tokens(&mut env.rpc, &env.payer, env.mint_pda, env.associated_token_account, 1_000_000).await;
// Call the anchor program to freeze account
let ix = Instruction {
program_id: ID,
accounts: accounts::FreezeAccounts {
light_token_program: LIGHT_TOKEN_PROGRAM_ID,
token_account: env.associated_token_account,
mint: env.mint_pda,
freeze_authority: env.freeze_authority,
}
.to_account_metas(Some(true)),
data: Freeze {}.data(),
};
let sig = env
.rpc
.create_and_send_transaction(&[ix], &env.payer.pubkey(), &[&env.payer])
.await
.unwrap();
println!("Tx: {}", sig);
}
```
View the [source code](https://github.com/Lightprotocol/light-protocol/blob/main/sdk-libs/token-sdk/src/instruction/thaw.rs) and [full example](https://github.com/Lightprotocol/examples-light-token/tree/main/programs/anchor/basic-instructions/thaw) with shared test utilities.
```rust lib.rs theme={null}
#![allow(unexpected_cfgs, deprecated)]
use anchor_lang::prelude::*;
use light_token::instruction::ThawCpi;
declare_id!("7j94EF5hSkDLf7R26bjrd8Qc6s3oLAQpcKiF3re8JYw9");
#[program]
pub mod light_token_anchor_thaw {
use super::*;
pub fn thaw(ctx: Context) -> Result<()> {
ThawCpi {
token_account: ctx.accounts.token_account.to_account_info(),
mint: ctx.accounts.mint.to_account_info(),
freeze_authority: ctx.accounts.freeze_authority.to_account_info(),
}
.invoke()?;
Ok(())
}
}
#[derive(Accounts)]
pub struct ThawAccounts<'info> {
/// CHECK: Light token program for CPI
pub light_token_program: AccountInfo<'info>,
/// CHECK: Validated by light-token CPI
#[account(mut)]
pub token_account: AccountInfo<'info>,
/// CHECK: Validated by light-token CPI
pub mint: AccountInfo<'info>,
pub freeze_authority: Signer<'info>,
}
```
```rust test.rs theme={null}
use anchor_lang::{InstructionData, ToAccountMetas};
use light_program_test::Rpc;
use light_token::instruction::{Freeze, LIGHT_TOKEN_PROGRAM_ID};
use light_token_anchor_thaw::{accounts, instruction::Thaw, ID};
use solana_sdk::{instruction::Instruction, signer::Signer};
use test_utils::{mint_tokens, setup_test_env_with_freeze};
#[tokio::test]
async fn test_thaw() {
let mut env = setup_test_env_with_freeze("light_token_anchor_thaw", ID).await;
// Mint tokens first
mint_tokens(&mut env.rpc, &env.payer, env.mint_pda, env.associated_token_account, 1_000_000).await;
// Freeze account first using SDK
let freeze_ix = Freeze {
token_account: env.associated_token_account,
mint: env.mint_pda,
freeze_authority: env.freeze_authority,
}
.instruction()
.unwrap();
env.rpc
.create_and_send_transaction(&[freeze_ix], &env.payer.pubkey(), &[&env.payer])
.await
.unwrap();
// Call the anchor program to thaw account
let ix = Instruction {
program_id: ID,
accounts: accounts::ThawAccounts {
light_token_program: LIGHT_TOKEN_PROGRAM_ID,
token_account: env.associated_token_account,
mint: env.mint_pda,
freeze_authority: env.freeze_authority,
}
.to_account_metas(Some(true)),
data: Thaw {}.data(),
};
let sig = env
.rpc
.create_and_send_transaction(&[ix], &env.payer.pubkey(), &[&env.payer])
.await
.unwrap();
println!("Tx: {}", sig);
}
```
{`---
description: Add freeze and thaw 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 freeze and thaw CPI to an Anchor program
Context:
- Guide: https://zkcompression.com/light-token/cookbook/freeze-thaw
- 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 (FreezeCpi, ThawCpi)
- Example: https://github.com/Lightprotocol/examples-light-token/tree/main/programs/anchor/basic-instructions/freeze
Key CPI structs: \`light_token::instruction::FreezeCpi\`, \`light_token::instruction::ThawCpi\`
### 1. Index project
- Grep \`declare_id|#\[program\]|anchor_lang|Account<|Pubkey|invoke|freeze|thaw|authority\` across src/
- Glob \`**/*.rs\` and \`**/Cargo.toml\` for project structure
- Identify: program ID, existing instructions, account structs, freeze authority
- 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 both Freeze and Thaw 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 freeze/thaw to existing program, new program from scratch, migrate from SPL freeze/thaw)
- AskUserQuestion: should the freeze authority be an external signer or a PDA? (determines invoke vs invoke_signed)
- AskUserQuestion: do you need both freeze and thaw, or just one?
- 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 FreezeCpi/ThawCpi structs → 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 freeze and thaw 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 freeze and thaw CPI to an Anchor program
Context:
- Guide: https://zkcompression.com/light-token/cookbook/freeze-thaw
- 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 (FreezeCpi, ThawCpi)
- Example: https://github.com/Lightprotocol/examples-light-token/tree/main/programs/anchor/basic-instructions/freeze
Key CPI structs: `light_token::instruction::FreezeCpi`, `light_token::instruction::ThawCpi`
### 1. Index project
- Grep `declare_id|#\[program\]|anchor_lang|Account<|Pubkey|invoke|freeze|thaw|authority` across src/
- Glob `**/*.rs` and `**/Cargo.toml` for project structure
- Identify: program ID, existing instructions, account structs, freeze authority
- 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 both Freeze and Thaw 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 freeze/thaw to existing program, new program from scratch, migrate from SPL freeze/thaw)
- AskUserQuestion: should the freeze authority be an external signer or a PDA? (determines invoke vs invoke_signed)
- AskUserQuestion: do you need both freeze and thaw, or just one?
- 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 FreezeCpi/ThawCpi structs → 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)