@solana/kit · General
Solana error #4
BLOCKHASH_STRING_LENGTH_OUT_OF_RANGE
Appears as Solana error #4; Decode this error by running `npx @solana/errors decode -- 4 '…'`
Message
Expected base58-encoded blockhash string of length in the range [32, 44]. Actual length: $actualLength.
Placeholders (actualLength) are filled from the error’s context. Paste the base64 argument below to see the real values.
What it means
Early, uncategorised errors: blockhash expiry, nonces, number parsing, and failures to send or sign.
What to do
- Most of these come from transaction lifecycle helpers. Check the blockhash or nonce you built the transaction with, then the signer and RPC you used to send it.
Decode it locally instead
npx @solana/errors decode -- 4 '<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__BLOCKHASH_STRING_LENGTH_OUT_OF_RANGE) lets you branch on it.