build-program

You are building a Solana program. Follow these steps:

Related Skills

• programs/anchor.md - Anchor build patterns
• programs/pinocchio.md - Pinocchio build optimization

Step 1: Identify Program Type

Check which framework is being used:

# Check for Anchor
if [ -f "Anchor.toml" ]; then
    echo "Anchor program detected"
fi

# Check for Cargo
if [ -f "Cargo.toml" ]; then
    echo "Native Rust program detected"
fi

Step 2: Build Program

For Anchor Programs

# Clean build
anchor clean
anchor build

# Build specific program
anchor build -p program-name

# Build with verifiable build
anchor build --verifiable

# Check build output
ls -lh target/deploy/*.so

For Native Rust Programs

# Build BPF program
cargo build-sbf

# Build with specific BPF SDK
cargo build-sbf --bpf-sdk /path/to/bpf-sdk

# Check output
ls -lh target/deploy/*.so

Step 3: Verify Build

# Check program size (should be < 400KB ideally)
ls -lh target/deploy/*.so | awk '{print $5, $9}'

# Verify program ID
solana address -k target/deploy/program-keypair.json

# If Anchor, verify IDL generated
ls -lh target/idl/*.json

Step 4: Run Format and Lint

After successful build:

# Format code
cargo fmt

# Run clippy
cargo clippy -- -W clippy::all

# Check for warnings
cargo clippy --all-targets --all-features -- -D warnings

Common Build Issues

Compilation Errors

• Check Rust version: rustc --version (need 1.79+)
• Update dependencies: cargo update
• Clean and rebuild: anchor clean && anchor build

Binary Size Too Large

# Check current size
ls -lh target/deploy/*.so

# Optimize in Cargo.toml:
# [profile.release]
# opt-level = "z"
# lto = "fat"
# codegen-units = 1

Missing Dependencies

# For Anchor
npm install

# For Rust
cargo fetch

BPF SDK Issues

# Update Solana CLI
agave-install update

# Reinstall BPF SDK
cargo build-sbf --force-tools-install