@solana/kit · Transaction building
Solana error #5663004
TRANSACTION__VERSION_NUMBER_OUT_OF_RANGE
Appears as Solana error #5663004; Decode this error by running `npx @solana/errors decode -- 5663004 '…'`
Message
Transaction version must be in the range [0, 127]. `$actualVersion` given
Placeholders (actualVersion) are filled from the error’s context. Paste the base64 argument below to see the real values.
What it means
Assembling, compiling, signing and size-checking transaction messages.
What to do
- Set a fee payer and a lifetime (blockhash or durable nonce) before compiling.
- Keep the serialised transaction at or under 1,232 bytes; use address lookup tables for large transactions.
- A durable-nonce transaction must have
AdvanceNonceAccount as its first instruction.
Decode it locally instead
npx @solana/errors decode -- 5663004 '<base64 context>'
In development, import from @solana/kit as usual and the full message is thrown. In production the message is stripped to keep bundles small; the error object still carries error.context with the same values this page decodes, and isSolanaError(err, SOLANA_ERROR__TRANSACTION__VERSION_NUMBER_OUT_OF_RANGE) lets you branch on it.