midnight-wallet-cli 0.1.3 → 0.1.5

package/README.md

@@ -6,7 +6,7 @@
 [![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 devnet — all from the terminal.
+A standalone CLI wallet for the Midnight blockchain. Manage wallets, check balances, transfer NIGHT tokens, and run a local network — all from the terminal.
 
 ## Install
 
@@ -14,7 +14,7 @@ A standalone CLI wallet for the Midnight blockchain. Manage wallets, check balan
 npm install -g midnight-wallet-cli
 ```
 
-This installs three commands: `midnight` (or `mn` for short) and `midnight-wallet-mcp`.
+This installs two commands: `midnight` (or `mn` for short) and `midnight-wallet-mcp`.
 
 ## Commands
 
@@ -24,7 +24,7 @@ This installs three commands: `midnight` (or `mn` for short) and `midnight-walle
 | `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 |
-| `midnight airdrop <amount>` | Fund wallet from genesis (local devnet only) |
+| `midnight airdrop <amount>` | Fund wallet from genesis (undeployed network only) |
 | `midnight dust register` | Register NIGHT UTXOs for dust (fee token) generation |
 | `midnight dust status` | Check dust registration status and balance |
 | `midnight address --seed <hex>` | Derive an address from a seed |
@@ -37,29 +37,28 @@ This installs three commands: `midnight` (or `mn` for short) and `midnight-walle
 ## Quick Start
 
 ```bash
+# Start local network
+midnight localnet up
+
 # Generate a wallet
-midnight generate --network preprod
+midnight generate --network undeployed
+
+# Airdrop tokens and register dust
+midnight airdrop 1000
+midnight dust register
 
 # Check balance
 midnight balance
 
 # Transfer NIGHT
-midnight transfer mn_addr_preprod1... 100
-
-# Local devnet: start network, airdrop, register dust
-midnight localnet up
-midnight generate --network undeployed
-midnight airdrop 1000
-midnight dust register
+midnight transfer mn_addr_undeployed1... 100
 ```
 
 ## Supported Networks
 
 | Network | Description |
 |---------|-------------|
-| `preprod` | Midnight pre-production testnet |
-| `preview` | Midnight preview testnet |
-| `undeployed` | Local devnet via Docker (`midnight localnet up`) |
+| `undeployed` | Local network via Docker (`midnight localnet up`) |
 
 ## JSON Output for Automation
 
@@ -190,4 +189,4 @@ Once connected, your AI agent gets access to 17 tools:
 
 - Node.js >= 20
 - Docker (for `midnight localnet` commands)
-- A running proof server on `localhost:6300` (for transactions on local devnet)
+- A running proof server on `localhost:6300` (for transactions on undeployed network)

package/dist/wallet.js

@@ -102,10 +102,13 @@ function green(text) {
 function yellow(text) {
   return fg(text, YELLOW_CODE);
 }
+function white(text) {
+  return fg(text, WHITE_CODE);
+}
 function gray(text) {
   return fg(text, DIM_GRAY);
 }
-var ESC = "\x1B[", RESET = "\x1B[0m", TEAL = 38, DIM_GRAY = 245, RED_CODE = 196, GREEN_CODE = 40, YELLOW_CODE = 226;
+var ESC = "\x1B[", RESET = "\x1B[0m", TEAL = 38, WHITE_CODE = 15, DIM_GRAY = 245, RED_CODE = 196, GREEN_CODE = 40, YELLOW_CODE = 226;
 
 // src/ui/format.ts
 function header(title, width = DEFAULT_WIDTH) {
@@ -2810,6 +2813,26 @@ var init_mcp_server = __esm(() => {
 });
 
 // src/ui/art.ts
+function getWordmarkTypingFrame(progress) {
+  const clamped = Math.max(0, Math.min(1, progress));
+  const width = WORDMARK_BIG[0].length;
+  const visibleCols = Math.floor(clamped * width);
+  return WORDMARK_BIG.map((line) => line.slice(0, visibleCols).padEnd(width));
+}
+function getWordmarkMaterializeFrame(progress) {
+  const clamped = Math.max(0, Math.min(1, progress));
+  const seed = Math.floor(progress * 100);
+  if (clamped >= 1)
+    return WORDMARK_BIG;
+  return WORDMARK_BIG.map((line, row) => Array.from(line).map((ch, col) => {
+    if (ch === " ")
+      return " ";
+    if (clamped <= 0)
+      return noiseChar(row + 20, col, 0);
+    const threshold = ((row + 20) * 131 + col * 997) % 100 / 100;
+    return clamped >= threshold ? ch : noiseChar(row + 20, col, seed);
+  }).join(""));
+}
 function noiseChar(row, col, seed) {
   const hash = (row * 131 + col * 997 + seed * 7919) % 65537 / 65537;
   return NOISE_CHARS[Math.floor(hash * NOISE_CHARS.length)];
@@ -2833,26 +2856,30 @@ function getMaterializeFrame(progress) {
   }).join("")).join(`
 `);
 }
-function getWordmarkFrame(progress) {
-  const clamped = Math.max(0, Math.min(1, progress));
-  const visibleChars = Math.floor(clamped * WORDMARK.length);
-  return WORDMARK.slice(0, visibleChars);
-}
-var MIDNIGHT_LOGO, WORDMARK = "m i d n i g h t", COMMAND_BRIEFS, NOISE_CHARS;
+var MIDNIGHT_LOGO, WORDMARK_BIG, COMMAND_BRIEFS, NOISE_CHARS;
 var init_art = __esm(() => {
   MIDNIGHT_LOGO = [
-    "        ██████████████        ",
-    "      ██              ██      ",
-    "    ██      ██████      ██    ",
-    "   ██       ██████       ██   ",
-    "   ██                    ██   ",
-    "   ██       ██████       ██   ",
-    "   ██       ██████       ██   ",
-    "    ██                  ██    ",
-    "      ██              ██      ",
-    "        ██████████████        "
+    "          ████████████          ",
+    "       ███            ███       ",
+    "     ███       ██       ███     ",
+    "    ██                    ██    ",
+    "   ██          ██          ██   ",
+    "   ██                      ██   ",
+    "   ██          ██          ██   ",
+    "   ██                      ██   ",
+    "   ██                      ██   ",
+    "   ██                      ██   ",
+    "    ██                    ██    ",
+    "     ███                ███     ",
+    "       ███            ███       ",
+    "          ████████████          "
   ].join(`
 `);
+  WORDMARK_BIG = [
+    "█▄ ▄█ █ █▀▄ █▄ █ █ █▀▀ █ █ ▀█▀",
+    "█ █ █ █ █ █ █ ██ █ █ █ █▀█  █ ",
+    "▀   ▀ ▀ ▀▀  ▀  ▀ ▀ ▀▀▀ ▀ ▀  ▀ "
+  ];
   COMMAND_BRIEFS = [
     ["generate", "Generate or restore a wallet"],
     ["info", "Display wallet metadata"],
@@ -2884,34 +2911,38 @@ function sleep(ms, signal) {
     }, { once: true });
   });
 }
-function writeLine(text) {
-  process.stderr.write(`\r${text}\x1B[K`);
-}
 async function animateMaterialize(signal, sideContent) {
   const totalFrames = 20;
   const logoLines = MIDNIGHT_LOGO.split(`
 `);
   const logoLineCount = logoLines.length;
+  const rightCol = 36;
+  const totalHeight = Math.max(logoLineCount, sideContent?.length ?? 0);
+  const wordmarkLineCount = 3;
   if (!isColorEnabled()) {
-    for (let j = 0;j < logoLineCount; j++) {
-      const left = logoLines[j].padEnd(30);
+    for (let j = 0;j < totalHeight; j++) {
+      const left = (j < logoLineCount ? logoLines[j] : "").padEnd(rightCol - 1);
       const right = sideContent?.[j] ?? "";
-      process.stderr.write((sideContent ? left + "    " + right : left) + `
+      process.stderr.write(left + right + `
 `);
     }
-    const wordmarkLine = `       ${WORDMARK}`;
-    const footerSide2 = sideContent?.[logoLineCount] ?? "";
-    process.stderr.write((footerSide2 ? wordmarkLine.padEnd(34) + footerSide2 : wordmarkLine) + `
+    return;
+  }
+  function renderFrame(frameLogoLines, rightLines) {
+    for (let j = 0;j < totalHeight; j++) {
+      const left = j < frameLogoLines.length ? white(frameLogoLines[j]) : "";
+      const right = rightLines[j] ?? "";
+      if (right) {
+        process.stderr.write(left + `\x1B[${rightCol}G` + right + `\x1B[K
 `);
-    if (sideContent) {
-      for (let j = logoLineCount + 1;j < sideContent.length; j++) {
-        if (sideContent[j]) {
-          process.stderr.write(" ".repeat(34) + sideContent[j] + `
+      } else {
+        process.stderr.write(left + `\x1B[K
 `);
-        }
       }
     }
-    return;
+  }
+  function moveUp() {
+    process.stderr.write(`\x1B[${totalHeight}A`);
   }
   for (let i = 0;i <= totalFrames; i++) {
     if (signal?.aborted)
@@ -2920,42 +2951,51 @@ async function animateMaterialize(signal, sideContent) {
     const frame = getMaterializeFrame(progress);
     const frameLines = frame.split(`
 `);
-    if (i > 0) {
-      process.stderr.write(`\x1B[${logoLineCount}A`);
-    }
-    for (let j = 0;j < logoLineCount; j++) {
-      const left = teal(frameLines[j]);
-      const right = sideContent?.[j] ?? "";
-      const line = sideContent ? left + `\x1B[35G` + right : left;
-      process.stderr.write(line + `\x1B[K
-`);
-    }
+    if (i > 0)
+      moveUp();
+    renderFrame(frameLines, []);
     await sleep(FRAME_MS, signal);
   }
-  const wordmarkFrames = 15;
-  const footerSide = sideContent?.[logoLineCount] ?? "";
-  for (let i = 0;i <= wordmarkFrames; i++) {
+  const typingFrames = 20;
+  for (let i = 0;i <= typingFrames; i++) {
     if (signal?.aborted)
       break;
-    const progress = i / wordmarkFrames;
-    const partial = getWordmarkFrame(progress);
-    if (footerSide) {
-      writeLine(`       ${bold(teal(partial))}\x1B[35G${footerSide}`);
-    } else {
-      writeLine(`       ${bold(teal(partial))}`);
-    }
+    const progress = i / typingFrames;
+    const typedLines = getWordmarkTypingFrame(progress);
+    moveUp();
+    const rightLines = new Array(totalHeight).fill(null);
+    for (let j = 0;j < typedLines.length; j++) {
+      rightLines[j] = bold(white(typedLines[j]));
+    }
+    renderFrame(logoLines, rightLines);
     await sleep(FRAME_MS, signal);
   }
-  process.stderr.write(`
-`);
+  const flashFrames = 12;
+  for (let i = 0;i <= flashFrames; i++) {
+    if (signal?.aborted)
+      break;
+    const progress = i / flashFrames;
+    const flashedLines = getWordmarkMaterializeFrame(progress);
+    moveUp();
+    const rightLines = new Array(totalHeight).fill(null);
+    for (let j = 0;j < flashedLines.length; j++) {
+      rightLines[j] = bold(white(flashedLines[j]));
+    }
+    renderFrame(logoLines, rightLines);
+    await sleep(FRAME_MS, signal);
+  }
+  moveUp();
+  const fullRight = new Array(totalHeight).fill(null);
   if (sideContent) {
-    for (let j = logoLineCount + 1;j < sideContent.length; j++) {
-      if (sideContent[j]) {
-        process.stderr.write(`\x1B[35G${sideContent[j]}\x1B[K
-`);
+    for (let j = 0;j < sideContent.length; j++) {
+      if (j < wordmarkLineCount) {
+        fullRight[j] = bold(white(sideContent[j]));
+      } else {
+        fullRight[j] = sideContent[j];
       }
     }
   }
+  renderFrame(logoLines, fullRight);
 }
 var FRAME_MS = 80;
 var init_animate = __esm(() => {
@@ -2969,8 +3009,12 @@ __export(exports_help, {
   COMMAND_SPECS: () => COMMAND_SPECS
 });
 import { createRequire as createRequire2 } from "node:module";
-function buildSideContent() {
+function buildRightColumn() {
   const lines = [];
+  for (const wl of WORDMARK_BIG) {
+    lines.push(wl);
+  }
+  lines.push("");
   lines.push(bold("Commands"));
   for (const [name, brief] of COMMAND_BRIEFS) {
     lines.push(`${teal(name.padEnd(18))}${brief}`);
@@ -3199,8 +3243,8 @@ async function helpCommand(args) {
     printPlainHelp();
     return;
   }
-  const sideContent = buildSideContent();
-  await animateMaterialize(undefined, sideContent);
+  const rightColumn = buildRightColumn();
+  await animateMaterialize(undefined, rightColumn);
 }
 var COMMAND_SPECS;
 var init_help = __esm(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "midnight-wallet-cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "description": "Git-style CLI wallet for the Midnight blockchain",
   "license": "Apache-2.0",