minara 0.2.0 → 0.2.1

package/README.md

@@ -18,9 +18,9 @@
 
 ## Features
 
-- **AI Chat** — Crypto-native AI for on-chain analysis, market research, and DeFi due diligence. Interactive REPL & single-shot queries with fast / quality / thinking modes
-- **Wallet** — Balances, deposits, and withdrawals across all supported chains
-- **Trading** — Cross-chain swaps, perpetual futures, limit orders, and copy trading. Accepts `$TICKER`, token name, or contract address
+- **AI Chat** — Crypto-native AI for on-chain analysis, market research, and DeFi due diligence. Interactive REPL & single-shot queries with `fast` / `quality` / `thinking` modes
+- **Wallet & Balance** — Unified balance view, spot holdings with PnL, perps account overview, deposits and withdrawals
+- **Chain-Abstracted Trading** — Cross-chain swaps with automatic chain detection, perpetual futures, and limit orders. Accepts `$TICKER`, token name, or contract address
 - **Market Discovery** — Trending tokens, Fear & Greed Index, on-chain metrics, and token / stock search
 
 ## Installation
@@ -55,8 +55,8 @@ minara chat
 # Or send a single question
 minara chat "What's the best DeFi yield right now?"
 
-# Swap tokens (accepts ticker or address)
-minara swap -c solana -t '$BONK' -s buy -a 100
+# Swap tokens (chain auto-detected from token)
+minara swap -t '$BONK' -s buy -a 100
 
 # View trending tokens
 minara discover trending
@@ -81,19 +81,23 @@ minara login --apple          # Apple ID (opens browser)
 
 ### Wallet & Funds
 
-| Command               | Description                                           |
-| --------------------- | ----------------------------------------------------- |
-| `minara assets`       | View wallet assets (interactive: spot / perps / both) |
-| `minara assets spot`  | View spot wallet balances across all chains           |
-| `minara assets perps` | View perps account balance and open positions         |
-| `minara deposit`      | Show deposit addresses and supported networks         |
-| `minara withdraw`     | Withdraw tokens to an external wallet                 |
+| Command               | Description                                     |
+| --------------------- | ----------------------------------------------- |
+| `minara balance`      | Combined USDC/USDT balance across spot and perps |
+| `minara assets`       | Full overview: spot holdings + perps account     |
+| `minara assets spot`  | Spot wallet: portfolio value, cost, PnL, holdings |
+| `minara assets perps` | Perps account: equity, margin, positions         |
+| `minara deposit`      | Deposit to spot (view addresses) or perps (direct / from spot) |
+| `minara withdraw`     | Withdraw tokens to an external wallet            |
 
 ```bash
-minara assets                     # Interactive: Spot / Perps / Both
-minara assets spot                # Spot wallet across all chains
-minara assets perps               # Perps account balance + positions
-minara deposit
+minara balance                    # Quick total: Spot + Perps available balance
+minara assets                     # Full overview (spot + perps)
+minara assets spot                # Spot wallet with PnL breakdown
+minara assets perps               # Perps equity, margin, positions
+minara deposit                    # Interactive: Spot (addresses) or Perps (address / transfer)
+minara deposit spot               # Show spot wallet deposit addresses (EVM + Solana)
+minara deposit perps              # Perps: show Arbitrum deposit address, or transfer from Spot → Perps
 minara withdraw -c solana -t '$SOL' -a 10 --to <address>
 minara withdraw                   # Interactive mode (accepts ticker or address)
 ```
@@ -102,23 +106,25 @@ minara withdraw                   # Interactive mode (accepts ticker or address)
 
 | Command           | Description                        |
 | ----------------- | ---------------------------------- |
-| `minara swap`     | Swap tokens (cross-chain)          |
+| `minara swap`     | Swap tokens (chain auto-detected)  |
 | `minara transfer` | Transfer tokens to another address |
 
 ```bash
-minara swap                        # Interactive
-minara swap -c solana -s buy -t '$BONK' -a 100   # By ticker
-minara swap -c solana -s buy -t <address> -a 100  # By contract address
+minara swap                        # Interactive: side → token → amount
+minara swap -s buy -t '$BONK' -a 100              # Buy by ticker (chain auto-detected)
+minara swap -s sell -t '$NVDAx' -a all             # Sell entire balance
 minara swap --dry-run              # Simulate without executing
 ```
 
-> **Token input:** All token fields (`-t`) accept a `$TICKER` (e.g. `$BONK`), a token name, or a contract address. When multiple tokens match, you'll be prompted to select the correct one with full contract addresses displayed.
+> **Chain abstraction:** The chain is automatically detected from the token. If a token exists on multiple chains (e.g. USDC), you'll be prompted to pick one, sorted by gas cost (lowest first). Sell mode supports `all` to sell full balance, and caps amounts exceeding your balance.
+>
+> **Token input:** All token fields (`-t`) accept a `$TICKER` (e.g. `$BONK`), a token name, or a contract address.
 
 ### Perpetual Futures
 
 | Command                     | Description                               |
 | --------------------------- | ----------------------------------------- |
-| `minara perps deposit`      | Deposit USDC to Hyperliquid perps account |
+| `minara perps deposit`      | Deposit USDC to perps (or use `minara deposit perps`) |
 | `minara perps withdraw`     | Withdraw USDC from perps account          |
 | `minara perps positions`    | View all open positions                   |
 | `minara perps order`        | Place an order (interactive builder)      |
@@ -149,23 +155,6 @@ minara limit-order list            # Show all orders with status
 minara limit-order cancel abc123   # Cancel order by ID
 ```
 
-### Copy Trading
-
-| Command                         | Description                 |
-| ------------------------------- | --------------------------- |
-| `minara copy-trade create`      | Create a new copy-trade bot |
-| `minara copy-trade list`        | List all copy-trade bots    |
-| `minara copy-trade start <id>`  | Start a paused bot          |
-| `minara copy-trade stop <id>`   | Pause a running bot         |
-| `minara copy-trade delete <id>` | Delete a bot permanently    |
-
-```bash
-minara copy-trade create           # Interactive: target wallet, chain, amount, options
-minara copy-trade list             # Show all bots with status
-minara copy-trade start abc123     # Resume a paused bot
-minara copy-trade stop abc123      # Pause a running bot
-```
-
 ### AI Chat
 
 | Command                          | Description                                   |
@@ -279,12 +268,15 @@ All fund-related operations go through a multi-layer safety flow:
 4. Execute
 ```
 
-The **transaction confirmation** shows the token ticker, name, full contract address, and operation details before asking for final approval:
+The **transaction confirmation** shows chain, token, address, side, amount, and operation details before asking for final approval:
 
 ```
 ⚠ Transaction confirmation
+  Chain    : solana
   Token    : $BONK — Bonk
   Address  : DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
+  Side     : BUY
+  Amount   : 100 USD
   Action   : BUY swap · 100 USD · solana
 ? Are you sure you want to proceed? (y/N)
 ```
@@ -299,7 +291,7 @@ Minara CLI supports macOS Touch ID to protect all fund-related operations. When
 minara config                     # Select "Touch ID" to enable / disable
 ```
 
-**Protected operations:** `withdraw`, `transfer`, `swap`, `perps deposit`, `perps withdraw`, `perps order`, `limit-order create`, `copy-trade create`
+**Protected operations:** `withdraw`, `transfer`, `swap`, `deposit` (Spot→Perps transfer), `perps deposit`, `perps withdraw`, `perps order`, `limit-order create`
 
 > **Note:** Touch ID requires macOS with Touch ID hardware. The `--yes` flag skips the initial confirmation prompt but does **not** bypass transaction confirmation or Touch ID.
 

package/dist/api/perps.d.ts

@@ -11,8 +11,6 @@ export declare function cancelOrders(token: string, dto: PerpsCancelOrdersDto):
 export declare function modifyOrders(token: string, dto: PerpsCancelOrdersDto): Promise<import("../types.js").ApiResponse<TransactionResult>>;
 /** Update leverage */
 export declare function updateLeverage(token: string, dto: UpdateLeverageDto): Promise<import("../types.js").ApiResponse<void>>;
-/** Get perps account state (balance, equity, margin) */
-export declare function getAccountState(token: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
 /** Get all positions */
 export declare function getPositions(token: string): Promise<import("../types.js").ApiResponse<PerpsPosition[]>>;
 /** Get completed trades */
@@ -23,6 +21,8 @@ export declare function getTokenPrices(token: string): Promise<import("../types.
 export declare function getFundRecords(token: string, page: number, limit: number): Promise<import("../types.js").ApiResponse<Record<string, unknown>[]>>;
 /** Get equity history chart */
 export declare function getEquityHistory(token: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
+/** Get perps account summary (balance, equity, positions, PnL) */
+export declare function getAccountSummary(token: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
 /** Get all decisions */
 export declare function getDecisions(token: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>[]>>;
 /** Claim rewards */

package/dist/api/perps.js

@@ -23,10 +23,6 @@ export function modifyOrders(token, dto) {
 export function updateLeverage(token, dto) {
     return post('/v1/tx/perps/update-leverage', { token, body: dto });
 }
-/** Get perps account state (balance, equity, margin) */
-export function getAccountState(token) {
-    return get('/v1/tx/perps/account-state', { token });
-}
 /** Get all positions */
 export function getPositions(token) {
     return get('/v1/tx/perps/positions/all', { token });
@@ -47,6 +43,10 @@ export function getFundRecords(token, page, limit) {
 export function getEquityHistory(token) {
     return get('/v1/tx/perps/equity-history-chart/all', { token });
 }
+/** Get perps account summary (balance, equity, positions, PnL) */
+export function getAccountSummary(token) {
+    return get('/v1/fully-managed/account-summary', { token });
+}
 /** Get all decisions */
 export function getDecisions(token) {
     return get('/v1/tx/perps/decisions/all', { token });

package/dist/commands/assets.js

@@ -1,11 +1,10 @@
 import { Command } from 'commander';
-import { select } from '@inquirer/prompts';
 import chalk from 'chalk';
-import { getAssets } from '../api/crosschain.js';
 import * as perpsApi from '../api/perps.js';
+import { get } from '../api/client.js';
 import { requireAuth } from '../config.js';
-import { spinner, unwrapApi, wrapAction } from '../utils.js';
-import { printKV, printTable, ASSET_COLUMNS, POSITION_COLUMNS } from '../formatters.js';
+import { spinner, wrapAction } from '../utils.js';
+import { printTable, SPOT_COLUMNS, POSITION_COLUMNS } from '../formatters.js';
 // ─── spot ────────────────────────────────────────────────────────────────
 const spotCmd = new Command('spot')
     .description('View spot wallet assets across chains')
@@ -13,22 +12,62 @@ const spotCmd = new Command('spot')
     const creds = requireAuth();
     await showSpotAssets(creds.accessToken);
 }));
+const MIN_DISPLAY_VALUE = 0.01;
 async function showSpotAssets(token) {
     const spin = spinner('Fetching spot assets…');
-    const res = await getAssets(token);
+    const res = await get('/users/pnls/all', { token });
     spin.stop();
-    const data = unwrapApi(res, 'Failed to fetch spot assets');
-    if (Array.isArray(data) && data.length === 0) {
-        console.log(chalk.dim('No spot assets found.'));
+    if (!res.success || !res.data) {
+        console.log('');
+        console.log(chalk.bold('Spot Wallet Assets:'));
+        console.log(chalk.dim('  Could not fetch spot assets.'));
+        if (res.error?.message)
+            console.log(chalk.dim(`  ${res.error.message}`));
+        console.log('');
         return;
     }
+    const all = res.data;
+    const holdings = [];
+    let totalValue = 0;
+    let totalRealizedPnl = 0;
+    let totalUnrealizedPnl = 0;
+    let hasUnrealizedPnl = false;
+    for (const t of all) {
+        const bal = Number(t.balance ?? 0);
+        const price = Number(t.marketPrice ?? 0);
+        const apiVal = Number(t.portfolioValue ?? 0);
+        const value = apiVal > 0 ? apiVal : bal * price;
+        const uPnl = Number(t.unrealizedPnl ?? 0);
+        const rPnl = Number(t.realizedPnl ?? 0);
+        totalValue += value;
+        totalRealizedPnl += rPnl;
+        if (uPnl !== 0) {
+            totalUnrealizedPnl += uPnl;
+            hasUnrealizedPnl = true;
+        }
+        if (bal > 0 && value >= MIN_DISPLAY_VALUE) {
+            holdings.push({ ...t, _value: value });
+        }
+    }
+    const fmt = (n) => `$${n.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+    const pnlFmt = (n) => {
+        if (n === 0)
+            return chalk.dim('$0.00');
+        const color = n >= 0 ? chalk.green : chalk.red;
+        return color(`${n >= 0 ? '+' : ''}${fmt(n)}`);
+    };
     console.log('');
-    console.log(chalk.bold('Spot Wallet Assets:'));
-    if (Array.isArray(data)) {
-        printTable(data, ASSET_COLUMNS);
+    console.log(chalk.bold('Spot Wallet:'));
+    console.log(`  Portfolio Value : ${fmt(totalValue)}`);
+    console.log(`  Unrealized PnL  : ${pnlFmt(totalUnrealizedPnl)}`);
+    console.log(`  Realized PnL    : ${pnlFmt(totalRealizedPnl)}`);
+    console.log('');
+    console.log(chalk.bold(`Holdings (${holdings.length}):`));
+    if (holdings.length === 0) {
+        console.log(chalk.dim('  No spot assets with balance.'));
     }
     else {
-        printKV(data);
+        printTable(holdings, SPOT_COLUMNS);
     }
     console.log('');
 }
@@ -40,42 +79,38 @@ const perpsCmd = new Command('perps')
     await showPerpsAssets(creds.accessToken);
 }));
 async function showPerpsAssets(token) {
-    // Fetch account state and positions in parallel
     const spin = spinner('Fetching perps account…');
-    const [accountRes, positionsRes] = await Promise.all([
-        perpsApi.getAccountState(token),
-        perpsApi.getPositions(token),
-    ]);
+    const res = await perpsApi.getAccountSummary(token);
     spin.stop();
-    // ── Account state ───────────────────────────────────────────────────
+    if (!res.success || !res.data) {
+        console.log(chalk.dim('  Could not fetch perps account.'));
+        if (res.error?.message)
+            console.log(chalk.dim(`  ${res.error.message}`));
+        return;
+    }
+    const d = res.data;
+    const fmt = (n) => `$${n.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+    const pnlFmt = (n) => {
+        const color = n >= 0 ? chalk.green : chalk.red;
+        return color(`${n >= 0 ? '+' : ''}${fmt(n)}`);
+    };
+    // ── Account overview ───────────────────────────────────────────────
     console.log('');
     console.log(chalk.bold('Perps Account:'));
-    if (accountRes.success && accountRes.data) {
-        printKV(accountRes.data);
-    }
-    else {
-        console.log(chalk.dim('  Could not fetch account state.'));
-        if (accountRes.error?.message) {
-            console.log(chalk.dim(`  ${accountRes.error.message}`));
-        }
-    }
+    console.log(`  Equity        : ${fmt(Number(d.equityValue ?? 0))}`);
+    console.log(`  Available     : ${fmt(Number(d.dispatchableValue ?? 0))}`);
+    console.log(`  Margin Used   : ${fmt(Number(d.totalMarginUsed ?? 0))}`);
+    console.log(`  Unrealized PnL: ${pnlFmt(Number(d.totalUnrealizedPnl ?? 0))}`);
+    console.log(`  Withdrawable  : ${fmt(Number(d.withdrawableValue ?? 0))}`);
     // ── Positions ───────────────────────────────────────────────────────
+    const positions = Array.isArray(d.positions) ? d.positions : [];
     console.log('');
-    console.log(chalk.bold('Open Positions:'));
-    if (!positionsRes.success) {
-        console.log(chalk.dim('  Could not fetch positions.'));
-        if (positionsRes.error?.message) {
-            console.log(chalk.dim(`  ${positionsRes.error.message}`));
-        }
+    console.log(chalk.bold(`Open Positions (${positions.length}):`));
+    if (positions.length === 0) {
+        console.log(chalk.dim('  No open positions.'));
     }
     else {
-        const positions = positionsRes.data;
-        if (!positions || (Array.isArray(positions) && positions.length === 0)) {
-            console.log(chalk.dim('  No open positions.'));
-        }
-        else {
-            printTable(positions, POSITION_COLUMNS);
-        }
+        printTable(positions, POSITION_COLUMNS);
     }
     console.log('');
 }
@@ -85,19 +120,7 @@ export const assetsCommand = new Command('assets')
     .addCommand(spotCmd)
     .addCommand(perpsCmd)
     .action(wrapAction(async () => {
-    const action = await select({
-        message: 'View assets:',
-        choices: [
-            { name: 'Spot wallet', value: 'spot' },
-            { name: 'Perps account', value: 'perps' },
-            { name: 'Both', value: 'both' },
-        ],
-    });
     const creds = requireAuth();
-    if (action === 'spot' || action === 'both') {
-        await showSpotAssets(creds.accessToken);
-    }
-    if (action === 'perps' || action === 'both') {
-        await showPerpsAssets(creds.accessToken);
-    }
+    await showSpotAssets(creds.accessToken);
+    await showPerpsAssets(creds.accessToken);
 }));

package/dist/commands/balance.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const balanceCommand: Command;

package/dist/commands/balance.js

@@ -0,0 +1,43 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { get } from '../api/client.js';
+import * as perpsApi from '../api/perps.js';
+import { requireAuth } from '../config.js';
+import { spinner, wrapAction } from '../utils.js';
+const STABLES = new Set(['usdc', 'usdt']);
+export const balanceCommand = new Command('balance')
+    .description('Show combined USDC / USDT balance across spot and perps')
+    .action(wrapAction(async () => {
+    const creds = requireAuth();
+    const spin = spinner('Fetching balances…');
+    const [spotRes, perpsRes] = await Promise.all([
+        get('/users/pnls/all', { token: creds.accessToken }),
+        perpsApi.getAccountSummary(creds.accessToken),
+    ]);
+    spin.stop();
+    const fmt = (n) => `$${n.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+    let spotStable = 0;
+    if (spotRes.success && Array.isArray(spotRes.data)) {
+        for (const t of spotRes.data) {
+            const sym = String(t.tokenSymbol ?? '').toLowerCase();
+            if (STABLES.has(sym)) {
+                const bal = Number(t.balance ?? 0);
+                const price = Number(t.marketPrice ?? 1);
+                spotStable += bal * price;
+            }
+        }
+    }
+    let perpsAvailable = 0;
+    if (perpsRes.success && perpsRes.data) {
+        const d = perpsRes.data;
+        perpsAvailable = Number(d.dispatchableValue ?? 0);
+    }
+    const total = spotStable + perpsAvailable;
+    console.log('');
+    console.log(chalk.bold('Balance:'));
+    console.log(`  Spot  (USDC/USDT) : ${fmt(spotStable)}`);
+    console.log(`  Perps (available) : ${fmt(perpsAvailable)}`);
+    console.log(`  ${'─'.repeat(30)}`);
+    console.log(`  Total             : ${chalk.bold(fmt(total))}`);
+    console.log('');
+}));

package/dist/commands/deposit.js

@@ -1,83 +1,154 @@
 import { Command } from 'commander';
-import { select } from '@inquirer/prompts';
+import { select, confirm, number as numberPrompt } from '@inquirer/prompts';
 import chalk from 'chalk';
-import Table from 'cli-table3';
-import { getCurrentUser } from '../api/auth.js';
 import { getAccount } from '../api/crosschain.js';
+import { getCurrentUser } from '../api/auth.js';
+import * as perpsApi from '../api/perps.js';
 import { requireAuth } from '../config.js';
-import { info, spinner, unwrapApi, wrapAction } from '../utils.js';
-import { printKV } from '../formatters.js';
-/**
- * Map wallet type keys from /auth/me → human-readable chain info.
- */
-function describeWalletType(key) {
-    const lower = key.toLowerCase();
-    if (lower.includes('evm') || lower === 'spot-evm' || lower === 'abstraction-evm') {
-        return {
-            network: 'EVM',
-            chains: ['Ethereum', 'Base', 'Arbitrum', 'Optimism', 'Polygon', 'Avalanche', 'BSC', 'Berachain', 'Blast'],
-        };
-    }
-    if (lower.includes('solana')) {
-        return { network: 'Solana', chains: ['Solana'] };
-    }
-    return { network: key, chains: [key] };
-}
-export const depositCommand = new Command('deposit')
-    .description('Show your deposit addresses and supported networks')
+import { info, success, spinner, assertApiOk, wrapAction, requireTransactionConfirmation } from '../utils.js';
+import { requireTouchId } from '../touchid.js';
+import { printTxResult } from '../formatters.js';
+const EVM_CHAINS = 'Ethereum, Base, Arbitrum, Optimism, Polygon, Avalanche, BSC, Berachain, Blast';
+// ─── spot ────────────────────────────────────────────────────────────────
+const spotCmd = new Command('spot')
+    .description('Show spot wallet deposit addresses')
     .action(wrapAction(async () => {
     const creds = requireAuth();
+    await showSpotDeposit(creds.accessToken);
+}));
+async function showSpotDeposit(token) {
     const spin = spinner('Fetching deposit addresses…');
-    const [userRes, accountRes] = await Promise.all([
-        getCurrentUser(creds.accessToken),
-        getAccount(creds.accessToken),
-    ]);
+    const res = await getAccount(token);
     spin.stop();
-    const user = unwrapApi(userRes, 'Failed to fetch account info');
-    const wallets = user.wallets;
-    if (!wallets || Object.keys(wallets).length === 0) {
-        info('No wallet addresses found. Your account may not have been fully initialized.');
-        info('Try logging in at https://minara.ai first, then run this command again.');
+    if (!res.success || !res.data) {
+        info('Could not fetch deposit addresses. Try logging in at https://minara.ai first.');
+        return;
+    }
+    const data = res.data;
+    const evmAddr = data.evmAddress;
+    const solAddr = data.solanaAddress;
+    if (!evmAddr && !solAddr) {
+        info('No deposit addresses found. Your account may not have been fully initialized.');
         return;
     }
     console.log('');
-    console.log(chalk.bold('Deposit Addresses'));
+    console.log(chalk.bold('Spot Deposit Addresses'));
     console.log(chalk.dim('Send tokens to the addresses below. Make sure to use the correct network!'));
     console.log('');
-    const table = new Table({
-        head: [chalk.white('Network'), chalk.white('Address'), chalk.white('Supported Chains')],
-        colWidths: [14, 48, 40],
-        wordWrap: true,
-    });
-    const seen = new Set();
-    for (const [walletType, address] of Object.entries(wallets)) {
-        if (!address || seen.has(address))
-            continue;
-        seen.add(address);
-        const { network, chains } = describeWalletType(walletType);
-        table.push([chalk.cyan.bold(network), chalk.yellow(address), chains.join(', ')]);
+    if (solAddr) {
+        console.log(`  ${chalk.cyan.bold('Solana')}`);
+        console.log(`    Address : ${chalk.yellow(solAddr)}`);
+        console.log(`    Chains  : Solana`);
+        console.log('');
+    }
+    if (evmAddr) {
+        console.log(`  ${chalk.cyan.bold('EVM')}`);
+        console.log(`    Address : ${chalk.yellow(evmAddr)}`);
+        console.log(`    Chains  : ${EVM_CHAINS}`);
+        console.log('');
     }
-    console.log(table.toString());
-    console.log('');
     console.log(chalk.red.bold('Important:'));
     console.log(chalk.red('  • Only send tokens on the supported chains listed above.'));
     console.log(chalk.red('  • Sending tokens on the wrong network may result in permanent loss.'));
-    console.log(chalk.red('  • EVM address supports all EVM-compatible chains (Ethereum, Base, Arbitrum, etc.)'));
     console.log('');
-    if (accountRes.success && accountRes.data) {
-        const wantDetails = await select({
-            message: 'Would you like to see detailed account info?',
-            choices: [
-                { name: 'Yes', value: true },
-                { name: 'No', value: false },
-            ],
-            default: false,
-        });
-        if (wantDetails) {
-            console.log('');
-            console.log(chalk.bold('Account Details:'));
-            printKV(accountRes.data);
-            console.log('');
-        }
+}
+// ─── perps ───────────────────────────────────────────────────────────────
+const perpsCmd = new Command('perps')
+    .description('Deposit USDC to perps account')
+    .option('-a, --amount <amount>', 'USDC amount (for transfer)')
+    .option('-y, --yes', 'Skip confirmation')
+    .action(wrapAction(async (opts) => {
+    const creds = requireAuth();
+    await perpsDepositFlow(creds.accessToken, opts);
+}));
+async function perpsDepositFlow(token, opts) {
+    const method = await select({
+        message: 'How would you like to deposit to perps?',
+        choices: [
+            { name: 'Show perps deposit address (for external transfers)', value: 'address' },
+            { name: `${chalk.bold('Transfer from Spot wallet → Perps wallet')} (internal)`, value: 'transfer' },
+        ],
+    });
+    if (method === 'address') {
+        await showPerpsDepositAddresses(token);
+    }
+    else {
+        await transferSpotToPerps(token, opts);
+    }
+}
+async function showPerpsDepositAddresses(token) {
+    const spin = spinner('Fetching perps deposit addresses…');
+    const res = await getCurrentUser(token);
+    spin.stop();
+    if (!res.success || !res.data) {
+        info('Could not fetch perps addresses. Try logging in at https://minara.ai first.');
+        return;
+    }
+    const wallets = res.data.wallets ?? {};
+    const perpsEvm = wallets['perpetual-evm'];
+    if (!perpsEvm) {
+        info('No perps deposit address found. Your perps account may not have been initialized yet.');
+        return;
+    }
+    console.log('');
+    console.log(chalk.bold('Perps Deposit Address'));
+    console.log(chalk.dim('Send USDC to the address below to fund your perps account directly.'));
+    console.log('');
+    console.log(`  ${chalk.cyan.bold('EVM (Arbitrum)')}`);
+    console.log(`    Address : ${chalk.yellow(perpsEvm)}`);
+    console.log('');
+    console.log(chalk.red.bold('Important:'));
+    console.log(chalk.red('  • Only send USDC on Arbitrum to this address.'));
+    console.log(chalk.red('  • Sending other tokens or using the wrong network may result in permanent loss.'));
+    console.log('');
+}
+async function transferSpotToPerps(token, opts) {
+    console.log('');
+    console.log(chalk.yellow.bold('⚠  This will transfer USDC from your Spot wallet to your Perps wallet.'));
+    console.log('');
+    const amount = opts?.amount
+        ? parseFloat(opts.amount)
+        : await numberPrompt({ message: 'USDC amount to transfer from Spot → Perps (min 5):', min: 5, required: true });
+    if (!amount || amount < 5) {
+        console.error(chalk.red('✖'), 'Minimum deposit is 5 USDC');
+        process.exit(1);
+    }
+    console.log(`\n  Transfer : ${chalk.bold(amount)} USDC  ${chalk.dim('Spot wallet')} → ${chalk.cyan('Perps wallet')}\n`);
+    if (!opts?.yes) {
+        const ok = await confirm({ message: 'Confirm transfer from Spot to Perps?', default: true });
+        if (!ok)
+            return;
+    }
+    await requireTransactionConfirmation(`Transfer ${amount} USDC from Spot → Perps`, undefined, {
+        amount: `${amount} USDC`,
+        side: 'Spot → Perps',
+    });
+    await requireTouchId();
+    const spin = spinner('Transferring…');
+    const res = await perpsApi.deposit(token, { usdcAmount: amount });
+    spin.stop();
+    assertApiOk(res, 'Transfer failed');
+    success(`Transferred ${amount} USDC from Spot wallet to Perps wallet`);
+    printTxResult(res.data);
+}
+// ─── parent ──────────────────────────────────────────────────────────────
+export const depositCommand = new Command('deposit')
+    .description('Deposit to spot wallet or perps account')
+    .addCommand(spotCmd)
+    .addCommand(perpsCmd)
+    .action(wrapAction(async () => {
+    const action = await select({
+        message: 'Deposit to:',
+        choices: [
+            { name: 'Spot wallet — view deposit addresses', value: 'spot' },
+            { name: 'Perps wallet — view deposit address or transfer from Spot', value: 'perps' },
+        ],
+    });
+    const creds = requireAuth();
+    if (action === 'spot') {
+        await showSpotDeposit(creds.accessToken);
+    }
+    else {
+        await perpsDepositFlow(creds.accessToken);
     }
 }));

package/dist/commands/limit-order.js

@@ -54,7 +54,7 @@ const createCmd = new Command('create')
         if (!ok)
             return;
     }
-    await requireTransactionConfirmation(`Limit ${side} · $${amount} · price ${priceCondition} $${targetPrice} · ${chain}`, tokenInfo);
+    await requireTransactionConfirmation(`Limit ${side} · $${amount} · price ${priceCondition} $${targetPrice} · ${chain}`, tokenInfo, { chain, side, amount: `$${amount}` });
     await requireTouchId();
     const spin = spinner('Creating limit order…');
     const res = await loApi.createLimitOrder(creds.accessToken, {

package/dist/commands/premium.js

@@ -124,6 +124,7 @@ const statusCmd = new Command('status')
     spin.stop();
     assertApiOk(userRes, 'Failed to fetch account info');
     const user = userRes.data;
+    const plans = plansRes.success && plansRes.data ? plansRes.data.plans : [];
     if (isRawJson()) {
         console.log(JSON.stringify({
             subscription: user.subscription ?? null,
@@ -134,18 +135,37 @@ const statusCmd = new Command('status')
     console.log('');
     console.log(chalk.bold('Subscription Status:'));
     console.log('');
-    // Try to extract subscription info from various possible response shapes
     const sub = user.subscription;
     const userPlan = user.plan;
     if (sub && Object.keys(sub).length > 0) {
         const planName = sub.planName ?? sub.plan ?? sub.name ?? '—';
-        const status = sub.status ?? '—';
-        const interval = sub.interval ?? '—';
+        const planId = sub.planId ?? sub.id;
+        // Cross-reference with plans list for interval and credits
+        const matchedPlan = planId != null
+            ? plans.find((p) => p.id === Number(planId) || p._id === String(planId))
+            : plans.find((p) => p.name === planName);
+        const status = sub.status;
+        const interval = sub.interval ?? matchedPlan?.interval;
         const cancelAt = sub.cancelAtPeriodEnd;
         const periodEnd = sub.currentPeriodEnd;
         console.log(`  ${chalk.dim('Plan'.padEnd(16))} : ${chalk.bold(String(planName))}`);
-        console.log(`  ${chalk.dim('Status'.padEnd(16))} : ${status === 'active' ? chalk.green('Active') : chalk.yellow(String(status))}`);
-        console.log(`  ${chalk.dim('Billing'.padEnd(16))} : ${String(interval)}`);
+        if (status) {
+            console.log(`  ${chalk.dim('Status'.padEnd(16))} : ${status === 'active' ? chalk.green('Active') : chalk.yellow(status)}`);
+        }
+        else {
+            console.log(`  ${chalk.dim('Status'.padEnd(16))} : ${chalk.green('Active')}`);
+        }
+        if (interval) {
+            const label = interval === 'month' ? 'Monthly' : interval === 'year' ? 'Yearly' : String(interval);
+            console.log(`  ${chalk.dim('Billing'.padEnd(16))} : ${label}`);
+        }
+        if (matchedPlan) {
+            console.log(`  ${chalk.dim('Price'.padEnd(16))} : ${formatPrice(matchedPlan)}`);
+            const credits = formatCredits(matchedPlan.rules);
+            if (credits !== '—') {
+                console.log(`  ${chalk.dim('Credits'.padEnd(16))} : ${credits}`);
+            }
+        }
         if (periodEnd) {
             console.log(`  ${chalk.dim('Renews On'.padEnd(16))} : ${new Date(periodEnd).toLocaleDateString()}`);
         }
@@ -157,7 +177,6 @@ const statusCmd = new Command('status')
         printKV(userPlan);
     }
     else {
-        // No subscription info found — assume free plan
         console.log(`  ${chalk.dim('Plan'.padEnd(16))} : ${chalk.bold('Free')}`);
         console.log(`  ${chalk.dim('Status'.padEnd(16))} : ${chalk.green('Active')}`);
         console.log('');

package/dist/commands/swap.js

@@ -1,14 +1,14 @@
 import { Command } from 'commander';
 import { input, select, confirm } from '@inquirer/prompts';
 import chalk from 'chalk';
-import { swap, swapsSimulate } from '../api/crosschain.js';
+import { swaps, swapsSimulate } from '../api/crosschain.js';
+import { get } from '../api/client.js';
 import { requireAuth } from '../config.js';
-import { success, info, spinner, formatOrderSide, assertApiOk, selectChain, wrapAction, requireTransactionConfirmation, lookupToken, formatTokenLabel } from '../utils.js';
+import { success, info, warn, spinner, formatOrderSide, assertApiOk, wrapAction, requireTransactionConfirmation, lookupToken, formatTokenLabel, normalizeChain } 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|ticker>', 'Token contract address or ticker symbol')
     .option('-a, --amount <amount>', 'USD amount (buy) or token amount (sell)')
@@ -16,9 +16,7 @@ export const swapCommand = new Command('swap')
     .option('--dry-run', 'Simulate without executing')
     .action(wrapAction(async (opts) => {
     const creds = requireAuth();
-    // ── 1. Chain ─────────────────────────────────────────────────────────
-    const chain = opts.chain ?? await selectChain();
-    // ── 2. Side ──────────────────────────────────────────────────────────
+    // ── 1. Side ──────────────────────────────────────────────────────────
     let side = opts.side;
     if (!side) {
         side = await select({
@@ -29,21 +27,59 @@ export const swapCommand = new Command('swap')
             ],
         });
     }
-    // ── 3. Token ───────────────────────────────────────────────────────────
+    // ── 2. 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);
+    // ── 3. Chain (derived from token) ────────────────────────────────────
+    const chain = normalizeChain(tokenInfo.chain);
+    if (!chain) {
+        warn(`Unable to determine chain for token. Raw chain value: ${tokenInfo.chain ?? 'unknown'}`);
+        return;
+    }
     // ── 4. Amount ────────────────────────────────────────────────────────
-    const amountLabel = side === 'buy' ? 'USD amount to spend' : 'Token amount to sell';
-    const amount = opts.amount ?? await input({
+    let maxBalance;
+    if (side === 'sell') {
+        const pnlRes = await get('/users/pnls/all', { token: creds.accessToken });
+        if (pnlRes.success && Array.isArray(pnlRes.data)) {
+            const match = pnlRes.data.find((t) => {
+                const addr = String(t.tokenAddress ?? '').toLowerCase();
+                const cid = String(t.chainId ?? '').toLowerCase();
+                const targetChain = chain.toLowerCase();
+                return addr === tokenInfo.address.toLowerCase() && cid === targetChain;
+            });
+            if (match) {
+                maxBalance = Number(match.balance ?? 0);
+                info(`Available balance: ${chalk.bold(String(maxBalance))} ${tokenInfo.symbol ?? ''}`);
+            }
+        }
+    }
+    const amountLabel = side === 'buy' ? 'USD amount to spend' : `Token amount to sell${maxBalance ? ' ("all" for max)' : ''}`;
+    let amount = opts.amount ?? await input({
         message: `${amountLabel}:`,
         validate: (v) => {
+            if (side === 'sell' && v.toLowerCase() === 'all')
+                return true;
             const n = parseFloat(v);
             return (isNaN(n) || n <= 0) ? 'Enter a valid positive number' : true;
         },
     });
+    if (side === 'sell') {
+        if (amount.toLowerCase() === 'all') {
+            if (!maxBalance || maxBalance <= 0) {
+                warn('Could not determine balance. Please enter an amount manually.');
+                return;
+            }
+            amount = String(maxBalance);
+            info(`Selling all: ${chalk.bold(amount)} ${tokenInfo.symbol ?? ''}`);
+        }
+        else if (maxBalance && parseFloat(amount) > maxBalance) {
+            info(`Amount exceeds balance (${maxBalance}), using max balance`);
+            amount = String(maxBalance);
+        }
+    }
     // ── 5. Summary ───────────────────────────────────────────────────────
     console.log('');
     console.log(chalk.bold('Swap Summary:'));
@@ -87,15 +123,21 @@ export const swapCommand = new Command('swap')
         }
     }
     // ── 8. Transaction confirmation & Touch ID ────────────────────────────
-    await requireTransactionConfirmation(`${side.toUpperCase()} swap · ${amount} ${side === 'buy' ? 'USD' : 'tokens'} · ${chain}`, tokenInfo);
+    await requireTransactionConfirmation(`${side.toUpperCase()} swap · ${amount} ${side === 'buy' ? 'USD' : 'tokens'} · ${chain}`, tokenInfo, { chain, side, amount: `${amount} ${side === 'buy' ? 'USD' : '(token)'}` });
     await requireTouchId();
     // ── 9. Execute ───────────────────────────────────────────────────────
     const spin = spinner('Executing swap…');
-    const res = await swap(creds.accessToken, {
-        chain, side, tokenAddress: tokenInfo.address, buyUsdAmountOrSellTokenAmount: amount,
-    });
+    const res = await swaps(creds.accessToken, [{
+            chain, side, tokenAddress: tokenInfo.address, buyUsdAmountOrSellTokenAmount: amount,
+        }]);
     spin.stop();
     assertApiOk(res, 'Swap failed');
     success('Swap submitted!');
-    printTxResult(res.data);
+    if (Array.isArray(res.data)) {
+        for (const tx of res.data)
+            printTxResult(tx);
+    }
+    else {
+        printTxResult(res.data);
+    }
 }));

package/dist/commands/transfer.js

@@ -54,7 +54,7 @@ export const transferCommand = new Command('transfer')
         }
     }
     // ── 6. Transaction confirmation & Touch ID ────────────────────────────
-    await requireTransactionConfirmation(`Transfer ${amount} tokens → ${recipient} · ${chain}`, tokenInfo);
+    await requireTransactionConfirmation(`Transfer ${amount} tokens → ${recipient} · ${chain}`, tokenInfo, { chain, amount });
     await requireTouchId();
     // ── 7. Execute ───────────────────────────────────────────────────────
     const spin = spinner('Processing transfer…');

package/dist/commands/withdraw.js

@@ -82,7 +82,7 @@ export const withdrawCommand = new Command('withdraw')
         }
     }
     // ── 7. Transaction confirmation & Touch ID ────────────────────────────
-    await requireTransactionConfirmation(`Withdraw ${amount} tokens → ${recipient} · ${chain}`, tokenInfo);
+    await requireTransactionConfirmation(`Withdraw ${amount} tokens → ${recipient} · ${chain}`, tokenInfo, { chain, amount });
     await requireTouchId();
     // ── 8. Execute ───────────────────────────────────────────────────────
     const spin = spinner('Processing withdrawal…');

package/dist/formatters.d.ts

@@ -37,13 +37,11 @@ export declare function printTable(data: Record<string, unknown>[] | object[], c
  */
 export declare function printTxResult(data: unknown): void;
 /** Spot wallet assets (WalletAsset[]) */
-export declare const ASSET_COLUMNS: ColumnDef[];
-/** Perps positions (PerpsPosition[]) */
+export declare const SPOT_COLUMNS: ColumnDef[];
+/** Perps positions — API uses snake_case field names */
 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[];
 /**

package/dist/formatters.js

@@ -55,6 +55,9 @@ export function formatValue(value, key) {
         return value.toLocaleString('en-US', { maximumFractionDigits: 6 });
     }
     if (typeof value === 'string') {
+        // Hex addresses — must check before numeric coercion (0x… is valid Number)
+        if (/^0x[0-9a-fA-F]{20,}$/.test(value))
+            return chalk.yellow(value);
         // Numeric string that looks like a price / amount
         const num = Number(value);
         if (!isNaN(num) && value.trim() !== '') {
@@ -64,9 +67,6 @@ export function formatValue(value, key) {
         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);
@@ -171,10 +171,14 @@ export function printTable(data, columns) {
         console.log(JSON.stringify(data, null, 2));
         return;
     }
-    if (!data || data.length === 0) {
+    if (!data || (Array.isArray(data) && data.length === 0)) {
         console.log(chalk.dim('  No data.'));
         return;
     }
+    if (!Array.isArray(data)) {
+        printKV(data);
+        return;
+    }
     const rows = data;
     const cols = columns ?? autoColumns(rows);
     if (cols.length === 0) {
@@ -228,14 +232,27 @@ export function printTxResult(data) {
 //  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('—') },
+export const SPOT_COLUMNS = [
+    { key: 'tokenSymbol', label: 'Token', format: (v) => chalk.bold(String(v ?? '—')) },
+    { key: 'chainId', label: 'Chain', format: (v) => {
+            const s = String(v ?? '—');
+            return chalk.cyan(s.charAt(0).toUpperCase() + s.slice(1));
+        } },
+    { key: 'balance', label: 'Balance' },
+    { key: 'marketPrice', label: 'Price', format: (v) => v ? `$${Number(v).toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 6 })}` : chalk.dim('—') },
+    { key: '_value', label: 'Value', format: (v) => {
+            const n = Number(v ?? 0);
+            return n > 0 ? `$${n.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}` : chalk.dim('—');
+        } },
+    { key: 'unrealizedPnl', label: 'PnL', format: (v) => {
+            const n = Number(v ?? 0);
+            if (n === 0)
+                return chalk.dim('—');
+            const color = n >= 0 ? chalk.green : chalk.red;
+            return color(`${n >= 0 ? '+' : ''}$${n.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`);
+        } },
 ];
-/** Perps positions (PerpsPosition[]) */
+/** Perps positions — API uses snake_case field names */
 export const POSITION_COLUMNS = [
     { key: 'symbol', label: 'Symbol', format: (v) => chalk.bold(String(v ?? '—')) },
     { key: 'side', label: 'Side', format: (v) => {
@@ -244,8 +261,8 @@ export const POSITION_COLUMNS = [
         } },
     { 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) => {
+    { key: 'positionValue', label: 'Value', format: (v) => formatValue(v, 'price') },
+    { key: 'unrealizedPnl', label: 'PnL', format: (v) => {
             if (!v && v !== 0)
                 return chalk.dim('—');
             const n = Number(v);
@@ -253,6 +270,7 @@ export const POSITION_COLUMNS = [
             return color(`${n >= 0 ? '+' : ''}$${n.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`);
         } },
     { key: 'leverage', label: 'Lev', format: (v) => v ? `${v}x` : chalk.dim('—') },
+    { key: 'marginUsed', label: 'Margin', format: (v) => formatValue(v, 'price') },
 ];
 /** Limit orders (LimitOrderInfo[]) */
 export const LIMIT_ORDER_COLUMNS = [
@@ -267,16 +285,6 @@ export const LIMIT_ORDER_COLUMNS = [
     { 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)

package/dist/index.js

@@ -8,13 +8,13 @@ const { version } = require('../package.json');
 import { logoutCommand } from './commands/logout.js';
 import { accountCommand } from './commands/account.js';
 import { assetsCommand } from './commands/assets.js';
+import { balanceCommand } from './commands/balance.js';
 import { depositCommand } from './commands/deposit.js';
 import { withdrawCommand } from './commands/withdraw.js';
 import { swapCommand } from './commands/swap.js';
 import { transferCommand } from './commands/transfer.js';
 import { perpsCommand } from './commands/perps.js';
 import { limitOrderCommand } from './commands/limit-order.js';
-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';
@@ -27,7 +27,7 @@ program
     .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, and chat with Minara AI.')
     .hook('preAction', (thisCommand) => {
     const opts = thisCommand.optsWithGlobals();
     if (opts.json)
@@ -38,6 +38,7 @@ program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
 program.addCommand(accountCommand);
 // ── Wallet & Funds ───────────────────────────────────────────────────────
+program.addCommand(balanceCommand);
 program.addCommand(assetsCommand);
 program.addCommand(depositCommand);
 program.addCommand(withdrawCommand);
@@ -48,7 +49,6 @@ program.addCommand(transferCommand);
 program.addCommand(perpsCommand);
 // ── Bots ─────────────────────────────────────────────────────────────────
 program.addCommand(limitOrderCommand);
-program.addCommand(copyTradeCommand);
 // ── AI Chat ──────────────────────────────────────────────────────────────
 program.addCommand(chatCommand);
 // ── Market ───────────────────────────────────────────────────────────────

package/dist/types.d.ts

@@ -256,41 +256,6 @@ export interface UpdateLimitOrderDto {
     targetPrice?: number;
     expiredAt?: number;
 }
-export interface CreateCopyTradeDto {
-    targetAddress: string;
-    chain: string;
-    name?: string;
-    mode?: 'fixedAmount';
-    copySell?: boolean;
-    copySellSamePercentage?: boolean;
-    copySellQuitPercentage?: number;
-    fixedAmount?: number;
-    status?: 'running' | 'paused';
-    expiredAt?: number;
-}
-export interface CopyTradeInfo {
-    id: string;
-    name?: string;
-    targetAddress: string;
-    chain: string;
-    mode?: string;
-    fixedAmount?: number;
-    copySell?: boolean;
-    status?: string;
-    createdAt?: string;
-}
-export interface UpdateCopyTradeDto {
-    chain: string;
-    name?: string;
-    mode?: 'fixedAmount';
-    copySell?: boolean;
-    copySellSamePercentage?: boolean;
-    copySellQuitPercentage?: number;
-    fixedAmount?: number;
-    targetAddress?: string;
-    status?: 'running' | 'paused';
-    expiredAt?: number;
-}
 export interface UserTradeConfig {
     slippage?: string;
     priorityFee?: string;

package/dist/utils.d.ts

@@ -34,7 +34,13 @@ export interface TokenDisplayInfo {
     symbol?: string;
     name?: string;
     address: string;
+    chain?: string;
 }
+/**
+ * Normalize a chain identifier from the token search API to a supported
+ * `Chain` value used by the swap / transfer APIs.
+ */
+export declare function normalizeChain(raw?: string): Chain | undefined;
 /**
  * Look up token metadata by address, ticker, or name.
  *
@@ -63,6 +69,10 @@ export declare function formatTokenLabel(token: TokenDisplayInfo): string;
  *
  * Exits the process if the user declines.
  */
-export declare function requireTransactionConfirmation(description: string, token?: TokenDisplayInfo): Promise<void>;
+export declare function requireTransactionConfirmation(description: string, token?: TokenDisplayInfo, details?: {
+    chain?: string;
+    side?: string;
+    amount?: string;
+}): Promise<void>;
 /** Open a URL in the user's default browser (cross-platform). */
 export declare function openBrowser(url: string): void;

package/dist/utils.js

@@ -115,6 +115,83 @@ export function wrapAction(fn) {
         }
     };
 }
+const NATIVE_TOKEN_ADDRESS = {
+    sol: 'So11111111111111111111111111111111111111112',
+    solana: 'So11111111111111111111111111111111111111112',
+};
+const EVM_NATIVE = '0x' + '0'.repeat(40);
+function resolveNativeAddress(chain) {
+    if (!chain)
+        return EVM_NATIVE;
+    return NATIVE_TOKEN_ADDRESS[chain.toLowerCase()] ?? EVM_NATIVE;
+}
+const CHAIN_ALIAS = {
+    sol: 'solana',
+    eth: 'ethereum',
+    arb: 'arbitrum',
+    op: 'optimism',
+    matic: 'polygon',
+    poly: 'polygon',
+    avax: 'avalanche',
+    bnb: 'bsc',
+    bera: 'berachain',
+    // Numeric chain IDs returned by the token search API
+    '101': 'solana',
+    '1': 'ethereum',
+    '8453': 'base',
+    '42161': 'arbitrum',
+    '10': 'optimism',
+    '56': 'bsc',
+    '137': 'polygon',
+    '43114': 'avalanche',
+    '81457': 'blast',
+    '169': 'manta',
+    '34443': 'mode',
+    '146': 'sonic',
+    '80094': 'berachain',
+    '196': 'xlayer',
+    '4200': 'merlin',
+};
+/**
+ * Normalize a chain identifier from the token search API to a supported
+ * `Chain` value used by the swap / transfer APIs.
+ */
+export function normalizeChain(raw) {
+    if (!raw)
+        return undefined;
+    const lower = raw.toLowerCase();
+    if (SUPPORTED_CHAINS.includes(lower))
+        return lower;
+    return CHAIN_ALIAS[lower];
+}
+/** Capitalize chain name for display (e.g. "solana" → "Solana", "bsc" → "BSC"). */
+function displayChain(raw) {
+    const name = normalizeChain(raw) ?? raw ?? 'unknown';
+    if (name === 'bsc')
+        return 'BSC';
+    return name.charAt(0).toUpperCase() + name.slice(1);
+}
+/** Lower = cheaper gas. Used to sort chain choices so the cheapest is first. */
+const CHAIN_GAS_RANK = {
+    sol: 1, solana: 1, '101': 1,
+    base: 2, '8453': 2,
+    arbitrum: 3, arb: 3, '42161': 3,
+    optimism: 4, op: 4, '10': 4,
+    bsc: 5, bnb: 5, '56': 5,
+    polygon: 6, matic: 6, poly: 6, '137': 6,
+    sonic: 7, '146': 7,
+    avalanche: 8, avax: 8, '43114': 8,
+    berachain: 9, bera: 9, '80094': 9,
+    blast: 10, '81457': 10,
+    manta: 11, '169': 11,
+    mode: 12, '34443': 12,
+    ethereum: 50, eth: 50, '1': 50,
+};
+function chainGasRank(chain) {
+    if (!chain)
+        return 99;
+    return CHAIN_GAS_RANK[chain.toLowerCase()] ?? 30;
+}
 /**
  * Look up token metadata by address, ticker, or name.
  *
@@ -149,25 +226,54 @@ export async function lookupToken(tokenInput) {
         if (!isTicker) {
             const exact = tokens.find((t) => t.address?.toLowerCase() === keyword.toLowerCase());
             if (exact) {
-                return { symbol: exact.symbol, name: exact.name, address: exact.address ?? tokenInput };
+                return { symbol: exact.symbol, name: exact.name ?? displayChain(exact.chain), address: exact.address ?? resolveNativeAddress(exact.chain), chain: exact.chain };
             }
         }
         if (tokens.length === 1) {
             const t = tokens[0];
-            return { symbol: t.symbol, name: t.name, address: t.address ?? tokenInput };
+            return { symbol: t.symbol, name: t.name ?? displayChain(t.chain), address: t.address ?? resolveNativeAddress(t.chain), chain: t.chain };
+        }
+        // Check if all results share the same symbol → multi-chain scenario
+        const uniqueSymbols = new Set(tokens.map((t) => t.symbol?.toLowerCase()));
+        if (uniqueSymbols.size === 1) {
+            const sorted = [...tokens].sort((a, b) => chainGasRank(a.chain) - chainGasRank(b.chain));
+            info(`$${sorted[0].symbol} is available on ${sorted.length} chains`);
+            const selected = await select({
+                message: 'Select chain:',
+                choices: sorted.map((t, i) => {
+                    const chainName = displayChain(t.chain);
+                    const addr = t.address
+                        ? chalk.dim(` · ${t.address.slice(0, 10)}…${t.address.slice(-6)}`)
+                        : chalk.dim(' · native token');
+                    const tag = i === 0 ? chalk.green(' (lowest gas)') : '';
+                    return { name: `${chalk.cyan(chainName)}${tag}${addr}`, value: t };
+                }),
+            });
+            return {
+                symbol: selected.symbol,
+                name: selected.name ?? displayChain(selected.chain),
+                address: selected.address ?? resolveNativeAddress(selected.chain),
+                chain: selected.chain,
+            };
         }
         info(`Found ${tokens.length} tokens matching "${tokenInput}"`);
         const selected = await select({
             message: 'Select the correct token:',
-            choices: tokens.map((t) => ({
-                name: `${t.symbol ? chalk.bold('$' + t.symbol) : '?'} — ${t.name ?? 'Unknown'}\n    ${chalk.yellow(t.address ?? '')}`,
-                value: t,
-            })),
+            choices: tokens.map((t) => {
+                const sym = t.symbol ? chalk.bold('$' + t.symbol) : '?';
+                const chainName = displayChain(t.chain);
+                const label = t.name || chainName;
+                const desc = label ? ` — ${label}` : '';
+                const chainTag = chainName && chainName !== label ? chalk.dim(` [${chainName}]`) : '';
+                const addr = t.address ? `\n    ${chalk.yellow(t.address)}` : chalk.dim('\n    (native token)');
+                return { name: `${sym}${desc}${chainTag}${addr}`, value: t };
+            }),
         });
         return {
             symbol: selected.symbol,
-            name: selected.name,
-            address: selected.address ?? tokenInput,
+            name: selected.name ?? displayChain(selected.chain),
+            address: selected.address ?? resolveNativeAddress(selected.chain),
+            chain: selected.chain,
         };
     }
     catch {
@@ -197,18 +303,29 @@ export function formatTokenLabel(token) {
  *
  * Exits the process if the user declines.
  */
-export async function requireTransactionConfirmation(description, token) {
+export async function requireTransactionConfirmation(description, token, details) {
     const config = loadConfig();
     if (config.confirmBeforeTransaction === false)
         return;
     console.log('');
     console.log(chalk.yellow('⚠'), chalk.bold('Transaction confirmation'));
+    if (details?.chain) {
+        console.log(chalk.dim('  Chain    : ') + chalk.cyan(details.chain));
+    }
     if (token) {
         const ticker = token.symbol ? '$' + token.symbol : undefined;
         const label = [ticker, token.name].filter(Boolean).join(' — ');
         console.log(chalk.dim('  Token    : ') + (label ? chalk.bold(label) : chalk.dim('Unknown token')));
         console.log(chalk.dim('  Address  : ') + chalk.yellow(token.address));
     }
+    if (details?.side) {
+        const s = details.side.toLowerCase();
+        const colored = s === 'buy' ? chalk.green.bold(details.side.toUpperCase()) : chalk.red.bold(details.side.toUpperCase());
+        console.log(chalk.dim('  Side     : ') + colored);
+    }
+    if (details?.amount) {
+        console.log(chalk.dim('  Amount   : ') + chalk.bold(details.amount));
+    }
     console.log(chalk.dim(`  Action   : ${description}`));
     console.log('');
     const ok = await confirm({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minara",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "CLI client for Minara.ai — login, trade, deposit/withdraw, chat and more from your terminal.",
   "type": "module",
   "main": "dist/index.js",