solanabr

Debug User Tx — Development skill for Claude Code

Development community

Replay a user's failing transaction on forked state and map the error to source.

How to install Debug User Tx

Installs to ~/.claude/commands/solanabr-ai-kit-debug-user-tx.md

Terminal
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/solanabr/ai-kit/HEAD/.claude/commands/debug-user-tx.md -o ~/.claude/commands/solanabr-ai-kit-debug-user-tx.md

Restart Claude Code, or start a new session, for it to be picked up.

What Debug User Tx does


description: "Replay a user's failing transaction on forked state and map the error to source"

Debug the failing transaction described in $ARGUMENTS. The answer the developer needs is where in this repo it failed: the handler, constraint or `require!` with `file:line`, why it failed, and a fix. References: [testing.md](../skills/ext/solana-dev/skills/solana-dev/references/testing.md) (LiteSVM, Surfpool), [surfpool/cheatcodes.md](../skills/ext/solana-dev/skills/solana-dev/references/surf

Alternatives in Development

  • Claude Code Source — claude code source map v2.1.88 757 ★
  • Cloud Run Debug — Diagnose a failing Cloud Run service — Antigravity (agy/Gemini) digests the error logs cheaply, Claude infers 284 ★
  • Gov Backlinks — Free .gov backlinks - drive the user's browser through SAM.gov, the SBA small business listing, and state vend 195 ★

Full documentation available on GitHub

View Source Repository