Compressed Token Instructions

Overview

The compressed token program (cTokenmWW8bLPjZEBAUgYy3zKxQZW6VKi7bqNFEVv3m) implements SPL Token-compatible operations for compressed tokens. Instructions support both compressed accounts (in Merkle trees) and decompressed CToken accounts (standard Solana accounts). Program ID: cTokenmWW8bLPjZEBAUgYy3zKxQZW6VKi7bqNFEVv3m
Documentation: Compressed Token Program

Instruction Categories

Token Operations

Transfer2, MintAction, Freeze, Thaw

Account Management

Create, Close token accounts

CToken Operations

Transfer, Approve, Burn, Mint

Discriminator Reference

Compressed Token Operations

Instruction	Discriminator	SPL Compatible
Transfer2	101	No
MintAction	103	No
Freeze	Anchor	No
Thaw	Anchor	No

CToken Account Operations

Instruction	Discriminator	SPL Equivalent
CreateTokenAccount	18	InitializeAccount3
CreateAssociatedTokenAccount	100	-
CreateAssociatedTokenAccountIdempotent	102	-
CloseTokenAccount	9	CloseAccount

CToken Transfer & Approval

Instruction	Discriminator	SPL Equivalent
CTokenTransfer	3	Transfer
CTokenTransferChecked	12	TransferChecked
CTokenApprove	4	Approve
CTokenRevoke	5	Revoke

CToken Mint & Burn

Instruction	Discriminator	SPL Equivalent
CTokenMintTo	7	MintTo
CTokenMintToChecked	14	MintToChecked
CTokenBurn	8	Burn
CTokenBurnChecked	15	BurnChecked

CToken Freeze

Instruction	Discriminator	SPL Equivalent
CTokenFreezeAccount	10	FreezeAccount
CTokenThawAccount	11	ThawAccount

Rent Management

Instruction	Discriminator	SPL Compatible
Claim	104	No
WithdrawFundingPool	105	No

Transfer2

Discriminator: 101
Enum: InstructionType::Transfer2 Batch transfer instruction supporting compress, decompress, and transfer operations.

Instruction Data

pub struct Transfer2InstructionData {
    pub inputs: Vec<CompressedTokenInput>,
    pub output_compressed_accounts: Vec<OutputCompressedAccountData>,
    pub output_state_merkle_tree_account_indices: Vec<u8>,
    pub ctoken_transfers: Vec<CTokenTransfer>,
    pub compress_or_decompress_amounts: Vec<u64>,
    pub compress_or_decompress_token_output_indices: Vec<u8>,
    pub proof: Option<CompressedProof>,
    pub mint: Pubkey,
    pub delegated_transfer: Option<DelegatedTransferData>,
    pub is_compress: bool,
    pub compression_lamports: Option<u64>,
}

inputs

Vec<CompressedTokenInput>

Input compressed token accounts to spend (with Merkle proofs)

output_compressed_accounts

Vec<OutputCompressedAccountData>

Output compressed token accounts to create

ctoken_transfers

Vec<CTokenTransfer>

Transfers between CToken (decompressed) accounts

compress_or_decompress_amounts

Vec<u64>

Amounts to compress or decompress

is_compress

bool

True for compress operations, false for decompress

Operations

Transfer Compressed

Transfer between compressed token accounts.Flow:

Verify inclusion proofs for input accounts
Sum check: inputs = outputs
Insert nullifiers for spent accounts
Insert output account hashes into queue

Compress

Convert CToken account to compressed token.Flow:

Verify CToken account ownership
Burn tokens from CToken account
Create compressed token account
Optionally close CToken account

Decompress

Convert compressed token to CToken account.Flow:

Verify inclusion proof for compressed account
Insert nullifier (spend compressed account)
Mint tokens to CToken account

Example

// Transfer between compressed accounts
let inputs = vec![CompressedTokenInput {
    owner: sender_pubkey,
    amount: 1000,
    delegate_index: None,
    merkle_context: PackedMerkleContext { /* ... */ },
    root_index: 0,
}];

let outputs = vec![OutputCompressedAccountData {
    owner: recipient_pubkey,
    amount: 1000,
    lamports: 0,
}];

let ix_data = Transfer2InstructionData {
    inputs,
    output_compressed_accounts: outputs,
    proof: Some(validity_proof),
    mint: mint_pubkey,
    // ... other fields
};

MintAction

Discriminator: 103
Enum: InstructionType::MintAction Batch instruction for mint management and minting operations.

Actions

Action	Description
CreateCompressedMint	Create new compressed mint
MintTo	Mint compressed tokens
UpdateMintAuthority	Change mint authority
UpdateFreezeAuthority	Change freeze authority
MintToCToken	Mint to CToken account
UpdateMetadataField	Update token metadata
UpdateMetadataAuthority	Change metadata authority
RemoveMetadataKey	Remove metadata field
DecompressMint	Convert to SPL mint
CompressAndCloseCMint	Compress and close mint account

Instruction Data

pub struct MintActionInstructionData {
    pub action: MintAction,
    pub amount: Option<u64>,
    pub new_authority: Option<Pubkey>,
    pub metadata_field: Option<TokenMetadataField>,
    pub proof: Option<CompressedProof>,
}

Example: Mint Tokens

let ix_data = MintActionInstructionData {
    action: MintAction::MintTo,
    amount: Some(1_000_000),
    new_authority: None,
    metadata_field: None,
    proof: None,
};

CToken Instructions

CTokenTransfer

Discriminator: 3
SPL Equivalent: Transfer Transfer tokens between CToken accounts.

pub struct CTokenTransferData {
    pub amount: u64,
}

Accounts:

Source CToken account (mut)
Destination CToken account (mut)
Authority (signer)

CTokenApprove

Discriminator: 4
SPL Equivalent: Approve Approve delegate for CToken account.

pub struct CTokenApproveData {
    pub amount: u64,
}

Accounts:

CToken account (mut)
Delegate
Owner (signer)

CTokenMintTo

Discriminator: 7
SPL Equivalent: MintTo Mint tokens to CToken account.

pub struct CTokenMintToData {
    pub amount: u64,
}

Accounts:

Mint
Destination CToken account (mut)
Mint authority (signer)

CTokenBurn

Discriminator: 8
SPL Equivalent: Burn Burn tokens from CToken account.

pub struct CTokenBurnData {
    pub amount: u64,
}

Accounts:

CToken account (mut)
Mint (mut)
Authority (signer)

Account Management

CreateTokenAccount

Discriminator: 18
SPL Equivalent: InitializeAccount3 Create CToken account.

pub struct CreateTokenAccountData {
    pub owner: Pubkey,
    pub extensions: Option<Vec<ExtensionType>>,
}

CloseTokenAccount

Discriminator: 9
SPL Equivalent: CloseAccount Close CToken account and reclaim rent. Rent distribution:

If compressible: rent → rent recipient
Remaining lamports → destination account

Rent Management

Claim

Discriminator: 104
Enum: InstructionType::Claim Claim rent from expired compressible accounts.

pub struct ClaimInstructionData {
    pub bump: u8,
}

Requirements:

Account must be compressible
Rentability period expired
Rent authority matches

WithdrawFundingPool

Discriminator: 105
Enum: InstructionType::WithdrawFundingPool Withdraw from rent recipient pool.

pub struct WithdrawFundingPoolData {
    pub amount: u64,
    pub bump: u8,
}

Error Codes

Common error codes (30000+ range):

Code	Error	Description
30001	`InsufficientFunds`	Not enough tokens
30002	`InvalidMint`	Wrong mint for operation
30003	`InvalidAuthority`	Authority check failed
30004	`InvalidDelegate`	Delegate check failed
30005	`AccountFrozen`	Account is frozen
30006	`MintHasNoFreezeAuthority`	Mint cannot freeze
30007	`SumCheckFailed`	Inputs != outputs
30008	`InvalidProof`	ZK proof verification failed
30009	`DecompressionError`	Failed to decompress
30010	`CompressionError`	Failed to compress

Best Practices

Always Validate Proofs

Transfer2 requires valid ZK proofs. Never skip proof validation.

Check Sum Constraints

For transfers, verify that total inputs equal total outputs (including fees).

Handle Tree Rollovers

When Merkle trees roll over, update account Merkle context references.

Use Batch Operations

Transfer2 and MintAction support batching. Combine operations for efficiency.

Resources

Program Source

View on GitHub

Instruction Docs

Detailed instruction reference

SDK

TypeScript SDK

Examples

Program examples

Program Libraries

Program Instructions

​Overview

​Instruction Categories

Token Operations

Account Management

CToken Operations

​Discriminator Reference

​Compressed Token Operations

​CToken Account Operations

​CToken Transfer & Approval

​CToken Mint & Burn

​CToken Freeze

​Rent Management

​Transfer2

​Instruction Data

​Operations

​Example

​MintAction

​Actions

​Instruction Data

​Example: Mint Tokens

​CToken Instructions

​CTokenTransfer

​CTokenApprove

​CTokenMintTo

​CTokenBurn

​Account Management

​CreateTokenAccount

​CloseTokenAccount

​Rent Management

​Claim

​WithdrawFundingPool

​Error Codes

​Best Practices

​Resources

Program Source

Instruction Docs

SDK

Examples

Build docs developers (and LLMs) love

Overview

Instruction Categories

Discriminator Reference

Compressed Token Operations

CToken Account Operations

CToken Transfer & Approval

CToken Mint & Burn

CToken Freeze

Rent Management

Transfer2

Instruction Data

Operations

Example

MintAction

Actions

Instruction Data

Example: Mint Tokens

CToken Instructions

CTokenTransfer

CTokenApprove

CTokenMintTo

CTokenBurn

Account Management

CreateTokenAccount

CloseTokenAccount

Rent Management

Claim

WithdrawFundingPool

Error Codes

Best Practices

Resources