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.