in-solana by Supanode

Solana Error Codes & Fixes

Search by error text to find causes, fixes and prevention.

Transaction simulation failed: Blockhash not found

Fix the Blockhash not found error when simulating or sending Solana transactions.

Invalid param: could not find account

Fix the 'could not find account' RPC error when querying a nonexistent Solana account.

This transaction has already been processed

Understand the 'already processed' transaction error on Solana — it means the transaction succeeded earlier.

Attempt to debit an account but found no record of a prior credit

Fix the 'no record of a prior credit' error when trying to transfer from a nonexistent Solana account.

custom program error: 0x1

Fix the custom program error 0x1 on Solana — usually means insufficient funds or invalid input in SPL programs.

TransactionExpiredBlockheightExceededError: block height exceeded

Fix the block height exceeded error when your Solana transaction expires before confirmation.

Computational budget exceeded

Fix the compute budget exceeded error when a Solana transaction uses more compute units than allocated.

getProgramAccounts request timed out

Fix getProgramAccounts timeouts on Solana RPC — use filters, dedicated nodes, or alternative approaches.

Transaction results in an account with insufficient funds for rent

Fix the insufficient funds for rent error when creating or modifying Solana accounts.

Insufficient funds for fee

Fix the insufficient funds for fee error when the Solana fee payer cannot cover the transaction fee.

Node is behind by N slots

Fix the 'Node is behind' health check warning when a Solana RPC node is lagging behind the cluster.

Signature verification failed

Fix signature verification errors when a Solana transaction has missing or invalid signatures.

429 Too Many Requests

Fix the 429 Too Many Requests rate limit error from Solana RPC providers and public endpoints.

Transaction was not confirmed in 30.00 seconds

Fix the 30-second confirmation timeout when sending Solana transactions.

Transaction not landing

Why Solana transactions get dropped and how to improve landing rate with priority fees, retries, and infrastructure.

Transaction too large

Fix the transaction too large error when a Solana transaction exceeds the 1232-byte size limit.

WebSocket connection closed abnormally (1006)

Fix WebSocket 1006 abnormal closure errors on Solana — reconnection strategies, keep-alive pings, and provider limits.

AccountInUse

Fix the AccountInUse error when a transaction tries to lock an account already in use by another transaction.

Transaction loads an address table account that doesn't exist

Fix the error when a Solana transaction references an Address Lookup Table that does not exist on-chain.

Anchor constraint errors

Understand and fix Anchor framework constraint validation errors in the 2000–2999 range on Solana.

WouldExceedMaxBlockCostLimit

Fix WouldExceedMaxBlockCostLimit and account cost limit errors when Solana blocks are at compute capacity.

Block not available for slot

Fix the Block not available for slot error when querying old or skipped slots on Solana RPC.

AccountNotInitialized

Fix the Anchor AccountNotInitialized error (3012) when a program expects an initialized account.

custom program error: 0x0

Understand and fix the custom program error: 0x0 in Solana transactions. Maps to error code 0 in the program's error enum.

Duplicate signer

Fix the Duplicate signer error when the same account appears twice in a Solana transaction's signer list.

IncorrectProgramId

Fix the IncorrectProgramId error when a transaction passes the wrong program ID for an account's owner.

InvalidAccountData for instruction

Fix InvalidAccountData when a Solana program receives an account with unexpected data layout or size.

InvalidRentPayingAccount

Fix InvalidRentPayingAccount when a new account is created without enough SOL for rent exemption.

InvalidWritableAccount

Fix InvalidWritableAccount when a transaction marks a read-only account as writable.

Bundle not landed

Fix Jito bundles that fail to land, get dropped, or time out on Solana mainnet.

Slippage tolerance exceeded

Fix the Jupiter swap slippage tolerance exceeded error when token prices move during transaction execution.

Slot has been skipped, or missing in long-term storage

Fix the -32009 error when a Solana RPC node has pruned the block data for the requested slot.

Method not found

Fix the JSON-RPC Method not found error (-32601) when calling a Solana RPC endpoint.

MaxLoadedAccountsDataSizeExceeded

Fix MaxLoadedAccountsDataSizeExceeded when a Solana transaction loads too much account data.

Owner does not match

Fix the Owner does not match error when a token operation is signed by the wrong wallet.

Program failed to complete

Fix the Program failed to complete error caused by exceeding the compute unit limit on Solana.

Slot was skipped, or missing in long-term storage

Understand why Solana returns Slot was skipped (-32007) and how to handle missing slots in your application.

Token account not initialized

Fix UninitializedAccount and token account not initialized errors when interacting with SPL Token accounts.

Transaction history is not available from this node

Fix the -32011 error when querying transaction history from a Solana RPC node without full history.

Transaction version (0) is not supported

Fix the error when an RPC node or wallet does not support versioned transactions (v0).

WebSocket subscription silently stops receiving updates

Fix Solana WebSocket subscriptions that silently stop receiving updates without an error or close event.