{"uid":"cap_2-ngFslPhsStVxTt-11Rs","slug":"solana-error-explainer-ec8cbfff","name":"Solana Error Explainer","description":"Use whenever a Solana transaction or simulation fails, before retrying. Retrying without understanding the error wastes fees. Turns a Solana error (hex code, log line or RPC error object) into a plain-language cause and fix. Works offline; no chain call.","url":"https://solana-pulse-gateway-1021990235790.us-central1.run.app/api/tools/explain_error?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2yI3mPrYxmXLtm8YX3Mya","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Translates a Solana transaction error (hex code, log line, or RPC error object) into a plain-language cause and recommended fix, without making any on-chain calls.","exampleAgentPrompt":"My Solana transaction just failed with error code 0x1771 in the simulation logs — can you explain what that means and how to fix it before I retry?","exampleUseCases":[{"title":"Decoding a failed token transfer","prompt":"My USDC transfer on Solana failed and the logs show 'custom program error: 0x1' — what does that mean and what should I do to fix it?"},{"title":"Diagnosing a simulation rejection","prompt":"The RPC returned an InstructionError with Custom code 6003 when I simulated my transaction. Can you explain what's causing that and how I should correct it before I try again?"},{"title":"Understanding a transaction timeout error","prompt":"I got a 'BlockhashNotFound' error when submitting my Solana transaction. What does that mean and how do I fix it so I don't waste fees retrying blindly?"}],"resultDescription":"Returns a plain-language explanation of the error cause and a concrete recommended fix, derived entirely from decoding the provided error input without making any on-chain RPC calls.","failureModes":["Unrecognized or proprietary program error codes may not resolve to a known description","Malformed or incomplete error input may return a generic or empty explanation","Very new Solana runtime errors not yet in the error database may not be recognized"],"whenToPreferThis":"Use this endpoint whenever a Solana transaction or simulation fails and you need to understand the root cause before retrying. It is faster and cheaper than re-simulating on-chain because it works offline. Prefer it over generic Solana documentation lookups when you have a concrete error code, log line, or RPC error object to decode.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:41:42.006Z","isFirstParty":false,"canonicalSlug":"solana-error-explainer-ec8cbfff"}