How do I install the Solana Common Errors skill?

Run npx skillmds add solizardking/solana-common-errors in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Solana Common Errors safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Solana Common Errors?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Solana Common Errors free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Solana Common Errors?

Solizardking (@solizardking) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Solana Common Errors by solizardking

Name: Solana Common Errors
Rating: 4.2 (5 reviews)
Author: Solizardking

Solana Common Errors

Diagnose and fix common Solana development errors — GLIBC mismatches, Anchor version conflicts, cargo build-sbf / platform-tools failures, LiteSVM issues, edition2024 crate pins, RPC airdrops, and Anchor 0.29→0.32 migrations. Use when builds fail, Anchor CLI won't install, or CI breaks on Debian/Ubuntu.

Solizardking c737b58 2 files · 35.7 KB Updated Sep 9, 2026 0 repo stars

File contents

Solana Common Errors & Solutions

Priority skill for Solana program development. When a build, install, test, or IDL step fails, use this skill before guessing.

Full encyclopedia: references/common-errors.md

Quick triage

Symptom	First fix
`GLIBC_2.38/2.39 not found`	Build Anchor from source, use Docker `ubuntu:24.04`, or `avm install X --from-source`
`cargo build-sbf` not found	Install Anza CLI + fix PATH
Platform tools corrupted	`cargo build-sbf --force-tools-install` + free ≥3GB disk
`feature edition2024 is required`	Pin crates (see below) + commit `Cargo.lock`
`litesvm` `__isoc23_strtol`	GLIBC <2.38 → use `solana-bankrun` or Ubuntu 24.04
`ECONNREFUSED ::1:8899`	Use `http://127.0.0.1:8899` / `NODE_OPTIONS=--dns-result-order=ipv4first`
Anchor CLI ≠ anchor-lang	Match versions via AVM + Cargo.toml

edition2024 pins (platform-tools v1.48 / cargo 1.84)

cargo update -p blake3 --precise 1.8.2
cargo update -p constant_time_eq --precise 0.3.1
cargo update -p base64ct --precise 1.7.3
cargo update -p indexmap --precise 2.11.4

Or in Cargo.toml:

blake3 = "=1.8.2"
constant_time_eq = "=0.3.1"
base64ct = "=1.7.3"
indexmap = "=2.11.4"

Install toolchain (safe baseline)

sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"
cargo install --git https://github.com/solana-foundation/anchor avm --force
avm install 0.30.1
avm use 0.30.1

When to read the full reference

Open references/common-errors.md for:

GLIBC / OS matrix
Anchor 0.29 → 0.30 → 0.31 → 0.32 migrations
IDL / proc_macro2 / unexpected_cfgs
LiteSVM vs bankrun
Platform-tools corruption & disk space
Verified Debian 12 test matrix (Jan 2026)

Hub links

Live catalog: https://skills.x402.wtf
Cheshire skills: https://cheshireterminal.ai/skills
Publish your own skill: https://skills.x402.wtf/publish

---name: solana-common-errorsdescription: Diagnose and fix common Solana development errors — GLIBC mismatches, Anchor version conflicts, cargo build-sbf / platform-tools failures, LiteSVM issues, edition2024 crate pins, RPC airdrops, and Anchor 0.29→0.32 migrations. Use when builds fail, Anchor CLI won't install, or CI breaks on Debian/Ubuntu.license: MIT--- # Solana Common Errors & Solutions **Priority skill** for Solana program development. When a build, install, test, or IDL step fails, use this skill before guessing. Full encyclopedia: [references/common-errors.md](./references/common-errors.md) ## Quick triage | Symptom | First fix | |---------|-----------| | `GLIBC_2.38/2.39 not found` | Build Anchor from source, use Docker `ubuntu:24.04`, or `avm install X --from-source` | | `cargo build-sbf` not found | Install Anza CLI + fix PATH | | Platform tools corrupted | `cargo build-sbf --force-tools-install` + free ≥3GB disk | | `feature edition2024 is required` | Pin crates (see below) + commit `Cargo.lock` | | `litesvm` `__isoc23_strtol` | GLIBC <2.38 → use `solana-bankrun` or Ubuntu 24.04 | | `ECONNREFUSED ::1:8899` | Use `http://127.0.0.1:8899` / `NODE_OPTIONS=--dns-result-order=ipv4first` | | Anchor CLI ≠ anchor-lang | Match versions via AVM + Cargo.toml | ## edition2024 pins (platform-tools v1.48 / cargo 1.84) ```bash cargo update -p blake3 --precise 1.8.2 cargo update -p constant_time_eq --precise 0.3.1 cargo update -p base64ct --precise 1.7.3 cargo update -p indexmap --precise 2.11.4 ``` Or in `Cargo.toml`: ```toml blake3 = "=1.8.2" constant_time_eq = "=0.3.1" base64ct = "=1.7.3" indexmap = "=2.11.4" ``` ## Install toolchain (safe baseline) ```bash sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)" export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH" cargo install --git https://github.com/solana-foundation/anchor avm --force avm install 0.30.1 avm use 0.30.1 ``` ## When to read the full reference Open [references/common-errors.md](./references/common-errors.md) for: - GLIBC / OS matrix - Anchor 0.29 → 0.30 → 0.31 → 0.32 migrations - IDL / `proc_macro2` / `unexpected_cfgs` - LiteSVM vs bankrun - Platform-tools corruption & disk space - Verified Debian 12 test matrix (Jan 2026) ## Hub links - Live catalog: https://skills.x402.wtf - Cheshire skills: https://cheshireterminal.ai/skills - Publish your own skill: https://skills.x402.wtf/publish

Frequently asked questions