Structs Error Codes

Version: 1.1.0 Category: errors Description: Complete catalog of error codes for AI agents

Error Codes

Success

Code Name Category Description Action Retryable
0 SUCCESS success Operation successful continue –

Game Errors

Code Name Category Description Action Retryable Requires
1 GENERAL_ERROR error General error occurred log and retry yes –
2 INSUFFICIENT_FUNDS error Insufficient funds for transaction wait for resources no check player inventory, wait for resources
3 INVALID_SIGNATURE error Transaction signature is invalid re-sign transaction yes –
4 INSUFFICIENT_GAS error Insufficient gas for transaction increase gas limit yes –
5 INVALID_MESSAGE error Message format is invalid validate message format no –
6 PLAYER_OFFLINE error Player offline: (load+structsLoad) > (capacity+capacitySecondary) restore capacity or shed load no There is no halted field — query player power attributes
7 INSUFFICIENT_CHARGE error Player has insufficient charge (per-player bar, not per-struct) wait for charge no check player charge, wait for charge
8 INVALID_LOCATION error Location is invalid or inaccessible validate location no –
9 INVALID_TARGET error Target is invalid or not attackable validate target no –

HTTP Errors

Code Name Category Description Action Retryable
400 BAD_REQUEST http Invalid request validate request format no
404 ENTITY_NOT_FOUND http Entity not found verify entity ID no
500 INTERNAL_SERVER_ERROR http Server error retry with backoff yes

Network Errors

Code Name Category Description Action Retryable
timeout REQUEST_TIMEOUT network Request timed out retry with backoff yes
network NETWORK_ERROR network Network error occurred retry with backoff yes

Error Categories

Category Error Codes
success 0
error 1, 2, 3, 4, 5, 6, 7, 8, 9
http 400, 404, 500
network timeout, network

Retry Classification

Retryable: 1 (GENERAL_ERROR), 3 (INVALID_SIGNATURE), 4 (INSUFFICIENT_GAS), 500 (INTERNAL_SERVER_ERROR), timeout (REQUEST_TIMEOUT), network (NETWORK_ERROR)

Not retryable: 0 (SUCCESS), 2 (INSUFFICIENT_FUNDS), 5 (INVALID_MESSAGE), 6 (PLAYER_OFFLINE), 7 (INSUFFICIENT_CHARGE), 8 (INVALID_LOCATION), 9 (INVALID_TARGET), 400 (BAD_REQUEST), 404 (ENTITY_NOT_FOUND)

Error Handling Strategy

Retryable Errors

Setting Value
Action retry
Max retries 3
Backoff exponential
Initial delay 1000 ms

Non-Retryable Errors

Setting Value
Action log
Fallback abort or wait