FixesUpdated 23 Oct 20261 min read

"Program failed to complete" on Solana: causes

The fix

A program stopped mid-execution, most often because it ran out of compute units or hit an internal limit, without returning a specific error code.

What the error means

Program failed to complete

A program stopped mid-execution, most often because it ran out of compute units or hit an internal limit, without returning a specific error code.

Where it comes fromSolana runtime (instruction error)
CodeProgramFailedToComplete

How to fix it

  1. Raise the compute unit limit (up to 1,400,000 per transaction) and retry.
  2. Reduce the work in one transaction, for example fewer hops in a swap route or fewer accounts.
  3. Read the program logs in a block explorer for the last line before the failure.

If that is not it

More fixes: how to decode any Solana error code and why Solana transactions fail.

Source

Error text and code from Solana SDK transaction and instruction error definitions (anza-xyz/solana-sdk), read on 24 October 2026.

Questions people ask

Is this a bug in my wallet?

Usually not. It is the on-chain program stopping, often from compute limits.

Will retrying help?

Sometimes, especially with a higher compute limit or a simpler route.

"Program failed to complete" on Solana: causes | Jumpbit