• ERROR
  • STATE
  • LOGS
  • HUMAN

How to debug failed Solana transactions with your AI

Connect SolanaFM to your AI client to turn cryptic error logs into clear explanations. Your agent handles the heavy lifting of scanning the blockchain for you.

Ask AI about this page

Short answer

Why did my Solana transaction fail?

Give your AI the transaction signature, and it will pull the transaction data and relevant account states to find the error. You'll get a breakdown of the failure reason, from insufficient funds to instruction mismatches.

Where your results land.

The outcomes of your analysis.

The AI categorizes the data it finds into actionable insights.

ERROR

Root cause identified

The AI uses transaction data to pinpoint the exact instruction or logic error that caused the revert.

STATE

Account state analysis

Your agent checks the current balances and data of involved accounts to see if they met the transaction requirements.

LOGS

Program log summary

The AI parses through the Solana program logs to translate technical error codes into plain English.

HUMAN

Manual intervention needed

If the failure is due to external factors like slippage or network congestion, the AI flags it for you to handle manually.

The workflow

What your AI does when a signature is provided.

Your agent acts as a bridge between the blockchain and your chat window.

  1. Fetch transaction details

    The AI pulls the full transaction history and event logs for the specific signature you provided.

    get_transaction

  2. Inspect account data

    It looks up the current state of every account involved in the failed call to check for discrepancies.

    get_account_info

  3. Analyze failure reason

    The agent compares the transaction logs against the account states to find the mismatch.

    get_transaction

  4. Report findings

    The AI summarizes the technical error and suggests what to change in your next attempt.

    get_account_info

Try it

Copy these to start.

Use these prompts to kick off the debugging process.

Starting points

Replace the transaction signatures and wallet addresses with your actual data.

SolanaFM Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_1EprSAIkH5bcouuKmaxigrvVTNhlcwOgFFqM3i0r/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — SolanaFM capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "solanafm-solana-fm-block-explorer-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_1EprSAIkH5bcouuKmaxigrvVTNhlcwOgFFqM3i0r/mcp"
    }
  }
}
Copy into chat04

  • Explain why this transaction failed: [signature]

  • Check the account state for [address] and tell me if it has enough SOL for this transaction.

  • Look at the logs for [signature] and tell me which instruction caused the revert.

  • Compare the account info for [address] with the requirements in this transaction: [signature]

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect SolanaFM once, then ask.

Just link your account once. Your credentials stay encrypted, and you can immediately start debugging in your preferred AI client.

Connect SolanaFM to your AI

FAQ

How this task behaves

  • 01

    Can the AI fix the transaction for me?

    No. The AI can only read data and explain what went wrong. You must manually resubmit corrected transactions.

  • 02

    Does the AI need my private keys?

    No. The AI only uses the tools to read public blockchain data. It never needs or asks for your private keys.

  • 03

    Can it analyze failed transactions from other chains?

    No. This specific connector is built for the Solana blockchain.

  • 04

    Can the AI execute a transaction to recover funds?

    No. The available tools are strictly for reading transaction and account information.

  • 05

    Will it work with any AI client?

    Yes, as long as the client supports the Model Context Protocol (MCP).

  • More questions about SolanaFM? The Connector page answers them. See everything the SolanaFM Connector can do

Connect SolanaFM to Claude, Cursor, ChatGPT & more