Recipes and errors
Common errors and how to fix them
Symptom, cause and fix for the errors everyone hits in week one.
| Symptom | Cause | Fix |
|---|---|---|
429 Too Many Requests |
Public RPC | Your Triton endpoint |
Attempt to debit an account but found no record of a prior credit |
The wallet has no SOL on that network | solana airdrop 2; check solana config get |
Blockhash not found |
Stale blockhash (older than ~60–90 s) | Fetch a fresh one right before signing |
custom program error: 0x... |
An error from a program — not always yours | Check the logs for which program failed: if it is yours, the code is in the IDL; if it is one you called by CPI (SPL Token, etc.), look it up in that program's |
anchor build fails on versions |
Incompatible toolchain | avm use <the version in your Anchor.toml>; rustup update; anchor clean — do not delete target/ by hand: the program keypair lives there; the skill's version matrix |
declare_id does not match the deployed program |
The program keypair changed or is missing | anchor keys sync; recover target/deploy/<program>-keypair.json from the team |
| GLIBC error on install | Binaries for a different libc | Build from source or use Anchor's Docker image |
| Deploy asks for more SOL than you have | Program rent, proportional to binary size | More airdrops; strip debug msg! and dependencies you do not use, then measure again |
Transaction too large |
Too many accounts/instructions | Address Lookup Tables or a v1 transaction |
| The extension does not show up in the demo | Wallet Standard with no provider | Embedded wallet, or leave Phantom connected beforehand |
The model writes Connection, PublicKey, wallet-adapter |
No current context | Solana MCP + solana-dev-skill; pin versions in the prompt |
More: the Common Errors & Solutions skill in solana-dev-skill and solana.stackexchange.com.