minara 0.1.5 → 0.2.0

package/dist/commands/transfer.js

@@ -3,11 +3,13 @@ import { input, confirm } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { transfer } from '../api/crosschain.js';
 import { requireAuth } from '../config.js';
-import { success, warn, spinner, assertApiOk, selectChain, wrapAction } from '../utils.js';
+import { success, warn, spinner, assertApiOk, selectChain, wrapAction, requireTransactionConfirmation, lookupToken, formatTokenLabel } from '../utils.js';
+import { requireTouchId } from '../touchid.js';
+import { printTxResult } from '../formatters.js';
 export const transferCommand = new Command('transfer')
     .description('Transfer tokens to another address')
     .option('-c, --chain <chain>', 'Blockchain')
-    .option('-t, --token <address>', 'Token contract address')
+    .option('-t, --token <address|ticker>', 'Token contract address or ticker symbol')
     .option('-a, --amount <amount>', 'Token amount to send')
     .option('--to <address>', 'Recipient address')
     .option('-y, --yes', 'Skip confirmation')
@@ -16,10 +18,11 @@ export const transferCommand = new Command('transfer')
     // ── 1. Chain ─────────────────────────────────────────────────────────
     const chain = opts.chain ?? await selectChain();
     // ── 2. Token ─────────────────────────────────────────────────────────
-    const tokenAddress = opts.token ?? await input({
-        message: 'Token contract address (native token = 0x0…0):',
-        validate: (v) => (v.length > 0 ? true : 'Address is required'),
+    const tokenInput = opts.token ?? await input({
+        message: 'Token (address or ticker, native = 0x0…0):',
+        validate: (v) => (v.length > 0 ? true : 'Token is required'),
     });
+    const tokenInfo = await lookupToken(tokenInput);
     // ── 3. Amount ────────────────────────────────────────────────────────
     const amount = opts.amount ?? await input({
         message: 'Amount to send:',
@@ -33,11 +36,12 @@ export const transferCommand = new Command('transfer')
         message: 'Recipient address:',
         validate: (v) => (v.length > 5 ? true : 'Enter a valid address'),
     });
-    // ── 5. Summary & confirm ─────────────────────────────────────────────
+    // ── 5. Summary ───────────────────────────────────────────────────────
     console.log('');
     console.log(chalk.bold.red('⚠  Transfer Summary:'));
     console.log(`  Chain     : ${chalk.cyan(chain)}`);
-    console.log(`  Token     : ${chalk.yellow(tokenAddress)}`);
+    console.log(`  Token     : ${formatTokenLabel(tokenInfo)}`);
+    console.log(`  Address   : ${chalk.yellow(tokenInfo.address)}`);
     console.log(`  Amount    : ${chalk.bold(amount)}`);
     console.log(`  To        : ${chalk.yellow(recipient)}`);
     console.log('');
@@ -49,12 +53,14 @@ export const transferCommand = new Command('transfer')
             return;
         }
     }
-    // ── 6. Execute ───────────────────────────────────────────────────────
+    // ── 6. Transaction confirmation & Touch ID ────────────────────────────
+    await requireTransactionConfirmation(`Transfer ${amount} tokens → ${recipient} · ${chain}`, tokenInfo);
+    await requireTouchId();
+    // ── 7. Execute ───────────────────────────────────────────────────────
     const spin = spinner('Processing transfer…');
-    const res = await transfer(creds.accessToken, { chain, tokenAddress, tokenAmount: amount, recipient });
+    const res = await transfer(creds.accessToken, { chain, tokenAddress: tokenInfo.address, tokenAmount: amount, recipient });
     spin.stop();
     assertApiOk(res, 'Transfer failed');
     success('Transfer submitted!');
-    if (res.data)
-        console.log(JSON.stringify(res.data, null, 2));
+    printTxResult(res.data);
 }));

package/dist/commands/withdraw.js

@@ -3,11 +3,13 @@ import { input, confirm } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { transfer, getAssets } from '../api/crosschain.js';
 import { requireAuth } from '../config.js';
-import { success, warn, spinner, assertApiOk, selectChain, wrapAction } from '../utils.js';
+import { success, warn, spinner, assertApiOk, selectChain, wrapAction, requireTransactionConfirmation, lookupToken, formatTokenLabel } from '../utils.js';
+import { requireTouchId } from '../touchid.js';
+import { printTxResult } from '../formatters.js';
 export const withdrawCommand = new Command('withdraw')
     .description('Withdraw tokens from your Minara wallet to an external address')
     .option('-c, --chain <chain>', 'Blockchain network')
-    .option('-t, --token <address>', 'Token contract address')
+    .option('-t, --token <address|ticker>', 'Token contract address or ticker symbol')
     .option('-a, --amount <amount>', 'Amount to withdraw')
     .option('--to <address>', 'Destination address')
     .option('-y, --yes', 'Skip confirmation')
@@ -39,10 +41,11 @@ export const withdrawCommand = new Command('withdraw')
     // ── 2. Chain ─────────────────────────────────────────────────────────
     const chain = opts.chain ?? await selectChain('Withdraw on which blockchain?');
     // ── 3. Token ─────────────────────────────────────────────────────────
-    const tokenAddress = opts.token ?? await input({
-        message: `Token contract address on ${chalk.cyan(chain)}:\n  (native gas token = ${'0x' + '0'.repeat(40)})\n  Address:`,
-        validate: (v) => (v.length > 0 ? true : 'Token address is required'),
+    const tokenInput = opts.token ?? await input({
+        message: `Token on ${chalk.cyan(chain)} (address or ticker, native = ${'0x' + '0'.repeat(40)}):`,
+        validate: (v) => (v.length > 0 ? true : 'Token is required'),
     });
+    const tokenInfo = await lookupToken(tokenInput);
     // ── 4. Amount ────────────────────────────────────────────────────────
     const amount = opts.amount ?? await input({
         message: 'Amount to withdraw:',
@@ -56,11 +59,12 @@ export const withdrawCommand = new Command('withdraw')
         message: 'Destination address (your external wallet):',
         validate: (v) => (v.length > 5 ? true : 'Enter a valid address'),
     });
-    // ── 6. Summary & double-confirm ──────────────────────────────────────
+    // ── 6. Summary ───────────────────────────────────────────────────────
     console.log('');
     console.log(chalk.bold.red('⚠  Withdrawal Summary'));
     console.log(`  Chain       : ${chalk.cyan(chain)}`);
-    console.log(`  Token       : ${chalk.yellow(tokenAddress)}`);
+    console.log(`  Token       : ${formatTokenLabel(tokenInfo)}`);
+    console.log(`  Address     : ${chalk.yellow(tokenInfo.address)}`);
     console.log(`  Amount      : ${chalk.bold(amount)}`);
     console.log(`  Destination : ${chalk.yellow(recipient)}`);
     console.log('');
@@ -77,13 +81,15 @@ export const withdrawCommand = new Command('withdraw')
             return;
         }
     }
-    // ── 7. Execute ───────────────────────────────────────────────────────
+    // ── 7. Transaction confirmation & Touch ID ────────────────────────────
+    await requireTransactionConfirmation(`Withdraw ${amount} tokens → ${recipient} · ${chain}`, tokenInfo);
+    await requireTouchId();
+    // ── 8. Execute ───────────────────────────────────────────────────────
     const spin = spinner('Processing withdrawal…');
-    const res = await transfer(creds.accessToken, { chain, tokenAddress, tokenAmount: amount, recipient });
+    const res = await transfer(creds.accessToken, { chain, tokenAddress: tokenInfo.address, tokenAmount: amount, recipient });
     spin.stop();
     assertApiOk(res, 'Withdrawal failed');
     success('Withdrawal submitted!');
-    if (res.data)
-        console.log(JSON.stringify(res.data, null, 2));
+    printTxResult(res.data);
     console.log(chalk.dim('\nIt may take a few minutes for the transaction to be confirmed on-chain.'));
 }));

package/dist/config.d.ts

@@ -5,6 +5,8 @@ export declare function clearCredentials(): void;
 export declare function requireAuth(): Credentials;
 export interface AppConfig {
     baseUrl: string;
+    touchId?: boolean;
+    confirmBeforeTransaction?: boolean;
 }
 export declare function loadConfig(): AppConfig;
 export declare function saveConfig(config: Partial<AppConfig>): void;

package/dist/config.js

@@ -48,6 +48,7 @@ export function requireAuth() {
 }
 const DEFAULT_CONFIG = {
     baseUrl: 'https://api.minara.ai',
+    confirmBeforeTransaction: true,
 };
 export function loadConfig() {
     if (!existsSync(CONFIG_FILE))

package/dist/formatters.d.ts

@@ -0,0 +1,56 @@
+/** Enable raw JSON output (all formatters fall back to JSON.stringify). */
+export declare function setRawJson(enabled: boolean): void;
+/** Check if raw JSON output mode is active. */
+export declare function isRawJson(): boolean;
+/** Convert camelCase / snake_case key to "Title Case" label. */
+export declare function formatLabel(key: string): string;
+/** Smart-format a single value for terminal display. */
+export declare function formatValue(value: unknown, key?: string): string;
+/**
+ * Print an object as aligned key-value pairs.
+ *
+ * ```
+ *   Transaction Id : 0x1234…abcd
+ *   Status         : pending
+ * ```
+ */
+export declare function printKV(data: Record<string, unknown> | object, indent?: number): void;
+export interface ColumnDef {
+    /** Object key (supports nested: "a.b") */
+    key: string;
+    /** Column header label (defaults to formatLabel(key)) */
+    label?: string;
+    /** Custom formatter for cell value */
+    format?: (value: unknown, row: Record<string, unknown>) => string;
+    /** Max column width (content will be truncated) */
+    maxWidth?: number;
+}
+/**
+ * Print an array of objects as a CLI table.
+ *
+ * If `columns` is omitted, columns are auto-detected from the data.
+ */
+export declare function printTable(data: Record<string, unknown>[] | object[], columns?: ColumnDef[]): void;
+/**
+ * Pretty-print a transaction result (deposit, withdraw, swap, transfer, order, etc.)
+ * Falls back silently if data is empty/undefined.
+ */
+export declare function printTxResult(data: unknown): void;
+/** Spot wallet assets (WalletAsset[]) */
+export declare const ASSET_COLUMNS: ColumnDef[];
+/** Perps positions (PerpsPosition[]) */
+export declare const POSITION_COLUMNS: ColumnDef[];
+/** Limit orders (LimitOrderInfo[]) */
+export declare const LIMIT_ORDER_COLUMNS: ColumnDef[];
+/** Copy trades (CopyTradeInfo[]) */
+export declare const COPY_TRADE_COLUMNS: ColumnDef[];
+/** Trending / search tokens (TokenInfo[]) */
+export declare const TOKEN_COLUMNS: ColumnDef[];
+/**
+ * Pretty-print Fear & Greed Index — hides redundant `timestamp` and `price`.
+ */
+export declare function printFearGreed(data: Record<string, unknown>): void;
+/**
+ * Pretty-print BTC/crypto metrics — flatten currentQuote, skip ohlcvQuotes.
+ */
+export declare function printCryptoMetrics(data: Record<string, unknown>): void;

package/dist/formatters.js

@@ -0,0 +1,376 @@
+// ═══════════════════════════════════════════════════════════════════════════
+//  CLI-friendly data formatters
+//
+//  Replaces raw JSON.stringify output with tables and key-value displays.
+// ═══════════════════════════════════════════════════════════════════════════
+import chalk from 'chalk';
+import Table from 'cli-table3';
+// ─── Raw JSON mode ───────────────────────────────────────────────────────
+let _rawJson = false;
+/** Enable raw JSON output (all formatters fall back to JSON.stringify). */
+export function setRawJson(enabled) { _rawJson = enabled; }
+/** Check if raw JSON output mode is active. */
+export function isRawJson() { return _rawJson; }
+// ─── Hidden keys (internal IDs, metadata noise) ─────────────────────────
+/**
+ * Keys matching this pattern are hidden from printKV / auto-detected table
+ * columns. They are still included in --json raw output.
+ */
+const HIDDEN_KEYS = /^_?id$|^_id$|^__v$/i;
+// ─── Per-context key exclusions (non-regex, for specific commands) ───────
+/** Keys to skip from Fear & Greed display (redundant with pointDate). */
+const FEAR_GREED_HIDDEN = new Set(['timestamp', 'price']);
+// ─── Key / value helpers ─────────────────────────────────────────────────
+/** Convert camelCase / snake_case key to "Title Case" label. */
+export function formatLabel(key) {
+    return key
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2') // camelCase → camel Case
+        .replace(/[_-]/g, ' ') // snake_case / kebab → spaces
+        .replace(/\b\w/g, (c) => c.toUpperCase()); // Capitalise words
+}
+/** Smart-format a single value for terminal display. */
+export function formatValue(value, key) {
+    if (value === null || value === undefined || value === '')
+        return chalk.dim('—');
+    if (typeof value === 'boolean')
+        return value ? chalk.green('Yes') : chalk.dim('No');
+    if (typeof value === 'number') {
+        // Percentage-like keys
+        if (key && /percent|change|pnl|roi|rate/i.test(key)) {
+            const sign = value >= 0 ? '+' : '';
+            const color = value >= 0 ? chalk.green : chalk.red;
+            return color(`${sign}${value.toLocaleString('en-US', { maximumFractionDigits: 4 })}%`);
+        }
+        // Price / USD-like keys
+        if (key && /price|value|usd|amount|equity|margin|balance|fee|cost|cap/i.test(key)) {
+            return `$${value.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 6 })}`;
+        }
+        // Unix timestamps – ms (13 digits ~2001–2100) or seconds (10 digits ~2001–2100)
+        if (key && /timestamp|time|date|createdAt|updatedAt|expir/i.test(key)) {
+            const ms = value > 1e12 ? value : value * 1000;
+            if (ms > 946684800000 && ms < 4102444800000) { // 2000-01-01 to 2100-01-01
+                return new Date(ms).toLocaleString();
+            }
+        }
+        return value.toLocaleString('en-US', { maximumFractionDigits: 6 });
+    }
+    if (typeof value === 'string') {
+        // Numeric string that looks like a price / amount
+        const num = Number(value);
+        if (!isNaN(num) && value.trim() !== '') {
+            return formatValue(num, key);
+        }
+        // Timestamps (ISO / unix seconds)
+        if (/^\d{4}-\d{2}-\d{2}T/.test(value)) {
+            return new Date(value).toLocaleString();
+        }
+        // Hex addresses
+        if (/^0x[0-9a-fA-F]{20,}$/.test(value))
+            return chalk.yellow(value);
+        // URLs
+        if (value.startsWith('http'))
+            return chalk.cyan.underline(value);
+        // Status-like
+        if (/^(success|completed|filled|running|active)$/i.test(value))
+            return chalk.green(value);
+        if (/^(failed|error|rejected|cancelled|canceled)$/i.test(value))
+            return chalk.red(value);
+        if (/^(pending|open|processing|paused)$/i.test(value))
+            return chalk.yellow(value);
+        return value;
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return chalk.dim('—');
+        if (value.every((v) => typeof v === 'string' || typeof v === 'number')) {
+            return value.join(', ');
+        }
+        return chalk.dim(`[${value.length} items]`);
+    }
+    if (typeof value === 'object') {
+        // Shallow nested — show as inline key=value
+        const entries = Object.entries(value).filter(([, v]) => v !== null && v !== undefined);
+        if (entries.length <= 3) {
+            return entries.map(([k, v]) => `${k}=${typeof v === 'string' ? v : JSON.stringify(v)}`).join('  ');
+        }
+        return chalk.dim(JSON.stringify(value));
+    }
+    return String(value);
+}
+// ─── printKV ─────────────────────────────────────────────────────────────
+/**
+ * Print an object as aligned key-value pairs.
+ *
+ * ```
+ *   Transaction Id : 0x1234…abcd
+ *   Status         : pending
+ * ```
+ */
+export function printKV(data, indent = 2) {
+    if (_rawJson) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    const entries = Object.entries(data).filter(([k, v]) => v !== undefined && v !== null && v !== '' && !HIDDEN_KEYS.test(k));
+    if (entries.length === 0) {
+        console.log(chalk.dim(`${' '.repeat(indent)}No data.`));
+        return;
+    }
+    const labels = entries.map(([k]) => formatLabel(k));
+    const maxLen = Math.max(...labels.map((l) => l.length));
+    const pad = ' '.repeat(indent);
+    for (let i = 0; i < entries.length; i++) {
+        const [key, value] = entries[i];
+        const label = labels[i].padEnd(maxLen);
+        console.log(`${pad}${chalk.dim(label)} : ${formatValue(value, key)}`);
+    }
+}
+// ─── printTable ──────────────────────────────────────────────────────────
+function getNestedValue(obj, path) {
+    return path.split('.').reduce((o, k) => {
+        if (o && typeof o === 'object' && k in o) {
+            return o[k];
+        }
+        return undefined;
+    }, obj);
+}
+/**
+ * Auto-detect columns from array data.
+ * Picks keys that appear in most rows and are not deeply nested.
+ */
+function autoColumns(data) {
+    const keyCounts = new Map();
+    for (const row of data) {
+        for (const k of Object.keys(row)) {
+            keyCounts.set(k, (keyCounts.get(k) ?? 0) + 1);
+        }
+    }
+    // Keep keys present in at least half the rows, exclude hidden keys & complex nested objects
+    return [...keyCounts.entries()]
+        .filter(([k, count]) => count >= data.length / 2 && !HIDDEN_KEYS.test(k))
+        .filter(([k]) => {
+        const sample = data.find((r) => r[k] !== undefined)?.[k];
+        // Skip deeply nested objects / large arrays
+        if (Array.isArray(sample) && sample.length > 3)
+            return false;
+        if (sample && typeof sample === 'object' && !Array.isArray(sample)) {
+            const keys = Object.keys(sample);
+            return keys.length <= 3;
+        }
+        return true;
+    })
+        .map(([key]) => ({ key }));
+}
+/**
+ * Print an array of objects as a CLI table.
+ *
+ * If `columns` is omitted, columns are auto-detected from the data.
+ */
+export function printTable(data, columns) {
+    if (_rawJson) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    if (!data || data.length === 0) {
+        console.log(chalk.dim('  No data.'));
+        return;
+    }
+    const rows = data;
+    const cols = columns ?? autoColumns(rows);
+    if (cols.length === 0) {
+        // fallback — just printKV for each item
+        for (const row of data) {
+            printKV(row);
+            console.log('');
+        }
+        return;
+    }
+    const table = new Table({
+        head: cols.map((c) => chalk.white.bold(c.label ?? formatLabel(c.key))),
+        style: { head: [], border: ['dim'] },
+        wordWrap: true,
+    });
+    for (const row of rows) {
+        table.push(cols.map((c) => {
+            const raw = getNestedValue(row, c.key);
+            if (c.format)
+                return c.format(raw, row);
+            const str = formatValue(raw, c.key);
+            if (c.maxWidth && str.length > c.maxWidth) {
+                return str.slice(0, c.maxWidth - 1) + '…';
+            }
+            return str;
+        }));
+    }
+    console.log(table.toString());
+}
+// ─── printTxResult ───────────────────────────────────────────────────────
+/**
+ * Pretty-print a transaction result (deposit, withdraw, swap, transfer, order, etc.)
+ * Falls back silently if data is empty/undefined.
+ */
+export function printTxResult(data) {
+    if (!data)
+        return;
+    if (_rawJson) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    if (typeof data !== 'object') {
+        console.log(chalk.dim(`  ${data}`));
+        return;
+    }
+    const obj = data;
+    console.log('');
+    printKV(obj);
+}
+// ═══════════════════════════════════════════════════════════════════════════
+//  Pre-built column configs for known data types
+// ═══════════════════════════════════════════════════════════════════════════
+/** Spot wallet assets (WalletAsset[]) */
+export const ASSET_COLUMNS = [
+    { key: 'symbol', label: 'Symbol', format: (v, row) => chalk.bold(String(v ?? row.tokenSymbol ?? '—')) },
+    { key: 'balance', label: 'Balance', format: (v, row) => String(v ?? row.amount ?? '—') },
+    { key: 'chain', label: 'Chain', format: (v, row) => chalk.cyan(String(v ?? row.chainName ?? '—')) },
+    { key: 'usdValue', label: 'USD Value', format: (v) => v ? `$${Number(v).toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}` : chalk.dim('—') },
+    { key: 'tokenAddress', label: 'Token Address', format: (v) => v ? chalk.dim(truncate(String(v), 16)) : chalk.dim('—') },
+];
+/** Perps positions (PerpsPosition[]) */
+export const POSITION_COLUMNS = [
+    { key: 'symbol', label: 'Symbol', format: (v) => chalk.bold(String(v ?? '—')) },
+    { key: 'side', label: 'Side', format: (v) => {
+            const s = String(v ?? '').toLowerCase();
+            return s === 'long' || s === 'buy' ? chalk.green.bold(String(v)) : chalk.red.bold(String(v));
+        } },
+    { key: 'size', label: 'Size' },
+    { key: 'entryPrice', label: 'Entry', format: (v) => formatValue(v, 'price') },
+    { key: 'markPrice', label: 'Mark', format: (v) => formatValue(v, 'price') },
+    { key: 'pnl', label: 'PnL', format: (v) => {
+            if (!v && v !== 0)
+                return chalk.dim('—');
+            const n = Number(v);
+            const color = n >= 0 ? chalk.green : chalk.red;
+            return color(`${n >= 0 ? '+' : ''}$${n.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`);
+        } },
+    { key: 'leverage', label: 'Lev', format: (v) => v ? `${v}x` : chalk.dim('—') },
+];
+/** Limit orders (LimitOrderInfo[]) */
+export const LIMIT_ORDER_COLUMNS = [
+    { key: 'id', label: 'ID', format: (v) => chalk.dim(truncate(String(v ?? ''), 12)) },
+    { key: 'side', label: 'Side', format: (v) => {
+            const s = String(v ?? '').toLowerCase();
+            return s === 'buy' ? chalk.green.bold('BUY') : chalk.red.bold('SELL');
+        } },
+    { key: 'chain', label: 'Chain', format: (v) => chalk.cyan(String(v ?? '—')) },
+    { key: 'targetTokenCA', label: 'Token', format: (v) => v ? chalk.yellow(truncate(String(v), 14)) : chalk.dim('—') },
+    { key: 'priceCondition', label: 'Condition', format: (v, row) => `${v ?? '?'} $${row.targetPrice ?? '?'}` },
+    { key: 'amount', label: 'Amount', format: (v) => v ? `$${v}` : chalk.dim('—') },
+    { key: 'status', label: 'Status', format: (v) => formatValue(v, 'status') },
+];
+/** Copy trades (CopyTradeInfo[]) */
+export const COPY_TRADE_COLUMNS = [
+    { key: 'id', label: 'ID', format: (v) => chalk.dim(truncate(String(v ?? ''), 12)) },
+    { key: 'name', label: 'Name', format: (v) => String(v ?? chalk.dim('—')) },
+    { key: 'chain', label: 'Chain', format: (v) => chalk.cyan(String(v ?? '—')) },
+    { key: 'targetAddress', label: 'Target', format: (v) => v ? chalk.yellow(truncate(String(v), 14)) : chalk.dim('—') },
+    { key: 'fixedAmount', label: 'Amount', format: (v) => v ? `$${v}` : chalk.dim('—') },
+    { key: 'copySell', label: 'Copy Sell', format: (v) => v ? chalk.green('Yes') : chalk.dim('No') },
+    { key: 'status', label: 'Status', format: (v) => formatValue(v, 'status') },
+];
+/** Format large numbers as $1.23B / $456.78M / $12.3K */
+function compactUsd(v) {
+    if (!v && v !== 0)
+        return chalk.dim('—');
+    const n = Number(v);
+    if (isNaN(n))
+        return chalk.dim('—');
+    if (n >= 1e9)
+        return `$${(n / 1e9).toFixed(2)}B`;
+    if (n >= 1e6)
+        return `$${(n / 1e6).toFixed(2)}M`;
+    if (n >= 1e3)
+        return `$${(n / 1e3).toFixed(1)}K`;
+    return `$${n.toFixed(2)}`;
+}
+/** Trending / search tokens (TokenInfo[]) */
+export const TOKEN_COLUMNS = [
+    { key: 'symbol', label: 'Symbol', format: (v) => chalk.bold(String(v ?? '—')) },
+    { key: 'chain', label: 'Chain', format: (v) => v ? chalk.cyan(String(v)) : chalk.dim('—') },
+    { key: 'price', label: 'Price', format: (v) => formatValue(v, 'price') },
+    { key: 'priceChange24H', label: '24h %', format: (v) => formatValue(v, 'change') },
+    { key: 'volume24H', label: 'Volume 24h', format: compactUsd },
+    { key: 'marketCap', label: 'Market Cap', format: compactUsd },
+];
+// ═══════════════════════════════════════════════════════════════════════════
+//  Specialised display helpers for discover commands
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Pretty-print Fear & Greed Index — hides redundant `timestamp` and `price`.
+ */
+export function printFearGreed(data) {
+    if (_rawJson) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    const entries = Object.entries(data).filter(([k, v]) => v !== undefined && v !== null && v !== '' && !HIDDEN_KEYS.test(k) && !FEAR_GREED_HIDDEN.has(k));
+    if (entries.length === 0) {
+        console.log(chalk.dim('  No data.'));
+        return;
+    }
+    const labels = entries.map(([k]) => formatLabel(k));
+    const maxLen = Math.max(...labels.map((l) => l.length));
+    for (let i = 0; i < entries.length; i++) {
+        const [key, value] = entries[i];
+        const label = labels[i].padEnd(maxLen);
+        console.log(`  ${chalk.dim(label)} : ${formatValue(value, key)}`);
+    }
+}
+/**
+ * Pretty-print BTC/crypto metrics — flatten currentQuote, skip ohlcvQuotes.
+ */
+export function printCryptoMetrics(data) {
+    if (_rawJson) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    const quote = data.currentQuote;
+    const change24h = data.priceChange24h;
+    // Build a flat display object from the quote
+    const display = [];
+    if (quote) {
+        if (quote.close !== undefined)
+            display.push(['Current Price', formatValue(quote.close, 'price')]);
+        if (quote.open !== undefined)
+            display.push(['Open (24h)', formatValue(quote.open, 'price')]);
+        if (quote.high !== undefined)
+            display.push(['High (24h)', formatValue(quote.high, 'price')]);
+        if (quote.low !== undefined)
+            display.push(['Low (24h)', formatValue(quote.low, 'price')]);
+        if (quote.high_timestamp)
+            display.push(['High At', formatValue(quote.high_timestamp, 'timestamp')]);
+        if (quote.low_timestamp)
+            display.push(['Low At', formatValue(quote.low_timestamp, 'timestamp')]);
+    }
+    if (change24h !== undefined) {
+        display.push(['Price Change 24h', formatValue(change24h, 'change')]);
+    }
+    else if (quote?.percent_change !== undefined) {
+        display.push(['Price Change 24h', formatValue(quote.percent_change, 'change')]);
+    }
+    if (quote?.price_change !== undefined) {
+        display.push(['Δ Price (USD)', formatValue(quote.price_change, 'price')]);
+    }
+    if (display.length === 0) {
+        // fallback to generic printKV
+        printKV(data);
+        return;
+    }
+    const maxLen = Math.max(...display.map(([l]) => l.length));
+    for (const [label, val] of display) {
+        console.log(`  ${chalk.dim(label.padEnd(maxLen))} : ${val}`);
+    }
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────
+function truncate(str, len) {
+    return str.length > len ? str.slice(0, len - 1) + '…' : str;
+}

package/dist/index.js

@@ -18,13 +18,21 @@ import { copyTradeCommand } from './commands/copy-trade.js';
 import { chatCommand } from './commands/chat.js';
 import { discoverCommand } from './commands/discover.js';
 import { configCommand } from './commands/config.js';
+import { premiumCommand } from './commands/premium.js';
+import { setRawJson } from './formatters.js';
 const program = new Command();
 program
     .name('minara')
     .version(version)
+    .option('--json', 'Output raw JSON instead of formatted tables')
     .description(chalk.bold('Minara CLI') +
     ' — Your AI-powered digital finance assistant in the terminal.\n\n' +
-    '  Login, swap, trade perps, copy-trade, and chat with Minara AI.');
+    '  Login, swap, trade perps, copy-trade, and chat with Minara AI.')
+    .hook('preAction', (thisCommand) => {
+    const opts = thisCommand.optsWithGlobals();
+    if (opts.json)
+        setRawJson(true);
+});
 // ── Auth & Account ───────────────────────────────────────────────────────
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
@@ -45,6 +53,8 @@ program.addCommand(copyTradeCommand);
 program.addCommand(chatCommand);
 // ── Market ───────────────────────────────────────────────────────────────
 program.addCommand(discoverCommand);
+// ── Premium ─────────────────────────────────────────────────────────────
+program.addCommand(premiumCommand);
 // ── Config ───────────────────────────────────────────────────────────────
 program.addCommand(configCommand);
 // Default: show help

package/dist/touchid.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Check whether Touch ID hardware is available on this machine.
+ * Returns `false` on non-macOS or when hardware is absent / not enrolled.
+ */
+export declare function isTouchIdAvailable(): boolean;
+/**
+ * Perform a Touch ID verification.
+ * Resolves on success, throws on failure or cancellation.
+ */
+export declare function verifyTouchId(reason?: string): void;
+/**
+ * If Touch ID is enabled in config, prompt the user for biometric
+ * verification. Exits the process on failure.
+ *
+ * Call this before any sensitive financial operation.
+ * On non-macOS platforms a warning is shown and execution continues.
+ */
+export declare function requireTouchId(): Promise<void>;