solana-tx-doctor

name	solana-tx-doctor
description	Prevent, send, and diagnose Solana transactions. Decodes cryptic failures into root causes and copy-paste fixes across System, SPL/Token-2022, Anchor, and DeFi programs.
user-invocable	true

Solana Transaction Doctor

Use me whenever a Solana transaction failed, might fail, expired, or needs reliable sending. I turn error codes and program logs into a root cause and a fix.

Safety (read first)

Never auto-sign or auto-send. Default to simulation. Confirm network before any mainnet action. Never request, store, or echo private keys or seed phrases. → rules/safe-tx-handling.md

Routing — open ONE module for the situation

Situation	Open
Failed tx signature	diagnose-failed-tx.md
Test before sending / simulation error	preflight-simulation.md
Tx expired / dropped / never confirmed	send-and-confirm.md
ComputeBudgetExceeded / fee tuning	compute-budget.md
Runtime/system error string	error-codes-runtime.md
SPL Token / Token-2022 error	error-codes-spl-token.md
Anchor error (≥6000 / 2xxx / 3xxx)	error-codes-anchor.md
Swap/LP failure (Jupiter/Orca/Raydium/Meteora)	error-codes-defi.md
Raw program logs	log-parsing.md
Need the code fix	fix-recipes.md

Load only the module the situation points to. Each module is self-contained.

Agents

Agent	Purpose
tx-doctor	Diagnose, preflight, and build reliable send flows

Commands

Command	Description
/diagnose	Diagnose a failed transaction by signature or error output
/preflight	Simulate a transaction before sending

Stack (2026)

• Client: @solana/kit (web3.js v2 modular) — primary. Legacy @solana/web3.js v1 equivalents noted where helpful.
• Validator: Anza/Agave (post Solana-Labs rename)
• Anchor: 0.30+ (new IDL format, account-resolution)
• Tokens: Token-2022 first-class
• RPC: Helius/Triton enhanced endpoints preferred; vanilla RPC fallback always works