# Error code system

### Format

Error codes follow this format: `[cra]-[gms]-[000]-[00]`

Where:

* `cra`: Unique prefix for easy identification
* `gms`: 3-letter module/SDK identifier
* `000`: 3-digit error type
* `00`: 2-digit specific error code

### Module/SDK Identifiers

* `gms`: Go Mobile SDK
* `mss`: Mobile Swift SDK (iOS)
* `mks`: Mobile Kotlin SDK (Android)
* `mfs`: Mobile Flutter SDK
* `mcl`: MPC Core Library
* `bcl`: Blockchain Core Library
* `ctl`: Cramium TSS Library

### Error Types and Codes

#### General Errors (000)

| Code   | Description               |
| ------ | ------------------------- |
| 000-00 | Client is not initialized |
| 000-01 | Token expired             |
| 000-99 | Unknown error             |

#### Passkey Errors (001)

| Code   | Description                 |
| ------ | --------------------------- |
| 001-00 | User name must not be empty |
| 001-01 | Cannot authenticate user    |
| 001-02 | Cannot register user        |
| 001-03 | User cancel operation       |
| 001-04 | Don't have permission       |
| 001-05 | Verification failed         |
| 001-99 | Unknown error               |

#### Network Interaction Errors (002)

| Code   | Description                                       |
| ------ | ------------------------------------------------- |
| 002-00 | No internet connection                            |
| 002-01 | Cannot connect                                    |
| 002-02 | Request timeout                                   |
| 002-03 | Bad request (status 400)                          |
| 002-04 | Not found (status 404)                            |
| 002-05 | Other server error code (not 200-299, 400 or 404) |
| 002-06 | Unknown server response                           |
| 002-07 | Cannot encode data (client side)                  |
| 002-08 | Cannot decode data (client side)                  |
| 002-99 | Unknown error                                     |

#### Whitelist Errors (003)

| Code   | Description                                                                |
| ------ | -------------------------------------------------------------------------- |
| 003-00 | White list repository is not initialized                                   |
| 003-01 | Address already exist                                                      |
| 003-02 | Address not in whitelist (build/send)                                      |
| 003-03 | Amount is not allowed                                                      |
| 003-04 | Per transaction limit is larger than global per transaction limit          |
| 003-05 | Per transaction limit is larger than global daily limit                    |
| 003-06 | Per transaction limit is larger than daily limit                           |
| 003-07 | Daily limit is larger than global daily limit                              |
| 003-08 | Global per transaction limit is smaller than address per transaction limit |
| 003-99 | Unknown error                                                              |

#### Backup Errors (004)

| Code   | Description                                             |
| ------ | ------------------------------------------------------- |
| 004-00 | File not found                                          |
| 004-01 | Shard/Server shard broken ("Group id → detail message") |
| 004-02 | Backup key not found                                    |
| 004-03 | Backup file is empty                                    |
| 004-04 | Can't decrypt backup file                               |
| 004-05 | Can't encrypt backup file                               |
| 004-06 | Paillier group not found                                |
| 004-07 | Group ID not found                                      |
| 004-08 | Request data for callback method is not found           |
| 004-09 | Fail to generate sek                                    |

#### Cloud Service Errors (005)

| Code   | Description                      |
| ------ | -------------------------------- |
| 005-00 | User/Account not found           |
| 005-01 | User cancel operation            |
| 005-02 | Don't have permission            |
| 005-03 | Fail to store backup to cloud    |
| 005-04 | Fail to get backup from cloud    |
| 005-05 | Fail to delete backup from cloud |
| 005-06 | Unavailable                      |
| 005-07 | Timeout                          |

#### Secure Storage Errors (006)

| Code   | Description                                          |
| ------ | ---------------------------------------------------- |
| 006-00 | An error occurred while writing to secure storage    |
| 006-01 | An error occurred while reading from secure storage  |
| 006-02 | An error occurred while deleting from secure storage |

#### UDM Errors (007)

| Code   | Description               |
| ------ | ------------------------- |
| 007-00 | Can't get IMEI for device |
| 007-99 | Unknown error             |

### Platform-Specific Error Codes

#### iOS (cra-mss)

| Type | Description  | Detail Error                                                                 |
| ---- | ------------ | ---------------------------------------------------------------------------- |
| 000  | General      | <p>00: Client is not initialized<br>99: Unknown error</p>                    |
| 001  | iOS Specific | <p>00: Cannot decode request - details: method name<br>99: Unknown error</p> |

#### Android (cra-mks)

| Type | Description      | Detail Error                                              |
| ---- | ---------------- | --------------------------------------------------------- |
| 000  | General          | <p>00: Client is not initialized<br>99: Unknown error</p> |
| 002  | Android Specific | <p>00: Cannot decode request<br>99: Unknown error</p>     |

#### Flutter (cra-mfs)

| Type | Description | Detail Error                                              |
| ---- | ----------- | --------------------------------------------------------- |
| 000  | General     | <p>00: Client is not initialized<br>99: Unknown error</p> |

### GoSDK Errors (cra-gms)

| Type | Description | Detail Error                                              |
| ---- | ----------- | --------------------------------------------------------- |
| 000  | General     | <p>00: Client is not initialized<br>99: Unknown error</p> |

### Usage Examples

#### iOS Example

```swift
do {
    // Some operation
} catch let error as MpcException {
    switch error.code {
    case "cra-mss-000-00":
        print("Client is not initialized")
    case "cra-mss-001-00":
        print("Cannot decode request")
    default:
        print("Unknown error: \(error.message)")
    }
}
```

#### Android Example

```kotlin
try {
    // Some operation
} catch (e: MpcException) {
    when (e.code) {
        "cra-mks-000-00" -> println("Client is not initialized")
        "cra-mks-002-00" -> println("Cannot decode request")
        else -> println("Unknown error: ${e.message}")
    }
}
```

#### Flutter Example

```dart
try {
    // Some operation
} catch (e) {
    if (e is MpcException) {
        switch (e.code) {
            case "cra-mfs-000-00":
                print("Client is not initialized");
                break;
            default:
                print("Unknown error: ${e.message}");
        }
    }
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cramiumlabs.gitbook.io/docs/feature-list/error-code-system.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.