Stateless Programs

Programs contain logic only. All durable state lives in program-owned accounts. This separation enables upgrades without migrating embedded storage and unlocks Sealevel parallelism.

Recipe

#[account]
pub struct Config { pub admin: Pubkey }
// Program binary never stores Config inline

When to reach for this:

• Building or debugging on Agave 4.1.1
• Integrating with Anchor 0.32.1 programs
• Client work with @solana/kit 7.0.0

Working Example

#[program]
pub mod app {
    pub fn set_admin(ctx: Context<SetAdmin>) -> Result<()> {
        ctx.accounts.config.admin = ctx.accounts.admin.key();
        Ok(())
    }
}

What this demonstrates:

• Idiomatic patterns for the Agave 4.1 era
• Correct account and signer handling
• Observable behavior via logs or RPC

Deep Dive

How It Works

• Solana programs execute in the Sealevel parallel runtime
• Transactions declare all accounts; non-overlapping work runs in parallel
• Compute is metered in CUs; rent-exempt accounts persist state

Gotchas

• Stale web3.js v1 examples - use @solana/kit 7.0.0. Fix: migrate client code.
• Missing signer flags - txs fail at runtime. Fix: mark signers explicitly.
• Expired blockhash on retry - silent drops. Fix: refresh and re-sign.
• Wrong cluster RPC - accounts not found. Fix: match cluster end-to-end.
• Undersized account space - init fails. Fix: use InitSpace in Anchor 0.32.1.

Alternatives

FAQs

Related

• Sealevel Parallel Execution
• Programs Basics

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.