@veil-cash/sdk 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Veil Cash
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,8 +1,12 @@
 # @veil-cash/sdk
 
+[![npm version](https://img.shields.io/npm/v/@veil-cash/sdk.svg)](https://www.npmjs.com/package/@veil-cash/sdk)
+[![npm downloads](https://img.shields.io/npm/dm/@veil-cash/sdk.svg)](https://www.npmjs.com/package/@veil-cash/sdk)
+[![license](https://img.shields.io/npm/l/@veil-cash/sdk.svg)](https://github.com/veildotcash/veildotcash-sdk/blob/main/LICENSE)
+
 SDK and CLI for interacting with [Veil Cash](https://veil.cash) privacy pools on Base.
 
-Generate keypairs, register, deposit, withdraw, and transfer ETH privately.
+Generate keypairs, register, deposit, withdraw, transfer, and merge ETH privately.
 
 ## Installation
 
@@ -31,17 +35,23 @@ export WALLET_KEY=0x...
 # 3. Register your deposit key (one-time)
 veil register
 
-# 4. Deposit ETH
-veil deposit 0.1
+# 4. Check your setup
+veil status
+
+# 5. Deposit ETH
+veil deposit ETH 0.1
 
-# 5. Check your balance
+# 6. Check your balance
 veil balance
 
-# 6. Withdraw to any address
-veil withdraw 0.05 0xRecipientAddress
+# 7. Withdraw to any address
+veil withdraw ETH 0.05 0xRecipientAddress
 
-# 7. Transfer privately to another registered user
-veil transfer 0.02 0xRecipientAddress
+# 8. Transfer privately to another registered user
+veil transfer ETH 0.02 0xRecipientAddress
+
+# 9. Merge small UTXOs (consolidate balances)
+veil merge ETH 0.1
 ```
 
 ## CLI Commands
@@ -60,13 +70,43 @@ veil init --no-save    # Print keypair without saving
 
 ### `veil keypair`
 
-Generate and show a new keypair as JSON (does not save).
+Show current Veil keypair as JSON (from VEIL_KEY env).
 
 ```bash
 veil keypair
 # {"veilPrivateKey":"0x...","depositKey":"0x..."}
 ```
 
+### `veil status`
+
+Check configuration and service status.
+
+```bash
+veil status
+```
+
+Output:
+```json
+{
+  "walletKey": { "found": true, "address": "0x..." },
+  "veilKey": { "found": true },
+  "depositKey": { "found": true, "key": "0x1234...abcd" },
+  "rpcUrl": { "found": false, "url": "https://mainnet.base.org" },
+  "registration": {
+    "checked": true,
+    "registered": true,
+    "matches": true,
+    "onChainKey": "0x..."
+  },
+  "relay": {
+    "checked": true,
+    "healthy": true,
+    "status": "ok",
+    "network": "mainnet"
+  }
+}
+```
+
 ### `veil register`
 
 Register your deposit key on-chain (one-time per address).
@@ -77,14 +117,14 @@ veil register --json                       # JSON output
 veil register --unsigned --address 0x...   # Unsigned payload for agents
 ```
 
-### `veil deposit <amount>`
+### `veil deposit ETH <amount>`
 
 Deposit ETH into the privacy pool.
 
 ```bash
-veil deposit 0.1                    # Signs & sends (JSON output)
-veil deposit 0.1 --unsigned         # Unsigned payload for agents
-veil deposit 0.1 --quiet            # Suppress progress output
+veil deposit ETH 0.1                    # Signs & sends (JSON output)
+veil deposit ETH 0.1 --unsigned         # Unsigned payload for agents
+veil deposit ETH 0.1 --quiet            # Suppress progress output
 ```
 
 Output:
@@ -134,13 +174,13 @@ Output:
 }
 ```
 
-### `veil withdraw <amount> <recipient>`
+### `veil withdraw ETH <amount> <recipient>`
 
 Withdraw from the privacy pool to any public address.
 
 ```bash
-veil withdraw 0.05 0xRecipientAddress
-veil withdraw 0.05 0xRecipientAddress --quiet
+veil withdraw ETH 0.05 0xRecipientAddress
+veil withdraw ETH 0.05 0xRecipientAddress --quiet
 ```
 
 Output:
@@ -155,13 +195,13 @@ Output:
 }
 ```
 
-### `veil transfer <amount> <recipient>`
+### `veil transfer ETH <amount> <recipient>`
 
 Transfer privately to another registered Veil user.
 
 ```bash
-veil transfer 0.02 0xRecipientAddress
-veil transfer 0.02 0xRecipientAddress --quiet
+veil transfer ETH 0.02 0xRecipientAddress
+veil transfer ETH 0.02 0xRecipientAddress --quiet
 ```
 
 Output:
@@ -176,13 +216,24 @@ Output:
 }
 ```
 
-### `veil merge <amount>`
+### `veil merge ETH <amount>`
 
 Consolidate multiple small UTXOs into one (self-transfer).
 
 ```bash
-veil merge 0.1                      # Merge UTXOs totaling 0.1 ETH
-veil merge 0.1 --quiet
+veil merge ETH 0.1                      # Merge UTXOs totaling 0.1 ETH
+veil merge ETH 0.1 --quiet
+```
+
+Output:
+```json
+{
+  "success": true,
+  "transactionHash": "0x...",
+  "blockNumber": 12345678,
+  "amount": "0.1",
+  "type": "merge"
+}
 ```
 
 ## Environment Variables
@@ -387,11 +438,11 @@ veil init --json
 
 # Get unsigned transaction payloads for agent signing
 veil register --unsigned --address 0x...
-veil deposit 0.1 --unsigned
+veil deposit ETH 0.1 --unsigned
 
 # Suppress progress output for clean JSON
 veil balance --quiet
-veil withdraw 0.05 0xRecipient --quiet
+veil withdraw ETH 0.05 0xRecipient --quiet
 ```
 
 ### Bankr Integration
@@ -399,7 +450,7 @@ veil withdraw 0.05 0xRecipient --quiet
 Use `--unsigned` to get Bankr-compatible transaction payloads:
 
 ```bash
-veil deposit 0.1 --unsigned
+veil deposit ETH 0.1 --unsigned
 # {"to":"0x...","data":"0x...","value":"100000000000000000","chainId":8453}
 ```
 
@@ -431,14 +482,15 @@ const result = await withdraw({
 
 1. **Generate Keypair**: Run `veil init` to create and save your Veil keypair
 2. **Register**: Run `veil register` to link your deposit key on-chain (one-time)
-3. **Deposit**: Run `veil deposit <amount>` to send ETH
-4. **Wait**: The Veil deposit engine processes your deposit
-5. **Done**: Your deposit is accepted into the privacy pool
+3. **Check Status**: Run `veil status` to verify your setup
+4. **Deposit**: Run `veil deposit ETH <amount>` to send ETH
+5. **Wait**: The Veil deposit engine processes your deposit
+6. **Done**: Your deposit is accepted into the privacy pool
 
 ## Withdrawal Flow
 
 1. **Check Balance**: Run `veil balance` to see your private balance
-2. **Withdraw**: Run `veil withdraw <amount> <recipient>`
+2. **Withdraw**: Run `veil withdraw ETH <amount> <recipient>`
 3. **Done**: The SDK builds ZK proofs and submits via the relayer
 
 ## License

package/dist/cli/index.cjs

@@ -5170,8 +5170,11 @@ function progress(msg, quiet) {
   }
 }
 function createDepositCommand() {
-  const deposit = new Command("deposit").description("Deposit ETH into Veil").argument("<amount>", "Amount to deposit (e.g., 0.1)").option("--deposit-key <key>", "Your Veil deposit key (or set DEPOSIT_KEY env)").option("--wallet-key <key>", "Ethereum wallet key for signing (or set WALLET_KEY env)").option("--rpc-url <url>", "RPC URL (or set RPC_URL env)").option("--unsigned", "Output unsigned transaction payload (Bankr-compatible format)").option("--quiet", "Suppress progress output").action(async (amount, options) => {
+  const deposit = new Command("deposit").description("Deposit ETH into Veil").argument("<asset>", "Asset to deposit (ETH)").argument("<amount>", "Amount to deposit (e.g., 0.1)").option("--deposit-key <key>", "Your Veil deposit key (or set DEPOSIT_KEY env)").option("--wallet-key <key>", "Ethereum wallet key for signing (or set WALLET_KEY env)").option("--rpc-url <url>", "RPC URL (or set RPC_URL env)").option("--unsigned", "Output unsigned transaction payload (Bankr-compatible format)").option("--quiet", "Suppress progress output").action(async (asset, amount, options) => {
     try {
+      if (asset.toUpperCase() !== "ETH") {
+        throw new CLIError(ErrorCode.INVALID_AMOUNT, "Only ETH is supported");
+      }
       const amountNum = parseFloat(amount);
       if (amountNum < MINIMUM_DEPOSIT_WITH_FEE) {
         throw new CLIError(
@@ -5847,6 +5850,14 @@ async function submitRelay(options) {
   }
   return data;
 }
+async function checkRelayHealth(relayUrl) {
+  const url = getRelayUrl();
+  const response = await fetch(`${url}/health`);
+  if (!response.ok) {
+    throw new RelayError("Relay service health check failed", response.status);
+  }
+  return response.json();
+}
 
 // src/withdraw.ts
 function selectUtxosForWithdraw(utxos, amount, decimals = 18) {
@@ -6018,8 +6029,11 @@ function progress2(msg, quiet) {
   }
 }
 function createWithdrawCommand() {
-  const withdrawCmd = new Command("withdraw").description("Withdraw from private pool to a public address").argument("<amount>", "Amount to withdraw (e.g., 0.1)").argument("<recipient>", "Recipient address (e.g., 0x...)").option("--veil-key <key>", "Veil private key (or set VEIL_KEY env)").option("--rpc-url <url>", "RPC URL (or set RPC_URL env)").option("--quiet", "Suppress progress output").action(async (amount, recipient, options) => {
+  const withdrawCmd = new Command("withdraw").description("Withdraw from private pool to a public address").argument("<asset>", "Asset to withdraw (ETH)").argument("<amount>", "Amount to withdraw (e.g., 0.1)").argument("<recipient>", "Recipient address (e.g., 0x...)").option("--veil-key <key>", "Veil private key (or set VEIL_KEY env)").option("--rpc-url <url>", "RPC URL (or set RPC_URL env)").option("--quiet", "Suppress progress output").action(async (asset, amount, recipient, options) => {
     try {
+      if (asset.toUpperCase() !== "ETH") {
+        throw new CLIError(ErrorCode.INVALID_AMOUNT, "Only ETH is supported");
+      }
       if (!/^0x[a-fA-F0-9]{40}$/.test(recipient)) {
         throw new CLIError(ErrorCode.INVALID_ADDRESS, "Invalid recipient address format");
       }
@@ -6337,8 +6351,11 @@ function progress3(msg, quiet) {
   }
 }
 function createTransferCommand() {
-  const transferCmd = new Command("transfer").description("Transfer privately within the pool to another registered address").argument("<amount>", "Amount to transfer (e.g., 0.1)").argument("<recipient>", "Recipient address (must be registered)").option("--veil-key <key>", "Veil private key (or set VEIL_KEY env)").option("--rpc-url <url>", "RPC URL (or set RPC_URL env)").option("--quiet", "Suppress progress output").action(async (amount, recipient, options) => {
+  const transferCmd = new Command("transfer").description("Transfer privately within the pool to another registered address").argument("<asset>", "Asset to transfer (ETH)").argument("<amount>", "Amount to transfer (e.g., 0.1)").argument("<recipient>", "Recipient address (must be registered)").option("--veil-key <key>", "Veil private key (or set VEIL_KEY env)").option("--rpc-url <url>", "RPC URL (or set RPC_URL env)").option("--quiet", "Suppress progress output").action(async (asset, amount, recipient, options) => {
     try {
+      if (asset.toUpperCase() !== "ETH") {
+        throw new CLIError(ErrorCode.INVALID_AMOUNT, "Only ETH is supported");
+      }
       if (!/^0x[a-fA-F0-9]{40}$/.test(recipient)) {
         throw new CLIError(ErrorCode.INVALID_ADDRESS, "Invalid recipient address format");
       }
@@ -6378,8 +6395,11 @@ function createTransferCommand() {
   return transferCmd;
 }
 function createMergeCommand() {
-  const mergeCmd = new Command("merge").description("Merge UTXOs by self-transfer (consolidate small UTXOs)").argument("<amount>", "Amount to merge (e.g., 0.5)").option("--veil-key <key>", "Veil private key (or set VEIL_KEY env)").option("--rpc-url <url>", "RPC URL (or set RPC_URL env)").option("--quiet", "Suppress progress output").action(async (amount, options) => {
+  const mergeCmd = new Command("merge").description("Merge UTXOs by self-transfer (consolidate small UTXOs)").argument("<asset>", "Asset to merge (ETH)").argument("<amount>", "Amount to merge (e.g., 0.5)").option("--veil-key <key>", "Veil private key (or set VEIL_KEY env)").option("--rpc-url <url>", "RPC URL (or set RPC_URL env)").option("--quiet", "Suppress progress output").action(async (asset, amount, options) => {
     try {
+      if (asset.toUpperCase() !== "ETH") {
+        throw new CLIError(ErrorCode.INVALID_AMOUNT, "Only ETH is supported");
+      }
       const veilKey = options.veilKey || process.env.VEIL_KEY;
       if (!veilKey) {
         throw new CLIError(ErrorCode.VEIL_KEY_MISSING, "VEIL_KEY required. Use --veil-key or set VEIL_KEY env");
@@ -6414,6 +6434,75 @@ function createMergeCommand() {
   return mergeCmd;
 }
 
+// src/cli/commands/status.ts
+function createStatusCommand() {
+  const status = new Command("status").description("Check configuration and service status").option("--rpc-url <url>", "RPC URL (or set RPC_URL env)").action(async (options) => {
+    const result = {
+      walletKey: { found: false },
+      veilKey: { found: false },
+      depositKey: { found: false },
+      rpcUrl: { found: false, url: "https://mainnet.base.org" },
+      registration: { checked: false },
+      relay: { checked: false }
+    };
+    const walletKey = process.env.WALLET_KEY;
+    if (walletKey) {
+      result.walletKey.found = true;
+      try {
+        result.walletKey.address = getAddress(walletKey);
+      } catch {
+      }
+    }
+    const veilKey = process.env.VEIL_KEY;
+    if (veilKey) {
+      result.veilKey.found = true;
+    }
+    const depositKey = process.env.DEPOSIT_KEY;
+    if (depositKey) {
+      result.depositKey.found = true;
+      if (depositKey.length > 20) {
+        result.depositKey.key = `${depositKey.slice(0, 10)}...${depositKey.slice(-8)}`;
+      } else {
+        result.depositKey.key = depositKey;
+      }
+    }
+    const rpcUrl = options.rpcUrl || process.env.RPC_URL;
+    if (rpcUrl) {
+      result.rpcUrl.found = true;
+      result.rpcUrl.url = rpcUrl;
+    }
+    const effectiveRpcUrl = rpcUrl || "https://mainnet.base.org";
+    if (result.walletKey.found && result.walletKey.address) {
+      result.registration.checked = true;
+      try {
+        const regStatus = await isRegistered(
+          result.walletKey.address,
+          effectiveRpcUrl
+        );
+        result.registration.registered = regStatus.registered;
+        result.registration.onChainKey = regStatus.depositKey;
+        if (regStatus.registered && depositKey && regStatus.depositKey) {
+          result.registration.matches = regStatus.depositKey.toLowerCase() === depositKey.toLowerCase();
+        }
+      } catch (error) {
+        result.registration.error = error instanceof Error ? error.message : "Unknown error";
+      }
+    }
+    result.relay.checked = true;
+    try {
+      const health = await checkRelayHealth();
+      result.relay.healthy = health.status === "ok";
+      result.relay.status = health.status;
+      result.relay.network = health.network;
+    } catch (error) {
+      result.relay.healthy = false;
+      result.relay.error = error instanceof Error ? error.message : "Unknown error";
+    }
+    console.log(JSON.stringify(result, null, 2));
+  });
+  return status;
+}
+
 // src/cli/index.ts
 loadEnv();
 var program2 = new Command();
@@ -6428,4 +6517,5 @@ program2.addCommand(createPrivateBalanceCommand());
 program2.addCommand(createWithdrawCommand());
 program2.addCommand(createTransferCommand());
 program2.addCommand(createMergeCommand());
+program2.addCommand(createStatusCommand());
 program2.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veil-cash/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "SDK and CLI for interacting with Veil Cash privacy pools - keypair generation, deposits, and status checking",
   "type": "module",
   "main": "./dist/index.js",

package/src/cli/commands/deposit.ts

@@ -25,14 +25,20 @@ function progress(msg: string, quiet?: boolean) {
 export function createDepositCommand(): Command {
   const deposit = new Command('deposit')
     .description('Deposit ETH into Veil')
+    .argument('<asset>', 'Asset to deposit (ETH)')
     .argument('<amount>', 'Amount to deposit (e.g., 0.1)')
     .option('--deposit-key <key>', 'Your Veil deposit key (or set DEPOSIT_KEY env)')
     .option('--wallet-key <key>', 'Ethereum wallet key for signing (or set WALLET_KEY env)')
     .option('--rpc-url <url>', 'RPC URL (or set RPC_URL env)')
     .option('--unsigned', 'Output unsigned transaction payload (Bankr-compatible format)')
     .option('--quiet', 'Suppress progress output')
-    .action(async (amount: string, options) => {
+    .action(async (asset: string, amount: string, options) => {
       try {
+        // Validate asset is ETH
+        if (asset.toUpperCase() !== 'ETH') {
+          throw new CLIError(ErrorCode.INVALID_AMOUNT, 'Only ETH is supported');
+        }
+
         const amountNum = parseFloat(amount);
         
         // Check minimum deposit

package/src/cli/commands/status.ts

@@ -0,0 +1,129 @@
+/**
+ * Status CLI command - Check configuration and service status
+ */
+
+import { Command } from 'commander';
+import { isRegistered, getAddress } from '../wallet.js';
+import { checkRelayHealth } from '../../relay.js';
+
+interface StatusResult {
+  walletKey: {
+    found: boolean;
+    address?: string;
+  };
+  veilKey: {
+    found: boolean;
+  };
+  depositKey: {
+    found: boolean;
+    key?: string;
+  };
+  rpcUrl: {
+    found: boolean;
+    url: string;
+  };
+  registration: {
+    checked: boolean;
+    registered?: boolean;
+    matches?: boolean;
+    onChainKey?: string | null;
+    error?: string;
+  };
+  relay: {
+    checked: boolean;
+    healthy?: boolean;
+    status?: string;
+    network?: string;
+    error?: string;
+  };
+}
+
+export function createStatusCommand(): Command {
+  const status = new Command('status')
+    .description('Check configuration and service status')
+    .option('--rpc-url <url>', 'RPC URL (or set RPC_URL env)')
+    .action(async (options) => {
+      const result: StatusResult = {
+        walletKey: { found: false },
+        veilKey: { found: false },
+        depositKey: { found: false },
+        rpcUrl: { found: false, url: 'https://mainnet.base.org' },
+        registration: { checked: false },
+        relay: { checked: false },
+      };
+
+      // Check WALLET_KEY
+      const walletKey = process.env.WALLET_KEY;
+      if (walletKey) {
+        result.walletKey.found = true;
+        try {
+          result.walletKey.address = getAddress(walletKey as `0x${string}`);
+        } catch {
+          // Invalid key format, but it was found
+        }
+      }
+
+      // Check VEIL_KEY
+      const veilKey = process.env.VEIL_KEY;
+      if (veilKey) {
+        result.veilKey.found = true;
+      }
+
+      // Check DEPOSIT_KEY
+      const depositKey = process.env.DEPOSIT_KEY;
+      if (depositKey) {
+        result.depositKey.found = true;
+        // Show truncated key
+        if (depositKey.length > 20) {
+          result.depositKey.key = `${depositKey.slice(0, 10)}...${depositKey.slice(-8)}`;
+        } else {
+          result.depositKey.key = depositKey;
+        }
+      }
+
+      // Check RPC_URL
+      const rpcUrl = options.rpcUrl || process.env.RPC_URL;
+      if (rpcUrl) {
+        result.rpcUrl.found = true;
+        result.rpcUrl.url = rpcUrl;
+      }
+      const effectiveRpcUrl = rpcUrl || 'https://mainnet.base.org';
+
+      // Check registration status (requires wallet address)
+      if (result.walletKey.found && result.walletKey.address) {
+        result.registration.checked = true;
+        try {
+          const regStatus = await isRegistered(
+            result.walletKey.address as `0x${string}`,
+            effectiveRpcUrl
+          );
+          result.registration.registered = regStatus.registered;
+          result.registration.onChainKey = regStatus.depositKey;
+
+          // Check if on-chain key matches env DEPOSIT_KEY
+          if (regStatus.registered && depositKey && regStatus.depositKey) {
+            result.registration.matches = 
+              regStatus.depositKey.toLowerCase() === depositKey.toLowerCase();
+          }
+        } catch (error) {
+          result.registration.error = error instanceof Error ? error.message : 'Unknown error';
+        }
+      }
+
+      // Check relay health
+      result.relay.checked = true;
+      try {
+        const health = await checkRelayHealth();
+        result.relay.healthy = health.status === 'ok';
+        result.relay.status = health.status;
+        result.relay.network = health.network;
+      } catch (error) {
+        result.relay.healthy = false;
+        result.relay.error = error instanceof Error ? error.message : 'Unknown error';
+      }
+
+      console.log(JSON.stringify(result, null, 2));
+    });
+
+  return status;
+}

package/src/cli/commands/transfer.ts

@@ -17,13 +17,19 @@ function progress(msg: string, quiet?: boolean) {
 export function createTransferCommand(): Command {
   const transferCmd = new Command('transfer')
     .description('Transfer privately within the pool to another registered address')
+    .argument('<asset>', 'Asset to transfer (ETH)')
     .argument('<amount>', 'Amount to transfer (e.g., 0.1)')
     .argument('<recipient>', 'Recipient address (must be registered)')
     .option('--veil-key <key>', 'Veil private key (or set VEIL_KEY env)')
     .option('--rpc-url <url>', 'RPC URL (or set RPC_URL env)')
     .option('--quiet', 'Suppress progress output')
-    .action(async (amount: string, recipient: string, options) => {
+    .action(async (asset: string, amount: string, recipient: string, options) => {
       try {
+        // Validate asset is ETH
+        if (asset.toUpperCase() !== 'ETH') {
+          throw new CLIError(ErrorCode.INVALID_AMOUNT, 'Only ETH is supported');
+        }
+
         // Validate recipient
         if (!/^0x[a-fA-F0-9]{40}$/.test(recipient)) {
           throw new CLIError(ErrorCode.INVALID_ADDRESS, 'Invalid recipient address format');
@@ -82,12 +88,18 @@ export function createTransferCommand(): Command {
 export function createMergeCommand(): Command {
   const mergeCmd = new Command('merge')
     .description('Merge UTXOs by self-transfer (consolidate small UTXOs)')
+    .argument('<asset>', 'Asset to merge (ETH)')
     .argument('<amount>', 'Amount to merge (e.g., 0.5)')
     .option('--veil-key <key>', 'Veil private key (or set VEIL_KEY env)')
     .option('--rpc-url <url>', 'RPC URL (or set RPC_URL env)')
     .option('--quiet', 'Suppress progress output')
-    .action(async (amount: string, options) => {
+    .action(async (asset: string, amount: string, options) => {
       try {
+        // Validate asset is ETH
+        if (asset.toUpperCase() !== 'ETH') {
+          throw new CLIError(ErrorCode.INVALID_AMOUNT, 'Only ETH is supported');
+        }
+
         // Get keypair
         const veilKey = options.veilKey || process.env.VEIL_KEY;
         if (!veilKey) {

package/src/cli/commands/withdraw.ts

@@ -17,13 +17,19 @@ function progress(msg: string, quiet?: boolean) {
 export function createWithdrawCommand(): Command {
   const withdrawCmd = new Command('withdraw')
     .description('Withdraw from private pool to a public address')
+    .argument('<asset>', 'Asset to withdraw (ETH)')
     .argument('<amount>', 'Amount to withdraw (e.g., 0.1)')
     .argument('<recipient>', 'Recipient address (e.g., 0x...)')
     .option('--veil-key <key>', 'Veil private key (or set VEIL_KEY env)')
     .option('--rpc-url <url>', 'RPC URL (or set RPC_URL env)')
     .option('--quiet', 'Suppress progress output')
-    .action(async (amount: string, recipient: string, options) => {
+    .action(async (asset: string, amount: string, recipient: string, options) => {
       try {
+        // Validate asset is ETH
+        if (asset.toUpperCase() !== 'ETH') {
+          throw new CLIError(ErrorCode.INVALID_AMOUNT, 'Only ETH is supported');
+        }
+
         // Validate recipient
         if (!/^0x[a-fA-F0-9]{40}$/.test(recipient)) {
           throw new CLIError(ErrorCode.INVALID_ADDRESS, 'Invalid recipient address format');

package/src/cli/index.ts

@@ -2,16 +2,17 @@
  * Veil CLI - Command-line interface for Veil Cash
  * 
  * Usage:
- *   veil init              # Generate keypair
- *   veil keypair           # Show keypair (JSON)
- *   veil register          # Register on-chain
- *   veil deposit 0.1       # Deposit ETH
- *   veil balance           # Show all balances
- *   veil queue-balance     # Show pending queue deposits
- *   veil private-balance   # Show private balance
- *   veil withdraw 0.1 --recipient 0x...  # Withdraw to public address
- *   veil transfer 0.1 --to 0x...         # Transfer privately
- *   veil merge 0.5         # Merge UTXOs (self-transfer)
+ *   veil init                        # Generate keypair
+ *   veil keypair                     # Show keypair (JSON)
+ *   veil status                      # Check config and service status
+ *   veil register                    # Register on-chain
+ *   veil deposit ETH 0.1             # Deposit ETH
+ *   veil balance                     # Show all balances
+ *   veil queue-balance               # Show pending queue deposits
+ *   veil private-balance             # Show private balance
+ *   veil withdraw ETH 0.1 0x...      # Withdraw to public address
+ *   veil transfer ETH 0.1 0x...      # Transfer privately
+ *   veil merge ETH 0.5               # Merge UTXOs (self-transfer)
  */
 
 import { Command } from 'commander';
@@ -25,6 +26,7 @@ import { createQueueBalanceCommand } from './commands/queue-balance.js';
 import { createPrivateBalanceCommand } from './commands/private-balance.js';
 import { createWithdrawCommand } from './commands/withdraw.js';
 import { createTransferCommand, createMergeCommand } from './commands/transfer.js';
+import { createStatusCommand } from './commands/status.js';
 
 // Load environment variables
 loadEnv();
@@ -47,6 +49,7 @@ program.addCommand(createPrivateBalanceCommand());
 program.addCommand(createWithdrawCommand());
 program.addCommand(createTransferCommand());
 program.addCommand(createMergeCommand());
+program.addCommand(createStatusCommand());
 
 // Parse and execute
 program.parse();