minara 0.3.0 → 0.4.0

package/README.md

@@ -21,7 +21,8 @@
 - **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, withdrawals, and credit card on-ramp via MoonPay
 - **Chain-Abstracted Trading** — Cross-chain swaps with automatic chain detection, perpetual futures, and limit orders. Accepts `$TICKER`, token name, or contract address
-- **AI Autopilot & Analysis** — Fully managed AI trading strategies for perps, plus on-demand long/short analysis with one-click quick order
+- **Multi-Wallet Perps** — Manage multiple sub-wallets per account: create, rename, sweep, transfer USDC between wallets. All trading commands support `--wallet` targeting
+- **AI Autopilot & Analysis** — Multi-strategy AI trading per wallet with performance dashboard, strategy comparison table, and one-click config management. Plus on-demand long/short analysis with quick order
 - **Market Discovery** — Trending tokens & stocks, Fear & Greed Index, on-chain metrics, and search
 
 ## Installation
@@ -135,28 +136,44 @@ minara swap --dry-run              # Simulate without executing
 | `minara perps deposit`      | Deposit USDC to perps (or use `minara deposit perps`) |
 | `minara perps withdraw`     | Withdraw USDC from perps account                      |
 | `minara perps fund-records` | View fund deposit/withdrawal records                  |
-| `minara perps autopilot`    | Manage AI autopilot trading strategy (on/off/config)  |
+| `minara perps wallets`      | List all sub-wallets with balances and autopilot info |
+| `minara perps create-wallet`| Create a new perps sub-wallet                         |
+| `minara perps rename-wallet`| Rename a sub-wallet                                   |
+| `minara perps sweep`        | Consolidate funds from sub-wallet to default          |
+| `minara perps transfer`     | Transfer USDC between sub-wallets                     |
+| `minara perps autopilot`    | Manage AI autopilot strategies per wallet             |
 | `minara perps ask`          | AI long/short analysis with quick order               |
 
 ```bash
-minara perps positions             # List positions with equity, margin, PnL
-minara perps order                 # Interactive: symbol selector → side → size → confirm
+minara perps positions             # Positions per wallet with equity, margin, PnL
+minara perps positions --wallet Bot-1  # Positions for a specific wallet only
+minara perps order                 # Interactive: symbol → side → size → confirm
+minara perps order --wallet Bot-1  # Place order on a specific wallet
 minara perps close                 # Close a position: pick from list → market close
+minara perps close --all           # Close all positions at once
 minara perps cancel                # Cancel an order: pick from open orders list
 minara perps leverage              # Interactive: shows max leverage per asset
 minara perps trades                # Recent fills from Hyperliquid (default 7 days)
 minara perps trades -d 30          # Last 30 days of trade history
 minara perps deposit -a 100        # Deposit 100 USDC to perps
 minara perps withdraw -a 50        # Withdraw 50 USDC from perps
-minara perps autopilot             # Toggle AI autopilot, create/update strategy
+minara perps wallets               # All wallets: equity, margin, PnL, strategies
+minara perps create-wallet -n Bot-2  # Create a new sub-wallet
+minara perps sweep                 # Move funds from a sub-wallet to default
+minara perps transfer              # Transfer USDC between any two wallets
+minara perps autopilot             # Strategy dashboard: enable/disable, config, perf
 minara perps ask                   # AI analysis → optional quick order
 ```
 
+> **Multi-wallet support:** All trading commands (`order`, `deposit`, `withdraw`, `close`, `cancel`, `leverage`, `trades`, `fund-records`, `ask`) accept `--wallet <name>` to target a specific sub-wallet. If omitted, you'll be prompted to pick one interactively.
+>
+> **Autopilot dashboard:** Each wallet can have multiple AI strategies. The dashboard shows strategy name, status, config, and a performance comparison table across all available strategies with the active one highlighted.
+>
 > **Close position:** Select an open position from the list, and it will be closed at market price with a reduce-only order in the opposite direction — no manual price or size entry needed.
 >
 > **Cancel order:** Open orders are fetched from Hyperliquid and shown as a selectable list with coin, side, size, and price — no need to look up order IDs.
 >
-> **Autopilot:** When autopilot is ON, manual order placement (`minara perps order`) is blocked to prevent conflicts with AI-managed trades. Turn off autopilot first via `minara perps autopilot`.
+> **Autopilot:** When autopilot is ON for a wallet, manual order placement on that wallet is blocked to prevent conflicts with AI-managed trades. Turn off autopilot first via `minara perps autopilot`.
 >
 > **Ask AI → Quick Order:** After the AI analysis, you can instantly place a market order based on the recommended direction, entry price, and position size — no need to re-enter parameters.
 
@@ -340,12 +357,12 @@ minara --help
 
 ## Testing
 
-Test suite built with [Vitest](https://vitest.dev/) — 119 tests covering unit, API, and command integration layers.
+Test suite built with [Vitest](https://vitest.dev/) — 251 tests covering unit, API, command integration, and formatter layers.
 
 ```bash
 npm test                # Run all tests
 npm run test:watch      # Watch mode
-npm run test:coverage   # With coverage report
+npm run test:coverage   # With v8 coverage report
 ```
 
 ## Security

package/dist/api/perps.d.ts

@@ -1,4 +1,4 @@
-import type { PerpsDepositDto, PerpsWithdrawDto, PerpsPlaceOrdersDto, PerpsCancelOrdersDto, UpdateLeverageDto, PerpsPosition, TokenPrice, TransactionResult } from '../types.js';
+import type { PerpsDepositDto, PerpsWithdrawDto, PerpsPlaceOrdersDto, PerpsCancelOrdersDto, UpdateLeverageDto, PerpsPosition, TokenPrice, TransactionResult, PerpSubAccount, CreatePerpSubAccountDto, RenamePerpSubAccountDto, TransferFundsDto, SweepFundsDto } from '../types.js';
 /** Deposit USDC to perps (min 5 USDC) */
 export declare function deposit(token: string, dto: PerpsDepositDto): Promise<import("../types.js").ApiResponse<TransactionResult>>;
 /** Withdraw USDC from perps */
@@ -33,6 +33,7 @@ export declare function createStrategy(token: string, dto: {
     symbols: string[];
     strategyConfig?: Record<string, unknown>;
     language?: string;
+    subAccountId?: string;
 }): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
 export declare function enableStrategy(token: string, strategyId: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
 export declare function disableStrategy(token: string, strategyId: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
@@ -43,6 +44,29 @@ export declare function updateStrategy(token: string, dto: {
     language?: string;
 }): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
 export declare function getPerformanceMetrics(token: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
+export declare function getMinEquityValue(token: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
+export declare function setMinEquityValue(token: string, dto: Record<string, unknown>): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
+export declare function getRecords(token: string, page: number, limit: number): Promise<import("../types.js").ApiResponse<Record<string, unknown>[]>>;
+/** List all perp sub-accounts */
+export declare function listSubAccounts(token: string): Promise<import("../types.js").ApiResponse<PerpSubAccount[]>>;
+/** Create a new perp sub-account */
+export declare function createSubAccount(token: string, dto: CreatePerpSubAccountDto): Promise<import("../types.js").ApiResponse<PerpSubAccount>>;
+/** Rename a perp sub-account */
+export declare function renameSubAccount(token: string, dto: RenamePerpSubAccountDto): Promise<import("../types.js").ApiResponse<void>>;
+/** Get summary for a specific sub-account */
+export declare function getSubAccountSummary(token: string, subAccountId: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
+/** Get aggregated PnL across all sub-accounts */
+export declare function getAggregatedSummary(token: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
+/** Get autopilot records for a specific sub-account */
+export declare function getSubAccountRecords(token: string, subAccountId: string, page: number, limit: number): Promise<import("../types.js").ApiResponse<Record<string, unknown>[]>>;
+/** Get fills for a specific sub-account */
+export declare function getSubAccountFills(token: string, subAccountId: string, startTime: number): Promise<import("../types.js").ApiResponse<Record<string, unknown>[]>>;
+/** Get open orders for a specific sub-account */
+export declare function getSubAccountOpenOrders(token: string, subAccountId: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>[]>>;
+/** Transfer USDC between sub-accounts (internal, no gas) */
+export declare function transferFunds(token: string, dto: TransferFundsDto): Promise<import("../types.js").ApiResponse<TransactionResult>>;
+/** Sweep all funds from a sub-account back to the default account */
+export declare function sweepFunds(token: string, dto: SweepFundsDto): Promise<import("../types.js").ApiResponse<TransactionResult>>;
 export declare function priceAnalysis(token: string, dto: {
     symbol: string;
     startTime?: number;

package/dist/api/perps.js

@@ -77,6 +77,56 @@ export function updateStrategy(token, dto) {
 export function getPerformanceMetrics(token) {
     return get('/v1/fully-managed/performance/metrics/v2', { token });
 }
+export function getMinEquityValue(token) {
+    return get('/v1/fully-managed/get-min-equity-value', { token });
+}
+export function setMinEquityValue(token, dto) {
+    return post('/v1/fully-managed/set-min-equity-value', { token, body: dto });
+}
+export function getRecords(token, page, limit) {
+    return get('/v1/fully-managed/records', { token, query: { page, limit } });
+}
+// ── Perp Wallets (multi sub-account) ──────────────────────────────────────
+/** List all perp sub-accounts */
+export function listSubAccounts(token) {
+    return get('/v1/perp-wallets', { token });
+}
+/** Create a new perp sub-account */
+export function createSubAccount(token, dto) {
+    return post('/v1/perp-wallets', { token, body: dto });
+}
+/** Rename a perp sub-account */
+export function renameSubAccount(token, dto) {
+    return post('/v1/perp-wallets/rename', { token, body: dto });
+}
+/** Get summary for a specific sub-account */
+export function getSubAccountSummary(token, subAccountId) {
+    return get('/v1/perp-wallets/summary', { token, query: { subAccountId } });
+}
+/** Get aggregated PnL across all sub-accounts */
+export function getAggregatedSummary(token) {
+    return get('/v1/perp-wallets/aggregated-summary', { token });
+}
+/** Get autopilot records for a specific sub-account */
+export function getSubAccountRecords(token, subAccountId, page, limit) {
+    return get('/v1/perp-wallets/records', { token, query: { subAccountId, page, limit } });
+}
+/** Get fills for a specific sub-account */
+export function getSubAccountFills(token, subAccountId, startTime) {
+    return get('/v1/perp-wallets/fills', { token, query: { subAccountId, startTime } });
+}
+/** Get open orders for a specific sub-account */
+export function getSubAccountOpenOrders(token, subAccountId) {
+    return get('/v1/perp-wallets/open-orders', { token, query: { subAccountId } });
+}
+/** Transfer USDC between sub-accounts (internal, no gas) */
+export function transferFunds(token, dto) {
+    return post('/v1/perp-wallets/transfer', { token, body: dto });
+}
+/** Sweep all funds from a sub-account back to the default account */
+export function sweepFunds(token, dto) {
+    return post('/v1/perp-wallets/sweep', { token, body: dto });
+}
 // ── Price Analysis (Ask Long/Short) ──────────────────────────────────────
 export function priceAnalysis(token, dto) {
     return post('/tokens/price-analysis', { token, body: dto });

package/dist/commands/assets.js

@@ -79,9 +79,63 @@ const perpsCmd = new Command('perps')
     await showPerpsAssets(creds.accessToken);
 }));
 async function showPerpsAssets(token) {
-    const spin = spinner('Fetching perps account…');
-    const res = await perpsApi.getAccountSummary(token);
+    const spin = spinner('Fetching perps wallets…');
+    const walletsRes = await perpsApi.listSubAccounts(token);
     spin.stop();
+    let wallets = [];
+    if (walletsRes.success && walletsRes.data) {
+        const raw = walletsRes.data;
+        if (Array.isArray(raw))
+            wallets = raw;
+        else if (raw && typeof raw === 'object') {
+            const inner = raw.data
+                ?? raw.subAccounts
+                ?? raw.wallets;
+            if (Array.isArray(inner))
+                wallets = inner;
+        }
+    }
+    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)}`);
+    };
+    if (wallets.length > 0) {
+        console.log('');
+        console.log(chalk.bold(`Perps Wallets (${wallets.length}):`));
+        for (const w of wallets) {
+            const name = String(w.name ?? 'Unnamed');
+            const def = w.isDefault ? chalk.cyan(' (default)') : '';
+            console.log('');
+            console.log(chalk.bold(`  ${name}${def}:`));
+            console.log(`    Equity        : ${fmt(Number(w.equityValue ?? 0))}`);
+            console.log(`    Available     : ${fmt(Number(w.dispatchableValue ?? 0))}`);
+            console.log(`    Margin Used   : ${fmt(Number(w.totalMarginUsed ?? 0))}`);
+            console.log(`    Unrealized PnL: ${pnlFmt(Number(w.totalUnrealizedPnl ?? 0))}`);
+            const positions = Array.isArray(w.positions) ? w.positions : [];
+            if (positions.length > 0) {
+                printTable(positions, POSITION_COLUMNS);
+            }
+            else {
+                console.log(chalk.dim('    No open positions.'));
+            }
+        }
+        // Aggregated summary
+        const aggRes = await perpsApi.getAggregatedSummary(token);
+        if (aggRes.success && aggRes.data) {
+            const d = aggRes.data;
+            console.log('');
+            console.log(chalk.bold('  Aggregated:'));
+            console.log(`    Total Equity     : ${fmt(Number(d.totalEquity ?? d.equityValue ?? 0))}`);
+            console.log(`    Total Unrl. PnL  : ${pnlFmt(Number(d.totalUnrealizedPnl ?? 0))}`);
+        }
+        console.log('');
+        return;
+    }
+    // Fallback to legacy single-account API
+    const legacySpin = spinner('Fetching perps account…');
+    const res = await perpsApi.getAccountSummary(token);
+    legacySpin.stop();
     if (!res.success || !res.data) {
         console.log(chalk.dim('  Could not fetch perps account.'));
         if (res.error?.message)
@@ -89,12 +143,6 @@ async function showPerpsAssets(token) {
         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:'));
     console.log(`  Equity        : ${fmt(Number(d.equityValue ?? 0))}`);
@@ -102,7 +150,6 @@ async function showPerpsAssets(token) {
     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 (${positions.length}):`));

package/dist/commands/balance.js

@@ -10,8 +10,9 @@ export const balanceCommand = new Command('balance')
     .action(wrapAction(async () => {
     const creds = requireAuth();
     const spin = spinner('Fetching balances…');
-    const [spotRes, perpsRes] = await Promise.all([
+    const [spotRes, perpsAggRes, perpsLegacyRes] = await Promise.all([
         get('/users/pnls/all', { token: creds.accessToken }),
+        perpsApi.getAggregatedSummary(creds.accessToken),
         perpsApi.getAccountSummary(creds.accessToken),
     ]);
     spin.stop();
@@ -28,8 +29,12 @@ export const balanceCommand = new Command('balance')
         }
     }
     let perpsAvailable = 0;
-    if (perpsRes.success && perpsRes.data) {
-        const d = perpsRes.data;
+    if (perpsAggRes.success && perpsAggRes.data) {
+        const d = perpsAggRes.data;
+        perpsAvailable = Number(d.totalDispatchable ?? d.dispatchableValue ?? d.totalEquity ?? 0);
+    }
+    else if (perpsLegacyRes.success && perpsLegacyRes.data) {
+        const d = perpsLegacyRes.data;
         perpsAvailable = Number(d.dispatchableValue ?? 0);
     }
     const total = spotStable + perpsAvailable;