midnight-wallet-cli 0.1.10 → 0.2.0

package/README.md

@@ -4,7 +4,7 @@
 [![npm downloads](https://img.shields.io/npm/dm/midnight-wallet-cli)](https://npm-stat.com/charts.html?package=midnight-wallet-cli)
 [![License](https://img.shields.io/npm/l/midnight-wallet-cli)](https://www.apache.org/licenses/LICENSE-2.0)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue?logo=typescript)](https://www.typescriptlang.org/)
-[![CI](https://github.com/nel349/midnight-wallet-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/nel349/midnight-wallet-cli/actions/workflows/ci.yml)
+
 
 A standalone CLI wallet for the Midnight blockchain. Manage wallets, check balances, transfer NIGHT tokens, and run a local network — all from the terminal.
 
@@ -20,7 +20,11 @@ This installs two commands: `midnight` (or `mn` for short) and `midnight-wallet-
 
 | Command | Description |
 |---------|-------------|
-| `midnight generate` | Generate a new wallet or restore from seed/mnemonic |
+| `midnight wallet generate <name>` | Create a named wallet and set it as active |
+| `midnight wallet list` | List all wallets with active marker |
+| `midnight wallet use <name>` | Set the active wallet |
+| `midnight wallet info [name]` | Show wallet details |
+| `midnight wallet remove <name>` | Remove a wallet |
 | `midnight info` | Display wallet address, network, creation date |
 | `midnight balance [address]` | Check unshielded NIGHT balance |
 | `midnight transfer <to> <amount>` | Send NIGHT tokens to another address |
@@ -30,27 +34,38 @@ This installs two commands: `midnight` (or `mn` for short) and `midnight-wallet-
 | `midnight address --seed <hex>` | Derive an address from a seed |
 | `midnight genesis-address` | Show the genesis wallet address |
 | `midnight inspect-cost` | Display current block cost limits |
-| `midnight config get/set` | Manage persistent config (default network, etc.) |
+| `midnight serve` | Start DApp Connector server (WebSocket JSON-RPC) |
+| `midnight config get/set` | Manage persistent config (network, wallet, endpoints) |
 | `midnight localnet up/stop/down/status` | Manage a local Midnight network via Docker |
 | `midnight help [command]` | Show usage for all or a specific command |
 
 ## Quick Start
 
+### Preprod (testnet)
+
+```bash
+# Generate a wallet on preprod
+midnight wallet generate alice --network preprod
+
+# Check balance
+midnight balance
+```
+
+### Local development
+
 ```bash
 # Start local network
 midnight localnet up
 
 # Generate a wallet
-midnight generate --network undeployed
+midnight wallet generate dev --network undeployed
 
 # Airdrop tokens and register dust
 midnight airdrop 1000
 midnight dust register
 
-# Check balance
+# Check balance and transfer
 midnight balance
-
-# Transfer NIGHT
 midnight transfer mn_addr_undeployed1... 100
 ```
 
@@ -58,8 +73,11 @@ midnight transfer mn_addr_undeployed1... 100
 
 | Network | Description |
 |---------|-------------|
+| `preprod` | Midnight pre-production testnet |
 | `undeployed` | Local network via Docker (`midnight localnet up`) |
 
+Use `--network <name>` to select a network, or persist it with `midnight config set network preprod`.
+
 ## JSON Output for Automation
 
 Every command supports `--json` for structured output:
@@ -91,8 +109,7 @@ Create `.mcp.json` in your project root:
 {
   "mcpServers": {
     "midnight-wallet": {
-      "command": "npx",
-      "args": ["-y", "midnight-wallet-cli@latest", "--mcp"]
+      "command": "midnight-wallet-mcp"
     }
   }
 }
@@ -106,8 +123,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 {
   "mcpServers": {
     "midnight-wallet": {
-      "command": "npx",
-      "args": ["-y", "midnight-wallet-cli@latest", "--mcp"]
+      "command": "midnight-wallet-mcp"
     }
   }
 }
@@ -121,8 +137,7 @@ Create `.cursor/mcp.json` in your project root:
 {
   "mcpServers": {
     "midnight-wallet": {
-      "command": "npx",
-      "args": ["-y", "midnight-wallet-cli@latest", "--mcp"]
+      "command": "midnight-wallet-mcp"
     }
   }
 }
@@ -137,8 +152,7 @@ Create `.vscode/mcp.json` in your project root:
   "servers": {
     "midnight-wallet": {
       "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "midnight-wallet-cli@latest", "--mcp"]
+      "command": "midnight-wallet-mcp"
     }
   }
 }
@@ -152,22 +166,26 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
 {
   "mcpServers": {
     "midnight-wallet": {
-      "command": "npx",
-      "args": ["-y", "midnight-wallet-cli@latest", "--mcp"]
+      "command": "midnight-wallet-mcp"
     }
   }
 }
 ```
 
-> **Tip:** If you installed globally (`npm install -g midnight-wallet-cli`), you can use `"command": "midnight-wallet-mcp"` instead of the `npx` form.
+> **Tip:** If you haven't installed globally, use `"command": "npx"` with `"args": ["-y", "midnight-wallet-cli@latest", "--mcp"]` instead.
 
 ### Available MCP Tools
 
-Once connected, your AI agent gets access to 17 tools:
+Once connected, your AI agent gets access to 22 tools:
 
 | Tool | Description |
 |------|-------------|
-| `midnight_generate` | Generate or restore a wallet |
+| `midnight_wallet_generate` | Create a named wallet |
+| `midnight_wallet_list` | List all wallets |
+| `midnight_wallet_use` | Set active wallet |
+| `midnight_wallet_info` | Show wallet details |
+| `midnight_wallet_remove` | Remove a wallet |
+| `midnight_generate` | Generate a wallet (deprecated) |
 | `midnight_info` | Show wallet info (no secrets) |
 | `midnight_balance` | Check NIGHT balance |
 | `midnight_address` | Derive address from seed |
@@ -195,4 +213,4 @@ For documentation, guides, and more: [midnight-wallet-cli-hub](https://github.co
 
 - Node.js >= 20
 - Docker (for `midnight localnet` commands)
-- A running proof server on `localhost:6300` (for transactions on undeployed network)
+- A running proof server on `localhost:6300` (for transactions — required on all networks)