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.
- License 许可
- MIT
- 最近更新
- 2026-11-02
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- solana-common-errors
- license
- MIT
- version
- 1.0.0
- metadata
- { "author": "cheshire-terminal", "aliases": [ "common-errors", "anchor-errors", "glibc-solana" ], "version": "1.0.0", "category": "Solana / Blockchain", "homepage": "https://skills.x402.wtf/api/skills/solana-common-errors/SKILL.md", "priority": "critical" }
- description
- 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.
- compatibility
- Anchor 0.30–0.32, Solana CLI 2.x, Node 18+, Linux/macOS
02 资源文件 1
- 参考文档references/common-errors.md33.2 KB
03 SKILL.md 正文
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
04 同仓库更多 Skills
youtube-clipper
YouTube 视频智能剪辑工具。下载视频和字幕,AI 分析生成精细章节(几分钟级别), 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频,并生成总结文案。 使用场景:当用户需要剪辑 YouTube 视频、生成短视频片段、制作双语字幕版本时。 关键词:视频剪辑、YouTube、字幕翻译、双语字幕、视频下载、clip video
viem-integration
Integrate EVM blockchains using viem. Use when user says "read blockchain data", "send transaction", "interact with smart contract", "connect to Ethereum", "use viem", "use wagmi", "wallet integration", "viem setup", or mentions blockchain/EVM development with TypeScript.
v4-security-foundations
Security-first Uniswap v4 hook development. Use when user mentions "v4 hooks", "hook security", "PoolManager", "beforeSwap", "afterSwap", or asks about V4 hook best practices, vulnerabilities, or audit requirements.
v4-sdk-integration
App-layer SDK guide for building swap and liquidity experiences directly with the Uniswap v4 SDK. Use when user asks about "v4 sdk", "uniswap v4", "v4 swap", "v4 liquidity", "PoolManager", "V4Planner", "StateView", "PositionManager", "pool state", "v4 position", "uniswap sdk", or when building swap/liquidity UX directly with SDKs rather than via the Trading API.
v4-hook-generator
Generate Uniswap v4 hook contracts via OpenZeppelin MCP. Use when building custom swap logic, async swaps, hook-owned liquidity, custom curves, dynamic fees, MEV protection, limit orders, or oracle hooks.
testing
For testing with Light Protocol programs and clients on localnet, devnet, and mainnet validation.