> For the complete documentation index, see [llms.txt](/llms.txt).

# Error codes

The `mm` CLI surfaces errors with stable `code` values. Use these codes in scripts and agent workflows to branch on failures.

Run `mm <command> --help` for command-specific validation rules.

## Authentication errors (`AuthError`)[​](#authentication-errors-autherror "Direct link to authentication-errors-autherror")

| Code                  | Meaning                                                        |
| --------------------- | -------------------------------------------------------------- |
| AUTH_FAILED           | Authentication failed (includes missing refresh token)         |
| AUTH_ERROR            | Generic authentication error                                   |
| ALREADY_AUTHENTICATED | Valid session already exists; run mm logout before login       |
| COMING_SOON           | Feature not available (for example, mm login qr in production) |
| TOKEN_INVALID         | Invalid CLI token, token pair, or project ID                   |
| TOKEN_REFRESH_FAILED  | Failed to refresh token                                        |
| PAIRING_EXPIRED       | Pairing session expired                                        |
| INVALID_OTP           | Invalid one-time password                                      |
| MWP_TIMEOUT           | Mobile Wallet Protocol timeout                                 |
| MWP_CANCELLED         | Mobile Wallet Protocol cancelled (pairing aborted)             |
| LOGOUT_FAILED         | Sign-out operation failed (includes token revoke failures)     |

## Validation errors (`ValidationError`)[​](#validation-errors-validationerror "Direct link to validation-errors-validationerror")

| Code                        | Meaning                                                 |
| --------------------------- | ------------------------------------------------------- |
| MISSING_FLAG                | Required flag missing in headless mode                  |
| MISSING_INPUT               | Required input is missing                               |
| MISSING_CHAIN               | Chain value is missing                                  |
| MISSING_CHAIN_ID            | --chain-id is missing                                   |
| INVALID_CHAIN               | Chain value is invalid                                  |
| INVALID_INPUT               | Invalid user input                                      |
| INVALID_TO                  | Recipient address is invalid                            |
| INVALID_TYPED_DATA          | EIP-712 payload is invalid                              |
| INVALID_TRANSACTION_PAYLOAD | Transaction payload is invalid                          |
| CHAIN_ID_MISMATCH           | Typed-data domain chain ID differs from --chain-id      |
| INVALID_MNEMONIC            | Bring your own wallet mnemonic is invalid               |
| NOT_INITIALIZED             | Project not initialized; run mm init                    |
| INVALID_LIMIT               | Invalid --limit value for mm tx history (must be 1–500) |

## Wallet errors (`WalletError`)[​](#wallet-errors-walleterror "Direct link to wallet-errors-walleterror")

| Code               | Meaning                                          |
| ------------------ | ------------------------------------------------ |
| MISSING_MNEMONIC   | Bring your own wallet mode is missing a mnemonic |
| MNEMONIC_LOCKED    | Mnemonic is password-protected                   |
| WRONG_PASSWORD     | Mnemonic password is incorrect                   |
| WALLET_NOT_FOUND   | Wallet not found                                 |
| WALLET_ERROR       | Wallet operation failed                          |
| NO_AUTH_TOKEN      | Missing authentication token                     |
| NO_PROJECT_ID      | Project ID not configured                        |
| NO_HISTORY_WALLETS | No EVM wallets found for mm tx history           |

## Swap errors (`SwapCommandError`)[​](#swap-errors-swapcommanderror "Direct link to swap-errors-swapcommanderror")

| Code                | Meaning                                 |
| ------------------- | --------------------------------------- |
| NO_QUOTES           | No swap quotes returned for the request |
| INVALID_SWAP_PARAMS | Missing or invalid swap parameters      |
| TOKEN_NOT_FOUND     | Token not found for the selected chain  |
| QUOTE_NOT_FOUND     | Quote ID not found                      |
| NO_TRADE_DATA       | Selected quote has no trade transaction |
| EXECUTE_FAILED      | Swap execution failed                   |
| STATUS_UNAVAILABLE  | Swap status unavailable                 |
| SWAP_ERROR          | Generic swap error                      |

## Perpetuals errors[​](#perpetuals-errors "Direct link to Perpetuals errors")

Common Hyperliquid failures include `ORDER_REJECTED`, `DEPOSIT_FAILED`, `INSUFFICIENT_BALANCE`, and `HYPERLIQUID_ERROR` when the venue sub-account has not been funded. See [Trade perpetuals](/agent-wallet/guides/trade-perpetuals/).

## Predict errors[​](#predict-errors "Direct link to Predict errors")

| Code                                 | Meaning                                    |
| ------------------------------------ | ------------------------------------------ |
| PREDICT_SETUP_REQUIRED               | Run mm predict setup before this operation |
| PREDICT_AUTH_REQUIRED                | Predict credentials missing or expired     |
| PREDICT_INSUFFICIENT_BALANCE         | Insufficient pUSD in the deposit wallet    |
| PREDICT_INSUFFICIENT_FUNDING_BALANCE | Insufficient USDC.e for mm predict deposit |
| PREDICT_ERROR                        | Generic predict error                      |

## Network errors[​](#network-errors "Direct link to Network errors")

| Code                | Meaning             |
| ------------------- | ------------------- |
| NETWORK_UNREACHABLE | Network unreachable |

## Related pages[​](#related-pages "Direct link to Related pages")

- [Troubleshooting](/agent-wallet/troubleshooting/)
- [Commands reference](/agent-wallet/reference/commands/)