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

🤖 AI Agent Integration

Nova can be used directly by AI agents via Vercel Skills.

Install with Vercel Skills CLI

npx skills add MynthAI/nova

Once installed, the skill is automatically available to your AI agent. The agent will invoke Nova commands when relevant tasks are detected.

Example Agent Prompts

• Sign-in to my wallet with me@email.com
• Create a $10 claim link

🚀 Quick Start

Get up and running in under a minute:

Option 1: Install from npm

npm install @mynthai/nova

Or run directly without installing:

npx @mynthai/nova --help

Option 2: Build from source

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

Authenticate and start using Nova:

nova login request you@example.com
nova login confirm 123456
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 (for building from source)

Install from npm

npm install @mynthai/nova

You can also run Nova directly with npx without installing it globally:

npx @mynthai/nova --help

Install from source

Clone the repository and install dependencies:

cd nova
pnpm install
pnpm build
pnpm link

After linking, the nova command will be available globally.

🔐 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 start login by requesting an authentication code to your email
• You confirm the code to complete login
• Nova securely manages your wallet
• You generate an authentication token for CLI access

Commands

nova login request <email>
nova login confirm <code>
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 (non-interactive 2-step flow).

nova login request <email>
nova login confirm <code>

Commands

• request <email> — Send an authentication code to the email address
• confirm <code> — Confirm the authentication code and complete login

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

Options

• -d, --dry-run — Preview the transaction without submitting it

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)

Options

• -d, --dry-run — Preview the transaction without submitting it

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.