troubleshoot-errors

| Contract Errors | Assert failures, opcode budget, invalid operations | contract-errors.md | | Transaction Errors | Overspend, invalid params, group issues | transaction-errors.md |

Cause: An assert statement in the smart contract evaluated to false.

Cause: Sender account has insufficient balance for amount + fee.

Diagnose and fix common Algorand errors including smart contract failures, transaction rejections, and SDK exceptions. Use when encountering smart contract logic errors or assertion failures, transaction rejections or confirmation timeouts, SDK exceptions (AlgodHTTPError, LogicError), account-related errors (insufficient balance, not opted in), or ABI encoding/decoding errors. Strong triggers include "logic eval error", "assert failed", "overspend", "transaction rejected", "pc=X" in error messages, "opcode budget exceeded", "account not found", "asset not found". Source: algorand-devrel/algorand-agent-skills.