Match the substring you see to the fix. Fuller explanations live in
troubleshooting/.
| Error substring | Meaning | Fix |
|---|---|---|
account sequence mismatch |
Two txs from one key before the first landed | One tx per key at a time; wait ~6s (one block). Never run two *-compute jobs on one key. |
out of gas |
Missing/low gas, or estimate exceeded the meter | Always pass --gas auto --gas-adjustment 1.5. Free gameplay txs still need it. |
insufficient funds / fee |
Tx fell off the free path (mixed modules) | Keep a tx purely Structs; don’t mix bank/gov messages. See transactions. |
unknown command / unknown flag |
Wrong CLI name or an ID parsed as a flag | Check the command name; put -- before entity IDs (... -- 4-5). See conventions. |
not online / power / capacity |
You’re offline (load > capacity) | Offline card. |
not onStation / fleet |
Fleet must be on station to build/act there | Move the fleet and verify status before committing. |
no available slots |
Planet/ambit slot full | Free a slot or build elsewhere. See building. |
| shield / raid completion rejected | Command Ship back online — shields not vulnerable | Re-scout; only raid when shields are vulnerable. failed compute. |
| broadcast ok but nothing changed | Broadcast ≠ success; a precondition failed | Query state to confirm. transaction issues. |
| permission / unauthorized | Missing permission bit for the action | permissions; skill: permissions. |
Not here? Search troubleshooting/common-issues.md,
troubleshooting/error-codes.md, and
troubleshooting/edge-cases.md.