MNEE CLI

The MNEE CLI tool is a command-line interface for managing MNEE tokens and wallets. It provides a secure way to create, manage, and interact with MNEE wallets across different environments.

The open source repo can be found here.

Installation

npm install -g @mnee/cli

Available Commands

Create a New Wallet

mnee create

Creates a new wallet with the following features:

  • Generates a new private key

  • Securely stores the encrypted key

  • Allows naming the wallet

  • Supports both production and sandbox environments

  • Sets up password protection

View Wallet Address

mnee address

Displays the address of your currently active wallet.

Check Balance

mnee balance

Shows the current MNEE balance of your active wallet.

View Transaction History

mnee history

Displays the transaction history for your active wallet.Options:

  • -u, --unconfirmed: Show only unconfirmed transactions

  • -f, --fresh: Clear cache and fetch fresh history from the beginning

Transfer MNEE

mnee transfer

Initiates a transfer of MNEE tokens to another address. The command will:

  1. Prompt for the recipient's address

  2. Ask for the amount to transfer

  3. Request your wallet password for security

  4. Execute the transfer and provide a transaction ID

Export Private Key

mnee export

Exports your wallet's private key in WIF format. This command:

  • Requires your wallet password

  • Includes a security confirmation step

  • Displays the key in a secure format

Delete a Wallet

mnee delete <walletName>

Deletes a specified wallet. Features:

  • Requires password confirmation

  • Automatically switches to another wallet if available

  • Cannot be undone

List Wallets

mnee list

Shows all your wallets and allows you to:

  • View all wallet names and addresses

  • See which wallet is currently active

  • Switch between wallets

Rename a Wallet

mnee rename <oldName> <newName>

Renames an existing wallet. The new name must:

  • Be between 1-50 characters

  • Contain only letters, numbers, hyphens, and underscores

  • Not contain spaces

  • Be unique among your wallets

Import Existing Wallet

mnee import

Imports an existing wallet using a WIF private key. The process:

  1. Prompts for the WIF key

  2. Allows setting a new name

  3. Requires password creation

  4. Encrypts and stores the key securely

Authentication & Developer Portal

Login

mnee login

Authenticate with the MNEE Developer Portal

Logout

mnee logout

Sign out of the MNEE Developer Portal

Who Am I?

mnee whoami

Show current authenticated user information

Faucet

mnee faucet

Request sandbox tokens (requires authentication)

You can also use -a <address> or --address <address> to specify a specific deposit address


Environment Support

The CLI supports two environments:

  • Production: For real MNEE tokens

  • Sandbox: For testing purposes

Security Features

  • All private keys are encrypted before storage

  • Password protection for sensitive operations

  • Secure key storage using system keychain

  • Confirmation prompts for dangerous operations

Best Practices

  1. Always keep your password secure

  2. Regularly backup your wallet information

  3. Use the sandbox environment for testing

  4. Never share your private key or password

  5. Use strong, unique passwords for each wallet

Error Handling

The CLI includes comprehensive error handling for:

  • Invalid commands

  • Network issues

  • Authentication failures

  • Invalid inputs

  • Duplicate wallet names

  • Incorrect passwords

Last updated