@solana/kit · Keys and signatures

Solana error #3704001

KEYS__INVALID_PRIVATE_KEY_BYTE_LENGTH

Appears as Solana error #3704001; Decode this error by running `npx @solana/errors decode -- 3704001 '…'`

Message

Expected private key bytes with length 32. 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

Key pair construction, signature byte lengths and key extractability.

What to do

  • Secret keys are 32 bytes (seed) or 64 bytes (seed + public key); signatures are 64 bytes.
  • Keys created with extractable: false cannot be exported later.
@solana/errors 8.4.0 source ↗All Keys and signatures codes →

Decode it locally instead

npx @solana/errors decode -- 3704001 '<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__KEYS__INVALID_PRIVATE_KEY_BYTE_LENGTH) lets you branch on it.

Other Keys and signatures codes

3704000INVALID_KEY_PAIR_BYTE_LENGTH3704002INVALID_SIGNATURE_BYTE_LENGTH3704003SIGNATURE_STRING_LENGTH_OUT_OF_RANGE3704004PUBLIC_KEY_MUST_MATCH_PRIVATE_KEY3704005INVALID_BASE58_IN_GRIND_REGEX3704006WRITE_KEY_PAIR_UNSUPPORTED_ENVIRONMENT

Decode another error

Try: