@solana/kit · Instruction shape

Solana error #4128002

INSTRUCTION__PROGRAM_ID_MISMATCH

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

Message

Expected instruction to have progress address $expectedProgramAddress, got $actualProgramAddress.

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

What it means

An instruction object is missing data, accounts or the expected program address.

What to do

  • Compare the instruction with the program client's generated builder; pass the program address and all required accounts.

Decode it locally instead

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

Decode another error

Try: