@solana/kit · Transaction errors (on-chain)

Solana error #7050036

TRANSACTION_ERROR__UNBALANCED_TRANSACTION

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

Message

Sum of account balances before and after transaction do not match

What it means

Kit's typed wrappers around the runtime's TransactionError variants, such as blockhash not found or insufficient funds for fee.

What to do

  • These happen before any instruction runs. See the linked legacy page for causes and fixes.

This wraps the on-chain error UnbalancedTransaction, which has its own page with causes and fixes.

@solana/errors 8.4.0 source ↗All Transaction errors (on-chain) codes →

Decode it locally instead

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

Other Transaction errors (on-chain) codes

7050000UNKNOWN7050001ACCOUNT_IN_USE7050002ACCOUNT_LOADED_TWICE7050003ACCOUNT_NOT_FOUND7050004PROGRAM_ACCOUNT_NOT_FOUND7050005INSUFFICIENT_FUNDS_FOR_FEE7050006INVALID_ACCOUNT_FOR_FEE7050007ALREADY_PROCESSED

Decode another error

Try: