@solana/kit · Addresses and PDAs

Solana error #2800009

ADDRESSES__FAILED_TO_FIND_VIABLE_PDA_BUMP_SEED

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

Message

Unable to find a viable program address bump seed.

What it means

Base58 address validation and program derived address derivation.

What to do

  • Addresses must decode to exactly 32 bytes; PDA seeds must be 32 bytes or fewer and at most 16 of them.
  • Use the PDA tool on this site to reproduce the derivation and compare bytes.
@solana/errors 8.4.0 source ↗All Addresses and PDAs codes →

Decode it locally instead

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

Other Addresses and PDAs codes

2800000INVALID_BYTE_LENGTH2800001STRING_LENGTH_OUT_OF_RANGE2800002INVALID_BASE58_ENCODED_ADDRESS2800003INVALID_ED25519_PUBLIC_KEY2800004MALFORMED_PDA2800005PDA_BUMP_SEED_OUT_OF_RANGE2800006MAX_NUMBER_OF_PDA_SEEDS_EXCEEDED2800007MAX_PDA_SEED_LENGTH_EXCEEDED

Decode another error

Try: