zoa-wallet 0.2.3 → 0.2.5

package/dist/index.mjs

@@ -22224,6 +22224,63 @@ async function deleteConfigValue(key) {
 function getConfigFilePath() {
   return CONFIG_FILE;
 }
+function generateWalletId() {
+  const hex = Array.from(crypto.getRandomValues(new Uint8Array(4))).map((b) => b.toString(16).padStart(2, "0")).join("");
+  return `w_${hex}`;
+}
+async function getWallets() {
+  const config = await loadConfig();
+  return config.wallets ?? [];
+}
+async function getActiveWallet() {
+  const config = await loadConfig();
+  if (!config.activeWalletId || !config.wallets?.length)
+    return null;
+  return config.wallets.find((w) => w.id === config.activeWalletId) ?? null;
+}
+async function getActiveAccountIndex() {
+  const config = await loadConfig();
+  return config.activeAccountIndex ?? 0;
+}
+async function addWallet(entry) {
+  const config = await loadConfig();
+  config.wallets = config.wallets ?? [];
+  config.wallets.push(entry);
+  if (!config.activeWalletId) {
+    config.activeWalletId = entry.id;
+  }
+  await saveConfig(config);
+}
+async function removeWallet(id) {
+  const config = await loadConfig();
+  config.wallets = (config.wallets ?? []).filter((w) => w.id !== id);
+  if (config.activeWalletId === id) {
+    config.activeWalletId = config.wallets[0]?.id;
+    config.activeAccountIndex = 0;
+  }
+  await saveConfig(config);
+}
+async function setActiveWallet(id) {
+  const config = await loadConfig();
+  const wallet = (config.wallets ?? []).find((w) => w.id === id);
+  if (!wallet)
+    throw new Error(`Wallet ${id} not found`);
+  config.activeWalletId = id;
+  config.activeAccountIndex = 0;
+  wallet.lastUsedAt = Date.now();
+  await saveConfig(config);
+}
+async function updateWallet(id, updates) {
+  const config = await loadConfig();
+  const wallet = (config.wallets ?? []).find((w) => w.id === id);
+  if (!wallet)
+    throw new Error(`Wallet ${id} not found`);
+  if (updates.label !== void 0)
+    wallet.label = updates.label;
+  if (updates.color !== void 0)
+    wallet.color = updates.color;
+  await saveConfig(config);
+}
 
 // dist/utils/output.js
 var _outputMode = "pretty";
@@ -44074,6 +44131,49 @@ var ChainAdapterRegistry = class {
 };
 var chainRegistry = new ChainAdapterRegistry();
 
+// dist/commands/balance.js
+import inquirer from "inquirer";
+
+// dist/utils/format.js
+function truncateAddress(address, chars = 6) {
+  if (address.length <= chars * 2 + 3)
+    return address;
+  return `${address.slice(0, chars + 2)}...${address.slice(-chars)}`;
+}
+function formatBalance(balance, decimals = 4) {
+  const num2 = typeof balance === "string" ? Number.parseFloat(balance) : balance;
+  if (num2 === 0)
+    return "0";
+  if (num2 < 1e-4)
+    return "< 0.0001";
+  return num2.toFixed(decimals).replace(/\.?0+$/, "");
+}
+function formatUSD(value) {
+  if (value < 0.01)
+    return "< $0.01";
+  return `$${value.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+}
+function timeAgo(timestamp) {
+  const seconds = Math.floor((Date.now() - timestamp * 1e3) / 1e3);
+  if (seconds < 60)
+    return `${seconds}s ago`;
+  const minutes = Math.floor(seconds / 60);
+  if (minutes < 60)
+    return `${minutes}m ago`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24)
+    return `${hours}h ago`;
+  const days = Math.floor(hours / 24);
+  if (days < 30)
+    return `${days}d ago`;
+  const months = Math.floor(days / 30);
+  return `${months}mo ago`;
+}
+function formatGas(wei, decimals = 18) {
+  const value = Number(wei) / 10 ** decimals;
+  return formatBalance(value, 6);
+}
+
 // ../../packages/wallet-core/dist/storage.js
 function uint8ToBase64(bytes) {
   let binary = "";
@@ -47399,17 +47499,17 @@ async function decryptVault(vault, password) {
     throw new Error("Incorrect password or corrupted vault");
   }
 }
-async function saveVault(vault, storage) {
+async function saveVault(vault, storage, key) {
   const backend = storage ?? getDefaultStorage();
-  await backend.save(VAULT_KEY, vault);
+  await backend.save(key ?? VAULT_KEY, vault);
 }
-async function loadVault(storage) {
+async function loadVault(storage, key) {
   const backend = storage ?? getDefaultStorage();
-  return backend.load(VAULT_KEY);
+  return backend.load(key ?? VAULT_KEY);
 }
-async function hasVault(storage) {
+async function hasVault(storage, key) {
   const backend = storage ?? getDefaultStorage();
-  return backend.has(VAULT_KEY);
+  return backend.has(key ?? VAULT_KEY);
 }
 async function deriveEncryptionKey(password, salt, iterations) {
   const encoder5 = new TextEncoder();
@@ -47449,8 +47549,10 @@ var KeyringManager = class {
   _seed = null;
   _accounts = [];
   _storage;
-  constructor(storage) {
+  _vaultKey;
+  constructor(storage, vaultKey) {
     this._storage = storage;
+    this._vaultKey = vaultKey;
   }
   get state() {
     return this._state;
@@ -47464,12 +47566,12 @@ var KeyringManager = class {
     const account = await this.deriveAccount(0, "Account 1");
     this._accounts = [account];
     const vault = await encryptVault(this._mnemonic, password, [{ index: 0, label: "Account 1" }]);
-    await saveVault(vault, this._storage);
+    await saveVault(vault, this._storage, this._vaultKey);
     this.persistSession();
     this._state = "unlocked";
   }
   async unlock(password) {
-    const vault = await loadVault(this._storage);
+    const vault = await loadVault(this._storage, this._vaultKey);
     if (!vault) {
       throw new Error("No vault found. Initialize a wallet first.");
     }
@@ -47491,7 +47593,7 @@ var KeyringManager = class {
     if (!sessionMnemonic)
       return false;
     try {
-      const vault = await loadVault(this._storage);
+      const vault = await loadVault(this._storage, this._vaultKey);
       if (!vault)
         return false;
       this._mnemonic = sessionMnemonic;
@@ -47581,7 +47683,7 @@ var KeyringManager = class {
     return `0x${bytesToHex7(account.keys.evm.privateKey)}`;
   }
   async hasVault() {
-    return hasVault(this._storage);
+    return hasVault(this._storage, this._vaultKey);
   }
   requireUnlocked() {
     if (this._state !== "unlocked") {
@@ -47606,13 +47708,13 @@ var KeyringManager = class {
   async persistAccountMetadata() {
     if (!this._mnemonic)
       return;
-    const vault = await loadVault(this._storage);
+    const vault = await loadVault(this._storage, this._vaultKey);
     if (vault) {
       vault.accounts = this._accounts.map((a) => ({
         index: a.index,
         label: a.label
       }));
-      await saveVault(vault, this._storage);
+      await saveVault(vault, this._storage, this._vaultKey);
     }
   }
   persistSession() {
@@ -47621,8 +47723,8 @@ var KeyringManager = class {
     }
   }
 };
-function createKeyring(storage) {
-  return new KeyringManager(storage);
+function createKeyring(storage, vaultKey) {
+  return new KeyringManager(storage, vaultKey);
 }
 var keyring = new KeyringManager();
 
@@ -47678,47 +47780,46 @@ var FileStorage = class {
   }
 };
 
-// dist/commands/balance.js
-import inquirer from "inquirer";
-
-// dist/utils/format.js
-function truncateAddress(address, chars = 6) {
-  if (address.length <= chars * 2 + 3)
-    return address;
-  return `${address.slice(0, chars + 2)}...${address.slice(-chars)}`;
-}
-function formatBalance(balance, decimals = 4) {
-  const num2 = typeof balance === "string" ? Number.parseFloat(balance) : balance;
-  if (num2 === 0)
-    return "0";
-  if (num2 < 1e-4)
-    return "< 0.0001";
-  return num2.toFixed(decimals).replace(/\.?0+$/, "");
-}
-function formatUSD(value) {
-  if (value < 0.01)
-    return "< $0.01";
-  return `$${value.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
-}
-function timeAgo(timestamp) {
-  const seconds = Math.floor((Date.now() - timestamp * 1e3) / 1e3);
-  if (seconds < 60)
-    return `${seconds}s ago`;
-  const minutes = Math.floor(seconds / 60);
-  if (minutes < 60)
-    return `${minutes}m ago`;
-  const hours = Math.floor(minutes / 60);
-  if (hours < 24)
-    return `${hours}h ago`;
-  const days = Math.floor(hours / 24);
-  if (days < 30)
-    return `${days}d ago`;
-  const months = Math.floor(days / 30);
-  return `${months}mo ago`;
+// dist/utils/wallet.js
+var LEGACY_VAULT_KEY = "zoa-vault";
+async function loadActiveWallet(password) {
+  await migrateLegacyVaultIfNeeded();
+  const wallet = await getActiveWallet();
+  if (!wallet) {
+    throw new Error("No wallet configured. Run 'zoa wallet create' or 'zoa init' first.");
+  }
+  const storage = new FileStorage();
+  const kr = createKeyring(storage, wallet.vaultKey);
+  await kr.unlock(password);
+  const accounts = kr.getAccounts();
+  const accountIndex = await getActiveAccountIndex();
+  const account = accounts[accountIndex] ?? accounts[0];
+  if (!account)
+    throw new Error("No accounts found in wallet.");
+  const config = await loadConfig();
+  const entry = (config.wallets ?? []).find((w) => w.id === wallet.id);
+  if (entry) {
+    entry.lastUsedAt = Date.now();
+    await saveConfig(config);
+  }
+  return { keyring: kr, wallet, account };
 }
-function formatGas(wei, decimals = 18) {
-  const value = Number(wei) / 10 ** decimals;
-  return formatBalance(value, 6);
+async function migrateLegacyVaultIfNeeded() {
+  const wallets = await getWallets();
+  if (wallets.length > 0)
+    return;
+  const storage = new FileStorage();
+  const hasLegacy = await storage.has(LEGACY_VAULT_KEY);
+  if (!hasLegacy)
+    return;
+  const id = generateWalletId();
+  await addWallet({
+    id,
+    label: "Default Wallet",
+    color: "#00bbf9",
+    vaultKey: LEGACY_VAULT_KEY,
+    createdAt: Date.now()
+  });
 }
 
 // dist/commands/balance.js
@@ -47750,13 +47851,7 @@ function registerBalanceCommand(program2) {
       const spinner = createSpinner("Unlocking wallet...");
       if (!isJsonMode())
         spinner.start();
-      const storage = new FileStorage();
-      const kr = createKeyring(storage);
-      await kr.unlock(password);
-      const accounts = kr.getAccounts();
-      const account = accounts[0];
-      if (!account)
-        throw new Error("No accounts found.");
+      const { account } = await loadActiveWallet(password);
       if (!isJsonMode())
         spinner.text = "  Fetching balances across networks...";
       let chainsToFetch = Object.entries(CHAIN_MAP);
@@ -47939,9 +48034,7 @@ function registerExportCommand(program2) {
       const spinner = createSpinner("Unlocking wallet...");
       if (!isJsonMode())
         spinner.start();
-      const storage = new FileStorage();
-      const kr = createKeyring(storage);
-      await kr.unlock(password);
+      const { keyring: kr } = await loadActiveWallet(password);
       if (!isJsonMode())
         spinner.stop();
       let exportType = opts.type;
@@ -48030,13 +48123,7 @@ function registerHistoryCommand(program2) {
       const spinner = createSpinner("Unlocking wallet...");
       if (!isJsonMode())
         spinner.start();
-      const storage = new FileStorage();
-      const kr = createKeyring(storage);
-      await kr.unlock(password);
-      const accounts = kr.getAccounts();
-      const account = accounts[0];
-      if (!account)
-        throw new Error("No accounts found.");
+      const { account } = await loadActiveWallet(password);
       const chainMap = {
         ethereum: ChainId.Ethereum,
         base: ChainId.Base,
@@ -48164,9 +48251,19 @@ function registerInitCommand(program2) {
       const spinner = createSpinner("Deriving keys and encrypting vault...");
       if (!isJsonMode())
         spinner.start();
+      const walletId = generateWalletId();
+      const vaultKey = `wallet_${walletId}`;
       const storage = new FileStorage();
-      const kr = createKeyring(storage);
+      const kr = createKeyring(storage, vaultKey);
       await kr.initialize(mnemonic, password);
+      await addWallet({
+        id: walletId,
+        label: "Default Wallet",
+        color: "#00bbf9",
+        vaultKey,
+        createdAt: Date.now()
+      });
+      await setActiveWallet(walletId);
       if (!isJsonMode())
         spinner.succeed("  Wallet initialized successfully!");
       const accounts = kr.getAccounts();
@@ -48289,13 +48386,7 @@ function registerReceiveCommand(program2) {
       const spinner = createSpinner("Unlocking wallet...");
       if (!isJsonMode())
         spinner.start();
-      const storage = new FileStorage();
-      const kr = createKeyring(storage);
-      await kr.unlock(password);
-      const accounts = kr.getAccounts();
-      const account = accounts[0];
-      if (!account)
-        throw new Error("No accounts found.");
+      const { account } = await loadActiveWallet(password);
       if (!isJsonMode())
         spinner.stop();
       const showEvm = !opts.chain || opts.chain === "evm";
@@ -48393,13 +48484,7 @@ function registerSendCommand(program2) {
       const spinner = createSpinner("Unlocking wallet...");
       if (!isJsonMode())
         spinner.start();
-      const storage = new FileStorage();
-      const kr = createKeyring(storage);
-      await kr.unlock(password);
-      const accounts = kr.getAccounts();
-      const account = accounts[0];
-      if (!account)
-        throw new Error("No accounts found.");
+      const { account } = await loadActiveWallet(password);
       if (!isJsonMode())
         spinner.text = "  Estimating gas...";
       const chainMap = {
@@ -48480,8 +48565,416 @@ function registerSendCommand(program2) {
   });
 }
 
-// dist/ui/banner.js
+// dist/commands/wallet.js
 import chalk3 from "chalk";
+import inquirer7 from "inquirer";
+var COLOR_PRESETS = [
+  { name: "Cyan", hex: "#00bbf9" },
+  { name: "Orange", hex: "#ff6b35" },
+  { name: "Purple", hex: "#7b2ff7" },
+  { name: "Green", hex: "#10b981" },
+  { name: "Pink", hex: "#ec4899" },
+  { name: "Yellow", hex: "#f59e0b" },
+  { name: "Red", hex: "#ef4444" },
+  { name: "Teal", hex: "#14b8a6" }
+];
+function registerWalletCommand(program2) {
+  const wallet = program2.command("wallet").description("Manage multiple wallets");
+  wallet.command("list").description("List all wallets").action(async () => {
+    try {
+      await migrateLegacyVaultIfNeeded();
+      const wallets = await getWallets();
+      const active = await getActiveWallet();
+      if (wallets.length === 0) {
+        output({ wallets: [] }, () => {
+          console.log(colors.muted("\n  No wallets configured. Run 'zoa wallet create' to get started.\n"));
+        });
+        return;
+      }
+      output({
+        wallets: wallets.map((w) => ({
+          ...w,
+          active: w.id === active?.id
+        })),
+        activeWalletId: active?.id
+      }, () => {
+        console.log(sectionHeader("Wallets"));
+        const table = createTable(["", "Label", "ID", "Created", "Last Used"], [4, 22, 14, 14, 14]);
+        for (const w of wallets) {
+          const isActive = w.id === active?.id;
+          const dot = chalk3.hex(w.color)("\u25CF");
+          const indicator = isActive ? ` ${chalk3.hex("#f59e0b")("\u2605")}` : "";
+          const label = isActive ? chalk3.bold(w.label) : w.label;
+          const created = new Date(w.createdAt).toLocaleDateString();
+          const lastUsed = w.lastUsedAt ? new Date(w.lastUsedAt).toLocaleDateString() : colors.muted("never");
+          table.push([
+            `${dot}${indicator}`,
+            label,
+            colors.muted(w.id),
+            colors.muted(created),
+            typeof lastUsed === "string" ? lastUsed : lastUsed
+          ]);
+        }
+        console.log(table.toString());
+        console.log();
+      });
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      outputError(msg);
+      if (!isJsonMode())
+        console.log(errorMsg(msg));
+      process.exitCode = 1;
+    }
+  });
+  wallet.command("create").description("Create a new wallet").option("--label <label>", "Wallet label").option("--color <hex>", "Wallet color (hex)").option("--mnemonic <phrase>", "Import mnemonic phrase").option("--password <password>", "Set wallet password").option("--word-count <count>", "Word count for new mnemonic: 12 or 24", "12").action(async (opts) => {
+    try {
+      let label;
+      let color;
+      let mnemonic;
+      let password;
+      let isNew = false;
+      if (opts.label && opts.password) {
+        label = opts.label;
+        color = opts.color || "#00bbf9";
+        if (opts.mnemonic) {
+          mnemonic = opts.mnemonic;
+        } else {
+          const wordCount = Number(opts.wordCount) === 24 ? 24 : 12;
+          const result = createMnemonic(wordCount);
+          mnemonic = result.phrase;
+          isNew = true;
+        }
+        password = opts.password;
+      } else {
+        if (!isJsonMode()) {
+          console.log(colors.brandBold("  Create New Wallet"));
+          console.log();
+        }
+        const { walletLabel } = await inquirer7.prompt([{
+          type: "input",
+          name: "walletLabel",
+          message: "Wallet label:",
+          default: "My Wallet",
+          validate: (input) => input.trim().length > 0 || "Label is required"
+        }]);
+        label = walletLabel;
+        const colorChoices = COLOR_PRESETS.map((c) => ({
+          name: `${chalk3.hex(c.hex)("\u25CF")} ${c.name}`,
+          value: c.hex
+        }));
+        colorChoices.push({ name: "Custom hex...", value: "custom" });
+        const { selectedColor } = await inquirer7.prompt([{
+          type: "list",
+          name: "selectedColor",
+          message: "Choose a color:",
+          choices: colorChoices
+        }]);
+        if (selectedColor === "custom") {
+          const { customHex } = await inquirer7.prompt([{
+            type: "input",
+            name: "customHex",
+            message: "Enter hex color (e.g. #ff6b35):",
+            validate: (input) => /^#[0-9a-fA-F]{6}$/.test(input) || "Enter a valid hex color"
+          }]);
+          color = customHex;
+        } else {
+          color = selectedColor;
+        }
+        const { action } = await inquirer7.prompt([{
+          type: "list",
+          name: "action",
+          message: "What would you like to do?",
+          choices: [
+            { name: "Create a new wallet", value: "create" },
+            { name: "Import from recovery phrase", value: "import" }
+          ]
+        }]);
+        if (action === "create") {
+          isNew = true;
+          const wordCount = Number(opts.wordCount) === 24 ? 24 : 12;
+          const result = createMnemonic(wordCount);
+          mnemonic = result.phrase;
+          if (!isJsonMode()) {
+            console.log();
+            console.log(warningBox("Recovery Phrase \u2014 Save This!", [
+              colors.warning("Write down these words and store them safely."),
+              colors.warning("Anyone with this phrase can access your funds."),
+              "",
+              colors.highlight(mnemonic),
+              "",
+              colors.muted(`${wordCount} words`)
+            ]));
+            console.log();
+          }
+        } else {
+          const { phrase } = await inquirer7.prompt([{
+            type: "input",
+            name: "phrase",
+            message: "Enter your recovery phrase:"
+          }]);
+          mnemonic = phrase.trim();
+        }
+        const { pwd } = await inquirer7.prompt([{
+          type: "password",
+          name: "pwd",
+          message: "Set a secure password:",
+          mask: "*",
+          validate: (input) => input.length >= 8 || "Password must be at least 8 characters"
+        }]);
+        await inquirer7.prompt([{
+          type: "password",
+          name: "confirmPwd",
+          message: "Confirm password:",
+          mask: "*",
+          validate: (input) => input === pwd || "Passwords do not match"
+        }]);
+        password = pwd;
+      }
+      const spinner = createSpinner("Creating wallet...");
+      if (!isJsonMode())
+        spinner.start();
+      const walletId = generateWalletId();
+      const vaultKey = `wallet_${walletId}`;
+      const storage = new FileStorage();
+      const kr = createKeyring(storage, vaultKey);
+      await kr.initialize(mnemonic, password);
+      await addWallet({
+        id: walletId,
+        label,
+        color,
+        vaultKey,
+        createdAt: Date.now()
+      });
+      await setActiveWallet(walletId);
+      if (!isJsonMode())
+        spinner.succeed("  Wallet created successfully!");
+      const accounts = kr.getAccounts();
+      const firstAccount = accounts[0];
+      if (firstAccount) {
+        output({
+          success: true,
+          isNew,
+          walletId,
+          label,
+          color,
+          account: {
+            index: firstAccount.index,
+            label: firstAccount.label,
+            evmAddress: firstAccount.evmAddress,
+            solanaAddress: firstAccount.solanaAddress
+          },
+          ...isNew ? { mnemonic } : {}
+        }, () => {
+          console.log();
+          console.log(successBox(`Wallet: ${label}`, [
+            kvLine("Wallet ID", walletId),
+            kvLine("EVM Address", firstAccount.evmAddress),
+            kvLine("Solana", firstAccount.solanaAddress),
+            "",
+            colors.muted("Vault encrypted and saved to ~/.zoa/")
+          ]));
+          console.log();
+        });
+      }
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      outputError(msg);
+      if (!isJsonMode())
+        console.log(errorMsg(msg));
+      process.exitCode = 1;
+    }
+  });
+  wallet.command("switch [id-or-label]").description("Switch active wallet").action(async (idOrLabel) => {
+    try {
+      await migrateLegacyVaultIfNeeded();
+      const wallets = await getWallets();
+      if (wallets.length === 0) {
+        throw new Error("No wallets configured. Run 'zoa wallet create' first.");
+      }
+      let targetId;
+      if (idOrLabel) {
+        const match = wallets.find((w) => w.id === idOrLabel || w.label.toLowerCase() === idOrLabel.toLowerCase() || w.id.includes(idOrLabel) || w.label.toLowerCase().includes(idOrLabel.toLowerCase()));
+        if (!match)
+          throw new Error(`No wallet found matching '${idOrLabel}'`);
+        targetId = match.id;
+      } else {
+        const active = await getActiveWallet();
+        const { selected } = await inquirer7.prompt([{
+          type: "list",
+          name: "selected",
+          message: "Select wallet:",
+          choices: wallets.map((w) => ({
+            name: `${chalk3.hex(w.color)("\u25CF")} ${w.label}${w.id === active?.id ? chalk3.hex("#f59e0b")(" \u2605 active") : ""} ${colors.muted(`(${w.id})`)}`,
+            value: w.id
+          }))
+        }]);
+        targetId = selected;
+      }
+      await setActiveWallet(targetId);
+      const switched = wallets.find((w) => w.id === targetId);
+      output({ success: true, activeWalletId: targetId, label: switched.label }, () => {
+        console.log(`
+  ${chalk3.hex(switched.color)("\u25CF")} Switched to ${chalk3.bold(switched.label)} ${colors.muted(`(${switched.id})`)}
+`);
+      });
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      outputError(msg);
+      if (!isJsonMode())
+        console.log(errorMsg(msg));
+      process.exitCode = 1;
+    }
+  });
+  wallet.command("rename <id> <new-label>").description("Rename a wallet").action(async (id, newLabel) => {
+    try {
+      await migrateLegacyVaultIfNeeded();
+      const wallets = await getWallets();
+      const match = wallets.find((w) => w.id === id || w.label.toLowerCase() === id.toLowerCase());
+      if (!match)
+        throw new Error(`No wallet found matching '${id}'`);
+      await updateWallet(match.id, { label: newLabel });
+      output({ success: true, id: match.id, label: newLabel }, () => {
+        console.log(`
+  ${chalk3.hex(match.color)("\u25CF")} Renamed to ${chalk3.bold(newLabel)} ${colors.muted(`(${match.id})`)}
+`);
+      });
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      outputError(msg);
+      if (!isJsonMode())
+        console.log(errorMsg(msg));
+      process.exitCode = 1;
+    }
+  });
+  wallet.command("color <id> <hex>").description("Change wallet color").action(async (id, hex) => {
+    try {
+      if (!/^#[0-9a-fA-F]{6}$/.test(hex)) {
+        throw new Error("Invalid hex color. Use format: #ff6b35");
+      }
+      await migrateLegacyVaultIfNeeded();
+      const wallets = await getWallets();
+      const match = wallets.find((w) => w.id === id || w.label.toLowerCase() === id.toLowerCase());
+      if (!match)
+        throw new Error(`No wallet found matching '${id}'`);
+      await updateWallet(match.id, { color: hex });
+      output({ success: true, id: match.id, color: hex }, () => {
+        console.log(`
+  ${chalk3.hex(hex)("\u25CF")} Updated color for ${chalk3.bold(match.label)}
+`);
+      });
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      outputError(msg);
+      if (!isJsonMode())
+        console.log(errorMsg(msg));
+      process.exitCode = 1;
+    }
+  });
+  wallet.command("remove <id>").description("Remove a wallet").option("--yes", "Skip confirmation").action(async (id, opts) => {
+    try {
+      await migrateLegacyVaultIfNeeded();
+      const wallets = await getWallets();
+      const match = wallets.find((w) => w.id === id || w.label.toLowerCase() === id.toLowerCase());
+      if (!match)
+        throw new Error(`No wallet found matching '${id}'`);
+      if (!opts.yes && !isJsonMode()) {
+        const { confirm } = await inquirer7.prompt([{
+          type: "confirm",
+          name: "confirm",
+          message: `Remove wallet '${match.label}' (${match.id})? This will delete the vault file.`,
+          default: false
+        }]);
+        if (!confirm) {
+          console.log(colors.muted("  Cancelled."));
+          return;
+        }
+      }
+      const storage = new FileStorage();
+      await storage.delete(match.vaultKey);
+      await removeWallet(match.id);
+      output({ success: true, removed: match.id }, () => {
+        console.log(`
+  ${colors.error("\u2716")} Removed wallet ${chalk3.bold(match.label)} ${colors.muted(`(${match.id})`)}
+`);
+      });
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      outputError(msg);
+      if (!isJsonMode())
+        console.log(errorMsg(msg));
+      process.exitCode = 1;
+    }
+  });
+  wallet.command("info").description("Show active wallet details").option("--password <password>", "Wallet password (non-interactive)").action(async (opts) => {
+    try {
+      await migrateLegacyVaultIfNeeded();
+      const active = await getActiveWallet();
+      if (!active) {
+        throw new Error("No active wallet. Run 'zoa wallet create' first.");
+      }
+      let password;
+      if (opts.password) {
+        password = opts.password;
+      } else {
+        const { pwd } = await inquirer7.prompt([{
+          type: "password",
+          name: "pwd",
+          message: "Enter your wallet password:",
+          mask: "*"
+        }]);
+        password = pwd;
+      }
+      const spinner = createSpinner("Unlocking wallet...");
+      if (!isJsonMode())
+        spinner.start();
+      const storage = new FileStorage();
+      const kr = createKeyring(storage, active.vaultKey);
+      await kr.unlock(password);
+      const accounts = kr.getAccounts();
+      if (!isJsonMode())
+        spinner.stop();
+      output({
+        wallet: {
+          id: active.id,
+          label: active.label,
+          color: active.color,
+          createdAt: active.createdAt,
+          lastUsedAt: active.lastUsedAt
+        },
+        accounts: accounts.map((a) => ({
+          index: a.index,
+          label: a.label,
+          evmAddress: a.evmAddress,
+          solanaAddress: a.solanaAddress
+        }))
+      }, () => {
+        console.log(sectionHeader(`${chalk3.hex(active.color)("\u25CF")} ${active.label}`));
+        console.log(kvLine("ID", active.id));
+        console.log(kvLine("Color", chalk3.hex(active.color)(active.color)));
+        console.log(kvLine("Created", new Date(active.createdAt).toLocaleString()));
+        if (active.lastUsedAt) {
+          console.log(kvLine("Last Used", new Date(active.lastUsedAt).toLocaleString()));
+        }
+        console.log();
+        for (const account of accounts) {
+          console.log(colors.brandBold(`  Account ${account.index + 1}: ${account.label}`));
+          console.log(kvLine("EVM", account.evmAddress));
+          console.log(kvLine("Solana", account.solanaAddress));
+          console.log();
+        }
+      });
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      outputError(msg);
+      if (!isJsonMode())
+        console.log(errorMsg(msg));
+      process.exitCode = 1;
+    }
+  });
+}
+
+// dist/ui/banner.js
+import chalk4 from "chalk";
 import figlet from "figlet";
 import gradient2 from "gradient-string";
 var zoaGradient2 = gradient2([
@@ -48492,37 +48985,45 @@ var zoaGradient2 = gradient2([
   "#c77dff"
 ]);
 var subtleGradient = gradient2(["#6b7280", "#9ca3af", "#6b7280"]);
-var VERSION = "0.2.3";
-function displayBanner() {
-  const banner = figlet.textSync("ZOA", { font: "ANSI Shadow" });
+var VERSION = "0.2.5";
+async function displayBanner() {
+  const banner = figlet.textSync("ZOA-wallet", { font: "ANSI Shadow" });
   console.log();
   console.log(zoaGradient2.multiline(banner));
-  const tagline = "  API-First Crypto Wallet for Developers & AI Agents";
+  const tagline = "  API-First Crypto Wallet for Power-traders, Developers, & AI Agents";
   console.log(subtleGradient(tagline));
   console.log();
-  const versionBadge = chalk3.bgHex("#5e60ce").white.bold(` v${VERSION} `);
-  const githubLink = chalk3.hex("#6b7280")("github.com/airxtech/zoa-wallet");
-  const npmBadge = chalk3.hex("#cb3837")("npm") + chalk3.hex("#6b7280")(" zoa-wallet");
-  console.log(`  ${versionBadge}  ${chalk3.hex("#3b3b3b")("\u2502")}  ${githubLink}  ${chalk3.hex("#3b3b3b")("\u2502")}  ${npmBadge}`);
+  const versionBadge = chalk4.bgHex("#5e60ce").white.bold(` v${VERSION} `);
+  const siteLink = chalk4.hex("#ff6b35")("wallet") + chalk4.hex("#00bbf9")(".zoa.fun");
+  const npmBadge = chalk4.hex("#cb3837")("npm") + chalk4.hex("#6b7280")(" zoa-wallet");
+  let walletIndicator = "";
+  try {
+    const active = await getActiveWallet();
+    if (active) {
+      walletIndicator = `  ${chalk4.hex("#3b3b3b")("\u2502")}  ${chalk4.hex(active.color)("\u25CF")} ${chalk4.bold(active.label)}`;
+    }
+  } catch {
+  }
+  console.log(`  ${versionBadge}  ${chalk4.hex("#3b3b3b")("\u2502")}  ${siteLink}  ${chalk4.hex("#3b3b3b")("\u2502")}  ${npmBadge}${walletIndicator}`);
   console.log();
-  console.log(chalk3.hex("#2d2d2d")("  " + "\u2500".repeat(58)));
+  console.log(chalk4.hex("#2d2d2d")("  " + "\u2500".repeat(58)));
   console.log();
 }
 
 // dist/index.js
 program.option("--json", "Output results as JSON (for scripts and AI agents)");
-program.hook("preAction", (_thisCommand, actionCommand) => {
+program.hook("preAction", async (_thisCommand, actionCommand) => {
   const rootOpts = program.opts();
   if (rootOpts.json) {
     setOutputMode("json");
   } else {
     const cmdName = actionCommand.name();
     if (cmdName !== "help") {
-      displayBanner();
+      await displayBanner();
     }
   }
 });
-program.name("zoa").description("ZOA Wallet \u2014 API-First Crypto Wallet for Developers & AI Agents").version("0.2.3");
+program.name("zoa").description("ZOA Wallet \u2014 API-First Crypto Wallet for Power-traders, Developers, & AI Agents").version("0.2.5");
 registerInitCommand(program);
 registerBalanceCommand(program);
 registerSendCommand(program);
@@ -48533,9 +49034,12 @@ registerChainsCommand(program);
 registerPricesCommand(program);
 registerConfigCommand(program);
 registerApiCommand(program);
+registerWalletCommand(program);
+if (!process.argv.slice(2).length) {
+  await displayBanner();
+}
 program.parse(process.argv);
 if (!process.argv.slice(2).length) {
-  displayBanner();
   program.outputHelp();
   console.log();
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zoa-wallet",
-  "version": "0.2.3",
-  "description": "API-First Crypto Wallet CLI for Developers & AI Agents. Manage multi-chain wallets from your terminal.",
+  "version": "0.2.5",
+  "description": "API-First Crypto Wallet CLI for Power-traders, Developers, & AI Agents. Manage multi-chain wallets from your terminal.",
   "type": "module",
   "license": "MIT",
   "keywords": [