nova

nova is a Node.js CLI tool for easily interacting with stablecoins. It provides simple commands to check balance, send, receive, withdraw, and share funds via claim links.

✨ Features

• 🪙 Receive stablecoins
• 💰 Check balance
• 📤 Send stablecoins to anyone for free
• 🔗 Generate shareable claim links
• 📥 Withdraw stablecoins to external blockchains
• 🔐 Multiple authentication methods

🚀 Quick Start

Get up and running in under a minute:

git clone https://github.com/MynthAI/nova.git
cd nova
pnpm install
pnpm link

Authenticate and start using Nova:

nova login you@example.com
nova balance
nova send 10 friend@example.com

Use -h or --help with any command to see detailed usage information.

📦 Installation

Requirements

• Node.js v24 (required)
• pnpm package manager

Clone the repository and install dependencies:

cd nova
pnpm install
pnpm link

After linking, the nova command will be available globally.

ℹ️ Nova is currently installed from source. If/when it is published to npm, installation instructions will be updated.

🔐 Authentication

Nova supports two authentication methods. You can choose the one that best fits your workflow and security preferences.

1️⃣ Email-based Authentication (Recommended)

Authenticate using your email address. Nova creates and manages a wallet for your account.

How it works

• You log in using your email address
• Nova securely manages your wallet
• You generate an authentication token for CLI access

Commands

nova login <email>
nova token

Best for

• New users
• Fast setup
• Users who don’t want to manage private keys

Pros

• Simple and beginner-friendly
• No manual key management
• Account recovery via email

Cons

• Requires trust in Nova for key management
• Email access is required

2️⃣ Private Key Authentication (Self-custody)

Authenticate by importing an existing wallet using a private key or mnemonic seed phrase. All signing happens locally.

Commands

nova import key
nova import phrase

Best for

• Advanced users
• Full self-custody
• Using an existing wallet

Pros

• Full control over your funds
• No email required
• Keys never leave your machine

Cons

• You are responsible for key security
• No recovery if keys are lost

⚠️ Warning: If you lose your private key or seed phrase, your funds cannot be recovered.

🔄 Switching Authentication Methods

• Email-based accounts can export their wallet and move to self-custody
• Private-key accounts cannot be converted to email-based authentication

🚀 Usage

After building, the nova command will be available. The nova CLI provides commands to manage your account, wallet, and transactions.

General Syntax

nova [options] [command]

Use -h or --help with any command to see detailed help.

Commands

login

Login using your email address.

nova login <email>

Arguments

• email — Email address to log in with

token

Create an authentication token (email-based accounts only).

nova token

address

Display your account address.

nova address

balance

Show your current account balance.

nova balance

send

Send funds to another Nova account or generate a claim link.

nova send <amount> [destination]

Arguments

• amount — Amount to send
• destination (optional) — Recipient email or Nova account address

Behavior

• If destination is provided, funds are sent directly to that account
• If destination is omitted, Nova generates a claim link

nova send 25

Example output:

Sent 25 to https://www.mynth.ai/c/MUhW0KzcB1BVxNRicamrRw

Anyone with the link can claim the funds. Once claimed, the link becomes invalid.

Claim links

• Claim links represent a one-time transferable balance
• The first person to claim the link receives the funds
• Links can be shared via chat, email, or any messaging platform
• Unclaimed funds remain locked until claimed

⚠️ Warning: Anyone with access to the claim link can claim the funds. Share links carefully.

withdraw

Withdraw funds to an external blockchain as a stablecoin.

nova withdraw <amount> <stablecoin> <address> <blockchain>

Arguments

• amount — Amount to withdraw
• stablecoin — Stablecoin to withdraw as
• address — Destination blockchain address
• blockchain — Target blockchain (required if it cannot be inferred from the address)

config

Manage Nova configuration values.

nova config get <key>
nova config set <key> <value>

import

Import an existing wallet.

nova import key
nova import phrase

• key — Import wallet using a private key
• phrase — Import wallet using a mnemonic seed phrase

export

Export sensitive wallet data.

nova export key
nova export phrase

• key — Export the wallet’s private key
• phrase — Export the wallet’s mnemonic seed phrase

⚠️ Warning: Exported data is highly sensitive. Store it securely.

🛠 Development

Lint the project:

pnpm lint

Format code:

pnpm prettier

Build the project:

pnpm build

📄 License

This project is licensed under the terms of the MIT License. See the LICENSE file for details.