Solana error codes › 0x4

custom program error: 0x4 (4)

0x4 is decimal 4. Its meaning depends on the program that failed: InvalidCoinVault in Raydium AMM V4, MaxSeedLengthExceeded in System Program, OwnerMismatch in SPL Token and 5 more below.

Small numbers like this are used by native programs (System, SPL Token, Token-2022, Raydium AMM v4 and others), each with its own list, so the meaning depends on which program failed.

SPL Token: OwnerMismatch

The signer is not the owner (or approved delegate) of the token account being debited.

What to do: Sign with the token account's owner, or pass the right token account for the signing wallet.

Token-2022: OwnerMismatch

The signer is not the owner (or approved delegate) of the token account being debited.

What to do: Sign with the token account's owner, or pass the right token account for the signing wallet.

0x4 by program

ProgramError
Raydium AMM V4InvalidCoinVault
System ProgramMaxSeedLengthExceeded
Length of requested seed is too long.
SPL TokenOwnerMismatch
Owner does not match
The signer is not the owner (or approved delegate) of the token account being debited.
Token-2022OwnerMismatch
Owner does not match
The signer is not the owner (or approved delegate) of the token account being debited.
Metaplex NFT PacksCardShouldntHaveProbabilityValue
Cards for this pack shouldn't have probability value
Metaplex Token MetadataUninitialized
The name points to account state: an account was expected to exist (or not exist) already.
PhoenixMarketUninitialized
Market is not initialized error
The name points to account state: an account was expected to exist (or not exist) already.
SPL Token SwapExpectedMint
Deserialized account is not an SPL Token mint

Same code, other formats

custom program error: 0x4 · {"Custom":4} · Custom(4) · Error Number: 4

How to tell which program failed

  1. Open the failed transaction in an explorer (or the simulation result in your code) and read the program logs.
  2. Find the line Program <address> failed: custom program error: 0x…. If several programs failed with the same code, the first one listed is the deepest call, the one that raised it.
  3. Look the code up for that program. Error processing Instruction 2 is a zero-based index, so it points to the third instruction (often the first one after two Compute Budget instructions).

Decode your exact error

Free, no sign-up, nothing to connect. Works offline from a bundled list; we do not look anything up on-chain.

Swapping a token you do not know? A free Rugsight check shows mint and freeze authority, Token-2022 extensions, holder concentration and liquidity before you trade.

← 0x3 · 0x5 → · All Solana error codes

Data: program error lists from published IDLs (solana-idls 1.2.1, MIT) and the System, SPL Token, Token-2022 and Associated Token Account source code, snapshot 2026-11-16. Programs can be upgraded and add or change errors; the failing program's current IDL is the final word.