Notre avis

Résout les conflits de dépendances de la chaîne d'outils Solana, y compris les incompatibilités de versions entre Anchor, Solana CLI, Rust, les outils de plateforme et GLIBC.

Points forts

Couvre les points de douleur les plus courants du développement Solana
Fournit une matrice de compatibilité pour les combinaisons de versions
Inclut des solutions spécifiques aux erreurs et des guides d'installation
Prend en charge la migration entre les versions majeures d'Anchor

Limites

Nécessite une exécution manuelle des commandes de diagnostic par l'utilisateur
La matrice de compatibilité doit être mise à jour au fur et à mesure des nouvelles versions
Ne résout pas automatiquement les problèmes d'environnement—fournit uniquement des conseils

Quand l'utiliser

À utiliser lors de la configuration d'un nouvel environnement Solana, de la mise à niveau d'Anchor/Solana/Rust, ou lors d'erreurs de compilation avec des conflits de versions.

Quand l'éviter

Évitez si le problème n'est pas lié aux versions de la chaîne d'outils Solana, comme des bugs logiques ou des problèmes réseau.

Exemples

GLIBC error during anchor build

I'm getting a GLIBC error when running anchor build on my Ubuntu 22.04 machine. Can you help me fix it?

Set up a Solana dev environment with specific versions

I need to set up a Solana development environment with Anchor 0.31.1 and Solana CLI 2.1.x. What are the compatible Rust and platform tools versions?

Upgrade Anchor version

I'm migrating from Anchor 0.29 to 0.31. How do I resolve version conflicts with solana-program and cargo build-sbf?

Solana Dependency & Compatibility Resolution

Description

Resolves the notoriously painful Solana toolchain dependency issues — version mismatches between Anchor, Solana CLI, Rust, Platform Tools, GLIBC, and related crates. This is the #1 developer pain point in the Solana ecosystem.

When to Use

Activate this skill when you encounter ANY of these situations:

Setting up a new Solana development environment
Upgrading Anchor, Solana CLI, or Rust versions
Build errors mentioning cargo build-sbf, cargo build-bpf, platform-tools, or rustc versions
GLIBC errors (GLIBC_2.38 not found, GLIBC_2.39 not found)
solana-program crate version conflicts
Anchor IDL generation failures
"No space left on device" during Solana toolchain install
Any error during anchor build, anchor test, or program deployment
Migration between Anchor versions (0.29→0.30→0.31→0.32)
Migration from solana-program-test/bankrun to litesvm

Instructions

Step 1: Diagnose Current Environment

Ask the user to run these commands and share the output:

# Check all versions
rustc --version
solana --version
anchor --version
avm --version
cargo build-sbf --version 2>/dev/null || echo "cargo build-sbf not found"
node --version
yarn --version || npm --version

# Check OS/GLIBC
uname -a
ldd --version 2>&1 | head -1  # Linux only
cat /etc/os-release 2>/dev/null | head -5  # Linux only

# Check Anchor.toml toolchain settings
cat Anchor.toml 2>/dev/null | grep -A5 '\[toolchain\]'

Step 2: Consult the Compatibility Matrix

Refer to compatibility-matrix.md to find the correct version combination for the user's needs.

Step 3: Check Common Errors

If the user has a specific error, check common-errors.md for the exact error message and its fix.

Step 4: Guide Installation

If a fresh install or upgrade is needed, refer to install-guide.md for step-by-step instructions.

Reference Files

compatibility-matrix.md — Full version compatibility tables
common-errors.md — Error message → solution mappings
install-guide.md — Clean install & upgrade procedures

Common Patterns

Quick Version Check

rustc --version && solana --version && anchor --version

Safe Modern Stack (as of Jan 2026)

Anchor 0.31.1+ with Solana CLI 2.1.x, Rust 1.79-1.83, Platform Tools v1.47+
Requires: Ubuntu 24.04+ or macOS 14+ (for GLIBC 2.38+)

Legacy-Compatible Stack

Anchor 0.30.1 with Solana CLI 1.18.x, Rust 1.79.0, Platform Tools v1.43
Works on: Ubuntu 20.04+, macOS 12+

Override Rust for Anchor Build

When AVM installs Anchor < 0.31, it auto-uses rustc 1.79.0 to avoid the Rust 1.80 time crate issue (#3143).

Anchor.toml Toolchain Override

[toolchain]
anchor_version = "0.31.1"
solana_version = "2.1.7"

Résolution des dépendances Solana

Recommandé pour