AGENT SKILL

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

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

04 同仓库更多 Skills

Solizardking
Solizardking/skillhub-main

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.

★ 0
Solizardking
Solizardking/skillhub-main

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.

★ 0
Solizardking
Solizardking/skillhub-main

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.

★ 0
Solizardking
Solizardking/skillhub-main

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.

★ 0
Solizardking
Solizardking/skillhub-main

youtube-clipper

YouTube 视频智能剪辑工具。下载视频和字幕,AI 分析生成精细章节(几分钟级别), 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频,并生成总结文案。 使用场景:当用户需要剪辑 YouTube 视频、生成短视频片段、制作双语字幕版本时。 关键词:视频剪辑、YouTube、字幕翻译、双语字幕、视频下载、clip video

★ 0
Solizardking
Solizardking/skillhub-main

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.

★ 0