Error reference
Find an exact code, understand its boundary, and choose the right next action.
211 codes
ABP_APPLICATION/ALREADY_EXISTSAn application already exists for this operation.ABP_APPLICATION/COUNT_DOCUMENTS_FAILEDCounting the documents failed.ABP_APPLICATION/CREATE_DOCUMENT_FAILEDCreating the document failed.ABP_APPLICATION/INVALID_EMAILThe supplied email address is invalid.ABP_APPLICATION/NOT_FOUNDThe requested resource was not found.ABP_APPLICATION/READ_DOCUMENT_FAILEDReading the document failed.ABP_APPLICATION/READ_SETTING_FAILEDReading the application settings failed.ABP_APPLICATION/REQUIRED_FIELD_MISSINGOne or more required input fields are missing.ABP_APPLICATION/REQUIRED_PROFILE_MISSINGRequired profile information is missing.ABP_APPLICATION/SETTING_NOT_FOUNDThe application settings document was not found.ABP_APPLICATION/UPDATE_DOCUMENT_FAILEDUpdating the document failed.AUTH/ADDRESS_MISMATCHThe address asserted by the client during handshake verification does not match what the server expects for this connection.AUTH/HANDSHAKE_MISSING_FIELDSThe server cannot verify the connection because the client did not provide the minimum required
handshake auth information.AUTH/HOST_MISMATCHIn production, the token record pins an expected host/pod, but the client connected to a different pod.
This prevents cross-pod token reuse when pods are not sharing auth state.AUTH/INVALID_TOKEN_RECORDThe token record exists, but its contents are not trustworthy (missing fields or corrupted JSON).AUTH/LOGIN_ATTEMPT_DATA_INVALIDThe stored provider login attempt has an invalid shape.AUTH/LOGIN_ATTEMPT_STORAGE_FAILEDThe provider login-attempt store operation failed.AUTH/LOGIN_CODE_DATA_INVALIDThe stored one-time login code record has an invalid shape.AUTH/LOGIN_CODE_INVALIDThe one-time login code or its verifier could not be validated.AUTH/LOGIN_CODE_STORAGE_FAILEDThe one-time login code store operation failed.NOT_AUTHENTICATEDThe operation requires an authenticated session.AUTH/NOT_INITALIZED_WALLETThe wallet object is required for the operation (signing, querying as a user, sending tx), but the client has not initialized it yet.AUTH/OAUTH_INVALID_CALLBACK_URLThe configured application callback URL is invalid.AUTH/OAUTH_INVALID_STATEThe provider login state does not identify a valid login attempt.AUTH/OAUTH_NOT_CONFIGUREDThe selected provider is not configured on the server.AUTH/OAUTH_PROVIDER_FAILEDProvider authentication or the returned identity could not be validated.AUTH/REFRESH_TOKEN_DATA_INVALIDThe stored refresh-session record has an invalid shape.AUTH/REFRESH_TOKEN_INVALIDThe refresh token is missing, expired, invalid or already used.AUTH/REFRESH_TOKEN_STORAGE_FAILEDThe refresh-session store operation failed.AUTH/ROOM_MISMATCHThe room/realm id asserted by the client does not match what the server stored for this token.AUTH/TOKEN_ISSUANCE_FAILEDThe server could not issue a service access token.AUTH/TOKEN_MISMATCHThe client provided a token, but it does not match the server’s stored token record for this address/session.AUTH/TOKEN_NOT_CONFIGUREDThe service token signing configuration is missing or invalid.AUTH/TOKEN_NOT_FOUNDThe server expects an existing token record (e.g. in Redis) for this address/session, but cannot find it.AUTH/WEB3_AUTH_NOT_INITIALIZEDWeb3Auth helpers (challenge/response generation, signatures, etc.) require an active private key/session, but the auth module has not been initialized.AXIOS/HTTP<status>A dynamic code family for Axios failures classified by the actual HTTP response status, such as AXIOS/HTTP404.AXIOS/UNKNOWNAn Axios error occurred, but it did not match any more specific classification rule (timeout, unreachable, HTTP status, etc.).BLOCK/NOT_FOUNDThe requested block id or block name does not exist in the server’s block registry.BLOCK/NOT_PERMISSIONThe player is not allowed to update this block.BLOCK/TEST_ERRORAn intentionally thrown error used for testing error handling paths in block-related endpoints.BLUEPRINT/ASSET_UPLOAD_FAILEDThe blueprint asset could not be uploaded.BLUEPRINT/CREATE_DOCUMENT_FAILEDCreating the document failed.BLUEPRINT/DELETE_DOCUMENT_FAILEDDeleting the document failed.BLUEPRINT/FORBIDDENThe caller is not permitted to access or modify the blueprint.BLUEPRINT/INVALID_ASSETThe blueprint asset does not satisfy validation constraints.BLUEPRINT/INVALID_STATUS_TRANSITIONThe requested blueprint status transition is not permitted.BLUEPRINT/LIST_DOCUMENTS_FAILEDListing the documents failed.BLUEPRINT/MISSING_BLUEPRINT_FILEThe request does not include a blueprint file.BLUEPRINT/NOT_FOUNDThe requested resource was not found.BLUEPRINT/PINNED_MAX_COUNT_REACHEDThe maximum number of pinned entries has been reached.BLUEPRINT/READ_DOCUMENT_FAILEDReading the document failed.BLUEPRINT/UPDATE_DOCUMENT_FAILEDUpdating the document failed.BUG_REPORT/ADD_SCREENSHOTS_FAILEDAdding screenshot references to the report failed.BUG_REPORT/COUNT_DOCUMENTS_FAILEDCounting the documents failed.BUG_REPORT/CREATE_DOCUMENT_FAILEDCreating the document failed.BUG_REPORT/CREATED_BY_ADDRESS_MISMATCHThe submitted creator address does not match the authenticated address.BUG_REPORT/IMAGE_UPLOAD_FAILEDThe image could not be saved to object storage.BUG_REPORT/INVALID_IMAGEThe supplied image does not satisfy the accepted file constraints.BUG_REPORT/INVALID_PAYLOAD_JSONThe supplied payload is not valid JSON.BUG_REPORT/LIST_DOCUMENTS_FAILEDListing the documents failed.BUG_REPORT/NO_BUG_REPORT_ID_PROVIDEDThe operation requires a bug report ID.BUG_REPORT/NOT_FOUNDThe requested resource was not found.BUG_REPORT/PAYLOAD_JSON_MUST_BE_OBJECTThe JSON payload must be an object.BUG_REPORT/READ_DOCUMENT_FAILEDReading the document failed.GET_REALM_BY_SLUG_FAILEDThe server-side contract adapter attempted to read a realm by slug, but the contract query or the “not found” detection failed.ERROR_CHAT_INVAILD_COMMAND_FORMATThe chat command format is invalid. The wire spelling is preserved for compatibility.ERROR_CHAT_RATE_LIMITThe chat message rate limit was exceeded.ERROR_CHAT_TARGET_AMBIGUOUSMore than one player matches the recipient name.ERROR_CHAT_TARGET_NOT_FOUNDThe chat recipient was not found.ERROR_INVITE_TARGET_NOT_FOUNDThe invited player was not found.ERROR_PLAYER_NOT_EXISTThe player was not found.ERROR_PLAYER_NOT_IN_ROOMThe player is not in the requested room.ERROR_ROOM_NOT_FOUNDThe room was not found.FACILITY/BUSYWait for the current craft to finish.FACILITY/CONNECTION_FAILEDThe facility server connection was interrupted. Sync your inventory before trying again.FACILITY/INPUT_MISMATCHThe selected items do not match this operation.FACILITY/INPUT_SLOT_CHANGEDA selected input slot is empty or contains a different item.FACILITY/INSUFFICIENT_CHARGEThe facility does not have enough operating charge.FACILITY/INSUFFICIENT_INPUTSThe selected slots do not have enough recipe inputs.FACILITY/INVALID_INPUT_EQUIPMENTThe selected equipment has invalid durability.FACILITY/INVALID_INPUT_SLOTSChoose valid material slots and try again.FACILITY/INVALID_RECIPEChoose an available recipe for this facility.FACILITY/INVALID_REQUESTThe facility request is invalid.FACILITY/INVENTORY_CAPACITY_INVALIDYour inventory capacity could not be resolved.FACILITY/INVENTORY_FULLYour inventory is full.FACILITY/INVENTORY_OUT_OF_SYNCYour inventory is unavailable. Reconnect and try again.FACILITY/NOT_FOUNDThe facility is not installed.FACILITY/PERMISSION_DENIEDYou no longer have access to this world.FACILITY/RECIPE_NOT_ALLOWEDThis facility type or level cannot use this recipe.FACILITY/REQUEST_CONFLICTThe request identity conflicts with a previously submitted facility request.FACILITY/REQUEST_FAILEDA server error prevented the facility request from completing. Sync your inventory before trying again.FACILITY/SESSION_CHANGEDReopen the facility and try again.FACILITY/STATE_CHANGEDThe facility state changed. Reopen it and try again.FACILITY/UNAVAILABLEThe facility is being moved or removed.FACILITY/WORLD_UNAVAILABLEThis world is unavailable.FIRESTORE/COUNT_FAILEDCounting the records failed.FIRESTORE/CREATE_FAILEDCreating the record failed.FIRESTORE/DELETE_FAILEDDeleting the record failed.FIRESTORE/GET_FAILEDReading the record failed.FIRESTORE/UPDATE_FAILEDUpdating the record failed.GET_TOTAL_BLOCK_SIZE_FAILEDReading the total block count from the contract failed.GRANT_NOT_FOUNDMailbox operation rejected: grant not found.HTTP/<status>A dynamic code family classified by the actual HTTP response status, such as HTTP/404.IDEMPOTENCY_CONFLICTMailbox operation rejected: idempotency conflict.INTERNAL/UNEXPECTEDThis is the default fallback classification for errors that cannot be mapped by known normalization rules.INVALID_GRANT_IDMailbox operation rejected: invalid grant id.INVALID_MAILBOX_AUTHORITYMailbox operation rejected: invalid mailbox authority.INVALID_MAILBOX_CURSORMailbox operation rejected: invalid mailbox cursor.INVALID_MAILBOX_GRANT_STATUSMailbox operation rejected: invalid mailbox grant status.INVALID_MAILBOX_GRANTMailbox operation rejected: invalid mailbox grant.INVALID_MAILBOX_QUERYMailbox operation rejected: invalid mailbox query.INVALID_PLAYER_EXPERIENCE_AMOUNTThe experience amount is invalid.INVALID_PLAYER_EXPERIENCE_INPUTThe experience update input is invalid.INVENTORY/AUTHORITY_UNAVAILABLEThe authoritative inventory session is unavailable.INVENTORY/CHECKPOINT_FAILEDThe inventory checkpoint barrier did not complete.INVENTORY/LEASE_INVALIDThe inventory authority lease is missing, stale or expired.INVENTORY/RECEIPT_PENDINGA previous mailbox receipt is still pending reconciliation.INVENTORY/REVISION_CONFLICTThe persisted inventory revision does not match the expected revision.INVENTORY_BINDING_CONFLICTMailbox operation rejected: inventory binding conflict.INVENTORY_CAPACITY_EXCEEDEDMailbox operation rejected: inventory capacity exceeded.INVENTORY_LEASE_ACTIVEMailbox operation rejected: inventory lease active.INVENTORY_NOT_PROVISIONEDMailbox operation rejected: inventory not provisioned.INVENTORY_POLICY_UNAVAILABLEMailbox operation rejected: inventory policy unavailable.INVENTORY_WEIGHT_EXCEEDEDMailbox operation rejected: inventory weight exceeded.ITEM_NOT_FOUNDMailbox operation rejected: item not found.LIST_BLOCKS_FAILEDListing blocks through the contract failed.LIST_ROLE_GRANTS_FAILEDListing realm role grants through the contract failed.LIST_WORLD_MASTERS_FAILEDListing world masters through the contract failed.INVENTORY_LEASE_INVALIDThe mailbox claim cannot use the supplied inventory authority: the lease is missing, expired or owned by a different session.INVENTORY_REVISION_CONFLICTThe mailbox claim cannot use the supplied inventory authority: the inventory revision changed before the claim could commit.MAILBOX_BINDING_CONFLICTMailbox operation rejected: mailbox binding conflict.MAILBOX_CAPACITY_EXCEEDEDMailbox operation rejected: mailbox capacity exceeded.MAILBOX_CLAIM_CONFLICTMailbox operation rejected: mailbox claim conflict.MAILBOX_POLICY_UNAVAILABLEMailbox operation rejected: mailbox policy unavailable.MAILBOX_RECEIPT_MISMATCHMailbox operation rejected: mailbox receipt mismatch.MAILBOX_SLOT_MISMATCHMailbox operation rejected: mailbox slot mismatch.MASTER_DATA/CSV_EMPTYThe CSV input is empty.MASTER_DATA/CSV_INVALIDThe CSV syntax could not be parsed.MASTER_DATA/HANDLER_NOT_REGISTEREDNo handler is registered for the requested master-data domain.MULTIPLAYER/CONNECTION_VERIFICATION_FAILEDThe server could not confirm that the player’s connection is valid for the target realm/room, so it rejects the join.MULTIPLAYER/ROOM_FULLThe room has reached the configured maximum number of players, so new joins are rejected.NETWORK/TIMEOUTA network request exceeded the configured timeout budget.NETWORK/UNREACHABLEThe client could not reach the network endpoint (offline, DNS issues, blocked request, etc.).NETWORK/VERIFY_META_NOT_FOUNDThe connection flow is missing required verification metadata (token/address/etc.), so the client/server cannot authenticate the WebSocket connection.NO_HANDLER_TYPE/COMMUNICATENo Communicate handler matches the incoming message type.NO_HANDLER_TYPE/MULTIPLAYERThe server received a WS message type that is not registered in the multiplayer router.NO_HANDLER_TYPE/TERRAINThe server received a WS terrain message type that is not registered in the handler router.PLAYER_NOT_FOUNDThe server could not find a player entity for the requested identity in the current room context.PLAYER_EXPERIENCE_DEFINITION_UNAVAILABLERequired experience definitions are unavailable.PLAYER_EXPERIENCE_IDEMPOTENCY_CONFLICTAn experience grant identity conflicts with the submitted operation.PLAYER_EXPERIENCE_OVERFLOWThe experience update exceeds the supported numeric range.PLAYER_NOT_SYNCHRONIZEDThe player record has not been synchronized.PORTAL/DESTINATION_FULLThe destination has reached its player limit.PORTAL/DESTINATION_NOT_READYThe destination is not active yet.PORTAL/DESTINATION_PRIVATEThe destination is no longer public to this player.REALM_NOT_FOUNDThe realm referenced by the client does not exist or cannot be verified as accessible.REALM/PINNED_MAX_COUNT_REACHEDThe maximum number of pinned entries has been reached.ROOM_INITIALIZATION_FAILEDThe server attempted to initialize a room (terrain seed/params, weather preset, storage config), but initialization failed.ROOM_NOT_FOUNDThe server could not find an active room instance for the requested realm/room id.RPC/BASE/CALL_FAILEDThis is a catch-all wrapper used when RPCBase.call() fails and the original error does not
cleanly map to a more specific code.RPC/BASE/CONTRACT_CALL_FAILEDThe contract call reached the chain/VM, but the VM returned a failure (contract runtime error,
revert-like behavior, invalid arguments, authorization failure, etc.).RPC/BASE/INVALID_QUERY_RESULTThe query response shape is not what the client expects, so the client cannot safely parse the
result.RPC/BASE/INVALID_TX_RESULTThe tx result shape is not what the client expects, so the client cannot safely determine
success/failure or parse the response payload.RPC/BASE/QUERY_CONTRACT_FAILEDThe query reached the chain/VM, but the VM returned a failure for the contract query.RPC/BASE/QUERY_FAILEDThis is a catch-all wrapper used when RPCBase.query() fails and the original error does not
cleanly map to a more specific query code.RPC/BIOME/GET_BIOME_INFOS_FAILEDThe client attempted to fetch biome descriptors (cost, name, theme, etc.) from the contract, but the query failed.RPC/BIOME/GET_BIOME_INFOS_MAP_FAILEDThe client attempted to build a biome lookup map (keyed by biome id), but the underlying biome query or mapping failed.RPC/BLOCK/GET_BLOCKS_FROM_TO_FAILEDThe client attempted to read a range of blocks from the contract, but the query failed.RPC/BLOCK/GET_CURRENT_BLOCK_ID_FAILEDThe client attempted to read the current chain block height/id (as used by the contract), but the query failed.RPC/WORLD/CREATE_PERSONAL_REALM_FAILEDThe client attempted to create a personal realm by submitting a transaction, but the tx flow failed.RPC/WORLD/DELETE_PERSONAL_REALM_FAILEDThe client attempted to delete a personal realm by submitting a transaction, but the tx flow failed.RPC/WORLD/EXPAND_PERSONAL_REALM_FAILEDThe client attempted to expand a personal realm by submitting a transaction, but the tx flow failed.RPC/WORLD/GET_RANDOM_REALMS_FAILEDThe client attempted to fetch a randomized realm list, but the chain query failed.RPC/WORLD/GET_REALM_BY_SLUG_FAILEDThe client attempted to fetch a personal realm by slug, but the underlying chain query failed.RPC/WORLD/GET_REALM_CREATION_COST_FAILEDThe client attempted to query how much it costs to create a realm, but the chain query failed.RPC/WORLD/GET_REALM_EXPANSION_COST_FAILEDThe client attempted to query how much it costs to expand a realm, but the chain query failed.RPC/WORLD/GET_REALM_SIZE_INFOS_FAILEDThe client attempted to query realm size information (tiers / cost mapping), but the chain query failed.RPC/WORLD/GET_REALMS_BY_OWNER_FAILEDThe client attempted to list realms owned by a given address, but the chain query failed.RPC/WORLD/GET_SYSTEM_REALMS_FAILEDThe client attempted to fetch the system realms list, but the underlying chain query failed.RPC/WORLD/GET_SYSTEM_WORLD_BY_ID_FAILEDThe client attempted to read a system world by its numeric id, but the underlying chain query failed.RPC/WORLD/GET_SYSTEM_WORLD_BY_SLUG_FAILEDThe client attempted to read a system world by its slug, but the underlying chain query failed.RPC/WORLD/GET_SYSTEM_WORLDS_FAILEDThe client attempted to fetch the system worlds list, but the underlying chain query failed.RPC/WORLD/GRANT_ROLE_FAILEDGranting a realm role through RPC failed.RPC/WORLD/REVOKE_ROLE_FAILEDRevoking a realm role through RPC failed.RPC/WORLD/UPDATE_PERSONAL_REALM_FAILEDThe client attempted to update a personal realm by submitting a transaction, but the tx flow failed.RUNTIME/AGGREGATE_ERRORMultiple errors were captured into an AggregateError and then normalized into AppError.RUNTIME/BUFFER_OOBA RangeError was detected as a likely buffer out-of-bounds access (heuristic based on the error message).
This often indicates corrupted data or a mismatch between expected and actual byte layouts.RUNTIME/INITIALIZE_FAILEDEntering a realm failed somewhere in the runtime initialization pipeline (auth → realm verification → route fetch → world system init).RUNTIME/RANGE_ERRORA runtime RangeError was caught and normalized into AppError (excluding buffer out-of-bounds cases).RUNTIME/REFERENCE_ERRORA runtime ReferenceError (using an undefined variable / missing binding) was caught and normalized into AppError.RUNTIME/SYNTAX_ERRORA runtime SyntaxError was caught and normalized into AppError.
This can happen when parsing JSON or dynamically evaluating code/config.RUNTIME/TYPE_ERRORA JavaScript/TypeScript runtime TypeError was caught and normalized into AppError.SOCIAL/FRIENDS_ACCEPT_NOT_ALLOWEDThe current friend request cannot be accepted.SOCIAL/FRIENDS_CANCEL_NOT_ALLOWEDThe current friend request cannot be cancelled.SOCIAL/FRIENDS_CONTEXT_PROCESS_NOT_VALIDThe friend-operation pipeline produced an invalid result.SOCIAL/FRIENDS_INVITE_NOT_ALLOWEDThe friend invitation is not allowed in the current relationship state.SOCIAL/FRIENDS_MAX_COUNT_REACHEDThe maximum number of friends has been reached.SOCIAL/FRIENDS_NOT_FOUNDThe requested friend relationship or request could not be found.SOCIAL/FRIENDS_REJECT_NOT_ALLOWEDThe current friend request cannot be rejected.SOCIAL/FRIENDS_UNFRIEND_NOT_ALLOWEDThe current friend relationship cannot be removed.TERRAIN/CHUNK_FAILED_TO_DECOMPRESSChunk bytes were fetched, but decompression failed (gzip/snappy/transport mismatch or corrupted payload).TERRAIN/CHUNK_FAILED_TO_GENERATEThe system could not generate a chunk deterministically from the provided inputs (seed, params, coords).TERRAIN/CHUNK_FAILED_TO_LOAD_FROM_CACHEChunk loading attempted to read from the cache layer (Redis) but failed unexpectedly.TERRAIN/CHUNK_FAILED_TO_LOAD_FROM_STORAGEChunk loading attempted to read a chunk from the authoritative storage layer but failed.TERRAIN/CHUNK_INVALID_DECOMPRESSED_BYTESChunk bytes were downloaded/decompressed, but the resulting byte buffer is not a valid chunk
payload for Akkadia’s terrain format (it cannot be reinterpreted as a Uint32Array).TERRAIN/CHUNK_NOT_FOUNDThe chunk key was requested in an in-memory cache, but there was no entry for it.INVALID_ERROR_ARGUMENTThe UI received a value that is not an Error, not an AppError, and not a ProblemJSON, so it falls back to a safe default representation.USER/LOGIN_FAILEDThe user login operation failed.USER/LOOKUP_FAILEDThe user lookup operation failed.VALIDATION_ERRORThe request failed server-side input validation.WS/VALIDATION_ERRORThe server received a WebSocket message, but the payload failed validation against the expected DTO/schema.One problem shape, distinct policies
HTTP failures, socket failures and local application errors can share safe problem information. Their response status, connection handling and recovery remain separate. Command results keep their own typed success/failure contract.
The reference includes 201 registered literal codes, two dynamic HTTP families and eight legacy message keys. Code spelling is preserved even where a historical identifier contains a typo. Search the exact value rather than classifying an English message.