> 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 --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 signing in | | 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) | | PAIRING_CANCELLED | Browser pairing cancelled by the user | | 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) | | INVALID_CONFIG_KEY | Unknown CLI config key | | INVALID_NETWORK | Unsupported or unknown network | | UNKNOWN_FLAG | Unrecognized CLI flag | ## 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_NOT_REGISTERED | BYOK wallet registration failed during mm init | | 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 | | TX_NOT_FOUND | Transaction hash not found onchain | | INVALID_TX_HASH | Malformed transaction hash | ## 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 | | INSUFFICIENT_FUNDS | Source token balance insufficient | | INSUFFICIENT_GAS | Native balance cannot cover gas fees | | AMOUNT_TOO_LOW | Swap amount below minimum threshold | | SLIPPAGE_TOO_HIGH | Slippage exceeds acceptable range | | QUOTE_RETRY | Transient bridge quote-stream retry signal (retryable) | | SWAP_ERROR | Generic swap error | ## Perpetuals errors[​](#perpetuals-errors "Direct link to Perpetuals errors") | Code | Meaning | | ----------------------- | ------------------------------------------------------ | | ORDER_REJECTED | Order rejected by Hyperliquid | | DEPOSIT_FAILED | Deposit to venue failed | | INSUFFICIENT_BALANCE | Venue sub-account has insufficient balance | | MINIMUM_DEPOSIT_AMOUNT | Deposit below Hyperliquid minimum | | MINIMUM_WITHDRAW_AMOUNT | Withdrawal below Hyperliquid minimum | | MINIMUM_ORDER_NOTIONAL | Order notional below $10 floor | | HYPERLIQUID_ERROR | Generic Hyperliquid error (often unfunded sub-account) | The CLI provides actionable hints for common failures — for example, minimum amounts for deposits and withdrawals, the $10 notional floor for orders, funding shortfalls (including `--include-spot`), and source-chain mismatches. Operational errors surface a retry hint instead of raw provider text. 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_INSUFFICIENT_GAS | Insufficient native POL for gas on predict deposit | | INVALID_TICK_SIZE | Invalid --tick-size value for mm predict quote/place | | PREDICT_ERROR | Generic predict error | ## Earn errors[​](#earn-errors "Direct link to Earn errors") | Code | Meaning | | ------------------------- | ----------------------------------------------------- | | EARN_VAULT_NOT_FOUND | Yield vault not found for the specified token/chain | | EARN_INSUFFICIENT_BALANCE | Insufficient balance for earn supply | | EARN_WITHDRAW_REVERTED | Withdraw transaction reverted (retried automatically) | | EARN_ERROR | Generic earn error | ## Server-wallet errors[​](#server-wallet-errors "Direct link to Server-wallet errors") | Code | Meaning | | ----------------- | --------------------------------------------------- | | JOB_TIMEOUT | Wallet job timed out (default 10 minutes, max 600s) | | REQUEST_NOT_FOUND | Server-wallet request not found | ## 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/)