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. |
under_raid |
A visitor heads the planet fleet queue; mine/refine compute and complete reject | Do not retry compute. Production · under attack. |
queue_full |
Visiting-fleet slot full (1 + locationListExtra, default extra 0 → one visitor) |
Wait for a departure or send a fleet home. fleet.md. |
cannot defend / StructCannotDefend |
Target type has canDefend: false (planetary types, including Ore Bunker) |
Assign a fleet-type defender only. combat.md. |
is_owner |
Founder already owns a guild | Transfer that guild before founding another. guild skill. |
recipient_not_eligible |
uguild.* send to IBC, escrow, or an unregistered address |
Send only to a registered player, the structs module, or a provider pool. guild-banking. |
charter / work-failure / guild-create proof |
Charter nonce died (anchor moved) or entitlement checks failed | Re-query guild-charter; restart compute against the new anchor. hashing.md. |
primary-address / PermAll |
player-update-primary-address signed by a limited key |
Sign from an address that holds PermAll. permissions · agent security. |
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.