Skip to content

solana-tx-debugger-skill as external skill submodule#29

Open
thesithunyein wants to merge 5 commits into
solanabr:mainfrom
thesithunyein:main
Open

solana-tx-debugger-skill as external skill submodule#29
thesithunyein wants to merge 5 commits into
solanabr:mainfrom
thesithunyein:main

Conversation

@thesithunyein

@thesithunyein thesithunyein commented Jun 21, 2026

Copy link
Copy Markdown

What

Adds solana-tx-debugger-skill as a new external skill submodule under ext/solana-tx-debugger.

Why

Failed Solana transactions are the #1 developer pain point — opaque error codes, nested CPI failures, compute budget exhaustion, and ALT/versioned tx issues are hard to diagnose without deep program knowledge. This skill gives Claude Code the domain expertise to:

  • Decode the real error models: Anchor framework codes (constraints 2000+, accounts 3000+) and user-defined #[error_code] errors starting at 6000 — plus SPL Token, Token-2022, and System program enums
  • Identify root cause from program logs, CPI depth, and compute usage
  • Prescribe concrete fixes with runnable code snippets (22+ real-world recipes)
  • Guide compute budget optimization, ALT creation, and pre-send simulation

Accuracy

Error codes are verified against the actual program enums (anchor_lang::error::ErrorCode, spl_token::error::TokenError, System SystemError) — including the common pitfall that Anchor uses no 0x1000 offset. The same decoding engine powers the live demo, so reviewers can verify accuracy in-browser.

Structure

Follows the same progressive markdown structure as solana-game-skill:

  • skill/SKILL.md — entry point with routing to 8 sub-skills
  • skill/recipes.md — 22+ error → cause → fix recipes (the core differentiator)
  • agents/tx-debugger.md — agent persona
  • commands/debug-tx.md — /debug-tx <signature> command
  • install.sh / install-custom.sh — standard install scripts

Demo

Live demo: solana-explainer.vercel.app

License

MIT

@vercel

vercel Bot commented Jun 21, 2026

Copy link
Copy Markdown

@thesithunyein is attempting to deploy a commit to the STBR TRUE Team on Vercel.

A member of the Team first needs to authorize it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant