Token & Associated Token Constraints

anchor-spl provides constraint helpers for SPL Token and Associated Token accounts, reducing manual mint/authority checks.

Recipe

init_if_needed (used by both ATA examples below) is gated behind a cargo feature. Without it neither snippet compiles:

[dependencies]
anchor-lang = { version = "0.32.1", features = ["init-if-needed"] }

use anchor_spl::associated_token::AssociatedToken;
use anchor_spl::token::{Mint, Token, TokenAccount};
 
#[account(
    init_if_needed,
    payer = payer,
    associated_token::mint = mint,
    associated_token::authority = owner,
)]
pub ata: Account<'info, TokenAccount>,

When to reach for this: Instructions move tokens or create ATAs.

Working Example

#[derive(Accounts)]
pub struct TransferTokens<'info> {
    #[account(mut)]
    pub payer: Signer<'info>,
    #[account(mut)]
    pub from: Account<'info, TokenAccount>,
    #[account(
        init_if_needed,
        payer = payer,
        associated_token::mint = mint,
        associated_token::authority = recipient,
    )]
    pub to: Account<'info, TokenAccount>,
    pub mint: Account<'info, Mint>,
    pub recipient: SystemAccount<'info>,
    pub token_program: Program<'info, Token>,
    pub associated_token_program: Program<'info, AssociatedToken>,
    pub system_program: Program<'info, System>,
}

What this demonstrates:

• associated_token::mint ties ATA to mint
• associated_token::authority sets owner
• Token program must be in accounts list
• Use token_interface for Token-2022

Deep Dive

Token-2022 / Interface

For Token-2022, use InterfaceAccount and TokenInterface. These types come from anchor_spl::token_interface, not anchor_spl::token — anchor_spl::token::Mint is the legacy-Token-only type and its owner check rejects Token-2022 mints:

use anchor_spl::token_interface::{Mint, TokenAccount, TokenInterface};
 
pub token_program: Interface<'info, TokenInterface>,
pub mint: InterfaceAccount<'info, Mint>,
#[account(mut)]
pub token_account: InterfaceAccount<'info, TokenAccount>,

anchor_spl::token_interface mirrors anchor_spl::token with interface-aware types; pick one module per program and don't mix the two Mint types.

Gotchas

• Wrong token program ID - Constraint fails for Token-2022. Fix: Use Interface when supporting both.
• ATA init without system program - Creation CPI incomplete. Fix: Include system + associated token programs.
• Mint mismatch on transfer - Token program rejects. Fix: Add constraint = from.mint == mint.key().
• Unchecked recipient ATA - Funds sent to wrong ATA. Fix: Use associated_token constraints.
• Missing mut on token accounts - Transfer fails. Fix: Mark source and dest mut.

Alternatives

FAQs

Related

• SPL Token CPIs - transfer helpers
• Associated Token Accounts - ATA model
• anchor-lang & anchor-spl - crate overview

Stack versions: This page was written for Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0, and LiteSVM 0.6.x.

3730363230327c3934336f6967637c6f692e73656469756765646f63