@veil-cash/sdk 0.6.1 → 0.6.3

package/package.json

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

package/skills/veil/SKILL.md

@@ -1,12 +1,13 @@
 ---
 name: veil
-version: 0.6.0
+version: 0.6.2
 description: >
   Veil CLI for private ETH and USDC transactions on Base. Use when the user wants
   to deposit, withdraw, or transfer assets privately, check private balances,
   manage Veil keypairs, register on-chain, manage deterministic subaccounts
-  (forwarder deploy, sweep, recover), or build unsigned transaction payloads
-  for an external signer (e.g. Bankr). All operations target Base (chain ID 8453).
+  (forwarder deploy, sweep, merge to main wallet, recover), or build unsigned
+  transaction payloads for an external signer (e.g. Bankr). All operations
+  target Base (chain ID 8453).
 author: veildotcash
 metadata:
   homepage: https://veil.cash
@@ -35,6 +36,7 @@ triggers:
   - pattern: withdraw privately
   - pattern: private transfer
   - pattern: subaccount
+  - pattern: subaccount merge
   - pattern: forwarder
   - pattern: stealth deposit
 ---
@@ -163,7 +165,7 @@ What do you want to do?
 |
 +-- Register deposit key on-chain     → veil register [--unsigned]
 |
-+-- Deposit ETH or USDC               → veil deposit <asset> <amount> [--unsigned]
++-- Deposit ETH or USDC               → veil deposit <asset> <amount> [--unsigned --address 0x...]
 |
 +-- Check balances                    → veil balance [queue|private] [--pool eth|usdc]
 |
@@ -200,6 +202,7 @@ What do you want to do?
 | Subaccount address | `veil subaccount address --slot 0` |
 | Deploy forwarder | `veil subaccount deploy --slot 0` |
 | Sweep forwarder | `veil subaccount sweep --slot 0 --asset eth` |
+| Merge subaccount to main | `veil subaccount merge --slot 0 --pool eth` |
 | Recover from forwarder | `veil subaccount recover --slot 0 --asset usdc --to 0xAddr --amount 25` |
 
 ---
@@ -327,7 +330,9 @@ Important:
   - If not yet registered, returns a normal `register` payload.
 
 Deposits treat the CLI amount as the **net** amount that lands in the pool.
-The `0.3%` protocol fee is calculated on-chain and added automatically.
+Each address gets a configurable number of fee-free deposits per UTC day.
+The CLI checks automatically — if free slots remain the fee is waived;
+otherwise the `0.3%` protocol fee is calculated on-chain and added.
 After submission, deposits go through screening / queue processing before they
 are accepted into the private pool. This typically takes around `10-15 minutes`.
 
@@ -335,8 +340,8 @@ are accepted into the private pool. This typically takes around `10-15 minutes`.
 veil deposit ETH 0.1
 veil deposit USDC 100
 veil deposit ETH 0.1 --json
-veil deposit ETH 0.1 --unsigned
-veil deposit USDC 100 --unsigned
+veil deposit ETH 0.1 --unsigned --address 0x...
+SIGNER_ADDRESS=0x... veil deposit USDC 100 --unsigned
 ```
 
 Minimums:
@@ -428,11 +433,13 @@ Subaccounts are deterministic child slots derived from your main `VEIL_KEY`:
 `root key → slot → child key → child deposit key → forwarder`
 
 Base mainnet only. Slots are `0`–`2` (max 3 subaccounts). Deploy and sweep are
-relay-backed (no `WALLET_KEY` needed). Recovery submits a direct on-chain
-transaction and **requires `WALLET_KEY`** as a gas payer.
+relay-backed (no `WALLET_KEY` needed). Merge transfers the subaccount's private
+pool balance back to the main wallet via a ZK proof (relay-backed, no `WALLET_KEY`
+needed). Recovery submits a direct on-chain transaction and **requires `WALLET_KEY`**
+as a gas payer.
 
-Status reports the forwarder wallet balances and queue state only, not private
-pool attribution after queued funds are accepted.
+Status reports the child slot's forwarder wallet balances, private pool
+balances, and queue state.
 
 ### Derive and inspect
 
@@ -440,7 +447,7 @@ pool attribution after queued funds are accepted.
 veil subaccount derive --slot 0           # Full slot metadata
 veil subaccount derive --slot 0 --json
 veil subaccount address --slot 0          # Just the forwarder address
-veil subaccount status --slot 0           # Deployment, balances, queue state
+veil subaccount status --slot 0           # Deployment, forwarder balances, private balances, queue state
 veil subaccount status --slot 0 --json
 ```
 
@@ -454,6 +461,18 @@ veil subaccount sweep --slot 0 --asset usdc   # Sweep USDC into the pool
 veil subaccount sweep --slot 0 --asset eth --json
 ```
 
+### Merge subaccount to main wallet (relay-backed)
+
+Merge transfers the subaccount's entire private pool balance back to the main
+wallet. It builds a ZK proof transferring child UTXOs to the parent keypair and
+submits via the relay. Only needs `VEIL_KEY`.
+
+```bash
+veil subaccount merge --slot 0 --pool eth
+veil subaccount merge --slot 0 --pool usdc
+veil subaccount merge --slot 0 --pool eth --json
+```
+
 ### Recover (direct on-chain — requires WALLET_KEY)
 
 Recovery is for assets still sitting on the forwarder after refund or rejection.
@@ -470,6 +489,7 @@ Important:
 - `--asset` is `eth` or `usdc` (case-insensitive in the CLI)
 - `--slot` is `0`–`2`
 - Deploy and sweep only need `VEIL_KEY`
+- Merge only needs `VEIL_KEY`
 - Recover needs both `VEIL_KEY` and `WALLET_KEY`
 
 ---

package/skills/veil/reference.md

@@ -148,9 +148,11 @@ const priv = await getPrivateBalance({
 ```typescript
 import {
   deriveSubaccountSlot,
+  getSubaccountPrivateBalance,
   getSubaccountStatus,
   deploySubaccountForwarder,
   sweepSubaccountForwarder,
+  mergeSubaccount,
   buildSubaccountRecoveryTx,
   isSubaccountForwarderDeployed,
   MAX_SUBACCOUNT_SLOTS,
@@ -168,12 +170,20 @@ const deployed = await isSubaccountForwarderDeployed({
   forwarderAddress: slot.forwarderAddress,
 });
 
-// Full status (deployment, balances, queue state)
+// Full status (deployment, forwarder balances, private balances, queue state)
 const status = await getSubaccountStatus({
   rootPrivateKey: '0xVEIL_KEY',
   slot: 0,
 });
-// status.deployed, status.balances.eth, status.balances.usdc, status.queues
+// status.deployed, status.balances, status.privateBalances, status.queues
+
+// Private pool balance for a single slot + pool
+const privateBalance = await getSubaccountPrivateBalance({
+  rootPrivateKey: '0xVEIL_KEY',
+  slot: 0,
+  pool: 'eth',
+});
+// privateBalance.privateBalance, privateBalance.unspentCount, privateBalance.utxos
 
 // Deploy forwarder (relay-backed, no WALLET_KEY needed)
 const deployResult = await deploySubaccountForwarder({
@@ -188,6 +198,14 @@ const sweepResult = await sweepSubaccountForwarder({
   asset: 'eth',     // 'eth' | 'usdc'
 });
 
+// Merge subaccount's private balance back to main wallet (relay-backed)
+const mergeResult = await mergeSubaccount({
+  rootPrivateKey: '0xVEIL_KEY',
+  slot: 0,
+  pool: 'eth',     // 'eth' | 'usdc' (default: 'eth')
+});
+// mergeResult.success, mergeResult.transactionHash, mergeResult.amount, mergeResult.slot, mergeResult.pool
+
 // Build recovery transaction (for assets stuck on forwarder)
 const recovery = await buildSubaccountRecoveryTx({
   rootPrivateKey: '0xVEIL_KEY',
@@ -240,8 +258,8 @@ SIGNER_ADDRESS=0x... veil register --unsigned --force # Unsigned register/change
 veil register --unsigned --address 0x...           # Unsigned register payload (explicit address)
 veil register --json                               # Register and output result as JSON
 
-veil deposit ETH 0.1 --unsigned                    # Unsigned ETH deposit payload
-veil deposit USDC 100 --unsigned                   # Unsigned USDC deposit payload(s)
+veil deposit ETH 0.1 --unsigned --address 0x...    # Unsigned ETH deposit payload
+SIGNER_ADDRESS=0x... veil deposit USDC 100 --unsigned # Unsigned USDC deposit payload(s)
 veil deposit ETH 0.1 --json                        # Deposit and output result as JSON
 
 veil balance                                       # All pool balances
@@ -256,12 +274,14 @@ veil balance private --json                        # Private balance as JSON
 veil subaccount derive --slot 0                    # Derive slot metadata
 veil subaccount derive --slot 0 --json             # Derive as JSON
 veil subaccount address --slot 0                   # Print forwarder address
-veil subaccount status --slot 0                    # Deployment, balances, queue state
+veil subaccount status --slot 0                    # Deployment, forwarder balances, private balances, queue state
 veil subaccount status --slot 0 --json             # Status as JSON
 veil subaccount deploy --slot 0                    # Deploy forwarder (relay-backed)
 veil subaccount deploy --slot 0 --json             # Deploy as JSON
 veil subaccount sweep --slot 0 --asset eth         # Sweep ETH into pool (relay-backed)
 veil subaccount sweep --slot 0 --asset usdc --json # Sweep USDC as JSON
+veil subaccount merge --slot 0 --pool eth          # Merge subaccount balance to main wallet
+veil subaccount merge --slot 0 --pool usdc --json  # Merge USDC as JSON
 veil subaccount recover --slot 0 --asset usdc --to 0x... --amount 25   # Recover assets (needs WALLET_KEY)
 veil subaccount recover --slot 0 --asset eth --to 0x... --amount 0.05 --json
 ```
@@ -287,10 +307,10 @@ Common codes: `VEIL_KEY_MISSING`, `WALLET_KEY_MISSING`, `DEPOSIT_KEY_MISSING`,
 
 | Asset | Minimum (net) | Notes |
 |-------|--------------|-------|
-| ETH | 0.01 | Fee (0.3%) added automatically via on-chain `getDepositAmountWithFee` |
-| USDC | 10 | Fee (0.3%) added automatically via on-chain `getDepositAmountWithFee` |
+| ETH | 0.01 | Fee (0.3%) added automatically, or waived if daily free deposits remain |
+| USDC | 10 | Fee (0.3%) added automatically, or waived if daily free deposits remain |
 
-The CLI amount is the **net** amount that lands in the pool. The fee is calculated on-chain and added to the transaction automatically — users do not need to account for it.
+The CLI amount is the **net** amount that lands in the pool. The CLI checks `getDailyFreeRemaining` on the queue contract — if the user has free slots left today the fee is skipped; otherwise the 0.3% fee is calculated on-chain and added to the transaction automatically.
 
 ---
 

package/src/abi.ts

@@ -218,6 +218,14 @@ export const QUEUE_ABI = [
     stateMutability: 'view',
     type: 'function',
   },
+  // Get remaining daily free deposits for an address (V3+)
+  {
+    inputs: [{ name: '_depositor', type: 'address' }],
+    name: 'getDailyFreeRemaining',
+    outputs: [{ name: 'remaining', type: 'uint256' }],
+    stateMutability: 'view',
+    type: 'function',
+  },
 ] as const;
 
 /**

package/src/balance.ts

@@ -127,6 +127,54 @@ export async function getQueueBalance(options: {
   };
 }
 
+/**
+ * Get remaining daily free deposits for an address.
+ * Returns 0 if the queue contract has not been upgraded to V3 yet
+ * or if the daily free feature is disabled.
+ *
+ * @param options - Query options
+ * @param options.address - Depositor address to check
+ * @param options.pool - Pool identifier ('eth' or 'usdc', default: 'eth')
+ * @param options.rpcUrl - Optional RPC URL
+ * @returns Number of free deposits remaining today
+ *
+ * @example
+ * ```typescript
+ * const remaining = await getDailyFreeRemaining({
+ *   address: '0x...',
+ *   pool: 'eth',
+ * });
+ * console.log(`Free deposits left today: ${remaining}`);
+ * ```
+ */
+export async function getDailyFreeRemaining(options: {
+  address: `0x${string}`;
+  pool?: RelayPool;
+  rpcUrl?: string;
+}): Promise<number> {
+  const { address, pool = 'eth', rpcUrl } = options;
+  const queueAddress = getQueueAddress(pool);
+
+  const publicClient = createPublicClient({
+    chain: base,
+    transport: http(rpcUrl),
+  });
+
+  try {
+    const remaining = await publicClient.readContract({
+      address: queueAddress,
+      abi: QUEUE_ABI,
+      functionName: 'getDailyFreeRemaining',
+      args: [address],
+    }) as bigint;
+
+    return Number(remaining);
+  } catch {
+    // V2 contracts don't have this function — treat as 0 remaining
+    return 0;
+  }
+}
+
 /**
  * Get private balance from the Pool contract
  * Decrypts all encrypted outputs, calculates nullifiers, and checks spent status

package/src/cli/commands/deposit.ts

@@ -4,8 +4,9 @@
 
 import { Command } from 'commander';
 import { buildDepositETHTx, buildDepositUSDCTx, buildApproveUSDCTx } from '../../deposit.js';
+import { getDailyFreeRemaining } from '../../balance.js';
 import { sendTransaction, getAddress, getBalance } from '../wallet.js';
-import { getConfig } from '../config.js';
+import { getConfig, resolveAddress } from '../config.js';
 import { createPublicClient, http, parseEther, parseUnits, formatEther, formatUnits } from 'viem';
 import { base } from 'viem/chains';
 import { handleCLIError, CLIError, ErrorCode } from '../errors.js';
@@ -13,6 +14,7 @@ import { clearProgress, createProgressReporter, printFields, printHeader, printJ
 import { POOL_CONFIG, getAddresses } from '../../addresses.js';
 import { ENTRY_ABI, ERC20_ABI } from '../../abi.js';
 import type { TransactionData } from '../../types.js';
+import type { WalletConfig } from '../wallet.js';
 
 const MINIMUM_NET: Record<string, number> = {
   ETH: 0.01,
@@ -20,13 +22,22 @@ const MINIMUM_NET: Record<string, number> = {
 };
 
 /**
- * Query the Entry contract for the exact gross amount (net + fee).
- * This matches the contract's own fee math and avoids rounding mismatches.
+ * Compute the gross amount and fee for a deposit.
+ * Checks daily free deposit availability first — if the user has
+ * free slots remaining the fee is waived and gross === net.
  */
 async function getGrossAmount(
   netWei: bigint,
+  depositor: `0x${string}`,
+  pool: 'eth' | 'usdc',
   rpcUrl: string | undefined,
-): Promise<{ grossWei: bigint; feeWei: bigint }> {
+): Promise<{ grossWei: bigint; feeWei: bigint; dailyFreeUsed: boolean; dailyFreeRemaining: number }> {
+  const freeRemaining = await getDailyFreeRemaining({ address: depositor, pool, rpcUrl });
+
+  if (freeRemaining > 0) {
+    return { grossWei: netWei, feeWei: 0n, dailyFreeUsed: true, dailyFreeRemaining: freeRemaining - 1 };
+  }
+
   const publicClient = createPublicClient({
     chain: base,
     transport: http(rpcUrl),
@@ -39,7 +50,7 @@ async function getGrossAmount(
     args: [netWei],
   }) as bigint;
 
-  return { grossWei, feeWei: grossWei - netWei };
+  return { grossWei, feeWei: grossWei - netWei, dailyFreeUsed: false, dailyFreeRemaining: 0 };
 }
 
 const SUPPORTED_ASSETS = ['ETH', 'USDC'];
@@ -49,16 +60,19 @@ export function createDepositCommand(): Command {
     .description('Deposit ETH or USDC into Veil')
     .argument('<asset>', 'Asset to deposit (ETH or USDC)')
     .argument('<amount>', 'Amount to deposit — this is what arrives in your Veil balance')
+    .option('--address <address>', 'Signer address (required in --unsigned mode unless SIGNER_ADDRESS or WALLET_KEY is set)')
     .option('--unsigned', 'Output unsigned transaction payload instead of sending')
     .option('--json', 'Output as JSON')
     .addHelpText('after', `
 The amount you specify is the net amount that lands in your Veil balance.
-The 0.3% protocol fee is automatically added on top.
+A 0.3% protocol fee is normally added on top, but each address gets
+free daily deposits (fee waived). The CLI checks automatically.
 
 Examples:
-  veil deposit ETH 0.1          # deposits 0.1 ETH (sends ~0.1003 ETH)
-  veil deposit USDC 100         # deposits 100 USDC (sends ~100.30 USDC)
-  veil deposit ETH 0.1 --unsigned
+  veil deposit ETH 0.1          # deposits 0.1 ETH (free or ~0.1003 ETH)
+  veil deposit USDC 100         # deposits 100 USDC (free or ~100.30 USDC)
+  veil deposit ETH 0.1 --unsigned --address 0x...
+  SIGNER_ADDRESS=0x... veil deposit ETH 0.1 --unsigned
   veil deposit ETH 0.1 --json
 `)
     .action(async (asset: string, amount: string, options) => {
@@ -80,15 +94,41 @@ Examples:
         }
 
         const rpcUrl = process.env.RPC_URL;
-        const poolConfig = POOL_CONFIG[assetUpper.toLowerCase() as 'eth' | 'usdc'];
+        const pool = assetUpper.toLowerCase() as 'eth' | 'usdc';
+        const poolConfig = POOL_CONFIG[pool];
         const netWei = assetUpper === 'ETH'
           ? parseEther(amount)
           : parseUnits(amount, poolConfig.decimals);
 
         const progress = createProgressReporter();
-        progress('Calculating fee...');
 
-        const { grossWei, feeWei } = await getGrossAmount(netWei, rpcUrl);
+        let config: WalletConfig | null = null;
+        let address: `0x${string}`;
+        let feeRpcUrl = rpcUrl;
+
+        if (options.unsigned) {
+          const resolved = resolveAddress({ address: options.address }, { required: true });
+          if (!resolved) {
+            throw new CLIError(
+              ErrorCode.WALLET_KEY_MISSING,
+              'Must provide --address, set SIGNER_ADDRESS, or set WALLET_KEY env.',
+            );
+          }
+          address = resolved.address;
+        } else {
+          config = getConfig(options);
+          address = getAddress(config.privateKey);
+          feeRpcUrl = config.rpcUrl;
+        }
+
+        progress('Checking deposit fee...');
+
+        const { grossWei, feeWei, dailyFreeUsed, dailyFreeRemaining } = await getGrossAmount(
+          netWei,
+          address,
+          pool,
+          feeRpcUrl,
+        );
         const grossStr = assetUpper === 'ETH'
           ? formatEther(grossWei)
           : formatUnits(grossWei, poolConfig.decimals);
@@ -140,8 +180,9 @@ Examples:
           return;
         }
 
-        const config = getConfig(options);
-        const address = getAddress(config.privateKey);
+        if (!config) {
+          throw new CLIError(ErrorCode.WALLET_KEY_MISSING, 'WALLET_KEY env var required. Set it before running this command.');
+        }
 
         if (assetUpper === 'ETH') {
           progress('Checking balance...');
@@ -203,6 +244,7 @@ Examples:
           asset: assetUpper,
           amount,
           fee: feeStr,
+          dailyFreeUsed,
           totalSent: grossStr,
           blockNumber: result.receipt.blockNumber.toString(),
         };
@@ -212,11 +254,15 @@ Examples:
           return;
         }
 
+        const feeLabel = dailyFreeUsed
+          ? `0 ${assetUpper} (free — ${dailyFreeRemaining} remaining today)`
+          : `${feeStr} ${assetUpper} (0.3%)`;
+
         printHeader('Deposit Submitted');
         printFields([
           { label: 'Asset', value: assetUpper },
           { label: 'Amount', value: `${amount} ${assetUpper}` },
-          { label: 'Fee', value: `${feeStr} ${assetUpper} (0.3%)` },
+          { label: 'Fee', value: feeLabel },
           { label: 'Total sent', value: `${grossStr} ${assetUpper}` },
           { label: 'From', value: address },
           { label: 'Transaction', value: txUrl(result.hash) },

package/src/cli/commands/subaccount.ts

@@ -7,13 +7,14 @@ import {
   getSubaccountStatus,
   isSubaccountForwarderDeployed,
   MAX_SUBACCOUNT_SLOTS,
+  mergeSubaccount,
   sweepSubaccountForwarder,
 } from '../../subaccount.js';
 import { getConfig } from '../config.js';
 import { CLIError, ErrorCode, handleCLIError } from '../errors.js';
 import { printFields, printHeader, printJson, printLine, printList, printSection, txUrl } from '../output.js';
 import { sendTransaction } from '../wallet.js';
-import type { SubaccountAsset } from '../../types.js';
+import type { SubaccountAsset, RelayPool } from '../../types.js';
 
 function parseSlotValue(raw: string): number {
   const normalized = raw.trim();
@@ -51,6 +52,14 @@ function parseAsset(raw: string): SubaccountAsset {
   return asset;
 }
 
+function parsePool(raw: string): RelayPool {
+  const pool = raw.toLowerCase();
+  if (pool !== 'eth' && pool !== 'usdc') {
+    throw new CLIError(ErrorCode.INVALID_AMOUNT, `Unsupported pool: ${raw}. Supported: eth, usdc`);
+  }
+  return pool;
+}
+
 function printQueueHuman(
   title: string,
   queue: {
@@ -81,6 +90,7 @@ Examples:
   veil subaccount status --slot 0
   veil subaccount deploy --slot 0
   veil subaccount sweep --slot 0 --asset eth
+  veil subaccount merge --slot 0 --pool eth
   veil subaccount recover --slot 0 --asset usdc --to 0xRecipientAddress --amount 25
   veil subaccount address --slot 0
 `);
@@ -130,7 +140,7 @@ Examples:
 
   subaccount
     .command('status')
-    .description('Show subaccount deployment, balances, and queue state')
+    .description('Show subaccount deployment, forwarder balances, private balances, and queue state')
     .requiredOption('--slot <n>', 'Subaccount slot', parseSlotValue)
     .option('--json', 'Output as JSON')
     .action(async (options) => {
@@ -162,6 +172,18 @@ Examples:
           { label: 'USDC', value: `${status.balances.usdc.balance} USDC` },
         ]);
 
+        printSection('Private Pool Balances');
+        printFields([
+          {
+            label: 'ETH',
+            value: `${status.privateBalances.eth.privateBalance} ETH (${status.privateBalances.eth.unspentCount} unspent / ${status.privateBalances.eth.spentCount} spent / ${status.privateBalances.eth.utxoCount} total UTXOs)`,
+          },
+          {
+            label: 'USDC',
+            value: `${status.privateBalances.usdc.privateBalance} USDC (${status.privateBalances.usdc.unspentCount} unspent / ${status.privateBalances.usdc.spentCount} spent / ${status.privateBalances.usdc.utxoCount} total UTXOs)`,
+          },
+        ]);
+
         printQueueHuman('ETH Queue', status.queues.eth);
         printQueueHuman('USDC Queue', status.queues.usdc);
         printLine();
@@ -255,6 +277,64 @@ Examples:
       }
     });
 
+  subaccount
+    .command('merge')
+    .description('Merge a subaccount\'s private pool balance back to the main wallet')
+    .requiredOption('--slot <n>', 'Subaccount slot', parseSlotValue)
+    .option('--pool <pool>', 'Pool to merge (eth or usdc)', parsePool, 'eth' as RelayPool)
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+      try {
+        const rootPrivateKey = getRequiredVeilKey();
+        const result = await mergeSubaccount({
+          rootPrivateKey,
+          slot: options.slot,
+          pool: options.pool,
+          rpcUrl: process.env.RPC_URL,
+          relayUrl: process.env.RELAY_URL,
+          onProgress: options.json
+            ? undefined
+            : (stage, detail) => {
+                const msg = detail ? `${stage} ${detail}` : stage;
+                process.stderr.write(`\r\x1b[K${msg}`);
+              },
+        });
+
+        if (!options.json) {
+          process.stderr.write('\r\x1b[K');
+        }
+
+        const output = {
+          success: result.success,
+          slot: result.slot,
+          pool: result.pool,
+          amount: result.amount,
+          transactionHash: result.transactionHash,
+          blockNumber: result.blockNumber,
+        };
+
+        if (options.json) {
+          printJson(output);
+          return;
+        }
+
+        printHeader('Subaccount Merge Submitted');
+        printFields([
+          { label: 'Slot', value: result.slot },
+          { label: 'Pool', value: result.pool.toUpperCase() },
+          { label: 'Amount', value: result.amount },
+          { label: 'Transaction', value: txUrl(result.transactionHash) },
+          { label: 'Block', value: result.blockNumber },
+        ]);
+        printLine();
+      } catch (error) {
+        if (!options.json) {
+          process.stderr.write('\r\x1b[K');
+        }
+        handleCLIError(error);
+      }
+    });
+
   subaccount
     .command('recover')
     .description('Recover assets sitting on the subaccount forwarder with a direct withdraw transaction')

package/src/cli/index.ts

@@ -38,7 +38,7 @@ const program = new Command();
 program
   .name('veil')
   .description('CLI for Veil Cash privacy pools on Base')
-  .version('0.6.1')
+  .version('0.6.2')
   .addHelpText('after', `
 Getting started:
   veil init

package/src/index.ts

@@ -53,6 +53,7 @@ export {
 export {
   getQueueBalance,
   getPrivateBalance,
+  getDailyFreeRemaining,
 } from './balance.js';
 export type { ProgressCallback } from './balance.js';
 
@@ -139,12 +140,14 @@ export {
   isSubaccountForwarderDeployed,
   deploySubaccountForwarder,
   sweepSubaccountForwarder,
+  getSubaccountPrivateBalance,
   getSubaccountStatus,
   buildSubaccountWithdrawTypedData,
   signSubaccountWithdraw,
   isSubaccountWithdrawNonceUsed,
   findNextSubaccountWithdrawNonce,
   buildSubaccountRecoveryTx,
+  mergeSubaccount,
 } from './subaccount.js';
 
 // Utilities
@@ -197,8 +200,12 @@ export type {
   SubaccountRelayResult,
   SubaccountAssetBalance,
   SubaccountBalances,
+  SubaccountPrivateBalanceStatus,
+  SubaccountPrivateBalances,
   SubaccountQueueStatus,
   SubaccountStatusResult,
   SubaccountWithdrawTypedData,
   SubaccountRecoveryResult,
+  SubaccountMergeOptions,
+  SubaccountMergeResult,
 } from './types.js';