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-10-08
- Stars
- ★ 0
- Forks
- 0
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
zkrouter
Self-hosted OpenAI-compatible LLM router — smart tier-based routing, ZK-stamped routing decisions, mode overrides, free OpenRouter at install via the Birth bot. Save 60-80% on inference costs by routing to the cheapest capable model across 12+ OpenRouter models.
zk
For custom ZK Solana programs and privacy-preserving applications to prevent double spending. Guide to integrate rent-free nullifier PDAs for double-spend prevention.
zk-omni-messaging
Zero-knowledge omnichain messaging between Robinhood Chain and Solana using CheshireZkOmniMessenger (msgType 4) with nullifier anti-replay and the zk-omni-relayer service.
zerion-wallet-data
Use when the user asks to check a wallet's portfolio, token balances, DeFi positions, PnL, transaction history, or NFTs. Provides interpreted on-chain data across 40+ EVM chains and Solana via x402 pay-per-request or API key — no raw RPC decoding needed.
youtube-clipper
YouTube 视频智能剪辑工具。下载视频和字幕,AI 分析生成精细章节(几分钟级别), 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频,并生成总结文案。 使用场景:当用户需要剪辑 YouTube 视频、生成短视频片段、制作双语字幕版本时。 关键词:视频剪辑、YouTube、字幕翻译、双语字幕、视频下载、clip video
yield-optimization
Multi-chain yield optimization via yield.xyz (StakeKit). Discover 2,988+ yield opportunities across 75+ blockchains, build deposit/withdrawal transactions with shell scripts, and sign them with a MoonPay wallet. Use when the user wants to earn yield, find the best lending or staking rate, enter/exit a position, or check portfolio balances.