clawncher 0.1.0

package/dist/cli.js

@@ -0,0 +1,2640 @@
+#!/usr/bin/env node
+/**
+ * Clawncher CLI
+ *
+ * Command-line interface for deploying tokens on Base with Uniswap V4 pools.
+ * Uses ClawnchDeployer from SDK (Clanker-backed infrastructure).
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import Table from 'cli-table3';
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { createWalletClient, createPublicClient, http, formatEther, parseEther, } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+import { base, baseSepolia } from 'viem/chains';
+import { ClawnchDeployer, ClawnchReader, ClawnchClient, ClawncherClaimer, ClawnchPortfolio, ClawnchWatcher, ClawnchSwapper, ClawnchLiquidity, ClawnchApiDeployer, getAddresses, NATIVE_TOKEN_ADDRESS, ClawnchFeeLockerABI, } from '@clawnch/clawncher-sdk';
+const VERSION = '0.1.0';
+// ============================================================================
+// UI Toolkit
+// ============================================================================
+// Brand colors - orange/red/yellow fire palette
+const c = {
+    accent: chalk.hex('#FF6B2B'), // bright orange
+    accent2: chalk.hex('#FF8C42'), // warm amber
+    muted: chalk.hex('#8B6B5A'), // muted brown
+    dim: chalk.hex('#5C4033'), // dark brown
+    label: chalk.hex('#CC9966'), // tan/gold for labels
+    value: chalk.white, // white for values
+    success: chalk.hex('#FFB347'), // warm gold
+    warn: chalk.hex('#FFCC00'), // yellow
+    error: chalk.hex('#FF3344'), // bright red
+    link: chalk.hex('#FFA066'), // peach for links
+    highlight: chalk.hex('#FF6B2B').bold, // bold orange
+};
+// Gradient for the big banner - row by row color shift (red -> orange -> yellow)
+function bannerGradient(lines) {
+    const rowColors = ['#FF2200', '#FF4400', '#FF6B2B', '#FF8C42', '#FFAA33', '#FFCC00'];
+    return lines.map((line, i) => {
+        const color = rowColors[Math.min(i, rowColors.length - 1)];
+        return chalk.hex(color).bold(line);
+    }).join('\n');
+}
+// Section header with line
+function sectionHeader(title) {
+    const line = c.dim('\u2500'.repeat(Math.max(0, 50 - title.length)));
+    return `  ${c.accent2.bold(title)} ${line}`;
+}
+// Key-value pair with aligned labels
+function kv(label, value, labelWidth = 16) {
+    const padded = label.padEnd(labelWidth);
+    return `  ${c.label(padded)} ${c.value(value)}`;
+}
+// Dim key-value (for less important info)
+function kvDim(label, value, labelWidth = 16) {
+    const padded = label.padEnd(labelWidth);
+    return `  ${c.muted(padded)} ${c.muted(value)}`;
+}
+// Status indicator dot
+function dot(color) {
+    const colors = { green: '#FFB347', yellow: '#FFCC00', red: '#FF3344' };
+    return chalk.hex(colors[color])('\u25CF');
+}
+// Network badge
+function networkBadge(network) {
+    if (network === 'mainnet') {
+        return chalk.bgHex('#FF6B2B').hex('#000000').bold(` ${network.toUpperCase()} `);
+    }
+    return chalk.bgHex('#FFCC00').hex('#000000').bold(` ${network.toUpperCase()} `);
+}
+// Progress bar
+function progressBar(percent, width = 20) {
+    const filled = Math.round(width * Math.min(percent, 100) / 100);
+    const empty = width - filled;
+    const bar = c.accent('\u2588'.repeat(filled)) + c.dim('\u2591'.repeat(empty));
+    return `${bar} ${c.value(percent.toFixed(1) + '%')}`;
+}
+// Address formatting - highlight 0x prefix and ccc vanity
+function fmtAddr(address, truncate = false) {
+    if (truncate) {
+        return c.muted('0x') + c.accent(address.slice(2, 6)) + c.dim('...') + c.value(address.slice(-4));
+    }
+    // Highlight vanity prefix if starts with 0xccc
+    if (address.toLowerCase().startsWith('0xccc')) {
+        return c.muted('0x') + c.accent(address.slice(2, 5)) + c.value(address.slice(5));
+    }
+    return c.muted('0x') + c.value(address.slice(2));
+}
+// Styled table with our colors
+function styledTable(heads, rows) {
+    const table = new Table({
+        head: heads.map(h => c.accent2.bold(h)),
+        chars: {
+            'top': '\u2500', 'top-mid': '\u252C', 'top-left': '\u250C', 'top-right': '\u2510',
+            'bottom': '\u2500', 'bottom-mid': '\u2534', 'bottom-left': '\u2514', 'bottom-right': '\u2518',
+            'left': '\u2502', 'left-mid': '\u251C', 'mid': '\u2500', 'mid-mid': '\u253C',
+            'right': '\u2502', 'right-mid': '\u2524', 'middle': '\u2502',
+        },
+        style: {
+            head: [],
+            border: [],
+        },
+    });
+    rows.forEach(row => table.push(row.map(cell => String(cell))));
+    // Dim the border characters
+    return table.toString().replace(/[\u2500\u252C\u250C\u2510\u2534\u2514\u2518\u2502\u251C\u253C\u2524]/g, (ch) => c.dim(ch));
+}
+const CONFIG_DIR = join(homedir(), '.clawncher');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+function loadConfig() {
+    try {
+        if (existsSync(CONFIG_FILE)) {
+            return JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'));
+        }
+    }
+    catch {
+        // Ignore errors, return empty config
+    }
+    return {};
+}
+function saveConfig(config) {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    }
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), { mode: 0o600 });
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function isValidAddress(address) {
+    return /^0x[0-9a-fA-F]{40}$/.test(address);
+}
+function validateAddress(address, label) {
+    if (!isValidAddress(address)) {
+        console.error(c.error(`  \u2717 Invalid ${label} address: ${address}`));
+        console.error(c.muted('    Expected a 42-character hex string starting with 0x'));
+        process.exit(1);
+    }
+    return address;
+}
+function safeParseInt(value, label) {
+    const n = parseInt(value, 10);
+    if (isNaN(n)) {
+        console.error(c.error(`Invalid ${label}: "${value}" is not a number`));
+        process.exit(1);
+    }
+    return n;
+}
+function handleError(err) {
+    if (err && typeof err === 'object' && 'message' in err) {
+        const error = err;
+        console.error(`\n  ${c.error('\u2717')} ${c.error(error.message)}`);
+        if (error.errors?.length) {
+            error.errors.forEach((e) => console.error(c.muted(`    \u2500 ${e}`)));
+        }
+        console.error();
+    }
+    else {
+        console.error(`\n  ${c.error('\u2717')} ${c.error('An unknown error occurred')}\n`);
+    }
+    process.exit(1);
+}
+function getPrivateKey(opts) {
+    // Priority: --private-key flag > env var > config file
+    const key = opts.privateKey || process.env.CLAWNCHER_PRIVATE_KEY || loadConfig().privateKey;
+    if (!key) {
+        console.error(c.error('Private key required. Use --private-key, CLAWNCHER_PRIVATE_KEY env var, `clawncher config --private-key`, or `clawncher wallet use <name>`'));
+        process.exit(1);
+    }
+    return key.startsWith('0x') ? key : `0x${key}`;
+}
+/**
+ * Get private key with wallet support. If no key is provided via flag/env/config,
+ * tries to decrypt the active wallet (prompts for password).
+ */
+async function getPrivateKeyOrWallet(opts) {
+    // First try the non-interactive sources
+    const key = opts.privateKey || process.env.CLAWNCHER_PRIVATE_KEY || loadConfig().privateKey;
+    if (key) {
+        return key.startsWith('0x') ? key : `0x${key}`;
+    }
+    // Try active wallet (lazy import to avoid circular issues at module load)
+    const { getActiveWallet: getActive, walletExists: exists, decryptWallet: decrypt, promptPassword: prompt } = await import('./wallet.js');
+    const activeWallet = getActive();
+    if (activeWallet && exists(activeWallet)) {
+        const password = await prompt(`  Enter password for wallet "${activeWallet}": `);
+        try {
+            const decrypted = decrypt(activeWallet, password);
+            return decrypted.privateKey;
+        }
+        catch {
+            console.error(c.error('  Incorrect wallet password'));
+            process.exit(1);
+        }
+    }
+    console.error(c.error('Private key required. Use --private-key, CLAWNCHER_PRIVATE_KEY env var, `clawncher config --private-key`, or `clawncher wallet use <name>`'));
+    process.exit(1);
+}
+function getNetwork(opts) {
+    const network = opts.network || loadConfig().network || 'sepolia';
+    if (network !== 'sepolia' && network !== 'mainnet') {
+        console.error(c.error('Invalid network. Use "sepolia" or "mainnet"'));
+        process.exit(1);
+    }
+    return network;
+}
+function getRpcUrl(network, opts) {
+    const config = loadConfig();
+    if (opts.rpc)
+        return opts.rpc;
+    if (network === 'sepolia' && config.rpc?.sepolia)
+        return config.rpc.sepolia;
+    if (network === 'mainnet' && config.rpc?.mainnet)
+        return config.rpc.mainnet;
+    // Default public RPCs
+    return network === 'mainnet'
+        ? 'https://mainnet.base.org'
+        : 'https://sepolia.base.org';
+}
+function getChain(network) {
+    return network === 'mainnet' ? base : baseSepolia;
+}
+function createClients(network, privateKey, rpcUrl) {
+    const chain = getChain(network);
+    const account = privateKeyToAccount(privateKey);
+    const wallet = createWalletClient({
+        account,
+        chain,
+        transport: http(rpcUrl),
+    });
+    const publicClient = createPublicClient({
+        chain,
+        transport: http(rpcUrl),
+    });
+    // Cast to any to avoid viem version mismatch between CLI and SDK
+    return { wallet: wallet, publicClient: publicClient, account };
+}
+function getClawnchApiUrl() {
+    return process.env.CLAWNCHER_API_URL || process.env.CLAWNCH_API_URL || 'https://clawn.ch';
+}
+// Helper to read ERC20 decimals/symbol via any-typed publicClient (avoids viem version mismatch)
+const erc20DecimalsAbi = [{ type: 'function', name: 'decimals', inputs: [], outputs: [{ type: 'uint8' }], stateMutability: 'view' }];
+const erc20SymbolAbi = [{ type: 'function', name: 'symbol', inputs: [], outputs: [{ type: 'string' }], stateMutability: 'view' }];
+async function readDecimals(client, token) {
+    return client.readContract({ address: token, abi: erc20DecimalsAbi, functionName: 'decimals' });
+}
+async function readSymbol(client, token) {
+    return client.readContract({ address: token, abi: erc20SymbolAbi, functionName: 'symbol' });
+}
+function getClient(options = {}) {
+    return new ClawnchClient({
+        baseUrl: options.apiUrl || process.env.CLAWNCHER_API_URL || 'https://clawn.ch',
+        moltbookKey: options.moltbookKey || process.env.MOLTBOOK_KEY,
+    });
+}
+// ============================================================================
+// Main Program
+// ============================================================================
+const program = new Command();
+program
+    .name('clawncher')
+    .description('CLI for Clawncher - token launch toolkit for Base, optimized for agents')
+    .version(VERSION)
+    .option('--api-url <url>', 'API base URL', 'https://clawn.ch')
+    .option('--moltbook-key <key>', 'Moltbook API key for authenticated operations');
+// ============================================================================
+// Deploy Command
+// ============================================================================
+program
+    .command('deploy')
+    .description('Deploy a new token on Base with Uniswap V4 pool')
+    .requiredOption('--name <name>', 'Token name')
+    .requiredOption('--symbol <symbol>', 'Token symbol')
+    .option('--image <url>', 'Token image URL')
+    .option('--description <text>', 'Token description')
+    .option('--recipient <address>', 'Fee recipient address (defaults to deployer)')
+    .option('--fee-preference <pref>', 'Fee preference: Clawnch (token), Paired (WETH), or Both', 'Clawnch')
+    .option('--vault-percent <n>', 'Vault allocation percentage (1-90)')
+    .option('--vault-lockup <days>', 'Vault lockup duration in days', '7')
+    .option('--vault-vesting <days>', 'Vault vesting duration in days after lockup (0 = instant)', '0')
+    .option('--vault-recipient <address>', 'Vault recipient (defaults to deployer)')
+    .option('--dev-buy <eth>', 'Dev buy: ETH amount to spend (instant transfer)')
+    .option('--dev-buy-recipient <address>', 'Dev buy recipient (defaults to deployer)')
+    .option('--no-vanity', 'Disable vanity address (default: enabled)')
+    .option('--dry-run', 'Simulate deployment without sending transaction')
+    .option('--network <network>', 'Network: sepolia or mainnet', 'sepolia')
+    .option('--rpc <url>', 'Custom RPC URL')
+    .option('--private-key <key>', 'Private key (or use CLAWNCHER_PRIVATE_KEY env)')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    const spinner = ora('Preparing deployment...').start();
+    try {
+        const privateKey = await getPrivateKeyOrWallet(opts);
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const { wallet, publicClient, account } = createClients(network, privateKey, rpcUrl);
+        spinner.text = `Deploying ${opts.symbol} on ${network}...`;
+        const deployer = new ClawnchDeployer({
+            wallet,
+            publicClient,
+            network,
+        });
+        if (!deployer.isConfigured()) {
+            spinner.stop();
+            console.error(c.error(`Contracts not deployed on ${network}`));
+            process.exit(1);
+        }
+        // Parse fee preference (default: Clawnch = receive fees in the token)
+        let feePreference = 'Clawnch';
+        if (opts.feePreference) {
+            const pref = opts.feePreference.toLowerCase();
+            if (pref === 'paired')
+                feePreference = 'Paired';
+            else if (pref === 'both')
+                feePreference = 'Both';
+            else
+                feePreference = 'Clawnch';
+        }
+        // Build deploy options
+        const recipient = opts.recipient ? validateAddress(opts.recipient, 'recipient') : account.address;
+        const deployOpts = {
+            name: opts.name,
+            symbol: opts.symbol,
+            tokenAdmin: account.address,
+            image: opts.image,
+            metadata: opts.description ? { description: opts.description } : undefined,
+            rewards: {
+                recipients: [{
+                        recipient,
+                        admin: recipient,
+                        bps: 10000, // 100%
+                        feePreference,
+                    }],
+            },
+        };
+        // Add vault if specified
+        if (opts.vaultPercent) {
+            const vaultPercent = safeParseInt(opts.vaultPercent, 'vault percent');
+            if (vaultPercent < 1 || vaultPercent > 90) {
+                spinner.stop();
+                console.error(c.error('Vault percent must be between 1 and 90'));
+                process.exit(1);
+            }
+            const lockupDays = safeParseInt(opts.vaultLockup || '7', 'vault lockup days');
+            const lockupSeconds = lockupDays * 24 * 60 * 60;
+            const vestingDays = safeParseInt(opts.vaultVesting || '0', 'vault vesting days');
+            const vestingSeconds = vestingDays * 24 * 60 * 60;
+            const vaultRecipient = opts.vaultRecipient ? validateAddress(opts.vaultRecipient, 'vault recipient') : account.address;
+            deployOpts.vault = {
+                percentage: vaultPercent,
+                lockupDuration: lockupSeconds,
+                vestingDuration: vestingSeconds,
+                recipient: vaultRecipient,
+            };
+        }
+        // Add instant dev buy if specified
+        if (opts.devBuy) {
+            const ethAmount = parseEther(opts.devBuy);
+            if (ethAmount <= 0n) {
+                spinner.stop();
+                console.error(c.error('Dev buy ETH amount must be greater than 0'));
+                process.exit(1);
+            }
+            const devBuyRecipient = opts.devBuyRecipient ? validateAddress(opts.devBuyRecipient, 'dev buy recipient') : account.address;
+            deployOpts.devBuy = {
+                ethAmount,
+                recipient: devBuyRecipient,
+            };
+        }
+        // Configure vanity address (default: enabled, uses Clanker's remote service)
+        deployOpts.vanity = opts.vanity !== false; // --no-vanity sets this to false
+        // Dry run mode
+        if (opts.dryRun) {
+            deployOpts.dryRun = true;
+            const result = await deployer.deploy(deployOpts);
+            spinner.stop();
+            if (result.error) {
+                handleError(result.error);
+            }
+            if (opts.json) {
+                console.log(JSON.stringify({
+                    dryRun: true,
+                    valid: result.valid,
+                    estimatedGas: result.estimatedGas?.toString(),
+                    estimatedCostEth: result.estimatedCostEth,
+                    translatedConfig: result.translatedConfig,
+                }, null, 2));
+                return;
+            }
+            console.log();
+            console.log(`  ${c.success('\u2713')} ${c.highlight('Dry run passed')}`);
+            console.log();
+            console.log(sectionHeader('Validation'));
+            console.log(kv('Valid', result.valid ? `${dot('green')} Yes` : `${dot('red')} No`));
+            console.log(kv('Name', opts.name));
+            console.log(kv('Symbol', c.highlight(opts.symbol)));
+            console.log(kv('Network', networkBadge(network)));
+            if (result.estimatedGas) {
+                console.log(kv('Est. Gas', c.value(result.estimatedGas.toLocaleString())));
+            }
+            if (result.estimatedCostEth) {
+                console.log(kv('Est. Cost', c.accent(result.estimatedCostEth + ' ETH')));
+            }
+            console.log();
+            console.log(sectionHeader('Translated Config'));
+            const configStr = JSON.stringify(result.translatedConfig, null, 2);
+            for (const line of configStr.split('\n')) {
+                console.log(c.muted('  ' + line));
+            }
+            console.log();
+            return;
+        }
+        const result = await deployer.deploy(deployOpts);
+        if (result.error) {
+            spinner.stop();
+            handleError(result.error);
+        }
+        spinner.text = 'Waiting for transaction confirmation...';
+        const { address } = await result.waitForTransaction();
+        spinner.stop();
+        if (opts.json) {
+            console.log(JSON.stringify({
+                success: true,
+                txHash: result.txHash,
+                tokenAddress: address,
+                network,
+                name: opts.name,
+                symbol: opts.symbol,
+                deployer: account.address,
+            }, null, 2));
+            return;
+        }
+        console.log();
+        console.log(`  ${c.success('\u2713')} ${c.highlight('Token deployed successfully')}`);
+        console.log();
+        console.log(sectionHeader('Deployment'));
+        console.log(kv('Network', networkBadge(network)));
+        console.log(kv('Name', opts.name));
+        console.log(kv('Symbol', c.highlight(opts.symbol)));
+        console.log(kv('Token', address ? fmtAddr(address) : c.warn('Pending...')));
+        console.log(kv('Transaction', c.muted(result.txHash)));
+        console.log(kv('Deployer', fmtAddr(account.address)));
+        console.log(kv('Fee Recipient', fmtAddr(recipient)));
+        if (opts.vaultPercent) {
+            console.log(kv('Vault', `${c.accent(opts.vaultPercent + '%')} locked for ${c.value((opts.vaultLockup || 7) + ' days')}`));
+        }
+        const explorerUrl = network === 'mainnet'
+            ? `https://basescan.org/tx/${result.txHash}`
+            : `https://sepolia.basescan.org/tx/${result.txHash}`;
+        console.log();
+        console.log(`  ${c.link(explorerUrl)}`);
+        console.log();
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+// ============================================================================
+// Info Command (Read from chain)
+// ============================================================================
+program
+    .command('info')
+    .description('Get full token details from chain (deployment, vault, MEV, rewards)')
+    .argument('<address>', 'Token contract address')
+    .option('--network <network>', 'Network: sepolia or mainnet', 'sepolia')
+    .option('--rpc <url>', 'Custom RPC URL')
+    .option('--json', 'Output as JSON')
+    .action(async (address, opts) => {
+    const spinner = ora('Fetching token details...').start();
+    try {
+        const tokenAddress = validateAddress(address, 'token');
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const chain = getChain(network);
+        const publicClient = createPublicClient({
+            chain,
+            transport: http(rpcUrl),
+        });
+        const reader = new ClawnchReader({
+            publicClient,
+            network,
+        });
+        const details = await reader.getTokenDetails(tokenAddress);
+        spinner.stop();
+        if (!details) {
+            // Fall back to basic ERC20 info if not a Clawnch token
+            const info = await reader.getTokenInfo(tokenAddress);
+            console.log();
+            console.log(`  ${c.warn('\u26A0')} ${c.warn(info.symbol + ' is not a Clawnch token')}`);
+            console.log();
+            console.log(kv('Address', fmtAddr(address)));
+            console.log(kv('Name', info.name));
+            console.log(kv('Symbol', info.symbol));
+            console.log(kv('Total Supply', formatEther(info.totalSupply)));
+            console.log(kv('Network', networkBadge(network)));
+            console.log();
+            return;
+        }
+        if (opts.json) {
+            // Serialize bigints for JSON output
+            const serializable = JSON.parse(JSON.stringify(details, (_, v) => typeof v === 'bigint' ? v.toString() : v));
+            console.log(JSON.stringify(serializable, null, 2));
+            return;
+        }
+        console.log();
+        console.log(`  ${c.highlight(details.symbol)} ${c.muted('\u00B7 ' + details.name)}`);
+        console.log();
+        console.log(sectionHeader('Token'));
+        console.log(kv('Address', fmtAddr(details.address)));
+        console.log(kv('Total Supply', formatEther(details.totalSupply)));
+        console.log(kv('Admin', fmtAddr(details.tokenAdmin)));
+        console.log(kv('Network', networkBadge(network)));
+        if (details.image) {
+            console.log(kv('Image', c.link(details.image)));
+        }
+        // Deployment
+        console.log();
+        console.log(sectionHeader('Deployment'));
+        console.log(kv('Hook', fmtAddr(details.deployment.hook, true)));
+        console.log(kv('Locker', fmtAddr(details.deployment.locker, true)));
+        if (details.deployment.extensions.length > 0) {
+            console.log(kv('Extensions', details.deployment.extensions.map(e => fmtAddr(e, true)).join(c.dim(', '))));
+        }
+        // Rewards
+        if (details.rewards) {
+            console.log();
+            console.log(sectionHeader('Fee Recipients'));
+            for (let i = 0; i < details.rewards.rewardRecipients.length; i++) {
+                const bps = details.rewards.rewardBps[i];
+                const pct = (bps / 100).toFixed(1);
+                console.log(`  ${fmtAddr(details.rewards.rewardRecipients[i], true)} ${c.dim('\u2500')} ${c.accent(pct + '%')}`);
+            }
+        }
+        // Vault
+        if (details.vault) {
+            console.log();
+            console.log(sectionHeader('Vault'));
+            console.log(kv('Vesting', progressBar(details.vault.percentVested)));
+            console.log(kv('Total', formatEther(details.vault.amountTotal) + ' tokens'));
+            console.log(kv('Claimed', formatEther(details.vault.amountClaimed) + ' tokens'));
+            console.log(kv('Available', c.accent(formatEther(details.vault.amountAvailable) + ' tokens')));
+            console.log(kv('Unlocked', details.vault.isUnlocked ? `${dot('green')} Yes` : `${dot('yellow')} No`));
+            console.log(kv('Admin', fmtAddr(details.vault.admin, true)));
+        }
+        // Vested Dev Buy (legacy v2 tokens only)
+        if (details.vestedDevBuy) {
+            console.log();
+            console.log(sectionHeader('Vested Dev Buy (Legacy)'));
+            console.log(c.warn('  Vested dev buy claiming is not available in v3'));
+            console.log(kv('Vesting', progressBar(details.vestedDevBuy.percentVested)));
+            console.log(kv('Total', formatEther(details.vestedDevBuy.amountTotal) + ' tokens'));
+            console.log(kv('Claimed', formatEther(details.vestedDevBuy.amountClaimed) + ' tokens'));
+            console.log(kv('Available', c.accent(formatEther(details.vestedDevBuy.amountAvailable) + ' tokens')));
+            console.log(kv('Unlocked', details.vestedDevBuy.isUnlocked ? `${dot('green')} Yes` : `${dot('yellow')} No`));
+        }
+        // MEV
+        if (details.mev) {
+            console.log();
+            console.log(sectionHeader('MEV Protection'));
+            console.log(kv('Current Fee', c.accent((details.mev.currentFee / 10000 * 100).toFixed(2) + '%')));
+            console.log(kv('Starting Fee', (details.mev.startingFee / 10000 * 100).toFixed(2) + '%'));
+            console.log(kv('Ending Fee', (details.mev.endingFee / 10000 * 100).toFixed(2) + '%'));
+            console.log(kv('Decay Done', details.mev.isDecayComplete ? `${dot('green')} Complete` : `${dot('yellow')} Active`));
+        }
+        // Explorer link
+        const explorerUrl = network === 'mainnet'
+            ? `https://basescan.org/address/${address}`
+            : `https://sepolia.basescan.org/address/${address}`;
+        console.log();
+        console.log(`  ${c.link(explorerUrl)}`);
+        console.log();
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+// ============================================================================
+// Fees Commands
+// ============================================================================
+const fees = program.command('fees').description('Manage trading fees');
+fees
+    .command('check')
+    .description('Check claimable fees for a wallet')
+    .argument('<wallet>', 'Wallet address')
+    .option('-t, --tokens <addresses>', 'Comma-separated token addresses to check')
+    .option('--network <network>', 'Network: sepolia or mainnet', 'sepolia')
+    .option('--rpc <url>', 'Custom RPC URL')
+    .option('--json', 'Output as JSON')
+    .action(async (wallet, opts) => {
+    const walletAddr = validateAddress(wallet, 'wallet');
+    const spinner = ora('Checking fees...').start();
+    try {
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const chain = getChain(network);
+        const publicClient = createPublicClient({
+            chain,
+            transport: http(rpcUrl),
+        });
+        const addresses = getAddresses(network);
+        // If specific tokens provided, validate and check those
+        const tokenAddresses = opts.tokens
+            ? opts.tokens.split(',').map((t) => validateAddress(t.trim(), 'token'))
+            : [];
+        const results = [];
+        // Check fees for each token in FeeLocker
+        for (const tokenAddr of tokenAddresses) {
+            try {
+                const available = await publicClient.readContract({
+                    address: addresses.clawnch.feeLocker,
+                    abi: ClawnchFeeLockerABI,
+                    functionName: 'availableFees',
+                    args: [walletAddr, tokenAddr],
+                });
+                results.push({
+                    token: tokenAddr,
+                    wethAvailable: available,
+                });
+            }
+            catch {
+                // Token may not have fees
+            }
+        }
+        spinner.stop();
+        if (opts.json) {
+            console.log(JSON.stringify({
+                wallet,
+                network,
+                tokens: results.map(r => ({
+                    token: r.token,
+                    wethAvailable: r.wethAvailable.toString(),
+                    wethFormatted: formatEther(r.wethAvailable),
+                })),
+            }, null, 2));
+            return;
+        }
+        console.log();
+        console.log(sectionHeader('Claimable Fees'));
+        console.log(kv('Wallet', fmtAddr(wallet)));
+        console.log(kv('Network', networkBadge(network)));
+        console.log();
+        if (results.length === 0) {
+            if (tokenAddresses.length === 0) {
+                console.log(c.warn('  Provide token addresses with --tokens to check fees'));
+            }
+            else {
+                console.log(c.muted('  No claimable fees found'));
+            }
+            console.log();
+            return;
+        }
+        console.log(styledTable(['Token', 'WETH Available'], results.map(r => [fmtAddr(r.token, true), c.accent(formatEther(r.wethAvailable))])));
+        console.log();
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+fees
+    .command('available')
+    .description('Check available fees for a wallet (via API)')
+    .argument('<wallet>', 'Wallet address')
+    .option('-t, --tokens <addresses>', 'Comma-separated token addresses to check')
+    .option('--json', 'Output as JSON')
+    .action(async (wallet, opts) => {
+    const spinner = ora('Checking fees...').start();
+    try {
+        const client = getClient(program.opts());
+        const result = await client.getAvailableFees(wallet, opts.tokens);
+        spinner.stop();
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log();
+        console.log(sectionHeader('Available Fees'));
+        console.log(kv('Wallet', fmtAddr(wallet)));
+        const totalWeth = result.total_weth || result.weth?.available || '0';
+        console.log(kv('Total WETH', c.accent((result.weth?.formatted || formatEther(BigInt(totalWeth))) + ' WETH')));
+        console.log();
+        if (!result.tokens?.length) {
+            console.log(c.muted('  No tokens with claimable fees'));
+            return;
+        }
+        console.log(styledTable(['Symbol', 'Address', 'Available'], result.tokens.map((t) => [
+            c.highlight(t.symbol),
+            fmtAddr(t.address, true),
+            c.accent(t.formatted || formatEther(BigInt(t.available || '0'))),
+        ])));
+        console.log();
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+fees
+    .command('claim')
+    .description('Claim trading fees on-chain (collect rewards + claim from FeeLocker)')
+    .argument('<token>', 'Token contract address')
+    .requiredOption('--fee-owner <address>', 'Fee owner address (the reward recipient configured at deploy)')
+    .option('--collect-only', 'Only collect LP rewards (skip fee claims)')
+    .option('--skip-collect', 'Skip collecting LP rewards (only claim from FeeLocker)')
+    .option('--vault', 'Also claim vault allocation if available')
+    .option('--network <network>', 'Network: sepolia or mainnet', 'sepolia')
+    .option('--rpc <url>', 'Custom RPC URL')
+    .option('--private-key <key>', 'Private key (or use CLAWNCHER_PRIVATE_KEY env)')
+    .option('--json', 'Output as JSON')
+    .action(async (token, opts) => {
+    const spinner = ora('Preparing claim...').start();
+    try {
+        const tokenAddress = validateAddress(token, 'token');
+        const feeOwner = validateAddress(opts.feeOwner, 'fee owner');
+        const privateKey = await getPrivateKeyOrWallet(opts);
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const { wallet, publicClient, account } = createClients(network, privateKey, rpcUrl);
+        const addresses = getAddresses(network);
+        const claimer = new ClawncherClaimer({
+            wallet,
+            publicClient,
+            network,
+        });
+        const results = [];
+        // Step 1: Collect LP rewards (unless --skip-collect)
+        if (!opts.skipCollect) {
+            spinner.text = 'Collecting LP rewards...';
+            try {
+                const collectResult = await claimer.collectRewards(tokenAddress);
+                const receipt = await collectResult.wait();
+                results.push({ step: 'Collect Rewards', txHash: collectResult.txHash, success: receipt.success });
+            }
+            catch (err) {
+                results.push({ step: 'Collect Rewards', txHash: '', success: false });
+                if (opts.collectOnly) {
+                    spinner.stop();
+                    handleError(err);
+                }
+                // Continue to fee claims even if collect fails (may already have unclaimed fees)
+            }
+        }
+        if (!opts.collectOnly) {
+            // Step 2: Check and claim WETH fees
+            spinner.text = 'Checking WETH fees...';
+            try {
+                const wethAvailable = await publicClient.readContract({
+                    address: addresses.clawnch.feeLocker,
+                    abi: ClawnchFeeLockerABI,
+                    functionName: 'availableFees',
+                    args: [feeOwner, addresses.infrastructure.weth],
+                });
+                if (wethAvailable > 0n) {
+                    spinner.text = `Claiming ${formatEther(wethAvailable)} WETH...`;
+                    const claimResult = await claimer.claimFees(feeOwner, addresses.infrastructure.weth);
+                    const receipt = await claimResult.wait();
+                    results.push({ step: `Claim WETH (${formatEther(wethAvailable)})`, txHash: claimResult.txHash, success: receipt.success });
+                }
+                else {
+                    results.push({ step: 'Claim WETH', txHash: '-', success: true });
+                }
+            }
+            catch {
+                results.push({ step: 'Claim WETH', txHash: '', success: false });
+            }
+            // Step 3: Check and claim token fees
+            spinner.text = 'Checking token fees...';
+            try {
+                const tokenAvailable = await publicClient.readContract({
+                    address: addresses.clawnch.feeLocker,
+                    abi: ClawnchFeeLockerABI,
+                    functionName: 'availableFees',
+                    args: [feeOwner, tokenAddress],
+                });
+                if (tokenAvailable > 0n) {
+                    spinner.text = `Claiming ${formatEther(tokenAvailable)} token fees...`;
+                    const claimResult = await claimer.claimFees(feeOwner, tokenAddress);
+                    const receipt = await claimResult.wait();
+                    results.push({ step: `Claim Token (${formatEther(tokenAvailable)})`, txHash: claimResult.txHash, success: receipt.success });
+                }
+                else {
+                    results.push({ step: 'Claim Token', txHash: '-', success: true });
+                }
+            }
+            catch {
+                results.push({ step: 'Claim Token', txHash: '', success: false });
+            }
+        }
+        // Optional: Claim vault
+        if (opts.vault) {
+            spinner.text = 'Claiming vault allocation...';
+            try {
+                const vaultResult = await claimer.claimVault(tokenAddress);
+                const receipt = await vaultResult.wait();
+                results.push({ step: 'Claim Vault', txHash: vaultResult.txHash, success: receipt.success });
+            }
+            catch {
+                results.push({ step: 'Claim Vault', txHash: '', success: false });
+            }
+        }
+        spinner.stop();
+        if (opts.json) {
+            console.log(JSON.stringify({ token, feeOwner, network, results }, null, 2));
+            return;
+        }
+        console.log();
+        console.log(sectionHeader('Fee Claim Results'));
+        console.log(kv('Token', fmtAddr(tokenAddress)));
+        console.log(kv('Fee Owner', fmtAddr(feeOwner)));
+        console.log(kv('Network', networkBadge(network)));
+        console.log(kv('Caller', fmtAddr(account.address)));
+        console.log();
+        for (const r of results) {
+            const icon = r.success ? c.success('\u2713') : c.error('\u2717');
+            const hash = r.txHash && r.txHash !== '-' && r.txHash !== ''
+                ? c.muted(r.txHash.slice(0, 10) + '...')
+                : r.txHash === '-' ? c.dim('no fees') : c.error('failed');
+            console.log(`  ${icon} ${c.label(r.step.padEnd(30))} ${hash}`);
+        }
+        const successCount = results.filter(r => r.success).length;
+        console.log();
+        console.log(c.dim(`  ${successCount}/${results.length} steps completed`));
+        console.log();
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+fees
+    .command('batch-claim')
+    .description('Claim fees for multiple tokens in one session')
+    .argument('<tokens...>', 'Token contract addresses (space-separated)')
+    .requiredOption('--fee-owner <address>', 'Fee owner address')
+    .option('--network <network>', 'Network: sepolia or mainnet', 'sepolia')
+    .option('--rpc <url>', 'Custom RPC URL')
+    .option('--private-key <key>', 'Private key (or use CLAWNCHER_PRIVATE_KEY env)')
+    .option('--json', 'Output as JSON')
+    .action(async (tokens, opts) => {
+    const spinner = ora('Starting batch claim...').start();
+    try {
+        const feeOwner = validateAddress(opts.feeOwner, 'fee owner');
+        const privateKey = await getPrivateKeyOrWallet(opts);
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const tokenAddresses = tokens.map((t) => validateAddress(t.trim(), 'token'));
+        const { wallet, publicClient, account } = createClients(network, privateKey, rpcUrl);
+        const claimer = new ClawncherClaimer({
+            wallet,
+            publicClient,
+            network,
+        });
+        const result = await claimer.claimBatch(tokenAddresses, feeOwner, {
+            onProgress: (token, step) => {
+                spinner.text = `${fmtAddr(token, true)}: ${step}`;
+            },
+        });
+        spinner.stop();
+        if (opts.json) {
+            console.log(JSON.stringify({
+                feeOwner,
+                network,
+                successCount: result.successCount,
+                failureCount: result.failureCount,
+                results: result.results.map(r => ({
+                    token: r.token,
+                    success: r.success,
+                    collectRewards: r.collectRewards?.txHash,
+                    claimFeesWeth: r.claimFeesWeth?.txHash,
+                    claimFeesToken: r.claimFeesToken?.txHash,
+                    error: r.error?.message,
+                })),
+            }, null, 2));
+            return;
+        }
+        console.log();
+        console.log(sectionHeader('Batch Claim Results'));
+        console.log(kv('Fee Owner', fmtAddr(feeOwner)));
+        console.log(kv('Network', networkBadge(network)));
+        console.log(kv('Tokens', c.value(tokenAddresses.length.toString())));
+        console.log();
+        for (const r of result.results) {
+            const icon = r.success ? c.success('\u2713') : c.error('\u2717');
+            const status = r.success ? c.success('claimed') : c.error(r.error?.message || 'failed');
+            console.log(`  ${icon} ${fmtAddr(r.token, true)} ${c.dim('\u2500')} ${status}`);
+            if (r.collectRewards) {
+                console.log(`    ${c.muted('collect:')} ${c.dim(r.collectRewards.txHash.slice(0, 14) + '...')}`);
+            }
+            if (r.claimFeesWeth) {
+                console.log(`    ${c.muted('weth:')}    ${c.dim(r.claimFeesWeth.txHash.slice(0, 14) + '...')}`);
+            }
+            if (r.claimFeesToken) {
+                console.log(`    ${c.muted('token:')}   ${c.dim(r.claimFeesToken.txHash.slice(0, 14) + '...')}`);
+            }
+        }
+        console.log();
+        console.log(c.dim(`  ${result.successCount}/${result.results.length} tokens claimed successfully`));
+        console.log();
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+// ============================================================================
+// Portfolio Command
+// ============================================================================
+program
+    .command('portfolio')
+    .description('Show all tokens and claimable fees for a wallet')
+    .argument('<wallet>', 'Wallet address')
+    .option('-t, --tokens <addresses>', 'Comma-separated token addresses to check')
+    .option('--discover', 'Discover tokens by scanning factory events (slower)')
+    .option('--network <network>', 'Network: sepolia or mainnet', 'sepolia')
+    .option('--rpc <url>', 'Custom RPC URL')
+    .option('--json', 'Output as JSON')
+    .action(async (wallet, opts) => {
+    const spinner = ora('Building portfolio...').start();
+    try {
+        const walletAddr = validateAddress(wallet, 'wallet');
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const chain = getChain(network);
+        const publicClient = createPublicClient({
+            chain,
+            transport: http(rpcUrl),
+        });
+        const portfolio = new ClawnchPortfolio({
+            publicClient,
+            network,
+        });
+        // Get token list
+        let tokenAddresses = [];
+        if (opts.tokens) {
+            tokenAddresses = opts.tokens.split(',').map((t) => validateAddress(t.trim(), 'token'));
+        }
+        else if (opts.discover) {
+            spinner.text = 'Scanning for deployed tokens...';
+            tokenAddresses = await portfolio.discoverTokens(walletAddr);
+        }
+        if (tokenAddresses.length === 0) {
+            spinner.stop();
+            console.log();
+            console.log(c.warn('  No tokens to check. Use --tokens or --discover to specify tokens.'));
+            console.log(c.muted('  Example: clawncher portfolio 0x... --tokens 0xToken1,0xToken2'));
+            console.log(c.muted('  Example: clawncher portfolio 0x... --discover'));
+            console.log();
+            return;
+        }
+        spinner.text = `Checking ${tokenAddresses.length} tokens...`;
+        const [tokens, claimable] = await Promise.all([
+            portfolio.getTokensForWallet(walletAddr, tokenAddresses),
+            portfolio.getTotalClaimable(walletAddr, tokenAddresses),
+        ]);
+        spinner.stop();
+        if (opts.json) {
+            console.log(JSON.stringify({
+                wallet,
+                network,
+                tokens: tokens.map(t => ({
+                    address: t.address,
+                    name: t.name,
+                    symbol: t.symbol,
+                    bps: t.bps,
+                    claimableWeth: t.claimableWeth.toString(),
+                    claimableToken: t.claimableToken.toString(),
+                    formattedWeth: t.formattedWeth,
+                    formattedToken: t.formattedToken,
+                })),
+                totalClaimable: {
+                    weth: claimable.weth.toString(),
+                    formattedWeth: claimable.formattedWeth,
+                    tokens: claimable.tokens.map(t => ({
+                        address: t.address,
+                        symbol: t.symbol,
+                        amount: t.amount.toString(),
+                        formatted: t.formatted,
+                    })),
+                },
+            }, null, 2));
+            return;
+        }
+        console.log();
+        console.log(`  ${c.highlight('Portfolio')} ${c.muted('for')} ${fmtAddr(wallet, true)}`);
+        console.log();
+        console.log(sectionHeader('Summary'));
+        console.log(kv('Total WETH', c.accent(claimable.formattedWeth + ' WETH')));
+        console.log(kv('Tokens Found', c.value(tokens.length.toString())));
+        console.log(kv('Network', networkBadge(network)));
+        console.log();
+        if (tokens.length === 0) {
+            console.log(c.muted('  No tokens found where this wallet is a fee recipient'));
+            console.log();
+            return;
+        }
+        console.log(styledTable(['Symbol', 'Address', 'BPS', 'WETH Fees', 'Token Fees'], tokens.map(t => [
+            c.highlight(t.symbol),
+            fmtAddr(t.address, true),
+            c.value((t.bps / 100).toFixed(1) + '%'),
+            c.accent(t.formattedWeth),
+            c.value(t.formattedToken),
+        ])));
+        if (claimable.tokens.length > 0) {
+            console.log();
+            console.log(sectionHeader('Token Fees'));
+            for (const t of claimable.tokens) {
+                console.log(`  ${c.highlight(t.symbol)} ${c.dim('\u2500')} ${c.accent(t.formatted)} tokens`);
+            }
+        }
+        console.log();
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+// ============================================================================
+// Watch Command
+// ============================================================================
+program
+    .command('watch')
+    .description('Watch for new token deployments in real-time')
+    .option('--admin <address>', 'Filter by token admin address')
+    .option('--history <blocks>', 'Also show recent deployments from last N blocks', '100')
+    .option('--network <network>', 'Network: sepolia or mainnet', 'sepolia')
+    .option('--rpc <url>', 'Custom RPC URL')
+    .action(async (opts) => {
+    const network = getNetwork(opts);
+    const rpcUrl = getRpcUrl(network, opts);
+    const chain = getChain(network);
+    const publicClient = createPublicClient({
+        chain,
+        transport: http(rpcUrl),
+    });
+    const watcher = new ClawnchWatcher({
+        publicClient,
+        network,
+    });
+    const adminFilter = opts.admin ? validateAddress(opts.admin, 'admin') : undefined;
+    console.log();
+    console.log(`  ${c.highlight('Watching deployments')} ${networkBadge(network)}`);
+    if (adminFilter) {
+        console.log(kv('Filter', `admin = ${fmtAddr(adminFilter, true)}`));
+    }
+    console.log(c.muted('  Press Ctrl+C to stop'));
+    console.log();
+    // Show recent history first
+    if (opts.history && parseInt(opts.history) > 0) {
+        const blocks = BigInt(parseInt(opts.history));
+        try {
+            const currentBlock = await publicClient.getBlockNumber();
+            const fromBlock = currentBlock > blocks ? currentBlock - blocks : 0n;
+            const historical = await watcher.getHistoricalDeployments({
+                fromBlock,
+                tokenAdmin: adminFilter,
+            });
+            if (historical.length > 0) {
+                console.log(sectionHeader(`Recent (last ${opts.history} blocks)`));
+                for (const event of historical) {
+                    console.log(`  ${c.dim('block ' + event.blockNumber.toString())} ${c.highlight(event.tokenSymbol)} ${c.muted(event.tokenName)} ${fmtAddr(event.tokenAddress, true)}`);
+                }
+                console.log();
+            }
+        }
+        catch {
+            // History scan failed, continue with live watching
+        }
+    }
+    console.log(sectionHeader('Live'));
+    // Start live watching
+    const unwatch = watcher.watchDeployments((event) => {
+        const time = new Date().toLocaleTimeString();
+        console.log(`  ${c.dim(time)} ${c.success('\u2713')} ${c.highlight(event.tokenSymbol)} ${c.muted(event.tokenName)}`);
+        console.log(`    ${kv('Token', fmtAddr(event.tokenAddress))}`);
+        console.log(`    ${kv('Admin', fmtAddr(event.tokenAdmin, true))}`);
+        console.log(`    ${kv('Block', c.value(event.blockNumber.toString()))}`);
+        console.log();
+    }, { tokenAdmin: adminFilter });
+    // Keep process alive until Ctrl+C
+    process.on('SIGINT', () => {
+        unwatch();
+        console.log();
+        console.log(c.muted('  Stopped watching.'));
+        console.log();
+        process.exit(0);
+    });
+    // Keep the process alive
+    await new Promise(() => { });
+});
+// ============================================================================
+// Config Command
+// ============================================================================
+program
+    .command('config')
+    .description('Show or set CLI configuration')
+    .option('--show', 'Show current configuration')
+    .option('--network <network>', 'Set default network (sepolia or mainnet)')
+    .option('--private-key <key>', 'Set private key')
+    .option('--rpc-sepolia <url>', 'Set Sepolia RPC URL')
+    .option('--rpc-mainnet <url>', 'Set Mainnet RPC URL')
+    .option('--clear', 'Clear all configuration')
+    .action((opts) => {
+    const config = loadConfig();
+    if (opts.clear) {
+        saveConfig({});
+        console.log(`  ${c.success('\u2713')} Configuration cleared`);
+        return;
+    }
+    if (opts.network) {
+        if (opts.network !== 'sepolia' && opts.network !== 'mainnet') {
+            console.error(c.error('Invalid network. Use "sepolia" or "mainnet"'));
+            process.exit(1);
+        }
+        config.network = opts.network;
+    }
+    if (opts.privateKey) {
+        config.privateKey = opts.privateKey.startsWith('0x')
+            ? opts.privateKey
+            : `0x${opts.privateKey}`;
+    }
+    if (opts.rpcSepolia) {
+        config.rpc = config.rpc || {};
+        config.rpc.sepolia = opts.rpcSepolia;
+    }
+    if (opts.rpcMainnet) {
+        config.rpc = config.rpc || {};
+        config.rpc.mainnet = opts.rpcMainnet;
+    }
+    // If any option was set, save config
+    if (opts.network || opts.privateKey || opts.rpcSepolia || opts.rpcMainnet) {
+        saveConfig(config);
+        console.log(`  ${c.success('\u2713')} Configuration saved`);
+    }
+    // Show config (always, or if --show)
+    if (opts.show || (!opts.network && !opts.privateKey && !opts.rpcSepolia && !opts.rpcMainnet && !opts.clear)) {
+        console.log();
+        console.log(sectionHeader('Configuration'));
+        console.log(kv('Config file', c.muted(CONFIG_FILE)));
+        console.log(kv('Network', config.network ? networkBadge(config.network) : c.muted('sepolia (default)')));
+        console.log(kv('Private key', config.privateKey
+            ? `${dot('green')} ${c.muted('********' + config.privateKey.slice(-4))}`
+            : `${dot('red')} ${c.muted('Not set')}`));
+        console.log(kv('RPC Sepolia', config.rpc?.sepolia || c.muted('Default')));
+        console.log(kv('RPC Mainnet', config.rpc?.mainnet || c.muted('Default')));
+        console.log();
+        console.log(sectionHeader('Environment'));
+        const envSet = process.env.CLAWNCHER_PRIVATE_KEY;
+        console.log(kv('CLAWNCHER_PRIVATE_KEY', envSet ? `${dot('green')} Set` : `${dot('red')} Not set`));
+        console.log();
+    }
+});
+// ============================================================================
+// Tokens Command (API)
+// ============================================================================
+program
+    .command('tokens')
+    .description('List all tokens launched via Clawncher (API)')
+    .option('-s, --symbol <symbol>', 'Filter by symbol')
+    .option('-l, --limit <n>', 'Limit results', '20')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    const spinner = ora('Fetching tokens...').start();
+    try {
+        const client = getClient(program.opts());
+        const tokens = await client.getTokens();
+        spinner.stop();
+        let filtered = tokens;
+        if (opts.symbol) {
+            filtered = tokens.filter((t) => t.symbol.toLowerCase().includes(opts.symbol.toLowerCase()));
+        }
+        const limited = filtered.slice(0, safeParseInt(opts.limit, 'limit'));
+        if (opts.json) {
+            console.log(JSON.stringify(limited, null, 2));
+            return;
+        }
+        if (limited.length === 0) {
+            console.log(c.muted('\n  No tokens found\n'));
+            return;
+        }
+        console.log();
+        console.log(styledTable(['Symbol', 'Name', 'Address', 'Agent'], limited.map((token) => [
+            c.highlight(token.symbol),
+            c.value(token.name),
+            fmtAddr(token.address, true),
+            token.agent ? c.accent2(token.agent) : c.dim('-'),
+        ])));
+        console.log(c.dim(`  Showing ${limited.length} of ${filtered.length} tokens`));
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+// ============================================================================
+// Launches Command (API)
+// ============================================================================
+program
+    .command('launches')
+    .description('View launch history (API)')
+    .option('-a, --agent <name>', 'Filter by agent name')
+    .option('-s, --source <source>', 'Filter by source (moltbook, 4claw, moltx)')
+    .option('-l, --limit <n>', 'Limit results', '20')
+    .option('-o, --offset <n>', 'Offset for pagination', '0')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    const spinner = ora('Fetching launches...').start();
+    try {
+        const client = getClient(program.opts());
+        const response = await client.getLaunches({
+            agent: opts.agent,
+            source: opts.source,
+            limit: safeParseInt(opts.limit, 'limit'),
+            offset: safeParseInt(opts.offset, 'offset'),
+        });
+        spinner.stop();
+        if (opts.json) {
+            console.log(JSON.stringify(response, null, 2));
+            return;
+        }
+        if (response.launches.length === 0) {
+            console.log(c.muted('\n  No launches found\n'));
+            return;
+        }
+        console.log();
+        console.log(styledTable(['Symbol', 'Agent', 'Source', 'Address', 'Date'], response.launches.map((launch) => {
+            const agent = launch.agent || launch.agentName || '-';
+            const address = launch.address || launch.contractAddress || '';
+            const date = launch.created_at || launch.launchedAt || '';
+            return [
+                c.highlight(launch.symbol),
+                agent !== '-' ? c.accent2(agent) : c.dim('-'),
+                c.value(launch.source),
+                address ? fmtAddr(address, true) : c.dim('-'),
+                date ? c.muted(new Date(date).toLocaleDateString()) : c.dim('-'),
+            ];
+        })));
+        const total = response.total || response.pagination?.total || response.launches.length;
+        console.log(c.dim(`  Showing ${response.launches.length} of ${total} launches`));
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+// ============================================================================
+// Stats Command (API)
+// ============================================================================
+program
+    .command('stats')
+    .description('Get Clawnch market statistics (API)')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    const spinner = ora('Fetching stats...').start();
+    try {
+        const client = getClient(program.opts());
+        const stats = await client.getStats();
+        spinner.stop();
+        if (opts.json) {
+            console.log(JSON.stringify(stats, null, 2));
+            return;
+        }
+        console.log();
+        console.log(sectionHeader('Statistics'));
+        console.log(kv('Total Tokens', c.accent((stats.totalTokens || stats.total_tokens || 0).toLocaleString())));
+        console.log(kv('Total Volume', c.value(stats.totalVolume || stats.total_volume || '-')));
+        console.log(kv('$CLAWNCH Price', c.accent(stats.clawnchPrice || '-')));
+        console.log(kv('Market Cap', c.value(stats.clawnchMarketCap || '-')));
+        console.log();
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+// ============================================================================
+// Addresses Command
+// ============================================================================
+program
+    .command('addresses')
+    .description('Show contract addresses for a network')
+    .option('--network <network>', 'Network: sepolia or mainnet', 'sepolia')
+    .option('--json', 'Output as JSON')
+    .action((opts) => {
+    const network = getNetwork(opts);
+    const addresses = getAddresses(network);
+    if (opts.json) {
+        console.log(JSON.stringify(addresses, null, 2));
+        return;
+    }
+    console.log();
+    console.log(`  ${c.highlight('Clawnch Contracts')} ${networkBadge(network)}`);
+    console.log();
+    console.log(sectionHeader('Core'));
+    console.log(kv('Factory', fmtAddr(addresses.clawnch.factory), 18));
+    console.log(kv('Hook', fmtAddr(addresses.clawnch.hook), 18));
+    console.log(kv('Locker', fmtAddr(addresses.clawnch.locker), 18));
+    console.log(kv('FeeLocker', fmtAddr(addresses.clawnch.feeLocker), 18));
+    console.log(kv('MevModule', fmtAddr(addresses.clawnch.mevModule), 18));
+    console.log();
+    console.log(sectionHeader('Extensions'));
+    console.log(kv('Vault', fmtAddr(addresses.clawnch.vault), 18));
+    console.log(kv('AirdropV2', fmtAddr(addresses.clawnch.airdropV2), 18));
+    console.log(kv('DevBuy', fmtAddr(addresses.clawnch.devBuy), 18));
+    console.log();
+    console.log(sectionHeader('Infrastructure'));
+    console.log(kv('PoolManager', fmtAddr(addresses.infrastructure.poolManager), 18));
+    console.log(kv('PositionManager', fmtAddr(addresses.infrastructure.positionManager), 18));
+    console.log(kv('UniversalRouter', fmtAddr(addresses.infrastructure.universalRouter), 18));
+    console.log(kv('WETH', fmtAddr(addresses.infrastructure.weth), 18));
+    console.log(kv('Permit2', fmtAddr(addresses.infrastructure.permit2), 18));
+    console.log();
+});
+// ============================================================================
+// Help/Info Command
+// ============================================================================
+program
+    .command('about')
+    .description('Show Clawncher information and links')
+    .action(() => {
+    const banner = [
+        '   ██████╗██╗       █████╗ ██╗    ██╗███╗   ██╗  ██████╗██╗  ██╗███████╗██████╗ ',
+        '  ██╔════╝██║      ██╔══██╗██║    ██║████╗  ██║ ██╔════╝██║  ██║██╔════╝██╔══██╗',
+        '  ██║     ██║      ███████║██║ █╗ ██║██╔██╗ ██║ ██║     ███████║█████╗  ██████╔╝',
+        '  ██║     ██║      ██╔══██║██║███╗██║██║╚██╗██║ ██║     ██╔══██║██╔══╝  ██╔══██╗',
+        '  ╚██████╗███████╗ ██║  ██║╚███╔███╔╝██║ ╚████║ ╚██████╗██║  ██║███████╗██║  ██║',
+        '   ╚═════╝╚══════╝ ╚═╝  ╚═╝ ╚══╝╚══╝ ╚═╝  ╚═══╝  ╚═════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝',
+    ];
+    console.log();
+    console.log(bannerGradient(banner));
+    console.log();
+    console.log(c.muted('  Token launch toolkit for Base, optimized for agents.'));
+    console.log(c.dim('  1% LP fee (80% deployer, 20% protocol) \u00B7 MEV protection \u00B7 Instant tradability'));
+    console.log();
+    console.log(sectionHeader('Links'));
+    console.log(kv('Website', c.link('https://clawn.ch/er')));
+    console.log(kv('Agent Skill', c.link('https://clawn.ch/er/skill')));
+    console.log(kv('Tech Docs', c.link('https://clawn.ch/er/docs')));
+    console.log();
+    console.log(sectionHeader('Install'));
+    console.log(kv('SDK', c.value('npm install @clawnch/clawncher-sdk')));
+    console.log(kv('CLI', c.value('npm install -g clawncher')));
+    console.log();
+    console.log(sectionHeader('Quick Start'));
+    console.log(c.dim('  $ ') + c.accent('clawncher') + c.value(' config --private-key <key>'));
+    console.log(c.dim('  $ ') + c.accent('clawncher') + c.value(' deploy --name "My Token" --symbol MYTKN'));
+    console.log(c.dim('  $ ') + c.accent('clawncher') + c.value(' info <token-address> --network mainnet'));
+    console.log();
+    console.log(c.dim(`  v${VERSION}`));
+    console.log();
+});
+// ============================================================================
+// Swap Commands
+// ============================================================================
+const swap = program.command('swap').description('Token swaps via 0x aggregation');
+swap
+    .command('price')
+    .description('Get an indicative swap price (no execution)')
+    .requiredOption('--sell-token <address>', 'Token to sell (address or "ETH")')
+    .requiredOption('--buy-token <address>', 'Token to buy (address or "ETH")')
+    .requiredOption('--amount <amount>', 'Amount to sell (in human-readable units, e.g. "0.01")')
+    .option('--slippage <bps>', 'Slippage tolerance in basis points (default: 100 = 1%)', '100')
+    .option('--network <network>', 'Network: sepolia or mainnet', 'sepolia')
+    .option('--rpc <url>', 'Custom RPC URL')
+    .option('--private-key <key>', 'Private key (or use CLAWNCHER_PRIVATE_KEY env)')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    const spinner = ora('Fetching price...').start();
+    try {
+        const privateKey = await getPrivateKeyOrWallet(opts);
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const { wallet, publicClient } = createClients(network, privateKey, rpcUrl);
+        const swapper = new ClawnchSwapper({
+            wallet,
+            publicClient,
+            network,
+            apiBaseUrl: getClawnchApiUrl(),
+        });
+        // Resolve token addresses
+        const sellToken = opts.sellToken.toLowerCase() === 'eth'
+            ? NATIVE_TOKEN_ADDRESS
+            : validateAddress(opts.sellToken, 'sell token');
+        const buyToken = opts.buyToken.toLowerCase() === 'eth'
+            ? NATIVE_TOKEN_ADDRESS
+            : validateAddress(opts.buyToken, 'buy token');
+        // Parse amount - get decimals for the sell token
+        const sellDecimals = await swapper.getDecimals(sellToken);
+        const { parseUnits } = await import('viem');
+        const sellAmount = parseUnits(opts.amount, sellDecimals);
+        spinner.text = 'Querying best price...';
+        const price = await swapper.getPrice({
+            sellToken,
+            buyToken,
+            sellAmount,
+            slippageBps: safeParseInt(opts.slippage, 'slippage'),
+        });
+        // Get symbols for display
+        const [sellSymbol, buySymbol, buyDecimals] = await Promise.all([
+            swapper.getSymbol(sellToken),
+            swapper.getSymbol(buyToken),
+            swapper.getDecimals(buyToken),
+        ]);
+        spinner.stop();
+        const { formatUnits: fmtUnits } = await import('viem');
+        if (opts.json) {
+            console.log(JSON.stringify({
+                sellToken: opts.sellToken,
+                buyToken: opts.buyToken,
+                sellAmount: sellAmount.toString(),
+                buyAmount: price.buyAmount.toString(),
+                minBuyAmount: price.minBuyAmount.toString(),
+                sellSymbol,
+                buySymbol,
+                sellFormatted: opts.amount,
+                buyFormatted: fmtUnits(price.buyAmount, buyDecimals),
+                minBuyFormatted: fmtUnits(price.minBuyAmount, buyDecimals),
+                gasEstimate: price.gas.toString(),
+                liquidityAvailable: price.liquidityAvailable,
+                route: price.route,
+            }, null, 2));
+            return;
+        }
+        console.log();
+        console.log(`  ${c.highlight('Swap Price')}`);
+        console.log();
+        console.log(sectionHeader('Quote'));
+        console.log(kv('Sell', `${c.accent(opts.amount)} ${c.value(sellSymbol)}`));
+        console.log(kv('Buy', `${c.accent(fmtUnits(price.buyAmount, buyDecimals))} ${c.value(buySymbol)}`));
+        console.log(kv('Min Receive', `${c.muted(fmtUnits(price.minBuyAmount, buyDecimals))} ${c.muted(buySymbol)}`));
+        console.log(kv('Liquidity', price.liquidityAvailable ? `${dot('green')} Available` : `${dot('red')} Insufficient`));
+        console.log(kv('Gas Estimate', c.value(price.gas.toLocaleString())));
+        console.log(kv('Network', networkBadge(network)));
+        if (price.route.fills.length > 0) {
+            console.log();
+            console.log(sectionHeader('Route'));
+            for (const fill of price.route.fills) {
+                const pct = (parseInt(fill.proportionBps) / 100).toFixed(1);
+                console.log(`  ${c.accent(pct + '%')} ${c.dim('\u2500')} ${c.value(fill.source)}`);
+            }
+        }
+        console.log();
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+swap
+    .command('exec')
+    .description('Execute a token swap')
+    .requiredOption('--sell-token <address>', 'Token to sell (address or "ETH")')
+    .requiredOption('--buy-token <address>', 'Token to buy (address or "ETH")')
+    .requiredOption('--amount <amount>', 'Amount to sell (in human-readable units, e.g. "0.01")')
+    .option('--slippage <bps>', 'Slippage tolerance in basis points (default: 100 = 1%)', '100')
+    .option('--network <network>', 'Network: sepolia or mainnet', 'sepolia')
+    .option('--rpc <url>', 'Custom RPC URL')
+    .option('--private-key <key>', 'Private key (or use CLAWNCHER_PRIVATE_KEY env)')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    const spinner = ora('Preparing swap...').start();
+    try {
+        const privateKey = await getPrivateKeyOrWallet(opts);
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const { wallet, publicClient, account } = createClients(network, privateKey, rpcUrl);
+        const swapper = new ClawnchSwapper({
+            wallet,
+            publicClient,
+            network,
+            apiBaseUrl: getClawnchApiUrl(),
+        });
+        const sellToken = opts.sellToken.toLowerCase() === 'eth'
+            ? NATIVE_TOKEN_ADDRESS
+            : validateAddress(opts.sellToken, 'sell token');
+        const buyToken = opts.buyToken.toLowerCase() === 'eth'
+            ? NATIVE_TOKEN_ADDRESS
+            : validateAddress(opts.buyToken, 'buy token');
+        const sellDecimals = await swapper.getDecimals(sellToken);
+        const { parseUnits } = await import('viem');
+        const sellAmount = parseUnits(opts.amount, sellDecimals);
+        const [sellSymbol, buySymbol, buyDecimals] = await Promise.all([
+            swapper.getSymbol(sellToken),
+            swapper.getSymbol(buyToken),
+            swapper.getDecimals(buyToken),
+        ]);
+        spinner.text = `Swapping ${opts.amount} ${sellSymbol} for ${buySymbol}...`;
+        const result = await swapper.swap({
+            sellToken,
+            buyToken,
+            sellAmount,
+            slippageBps: safeParseInt(opts.slippage, 'slippage'),
+        });
+        spinner.stop();
+        const { formatUnits: fmtUnits } = await import('viem');
+        if (opts.json) {
+            console.log(JSON.stringify({
+                success: true,
+                txHash: result.txHash,
+                sellToken: opts.sellToken,
+                buyToken: opts.buyToken,
+                sellAmount: result.sellAmount.toString(),
+                buyAmount: result.buyAmount.toString(),
+                sellFormatted: fmtUnits(result.sellAmount, sellDecimals),
+                buyFormatted: fmtUnits(result.buyAmount, buyDecimals),
+                sellSymbol,
+                buySymbol,
+                gasUsed: result.gasUsed.toString(),
+                network,
+            }, null, 2));
+            return;
+        }
+        console.log();
+        console.log(`  ${c.success('\u2713')} ${c.highlight('Swap executed')}`);
+        console.log();
+        console.log(sectionHeader('Result'));
+        console.log(kv('Sold', `${c.value(fmtUnits(result.sellAmount, sellDecimals))} ${c.muted(sellSymbol)}`));
+        console.log(kv('Received', `${c.accent(fmtUnits(result.buyAmount, buyDecimals))} ${c.value(buySymbol)}`));
+        console.log(kv('Transaction', c.muted(result.txHash)));
+        console.log(kv('Gas Used', c.value(result.gasUsed.toLocaleString())));
+        console.log(kv('Wallet', fmtAddr(account.address)));
+        console.log(kv('Network', networkBadge(network)));
+        const explorerUrl = network === 'mainnet'
+            ? `https://basescan.org/tx/${result.txHash}`
+            : `https://sepolia.basescan.org/tx/${result.txHash}`;
+        console.log();
+        console.log(`  ${c.link(explorerUrl)}`);
+        console.log();
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+// ============================================================================
+// Liquidity Commands
+// ============================================================================
+const liquidity = program.command('liquidity').description('Uniswap V3/V4 liquidity management');
+liquidity
+    .command('positions')
+    .description('List V3 liquidity positions for a wallet')
+    .argument('[wallet]', 'Wallet address (defaults to configured wallet)')
+    .option('--token <address>', 'Filter by token address')
+    .option('--network <network>', 'Network: sepolia or mainnet', 'sepolia')
+    .option('--rpc <url>', 'Custom RPC URL')
+    .option('--private-key <key>', 'Private key (or use CLAWNCHER_PRIVATE_KEY env)')
+    .option('--json', 'Output as JSON')
+    .action(async (walletArg, opts) => {
+    const spinner = ora('Fetching positions...').start();
+    try {
+        const privateKey = await getPrivateKeyOrWallet(opts);
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const { wallet, publicClient, account } = createClients(network, privateKey, rpcUrl);
+        const liq = new ClawnchLiquidity({
+            wallet,
+            publicClient,
+            network,
+        });
+        const walletAddr = walletArg
+            ? validateAddress(walletArg, 'wallet')
+            : account.address;
+        let positions;
+        if (opts.token) {
+            const tokenAddr = validateAddress(opts.token, 'token');
+            spinner.text = `Finding positions for token ${fmtAddr(tokenAddr, true)}...`;
+            positions = await liq.getPositionsForToken(tokenAddr, walletAddr);
+        }
+        else {
+            positions = await liq.v3GetPositionsForWallet(walletAddr);
+        }
+        spinner.stop();
+        if (opts.json) {
+            console.log(JSON.stringify(positions.map(p => ({
+                tokenId: p.tokenId.toString(),
+                version: p.version,
+                token0: p.token0,
+                token1: p.token1,
+                fee: p.fee,
+                tickLower: p.tickLower,
+                tickUpper: p.tickUpper,
+                liquidity: p.liquidity.toString(),
+                unclaimedFees: {
+                    token0: p.unclaimedFees.token0.toString(),
+                    token1: p.unclaimedFees.token1.toString(),
+                },
+            })), null, 2));
+            return;
+        }
+        console.log();
+        console.log(`  ${c.highlight('Liquidity Positions')} ${c.muted('for')} ${fmtAddr(walletAddr, true)}`);
+        console.log(kv('Network', networkBadge(network)));
+        console.log();
+        if (positions.length === 0) {
+            console.log(c.muted('  No V3 positions found'));
+            console.log();
+            return;
+        }
+        for (const pos of positions) {
+            const feeTier = (pos.fee / 10000).toFixed(2) + '%';
+            const hasLiq = pos.liquidity > 0n;
+            const hasFees = pos.unclaimedFees.token0 > 0n || pos.unclaimedFees.token1 > 0n;
+            console.log(`  ${hasLiq ? dot('green') : dot('red')} ${c.accent('#' + pos.tokenId.toString())} ${c.muted(pos.version.toUpperCase())} ${c.dim('fee=' + feeTier)}`);
+            console.log(`    ${c.label('Pair')}      ${fmtAddr(pos.token0, true)} ${c.dim('/')} ${fmtAddr(pos.token1, true)}`);
+            console.log(`    ${c.label('Range')}     ${c.value(pos.tickLower.toString())} ${c.dim('\u2192')} ${c.value(pos.tickUpper.toString())}`);
+            console.log(`    ${c.label('Liquidity')} ${hasLiq ? c.accent(pos.liquidity.toString()) : c.muted('0')}`);
+            if (hasFees) {
+                console.log(`    ${c.label('Fees')}      ${c.success(pos.unclaimedFees.token0.toString())} ${c.dim('/')} ${c.success(pos.unclaimedFees.token1.toString())}`);
+            }
+            console.log();
+        }
+        console.log(c.dim(`  ${positions.length} position${positions.length !== 1 ? 's' : ''} found`));
+        console.log();
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+liquidity
+    .command('mint')
+    .description('Create a new V3 liquidity position')
+    .requiredOption('--token0 <address>', 'Token 0 address (lower address)')
+    .requiredOption('--token1 <address>', 'Token 1 address (higher address)')
+    .requiredOption('--fee <tier>', 'Fee tier: 500 (0.05%), 3000 (0.3%), or 10000 (1%)')
+    .requiredOption('--tick-lower <tick>', 'Lower tick boundary')
+    .requiredOption('--tick-upper <tick>', 'Upper tick boundary')
+    .requiredOption('--amount0 <amount>', 'Amount of token0 (human-readable)')
+    .requiredOption('--amount1 <amount>', 'Amount of token1 (human-readable)')
+    .option('--network <network>', 'Network: sepolia or mainnet', 'sepolia')
+    .option('--rpc <url>', 'Custom RPC URL')
+    .option('--private-key <key>', 'Private key (or use CLAWNCHER_PRIVATE_KEY env)')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    const spinner = ora('Preparing to mint position...').start();
+    try {
+        const privateKey = await getPrivateKeyOrWallet(opts);
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const { wallet, publicClient, account } = createClients(network, privateKey, rpcUrl);
+        const liq = new ClawnchLiquidity({
+            wallet,
+            publicClient,
+            network,
+        });
+        const token0 = validateAddress(opts.token0, 'token0');
+        const token1 = validateAddress(opts.token1, 'token1');
+        const fee = safeParseInt(opts.fee, 'fee');
+        const tickLower = safeParseInt(opts.tickLower, 'tick-lower');
+        const tickUpper = safeParseInt(opts.tickUpper, 'tick-upper');
+        // Get decimals for parsing amounts
+        const { parseUnits } = await import('viem');
+        const [dec0, dec1] = await Promise.all([
+            readDecimals(publicClient, token0),
+            readDecimals(publicClient, token1),
+        ]);
+        const amount0Desired = parseUnits(opts.amount0, dec0);
+        const amount1Desired = parseUnits(opts.amount1, dec1);
+        spinner.text = 'Minting V3 position...';
+        const result = await liq.v3MintPosition({
+            token0,
+            token1,
+            fee,
+            tickLower,
+            tickUpper,
+            amount0Desired,
+            amount1Desired,
+        });
+        spinner.stop();
+        const { formatUnits: fmtUnits } = await import('viem');
+        if (opts.json) {
+            console.log(JSON.stringify({
+                success: true,
+                txHash: result.txHash,
+                tokenId: result.tokenId.toString(),
+                amount0: result.amount0.toString(),
+                amount1: result.amount1.toString(),
+                liquidity: result.liquidity.toString(),
+                network,
+            }, null, 2));
+            return;
+        }
+        console.log();
+        console.log(`  ${c.success('\u2713')} ${c.highlight('V3 position minted')}`);
+        console.log();
+        console.log(sectionHeader('Position'));
+        console.log(kv('Token ID', c.accent('#' + result.tokenId.toString())));
+        console.log(kv('Pair', `${fmtAddr(token0, true)} ${c.dim('/')} ${fmtAddr(token1, true)}`));
+        console.log(kv('Fee Tier', c.value((fee / 10000).toFixed(2) + '%')));
+        console.log(kv('Range', `${c.value(tickLower.toString())} ${c.dim('\u2192')} ${c.value(tickUpper.toString())}`));
+        console.log(kv('Deposited', `${c.accent(fmtUnits(result.amount0, dec0))} + ${c.accent(fmtUnits(result.amount1, dec1))}`));
+        console.log(kv('Liquidity', c.value(result.liquidity.toString())));
+        console.log(kv('Transaction', c.muted(result.txHash)));
+        console.log(kv('Network', networkBadge(network)));
+        const explorerUrl = network === 'mainnet'
+            ? `https://basescan.org/tx/${result.txHash}`
+            : `https://sepolia.basescan.org/tx/${result.txHash}`;
+        console.log();
+        console.log(`  ${c.link(explorerUrl)}`);
+        console.log();
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+liquidity
+    .command('add')
+    .description('Add liquidity to an existing V3 position')
+    .requiredOption('--id <tokenId>', 'Position NFT token ID')
+    .requiredOption('--amount0 <amount>', 'Amount of token0 (human-readable)')
+    .requiredOption('--amount1 <amount>', 'Amount of token1 (human-readable)')
+    .option('--network <network>', 'Network: sepolia or mainnet', 'sepolia')
+    .option('--rpc <url>', 'Custom RPC URL')
+    .option('--private-key <key>', 'Private key (or use CLAWNCHER_PRIVATE_KEY env)')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    const spinner = ora('Adding liquidity...').start();
+    try {
+        const privateKey = await getPrivateKeyOrWallet(opts);
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const { wallet, publicClient } = createClients(network, privateKey, rpcUrl);
+        const liq = new ClawnchLiquidity({
+            wallet,
+            publicClient,
+            network,
+        });
+        const tokenId = BigInt(opts.id);
+        // Get position to know tokens and decimals
+        spinner.text = 'Reading position...';
+        const position = await liq.v3GetPosition(tokenId);
+        const { parseUnits, formatUnits: fmtUnits } = await import('viem');
+        const [dec0, dec1] = await Promise.all([
+            readDecimals(publicClient, position.token0),
+            readDecimals(publicClient, position.token1),
+        ]);
+        const amount0Desired = parseUnits(opts.amount0, dec0);
+        const amount1Desired = parseUnits(opts.amount1, dec1);
+        spinner.text = `Adding liquidity to position #${opts.id}...`;
+        const result = await liq.v3AddLiquidity(tokenId, {
+            amount0Desired,
+            amount1Desired,
+        });
+        spinner.stop();
+        if (opts.json) {
+            console.log(JSON.stringify({
+                success: true,
+                txHash: result.txHash,
+                tokenId: opts.id,
+                amount0: result.amount0.toString(),
+                amount1: result.amount1.toString(),
+                network,
+            }, null, 2));
+            return;
+        }
+        console.log();
+        console.log(`  ${c.success('\u2713')} ${c.highlight('Liquidity added')}`);
+        console.log();
+        console.log(sectionHeader('Result'));
+        console.log(kv('Position', c.accent('#' + opts.id)));
+        console.log(kv('Deposited', `${c.accent(fmtUnits(result.amount0, dec0))} + ${c.accent(fmtUnits(result.amount1, dec1))}`));
+        console.log(kv('Transaction', c.muted(result.txHash)));
+        console.log(kv('Network', networkBadge(network)));
+        const explorerUrl = network === 'mainnet'
+            ? `https://basescan.org/tx/${result.txHash}`
+            : `https://sepolia.basescan.org/tx/${result.txHash}`;
+        console.log();
+        console.log(`  ${c.link(explorerUrl)}`);
+        console.log();
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+liquidity
+    .command('remove')
+    .description('Remove liquidity from a V3 position')
+    .requiredOption('--id <tokenId>', 'Position NFT token ID')
+    .option('--percent <pct>', 'Percentage to remove (1-100, default: 100)', '100')
+    .option('--burn', 'Burn the position NFT after full removal')
+    .option('--network <network>', 'Network: sepolia or mainnet', 'sepolia')
+    .option('--rpc <url>', 'Custom RPC URL')
+    .option('--private-key <key>', 'Private key (or use CLAWNCHER_PRIVATE_KEY env)')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    const spinner = ora('Removing liquidity...').start();
+    try {
+        const privateKey = await getPrivateKeyOrWallet(opts);
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const { wallet, publicClient } = createClients(network, privateKey, rpcUrl);
+        const liq = new ClawnchLiquidity({
+            wallet,
+            publicClient,
+            network,
+        });
+        const tokenId = BigInt(opts.id);
+        const percent = safeParseInt(opts.percent, 'percent');
+        if (percent < 1 || percent > 100) {
+            spinner.stop();
+            console.error(c.error('Percent must be between 1 and 100'));
+            process.exit(1);
+        }
+        // Get position to know tokens
+        spinner.text = 'Reading position...';
+        const position = await liq.v3GetPosition(tokenId);
+        const { formatUnits: fmtUnits } = await import('viem');
+        const [dec0, dec1] = await Promise.all([
+            readDecimals(publicClient, position.token0),
+            readDecimals(publicClient, position.token1),
+        ]);
+        spinner.text = `Removing ${percent}% liquidity from position #${opts.id}...`;
+        const result = await liq.v3RemoveLiquidity(tokenId, {
+            percentageToRemove: percent / 100,
+            burnToken: opts.burn,
+        });
+        spinner.stop();
+        if (opts.json) {
+            console.log(JSON.stringify({
+                success: true,
+                txHash: result.txHash,
+                tokenId: opts.id,
+                percentRemoved: percent,
+                amount0: result.amount0.toString(),
+                amount1: result.amount1.toString(),
+                burned: opts.burn && percent === 100,
+                network,
+            }, null, 2));
+            return;
+        }
+        console.log();
+        console.log(`  ${c.success('\u2713')} ${c.highlight('Liquidity removed')}`);
+        console.log();
+        console.log(sectionHeader('Result'));
+        console.log(kv('Position', c.accent('#' + opts.id)));
+        console.log(kv('Removed', c.value(percent + '%')));
+        console.log(kv('Received', `${c.accent(fmtUnits(result.amount0, dec0))} + ${c.accent(fmtUnits(result.amount1, dec1))}`));
+        if (opts.burn && percent === 100) {
+            console.log(kv('NFT', `${dot('red')} Burned`));
+        }
+        console.log(kv('Transaction', c.muted(result.txHash)));
+        console.log(kv('Network', networkBadge(network)));
+        const explorerUrl = network === 'mainnet'
+            ? `https://basescan.org/tx/${result.txHash}`
+            : `https://sepolia.basescan.org/tx/${result.txHash}`;
+        console.log();
+        console.log(`  ${c.link(explorerUrl)}`);
+        console.log();
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+liquidity
+    .command('fees')
+    .description('View or collect unclaimed fees from a V3 position')
+    .requiredOption('--id <tokenId>', 'Position NFT token ID')
+    .option('--collect', 'Collect the fees (otherwise just shows them)')
+    .option('--network <network>', 'Network: sepolia or mainnet', 'sepolia')
+    .option('--rpc <url>', 'Custom RPC URL')
+    .option('--private-key <key>', 'Private key (or use CLAWNCHER_PRIVATE_KEY env)')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    const spinner = ora('Checking position fees...').start();
+    try {
+        const privateKey = await getPrivateKeyOrWallet(opts);
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const { wallet, publicClient } = createClients(network, privateKey, rpcUrl);
+        const liq = new ClawnchLiquidity({
+            wallet,
+            publicClient,
+            network,
+        });
+        const tokenId = BigInt(opts.id);
+        const position = await liq.v3GetPosition(tokenId);
+        const { formatUnits: fmtUnits } = await import('viem');
+        const [dec0, dec1, sym0, sym1] = await Promise.all([
+            readDecimals(publicClient, position.token0),
+            readDecimals(publicClient, position.token1),
+            readSymbol(publicClient, position.token0),
+            readSymbol(publicClient, position.token1),
+        ]);
+        if (opts.collect) {
+            spinner.text = `Collecting fees from position #${opts.id}...`;
+            const result = await liq.v3CollectFees(tokenId);
+            spinner.stop();
+            if (opts.json) {
+                console.log(JSON.stringify({
+                    success: true,
+                    txHash: result.txHash,
+                    tokenId: opts.id,
+                    amount0: result.amount0.toString(),
+                    amount1: result.amount1.toString(),
+                    symbol0: sym0,
+                    symbol1: sym1,
+                    formatted0: fmtUnits(result.amount0, dec0),
+                    formatted1: fmtUnits(result.amount1, dec1),
+                    network,
+                }, null, 2));
+                return;
+            }
+            console.log();
+            console.log(`  ${c.success('\u2713')} ${c.highlight('Fees collected')}`);
+            console.log();
+            console.log(sectionHeader('Result'));
+            console.log(kv('Position', c.accent('#' + opts.id)));
+            console.log(kv(sym0, c.accent(fmtUnits(result.amount0, dec0))));
+            console.log(kv(sym1, c.accent(fmtUnits(result.amount1, dec1))));
+            console.log(kv('Transaction', c.muted(result.txHash)));
+            console.log(kv('Network', networkBadge(network)));
+            const explorerUrl = network === 'mainnet'
+                ? `https://basescan.org/tx/${result.txHash}`
+                : `https://sepolia.basescan.org/tx/${result.txHash}`;
+            console.log();
+            console.log(`  ${c.link(explorerUrl)}`);
+            console.log();
+        }
+        else {
+            spinner.stop();
+            const hasFees = position.unclaimedFees.token0 > 0n || position.unclaimedFees.token1 > 0n;
+            if (opts.json) {
+                console.log(JSON.stringify({
+                    tokenId: opts.id,
+                    token0: { address: position.token0, symbol: sym0, fees: position.unclaimedFees.token0.toString(), formatted: fmtUnits(position.unclaimedFees.token0, dec0) },
+                    token1: { address: position.token1, symbol: sym1, fees: position.unclaimedFees.token1.toString(), formatted: fmtUnits(position.unclaimedFees.token1, dec1) },
+                    hasFees,
+                    network,
+                }, null, 2));
+                return;
+            }
+            console.log();
+            console.log(`  ${c.highlight('Position Fees')} ${c.accent('#' + opts.id)}`);
+            console.log();
+            console.log(sectionHeader('Unclaimed'));
+            console.log(kv(sym0, hasFees ? c.accent(fmtUnits(position.unclaimedFees.token0, dec0)) : c.muted('0')));
+            console.log(kv(sym1, hasFees ? c.accent(fmtUnits(position.unclaimedFees.token1, dec1)) : c.muted('0')));
+            console.log(kv('Network', networkBadge(network)));
+            console.log();
+            if (hasFees) {
+                console.log(c.muted('  Run with --collect to claim these fees'));
+                console.log();
+            }
+        }
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+// ============================================================================
+// Agent Commands (Verified Launches)
+// ============================================================================
+const agent = program.command('agent').description('Verified agent registration and management');
+agent
+    .command('register')
+    .description('Register as a verified agent on Clawnch')
+    .requiredOption('--name <name>', 'Agent display name')
+    .requiredOption('--description <desc>', 'Short description of your agent')
+    .option('--network <network>', 'Network (mainnet/sepolia)', 'mainnet')
+    .option('--private-key <key>', 'Private key')
+    .option('--rpc <url>', 'RPC URL')
+    .option('--api-url <url>', 'Clawnch API URL')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    const spinner = ora('Registering agent...').start();
+    try {
+        const privateKey = await getPrivateKeyOrWallet(opts);
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const { wallet, publicClient, account } = createClients(network, privateKey, rpcUrl);
+        spinner.text = 'Submitting registration...';
+        const result = await ClawnchApiDeployer.register({
+            wallet,
+            publicClient,
+            apiBaseUrl: opts.apiUrl || getClawnchApiUrl(),
+        }, {
+            name: opts.name,
+            wallet: account.address,
+            description: opts.description,
+        });
+        spinner.succeed('Agent registered and verified');
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log();
+            console.log(kv('Agent ID', c.value(result.agentId)));
+            console.log(kv('Wallet', c.value(result.wallet)));
+            console.log(kv('API Key', c.accent(result.apiKey)));
+            console.log();
+            console.log(c.warn('  Save your API key — it will not be shown again.'));
+            console.log(c.muted('  Next steps:'));
+            console.log(c.muted('    1. Run: clawncher agent approve --api-key <key>'));
+            console.log(c.muted('    2. Deploy: clawncher deploy --verified --api-key <key>'));
+            console.log();
+        }
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+agent
+    .command('approve')
+    .description('Approve $CLAWNCH spend for verified launches (one-time)')
+    .requiredOption('--api-key <key>', 'Agent API key')
+    .option('--network <network>', 'Network (mainnet/sepolia)', 'mainnet')
+    .option('--private-key <key>', 'Private key')
+    .option('--rpc <url>', 'RPC URL')
+    .option('--api-url <url>', 'Clawnch API URL')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    const spinner = ora('Approving $CLAWNCH spend...').start();
+    try {
+        const privateKey = await getPrivateKeyOrWallet(opts);
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const { wallet, publicClient } = createClients(network, privateKey, rpcUrl);
+        const deployer = new ClawnchApiDeployer({
+            apiKey: opts.apiKey,
+            wallet,
+            publicClient,
+            network,
+            apiBaseUrl: opts.apiUrl || getClawnchApiUrl(),
+        });
+        spinner.text = 'Sending approval transaction...';
+        const result = await deployer.approveClawnch();
+        spinner.succeed('$CLAWNCH spend approved');
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log();
+            console.log(kv('Tx Hash', c.value(result.txHash)));
+            console.log(kv('Spender', c.value(result.spender)));
+            console.log(kv('Allowance', c.accent('unlimited')));
+            console.log();
+            console.log(c.muted('  You can now deploy verified tokens with: clawncher deploy --verified'));
+            console.log();
+        }
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+agent
+    .command('status')
+    .description('Show verified agent status, balance, and launch count')
+    .requiredOption('--api-key <key>', 'Agent API key')
+    .option('--api-url <url>', 'Clawnch API URL')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    const spinner = ora('Fetching agent status...').start();
+    try {
+        // For status we only need the API key, no wallet needed
+        // But ClawnchApiDeployer requires wallet/publicClient, so we use a direct fetch
+        const baseUrl = (opts.apiUrl || getClawnchApiUrl()).replace(/\/$/, '');
+        const response = await fetch(`${baseUrl}/api/agents/me`, {
+            method: 'GET',
+            headers: {
+                'Accept': 'application/json',
+                'Authorization': `Bearer ${opts.apiKey}`,
+            },
+        });
+        if (!response.ok) {
+            const err = await response.json().catch(() => ({ error: 'Request failed' }));
+            throw new Error(err.error || `HTTP ${response.status}`);
+        }
+        const status = await response.json();
+        spinner.succeed('Agent status retrieved');
+        if (opts.json) {
+            console.log(JSON.stringify(status, null, 2));
+        }
+        else {
+            console.log();
+            console.log(kv('Agent', c.accent(status.name)));
+            console.log(kv('ID', c.value(status.agentId)));
+            console.log(kv('Wallet', c.value(status.wallet)));
+            console.log(kv('Verified', status.verified ? `${dot('green')} Yes` : `${dot('red')} No`));
+            console.log(kv('$CLAWNCH Balance', c.value(status.clawnchBalance)));
+            console.log(kv('$CLAWNCH Allowance', c.value(status.clawnchAllowance)));
+            console.log(kv('Launches', c.value(status.launchCount.toString())));
+            console.log(kv('Registered', c.muted(status.registeredAt)));
+            console.log();
+        }
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+// ============================================================================
+// Verified Deploy (--verified flag on deploy command)
+// ============================================================================
+program
+    .command('deploy-verified')
+    .description('Deploy a token via Clawnch API (verified, gets @clawnch badge)')
+    .requiredOption('--name <name>', 'Token name')
+    .requiredOption('--symbol <symbol>', 'Token symbol (ticker)')
+    .requiredOption('--api-key <key>', 'Agent API key')
+    .option('--image <url>', 'Token image URL')
+    .option('--description <desc>', 'Token description')
+    .option('--recipient <address>', 'Fee recipient address')
+    .option('--fee-preference <pref>', 'Fee preference: Clawnch, Paired, Both', 'Clawnch')
+    .option('--vault-percent <n>', 'Vault allocation percentage (1-90)')
+    .option('--vault-lockup <days>', 'Vault lockup in days')
+    .option('--vault-recipient <address>', 'Vault recipient')
+    .option('--dev-buy <eth>', 'ETH amount for dev buy')
+    .option('--dev-buy-recipient <address>', 'Dev buy recipient')
+    .option('--no-vanity', 'Disable vanity address')
+    .option('--network <network>', 'Network (mainnet/sepolia)', 'mainnet')
+    .option('--private-key <key>', 'Private key')
+    .option('--rpc <url>', 'RPC URL')
+    .option('--api-url <url>', 'Clawnch API URL')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    const spinner = ora('Preparing verified deployment...').start();
+    try {
+        const privateKey = await getPrivateKeyOrWallet(opts);
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const { wallet, publicClient, account } = createClients(network, privateKey, rpcUrl);
+        const deployer = new ClawnchApiDeployer({
+            apiKey: opts.apiKey,
+            wallet,
+            publicClient,
+            network,
+            apiBaseUrl: opts.apiUrl || getClawnchApiUrl(),
+        });
+        // Build deploy request
+        const request = {
+            name: opts.name,
+            symbol: opts.symbol,
+        };
+        if (opts.image)
+            request.image = opts.image;
+        if (opts.description)
+            request.description = opts.description;
+        if (opts.vanity === false)
+            request.vanity = false;
+        // Rewards
+        if (opts.recipient) {
+            request.rewards = {
+                recipients: [{
+                        recipient: validateAddress(opts.recipient, 'recipient'),
+                        admin: account.address,
+                        bps: 10000,
+                        feePreference: opts.feePreference || 'Clawnch',
+                    }],
+            };
+        }
+        // Vault
+        if (opts.vaultPercent) {
+            const days = parseInt(opts.vaultLockup || '7', 10);
+            request.vault = {
+                percentage: parseInt(opts.vaultPercent, 10),
+                lockupDuration: days * 86400,
+                recipient: opts.vaultRecipient ? validateAddress(opts.vaultRecipient, 'vault recipient') : account.address,
+            };
+        }
+        // Dev buy
+        if (opts.devBuy) {
+            const { parseEther } = await import('viem');
+            request.devBuy = {
+                ethAmount: parseEther(opts.devBuy).toString(),
+                recipient: opts.devBuyRecipient ? validateAddress(opts.devBuyRecipient, 'dev buy recipient') : account.address,
+            };
+        }
+        spinner.text = 'Solving captcha challenge...';
+        const result = await deployer.deploy(request);
+        spinner.succeed('Token deployed (verified)');
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log();
+            console.log(kv('Token', c.accent(`${opts.name} (${opts.symbol})`)));
+            console.log(kv('Address', c.value(result.tokenAddress)));
+            console.log(kv('Tx Hash', c.value(result.txHash)));
+            console.log(kv('Deployed From', c.value(result.deployedFrom)));
+            console.log(kv('$CLAWNCH Burned', c.value(result.clawnchBurned)));
+            console.log(kv('Badge', `${dot('green')} @clawnch verified`));
+            console.log();
+            console.log(c.muted(`  View: https://clanker.world/clanker/${result.tokenAddress}`));
+            console.log();
+        }
+    }
+    catch (err) {
+        spinner.stop();
+        handleError(err);
+    }
+});
+// ============================================================================
+// Wallet Management Commands
+// ============================================================================
+import { createWallet as createNewWallet, importFromPrivateKey, importFromMnemonic, decryptWallet, listWallets, walletExists, removeWallet, getActiveWallet, setActiveWallet, getWalletInfo, changePassword, promptPassword, promptPasswordConfirm, } from './wallet.js';
+const walletCmd = program
+    .command('wallet')
+    .description('Manage encrypted wallets');
+walletCmd
+    .command('create')
+    .description('Create a new wallet with a fresh mnemonic')
+    .argument('<name>', 'Wallet name (alphanumeric, dash, underscore)')
+    .option('--set-active', 'Set as active wallet after creation')
+    .action(async (name, opts) => {
+    try {
+        // Validate name
+        if (!/^[a-zA-Z0-9_-]+$/.test(name)) {
+            console.error(c.error('  Wallet name must be alphanumeric (dashes and underscores allowed)'));
+            process.exit(1);
+        }
+        if (walletExists(name)) {
+            console.error(c.error(`  Wallet "${name}" already exists`));
+            process.exit(1);
+        }
+        const password = await promptPasswordConfirm('encryption password');
+        const spinner = ora('Generating wallet...').start();
+        const { keystore, mnemonic, privateKey } = createNewWallet(name, password);
+        spinner.succeed('Wallet created');
+        if (opts.setActive) {
+            setActiveWallet(name);
+        }
+        console.log();
+        console.log(sectionHeader('New Wallet'));
+        console.log(kv('Name', c.accent(name)));
+        console.log(kv('Address', fmtAddr(keystore.address)));
+        console.log();
+        console.log(sectionHeader('Recovery Phrase'));
+        console.log(c.warn('  IMPORTANT: Write down this mnemonic and store it safely.'));
+        console.log(c.warn('  It will NOT be shown again. Anyone with this phrase'));
+        console.log(c.warn('  can access your funds.'));
+        console.log();
+        const words = mnemonic.split(' ');
+        for (let i = 0; i < words.length; i += 4) {
+            const row = words.slice(i, i + 4)
+                .map((w, j) => `${c.muted(String(i + j + 1).padStart(2, ' '))}. ${c.value(w.padEnd(10))}`)
+                .join('  ');
+            console.log(`  ${row}`);
+        }
+        console.log();
+        if (opts.setActive) {
+            console.log(`  ${c.success('*')} Set as active wallet`);
+        }
+        else {
+            console.log(c.muted(`  Run ${c.accent('clawncher wallet use ' + name)} to set as active`));
+        }
+        console.log();
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+walletCmd
+    .command('import')
+    .description('Import a wallet from a private key or mnemonic')
+    .argument('<name>', 'Wallet name')
+    .option('--private-key <key>', 'Import from private key (hex)')
+    .option('--mnemonic <phrase>', 'Import from mnemonic phrase')
+    .option('--set-active', 'Set as active wallet after import')
+    .action(async (name, opts) => {
+    try {
+        if (!/^[a-zA-Z0-9_-]+$/.test(name)) {
+            console.error(c.error('  Wallet name must be alphanumeric (dashes and underscores allowed)'));
+            process.exit(1);
+        }
+        if (walletExists(name)) {
+            console.error(c.error(`  Wallet "${name}" already exists`));
+            process.exit(1);
+        }
+        if (!opts.privateKey && !opts.mnemonic) {
+            console.error(c.error('  Provide --private-key or --mnemonic'));
+            process.exit(1);
+        }
+        const password = await promptPasswordConfirm('encryption password');
+        const spinner = ora('Encrypting wallet...').start();
+        let keystore;
+        if (opts.privateKey) {
+            const key = opts.privateKey.startsWith('0x') ? opts.privateKey : `0x${opts.privateKey}`;
+            keystore = importFromPrivateKey(name, key, password);
+        }
+        else {
+            keystore = importFromMnemonic(name, opts.mnemonic, password);
+        }
+        spinner.succeed('Wallet imported');
+        if (opts.setActive) {
+            setActiveWallet(name);
+        }
+        console.log();
+        console.log(kv('Name', c.accent(name)));
+        console.log(kv('Address', fmtAddr(keystore.address)));
+        console.log(kv('Source', opts.privateKey ? 'Private key' : 'Mnemonic'));
+        if (opts.setActive) {
+            console.log(`  ${c.success('*')} Set as active wallet`);
+        }
+        console.log();
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+walletCmd
+    .command('list')
+    .alias('ls')
+    .description('List all wallets')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    try {
+        const wallets = listWallets();
+        if (opts.json) {
+            console.log(JSON.stringify(wallets, null, 2));
+            return;
+        }
+        if (wallets.length === 0) {
+            console.log(c.muted('\n  No wallets found. Create one with: clawncher wallet create <name>\n'));
+            return;
+        }
+        console.log();
+        console.log(sectionHeader(`Wallets (${wallets.length})`));
+        for (const w of wallets) {
+            const active = w.isActive ? c.success(' *') : '  ';
+            const mnemonicBadge = w.hasMnemonic ? c.muted(' [mnemonic]') : '';
+            console.log(`${active} ${c.accent(w.name.padEnd(16))} ${fmtAddr(w.address)}${mnemonicBadge}`);
+        }
+        const activeWallet = getActiveWallet();
+        if (activeWallet) {
+            console.log(c.muted(`\n  * = active wallet (${activeWallet})`));
+        }
+        console.log();
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+walletCmd
+    .command('use')
+    .description('Set the active wallet (used when no --private-key given)')
+    .argument('<name>', 'Wallet name')
+    .action(async (name) => {
+    try {
+        if (!walletExists(name)) {
+            console.error(c.error(`  Wallet "${name}" not found`));
+            process.exit(1);
+        }
+        setActiveWallet(name);
+        const info = getWalletInfo(name);
+        console.log(`  ${c.success('\u2713')} Active wallet: ${c.accent(name)} (${fmtAddr(info.address, true)})`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+walletCmd
+    .command('export')
+    .description('Export wallet private key (requires password)')
+    .argument('<name>', 'Wallet name')
+    .option('--show-mnemonic', 'Also show mnemonic phrase if available')
+    .action(async (name, opts) => {
+    try {
+        if (!walletExists(name)) {
+            console.error(c.error(`  Wallet "${name}" not found`));
+            process.exit(1);
+        }
+        const password = await promptPassword('  Enter wallet password: ');
+        const spinner = ora('Decrypting...').start();
+        const decrypted = decryptWallet(name, password);
+        spinner.succeed('Decrypted');
+        console.log();
+        console.log(c.warn('  WARNING: Never share your private key. Anyone with it controls your funds.'));
+        console.log();
+        console.log(kv('Name', c.accent(decrypted.name)));
+        console.log(kv('Address', fmtAddr(decrypted.address)));
+        console.log(kv('Private Key', c.value(decrypted.privateKey)));
+        if (opts.showMnemonic && decrypted.mnemonic) {
+            console.log();
+            console.log(sectionHeader('Recovery Phrase'));
+            const words = decrypted.mnemonic.split(' ');
+            for (let i = 0; i < words.length; i += 4) {
+                const row = words.slice(i, i + 4)
+                    .map((w, j) => `${c.muted(String(i + j + 1).padStart(2, ' '))}. ${c.value(w.padEnd(10))}`)
+                    .join('  ');
+                console.log(`  ${row}`);
+            }
+        }
+        else if (opts.showMnemonic && !decrypted.mnemonic) {
+            console.log(c.muted('\n  No mnemonic stored (wallet was imported from private key)'));
+        }
+        console.log();
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+walletCmd
+    .command('remove')
+    .alias('rm')
+    .description('Remove a wallet')
+    .argument('<name>', 'Wallet name')
+    .option('--force', 'Skip confirmation')
+    .action(async (name, opts) => {
+    try {
+        if (!walletExists(name)) {
+            console.error(c.error(`  Wallet "${name}" not found`));
+            process.exit(1);
+        }
+        const info = getWalletInfo(name);
+        if (!opts.force) {
+            console.log(c.warn(`\n  This will permanently delete wallet "${name}" (${fmtAddr(info.address, true)})`));
+            console.log(c.warn('  Make sure you have backed up your private key or mnemonic!\n'));
+            const confirm = await promptPassword('  Type wallet name to confirm: ');
+            if (confirm !== name) {
+                console.log(c.muted('  Cancelled'));
+                return;
+            }
+        }
+        removeWallet(name);
+        console.log(`  ${c.success('\u2713')} Wallet "${name}" removed`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+walletCmd
+    .command('password')
+    .description('Change wallet password')
+    .argument('<name>', 'Wallet name')
+    .action(async (name) => {
+    try {
+        if (!walletExists(name)) {
+            console.error(c.error(`  Wallet "${name}" not found`));
+            process.exit(1);
+        }
+        const oldPw = await promptPassword('  Enter current password: ');
+        // Verify old password works
+        const spinner = ora('Verifying...').start();
+        decryptWallet(name, oldPw); // Throws if wrong
+        spinner.succeed('Password verified');
+        const newPw = await promptPasswordConfirm('new password');
+        const reEncrypt = ora('Re-encrypting...').start();
+        changePassword(name, oldPw, newPw);
+        reEncrypt.succeed('Password changed');
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+walletCmd
+    .command('balance')
+    .description('Show wallet balances (ETH + tokens)')
+    .argument('[name]', 'Wallet name (default: active wallet)')
+    .option('-n, --network <network>', 'Network (sepolia or mainnet)')
+    .option('--rpc <url>', 'Custom RPC URL')
+    .option('-t, --token <address>', 'Also show balance of a specific ERC20 token')
+    .action(async (name, opts) => {
+    try {
+        const walletName = name || getActiveWallet();
+        if (!walletName) {
+            console.error(c.error('  No wallet specified and no active wallet set'));
+            console.error(c.muted('  Use: clawncher wallet balance <name>'));
+            console.error(c.muted('    or: clawncher wallet use <name>'));
+            process.exit(1);
+        }
+        if (!walletExists(walletName)) {
+            console.error(c.error(`  Wallet "${walletName}" not found`));
+            process.exit(1);
+        }
+        const info = getWalletInfo(walletName);
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        const chain = getChain(network);
+        const publicClient = createPublicClient({ chain, transport: http(rpcUrl) });
+        const spinner = ora('Fetching balances...').start();
+        // Get ETH balance
+        const ethBalance = await publicClient.getBalance({ address: info.address });
+        spinner.succeed('Balances fetched');
+        console.log();
+        console.log(sectionHeader(`${walletName} Balances`));
+        console.log(kv('Address', fmtAddr(info.address)));
+        console.log(kv('Network', networkBadge(network)));
+        console.log(kv('ETH', `${formatEther(ethBalance)} ETH`));
+        // Token balance if requested
+        if (opts.token) {
+            const tokenAddr = validateAddress(opts.token, 'token');
+            try {
+                const [balance, decimals, symbol] = await Promise.all([
+                    publicClient.readContract({
+                        address: tokenAddr,
+                        abi: [{ type: 'function', name: 'balanceOf', inputs: [{ type: 'address' }], outputs: [{ type: 'uint256' }], stateMutability: 'view' }],
+                        functionName: 'balanceOf',
+                        args: [info.address],
+                    }),
+                    readDecimals(publicClient, tokenAddr),
+                    readSymbol(publicClient, tokenAddr),
+                ]);
+                const formatted = Number(balance) / (10 ** decimals);
+                console.log(kv(symbol, `${formatted.toLocaleString()} ${symbol}`));
+            }
+            catch {
+                console.log(kv('Token', c.error('Failed to read token balance')));
+            }
+        }
+        console.log();
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+walletCmd
+    .command('send')
+    .description('Send ETH or tokens from wallet')
+    .argument('[name]', 'Wallet name (default: active wallet)')
+    .requiredOption('--to <address>', 'Recipient address')
+    .requiredOption('--amount <value>', 'Amount to send (in ETH or token units)')
+    .option('--token <address>', 'ERC20 token address (omit for ETH)')
+    .option('-n, --network <network>', 'Network (sepolia or mainnet)')
+    .option('--rpc <url>', 'Custom RPC URL')
+    .option('--json', 'Output as JSON')
+    .action(async (name, opts) => {
+    try {
+        const walletName = name || getActiveWallet();
+        if (!walletName) {
+            console.error(c.error('  No wallet specified and no active wallet set'));
+            process.exit(1);
+        }
+        if (!walletExists(walletName)) {
+            console.error(c.error(`  Wallet "${walletName}" not found`));
+            process.exit(1);
+        }
+        const to = validateAddress(opts.to, 'recipient');
+        const network = getNetwork(opts);
+        const rpcUrl = getRpcUrl(network, opts);
+        // Decrypt wallet
+        const password = await promptPassword('  Enter wallet password: ');
+        const spinner = ora('Decrypting wallet...').start();
+        const decrypted = decryptWallet(walletName, password);
+        spinner.text = 'Preparing transaction...';
+        const { wallet, publicClient } = createClients(network, decrypted.privateKey, rpcUrl);
+        if (opts.token) {
+            // ERC20 transfer
+            const tokenAddr = validateAddress(opts.token, 'token');
+            const [decimals, symbol] = await Promise.all([
+                readDecimals(publicClient, tokenAddr),
+                readSymbol(publicClient, tokenAddr),
+            ]);
+            const amount = BigInt(Math.floor(Number(opts.amount) * (10 ** decimals)));
+            spinner.text = `Sending ${opts.amount} ${symbol}...`;
+            const hash = await wallet.writeContract({
+                address: tokenAddr,
+                abi: [{ type: 'function', name: 'transfer', inputs: [{ type: 'address', name: 'to' }, { type: 'uint256', name: 'amount' }], outputs: [{ type: 'bool' }], stateMutability: 'nonpayable' }],
+                functionName: 'transfer',
+                args: [to, amount],
+            });
+            spinner.succeed(`Sent ${opts.amount} ${symbol}`);
+            if (opts.json) {
+                console.log(JSON.stringify({ hash, from: decrypted.address, to, amount: opts.amount, token: tokenAddr, symbol }));
+            }
+            else {
+                console.log();
+                console.log(kv('Tx Hash', c.value(hash)));
+                console.log(kv('From', fmtAddr(decrypted.address, true)));
+                console.log(kv('To', fmtAddr(to, true)));
+                console.log(kv('Amount', `${opts.amount} ${symbol}`));
+                console.log(kv('Network', networkBadge(network)));
+                console.log();
+            }
+        }
+        else {
+            // ETH transfer
+            const amount = parseEther(opts.amount);
+            spinner.text = `Sending ${opts.amount} ETH...`;
+            const hash = await wallet.sendTransaction({
+                to,
+                value: amount,
+            });
+            spinner.succeed(`Sent ${opts.amount} ETH`);
+            if (opts.json) {
+                console.log(JSON.stringify({ hash, from: decrypted.address, to, amount: opts.amount }));
+            }
+            else {
+                console.log();
+                console.log(kv('Tx Hash', c.value(hash)));
+                console.log(kv('From', fmtAddr(decrypted.address, true)));
+                console.log(kv('To', fmtAddr(to, true)));
+                console.log(kv('Amount', `${opts.amount} ETH`));
+                console.log(kv('Network', networkBadge(network)));
+                console.log();
+            }
+        }
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+walletCmd
+    .command('sign')
+    .description('Sign a message with wallet')
+    .argument('[name]', 'Wallet name (default: active wallet)')
+    .requiredOption('-m, --message <text>', 'Message to sign')
+    .option('--json', 'Output as JSON')
+    .action(async (name, opts) => {
+    try {
+        const walletName = name || getActiveWallet();
+        if (!walletName) {
+            console.error(c.error('  No wallet specified and no active wallet set'));
+            process.exit(1);
+        }
+        if (!walletExists(walletName)) {
+            console.error(c.error(`  Wallet "${walletName}" not found`));
+            process.exit(1);
+        }
+        const password = await promptPassword('  Enter wallet password: ');
+        const spinner = ora('Signing...').start();
+        const decrypted = decryptWallet(walletName, password);
+        const account = privateKeyToAccount(decrypted.privateKey);
+        const signature = await account.signMessage({ message: opts.message });
+        spinner.succeed('Message signed');
+        if (opts.json) {
+            console.log(JSON.stringify({ address: decrypted.address, message: opts.message, signature }));
+        }
+        else {
+            console.log();
+            console.log(kv('Address', fmtAddr(decrypted.address)));
+            console.log(kv('Message', c.value(opts.message)));
+            console.log(kv('Signature', c.value(signature)));
+            console.log();
+        }
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+// Parse and run
+program.parse();
+//# sourceMappingURL=cli.js.map