minara 0.2.0 → 0.2.2

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,150 @@
 import { Command } from 'commander';
-import { select } from '@inquirer/prompts';
+import { select, 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,
+}
+// ─── 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);
+    }
+    if (!opts?.yes) {
+        await requireTransactionConfirmation(`Transfer ${amount} USDC from Spot → Perps`, undefined, {
+            amount: `${amount} USDC`,
+            side: 'Spot → Perps',
         });
-        if (wantDetails) {
-            console.log('');
-            console.log(chalk.bold('Account Details:'));
-            printKV(accountRes.data);
-            console.log('');
-        }
+    }
+    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, {