> 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                               |
| 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          |

## 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                        |

## 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/)