@solana/kit · Program clients

Solana error #8500002

PROGRAM_CLIENTS__FAILED_TO_IDENTIFY_INSTRUCTION

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

Message

The provided instruction could not be identified as an instruction from the $programName program.

Placeholders (programName) are filled from the error’s context. Paste the base64 argument below to see the real values.

What it means

Generated program clients: unknown instruction or account discriminators, wrong program address.

What to do

  • Make sure the client matches the deployed program version and that you are calling the right program address.
@solana/errors 8.4.0 source ↗All Program clients codes →

Decode it locally instead

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

Other Program clients codes

8500000INSUFFICIENT_ACCOUNT_METAS8500001UNRECOGNIZED_INSTRUCTION_TYPE8500003UNEXPECTED_RESOLVED_INSTRUCTION_INPUT_TYPE8500004RESOLVED_INSTRUCTION_INPUT_MUST_BE_NON_NULL8500005UNRECOGNIZED_ACCOUNT_TYPE8500006FAILED_TO_IDENTIFY_ACCOUNT8500007RESOLVED_INSTRUCTION_INPUT_MUST_BE_SIGNER

Decode another error

Try: