|
1 | 1 | # Error Codes |
2 | 2 |
|
3 | | -This reference lists raw CLI and SDK error codes. Workflows for diagnosing failures live in `../workflows/troubleshooting.md`. |
| 3 | +This reference lists error codes the CLI actually emits. SDK-only or remapped codes are noted where relevant. Workflows for diagnosing failures live in `../workflows/troubleshooting.md`. |
4 | 4 |
|
5 | 5 | ## Auth Errors |
6 | 6 |
|
7 | 7 | | Code | Meaning | |
8 | 8 | | --- | --- | |
9 | | -| `AUTH_FAILED` | Authentication failed | |
10 | | -| `AUTH_ERROR` | Generic authentication error | |
11 | | -| `TOKEN_INVALID` | Invalid CLI token | |
| 9 | +| `ALREADY_AUTHENTICATED` | Valid session already exists; run `mm-dev logout` before logging in again | |
| 10 | +| `AUTH_FAILED` | Authentication failed (includes missing refresh token cases) | |
| 11 | +| `AUTH_ERROR` | Generic authentication error (includes missing auth token cases) | |
| 12 | +| `TOKEN_INVALID` | Invalid CLI token, token pair, or project ID | |
12 | 13 | | `TOKEN_REFRESH_FAILED` | Failed to refresh token | |
13 | | -| `PAIRING_ABORTED` | Login pairing was aborted | |
14 | 14 | | `PAIRING_TIMEOUT` | Login pairing timed out | |
15 | 15 | | `PAIRING_EXPIRED` | Pairing session expired | |
16 | | -| `INVALID_CLI_TOKENS` | CLI token pair is invalid | |
17 | | -| `INVALID_CLI_TOKEN` | CLI token is invalid | |
18 | | -| `MISSING_REFRESH_TOKEN` | Refresh token is missing | |
19 | | -| `REFRESH_CLI_TOKEN_FAILED` | CLI token refresh failed | |
20 | | -| `MISSING_TOKEN` | Required auth token is missing | |
21 | | -| `REVOKE_CLI_TOKEN_FAILED` | CLI token revoke failed | |
22 | | -| `INVALID_PROJECT_ID` | Project ID is invalid for the selected environment | |
23 | | -| `MISSING_PROJECT_ID` | Project ID is not configured | |
24 | 16 | | `INVALID_OTP` | Invalid one-time password | |
25 | 17 | | `MWP_TIMEOUT` | Mobile Wallet Protocol timeout | |
26 | | -| `MWP_CANCELLED` | Mobile Wallet Protocol cancelled | |
27 | | -| `LOGOUT_FAILED` | Logout operation failed | |
| 18 | +| `MWP_CANCELLED` | Mobile Wallet Protocol cancelled (pairing aborted) | |
| 19 | +| `LOGOUT_FAILED` | Logout operation failed (includes token revoke failures) | |
28 | 20 |
|
29 | 21 | ## Validation Errors |
30 | 22 |
|
@@ -67,12 +59,13 @@ This reference lists raw CLI and SDK error codes. Workflows for diagnosing failu |
67 | 59 | | `PASSWORD_MISMATCH` | Password confirmation does not match | |
68 | 60 | | `EMPTY_PASSWORD` | Empty password provided | |
69 | 61 | | `WALLET_NOT_FOUND` | Wallet not found | |
70 | | -| `WALLET_ERROR` | Wallet provider or wallet operation error | |
| 62 | +| `WALLET_ERROR` | Wallet provider or wallet operation error (includes on-chain reverts and network failures from wallet paths) | |
71 | 63 | | `WALLET_METADATA` | Wallet metadata error | |
72 | 64 | | `WRONG_NAMESPACE` | Wrong namespace for wallet | |
73 | 65 | | `UNSUPPORTED_NAMESPACE` | Unsupported wallet namespace | |
74 | 66 | | `NO_AUTH_TOKEN` | Missing authentication token for wallet operations | |
75 | 67 | | `NO_PROJECT_ID` | Project ID not configured for wallet | |
| 68 | +| `MISSING_PROJECT_ID` | Project ID is not configured | |
76 | 69 |
|
77 | 70 | ## Command Errors |
78 | 71 |
|
@@ -110,7 +103,7 @@ This reference lists raw CLI and SDK error codes. Workflows for diagnosing failu |
110 | 103 | | `UNSUPPORTED_NETWORK` | Unsupported network for perps | |
111 | 104 | | `UNSUPPORTED_ROUTE` | Unsupported deposit or withdraw route | |
112 | 105 | | `UNSUPPORTED_ASSET` | Unsupported asset | |
113 | | -| `UNSUPPORTED_SOURCE_CHAIN` | Unsupported source chain | |
| 106 | +| `UNSUPPORTED_SOURCE_CHAIN` | Unsupported source chain for perps deposit | |
114 | 107 | | `INVALID_SYMBOL` | Unknown perpetual market symbol | |
115 | 108 | | `INVALID_AMOUNT` | Invalid amount | |
116 | 109 | | `INVALID_SIZE` | Invalid position size | |
@@ -141,18 +134,17 @@ This reference lists raw CLI and SDK error codes. Workflows for diagnosing failu |
141 | 134 | | `PREDICT_FUNDING_CHAIN_UNSUPPORTED` | Funding chain not supported | |
142 | 135 | | `PREDICT_INSUFFICIENT_BALANCE` | Insufficient Predict balance | |
143 | 136 | | `PREDICT_INSUFFICIENT_ALLOWANCE` | Insufficient Predict allowance | |
| 137 | +| `PREDICT_INSUFFICIENT_FUNDING_BALANCE` | Insufficient funding balance for Predict deposit | |
144 | 138 | | `PREDICT_CANCEL_TARGET_REQUIRED` | Cancel target not specified | |
145 | 139 | | `PREDICT_WALLET_STATE_REQUIRED` | Wallet state required for Predict | |
146 | 140 | | `PREDICT_METHOD_UNAVAILABLE` | Predict method not available | |
| 141 | +| `PREDICT_DEPOSIT_FAILED` | Predict deposit failed | |
| 142 | +| `PREDICT_ERROR` | Generic Predict error | |
| 143 | +| `UNSUPPORTED_PREDICT_CHAIN` | Predict chain not supported | |
147 | 144 |
|
148 | 145 | ## Network & Filesystem Errors |
149 | 146 |
|
150 | 147 | | Code | Meaning | |
151 | 148 | | --- | --- | |
152 | 149 | | `NETWORK_UNREACHABLE` | Network unreachable | |
153 | | -| `NETWORK_TIMEOUT` | Network timeout | |
154 | | -| `NETWORK_ERROR` | Generic network error | |
155 | 150 | | `RESET_FAILED` | Failed to reset CLI session | |
156 | | -| `MNEMONIC_STORE_FAILED` | Failed to store mnemonic | |
157 | | -| `FILESYSTEM_ERROR` | Generic filesystem error | |
158 | | -| `TX_REVERTED` | Transaction reverted on-chain | |
0 commit comments