minara 0.1.4 → 0.2.0

package/dist/commands/swap.js

@@ -3,12 +3,14 @@ import { input, select, confirm } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { swap, swapsSimulate } from '../api/crosschain.js';
 import { requireAuth } from '../config.js';
-import { success, info, spinner, formatOrderSide, assertApiOk, selectChain, wrapAction } from '../utils.js';
+import { success, info, spinner, formatOrderSide, assertApiOk, selectChain, wrapAction, requireTransactionConfirmation, lookupToken, formatTokenLabel } from '../utils.js';
+import { requireTouchId } from '../touchid.js';
+import { printTxResult, printKV } from '../formatters.js';
 export const swapCommand = new Command('swap')
     .description('Swap tokens (cross-chain spot trading)')
     .option('-c, --chain <chain>', 'Blockchain (e.g. solana, base, ethereum)')
     .option('-s, --side <side>', 'buy or sell')
-    .option('-t, --token <address>', 'Token contract address')
+    .option('-t, --token <address|ticker>', 'Token contract address or ticker symbol')
     .option('-a, --amount <amount>', 'USD amount (buy) or token amount (sell)')
     .option('-y, --yes', 'Skip confirmation')
     .option('--dry-run', 'Simulate without executing')
@@ -27,11 +29,12 @@ export const swapCommand = new Command('swap')
             ],
         });
     }
-    // ── 3. Token address ─────────────────────────────────────────────────
-    const tokenAddress = opts.token ?? await input({
-        message: 'Token contract address:',
-        validate: (v) => (v.length > 5 ? true : 'Please enter a valid address'),
+    // ── 3. Token ───────────────────────────────────────────────────────────
+    const tokenInput = opts.token ?? await input({
+        message: 'Token (contract address or ticker):',
+        validate: (v) => (v.length > 0 ? true : 'Please enter a token address or ticker'),
     });
+    const tokenInfo = await lookupToken(tokenInput);
     // ── 4. Amount ────────────────────────────────────────────────────────
     const amountLabel = side === 'buy' ? 'USD amount to spend' : 'Token amount to sell';
     const amount = opts.amount ?? await input({
@@ -46,7 +49,8 @@ export const swapCommand = new Command('swap')
     console.log(chalk.bold('Swap Summary:'));
     console.log(`  Chain   : ${chalk.cyan(chain)}`);
     console.log(`  Action  : ${formatOrderSide(side)}`);
-    console.log(`  Token   : ${chalk.yellow(tokenAddress)}`);
+    console.log(`  Token   : ${formatTokenLabel(tokenInfo)}`);
+    console.log(`  Address : ${chalk.yellow(tokenInfo.address)}`);
     console.log(`  Amount  : ${chalk.bold(amount)} ${side === 'buy' ? 'USD' : '(token)'}`);
     console.log('');
     // ── 6. Dry run ───────────────────────────────────────────────────────
@@ -54,11 +58,21 @@ export const swapCommand = new Command('swap')
         info('Simulating swap (dry-run)…');
         const spin = spinner('Simulating…');
         const simRes = await swapsSimulate(creds.accessToken, [{
-                chain, side, tokenAddress, buyUsdAmountOrSellTokenAmount: amount,
+                chain, side, tokenAddress: tokenInfo.address, buyUsdAmountOrSellTokenAmount: amount,
             }]);
         spin.stop();
         assertApiOk(simRes, 'Simulation failed');
-        console.log(JSON.stringify(simRes.data, null, 2));
+        console.log('');
+        console.log(chalk.bold('Simulation Result:'));
+        if (Array.isArray(simRes.data)) {
+            for (const item of simRes.data) {
+                printKV(item);
+                console.log('');
+            }
+        }
+        else if (simRes.data) {
+            printKV(simRes.data);
+        }
         return;
     }
     // ── 7. Confirm ───────────────────────────────────────────────────────
@@ -72,14 +86,16 @@ export const swapCommand = new Command('swap')
             return;
         }
     }
-    // ── 8. Execute ───────────────────────────────────────────────────────
+    // ── 8. Transaction confirmation & Touch ID ────────────────────────────
+    await requireTransactionConfirmation(`${side.toUpperCase()} swap · ${amount} ${side === 'buy' ? 'USD' : 'tokens'} · ${chain}`, tokenInfo);
+    await requireTouchId();
+    // ── 9. Execute ───────────────────────────────────────────────────────
     const spin = spinner('Executing swap…');
     const res = await swap(creds.accessToken, {
-        chain, side, tokenAddress, buyUsdAmountOrSellTokenAmount: amount,
+        chain, side, tokenAddress: tokenInfo.address, buyUsdAmountOrSellTokenAmount: amount,
     });
     spin.stop();
     assertApiOk(res, 'Swap failed');
     success('Swap submitted!');
-    if (res.data)
-        console.log(JSON.stringify(res.data, null, 2));
+    printTxResult(res.data);
 }));

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;