minara 0.1.4 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Minara
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -18,15 +18,10 @@
 
 ## Features
 
-- **Multi-method Login** — Email verification code, Google OAuth, or Apple ID
-- **Deposit & Withdraw** — View deposit addresses across chains, withdraw to external wallets
-- **Asset Management** — View wallet balances across all supported chains
-- **AI Chat** — Stream conversations with Minara AI, with thinking and deep-research modes
-- **Spot Trading** — Cross-chain token swaps with dry-run simulation
-- **Perpetual Futures** — Deposit, withdraw, place/cancel orders, manage leverage (Hyperliquid)
-- **Limit Orders** — Create, list, and cancel price-triggered orders
-- **Copy Trading** — Follow wallet addresses with configurable bots
-- **Market Discovery** — Trending tokens, Fear & Greed Index, Bitcoin metrics
+- **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
+- **Market Discovery** — Trending tokens, Fear & Greed Index, on-chain metrics, and token / stock search
 
 ## Installation
 
@@ -54,11 +49,14 @@ minara account
 # View deposit addresses
 minara deposit
 
-# Chat with Minara AI
+# Chat with Minara AI (interactive REPL)
+minara chat
+
+# Or send a single question
 minara chat "What's the best DeFi yield right now?"
 
-# Swap tokens
-minara swap
+# Swap tokens (accepts ticker or address)
+minara swap -c solana -t '$BONK' -s buy -a 100
 
 # View trending tokens
 minara discover trending
@@ -68,10 +66,10 @@ minara discover trending
 
 ### Auth & Account
 
-| Command | Description |
-|---------|-------------|
-| `minara login` | Login via email, Google, or Apple ID |
-| `minara logout` | Logout and clear local credentials |
+| Command          | Description                                 |
+| ---------------- | ------------------------------------------- |
+| `minara login`   | Login via email, Google, or Apple ID        |
+| `minara logout`  | Logout and clear local credentials          |
 | `minara account` | View your account info and wallet addresses |
 
 ```bash
@@ -83,43 +81,51 @@ minara login --apple          # Apple ID (opens browser)
 
 ### Wallet & Funds
 
-| Command | Description |
-|---------|-------------|
-| `minara assets` | View wallet balances across all chains |
-| `minara deposit` | Show deposit addresses and supported networks |
-| `minara withdraw` | Withdraw tokens to an external wallet |
+| 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                 |
 
 ```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 withdraw -c solana -t <token> -a 10 --to <address>
-minara withdraw   # Interactive mode
+minara withdraw -c solana -t '$SOL' -a 10 --to <address>
+minara withdraw                   # Interactive mode (accepts ticker or address)
 ```
 
 ### Spot Trading
 
-| Command | Description |
-|---------|-------------|
-| `minara swap` | Swap tokens (cross-chain) |
+| Command           | Description                        |
+| ----------------- | ---------------------------------- |
+| `minara swap`     | Swap tokens (cross-chain)          |
 | `minara transfer` | Transfer tokens to another address |
 
 ```bash
 minara swap                        # Interactive
-minara swap -c solana -s buy -t <token> -a 100
+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 --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.
+
 ### Perpetual Futures
 
-| Command | Description |
-|---------|-------------|
-| `minara perps deposit` | Deposit USDC to Hyperliquid perps account |
-| `minara perps withdraw` | Withdraw USDC from perps account |
-| `minara perps positions` | View all open positions |
-| `minara perps order` | Place an order (interactive builder) |
-| `minara perps cancel` | Cancel open orders |
-| `minara perps leverage` | Update leverage for a symbol |
-| `minara perps trades` | View completed trade history |
-| `minara perps fund-records` | View fund deposit/withdrawal records |
+| Command                     | Description                               |
+| --------------------------- | ----------------------------------------- |
+| `minara perps deposit`      | Deposit USDC to Hyperliquid perps account |
+| `minara perps withdraw`     | Withdraw USDC from perps account          |
+| `minara perps positions`    | View all open positions                   |
+| `minara perps order`        | Place an order (interactive builder)      |
+| `minara perps cancel`       | Cancel open orders                        |
+| `minara perps leverage`     | Update leverage for a symbol              |
+| `minara perps trades`       | View completed trade history              |
+| `minara perps fund-records` | View fund deposit/withdrawal records      |
 
 ```bash
 minara perps deposit -a 100        # Deposit 100 USDC to perps
@@ -131,11 +137,11 @@ minara perps leverage              # Interactive: set leverage for a trading pai
 
 ### Limit Orders
 
-| Command | Description |
-|---------|-------------|
-| `minara limit-order create` | Create a price-triggered limit order |
-| `minara limit-order list` | List all your limit orders |
-| `minara limit-order cancel <id>` | Cancel a specific order by ID |
+| Command                          | Description                          |
+| -------------------------------- | ------------------------------------ |
+| `minara limit-order create`      | Create a price-triggered limit order |
+| `minara limit-order list`        | List all your limit orders           |
+| `minara limit-order cancel <id>` | Cancel a specific order by ID        |
 
 ```bash
 minara limit-order create          # Interactive: token, price, side, amount, expiry
@@ -145,13 +151,13 @@ 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 |
+| 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
@@ -162,29 +168,52 @@ minara copy-trade stop abc123      # Pause a running bot
 
 ### AI Chat
 
-| Command | Description |
-|---------|-------------|
-| `minara chat [message]` | Send a message (or enter interactive mode) |
-| `minara chat --list` | List all your conversations |
-| `minara chat --history <chatId>` | View messages in a conversation |
+| Command                          | Description                                   |
+| -------------------------------- | --------------------------------------------- |
+| `minara chat`                    | Enter interactive REPL (Python/Node.js-style) |
+| `minara chat [message]`          | Send a single message and exit                |
+| `minara chat --list`             | List all your conversations                   |
+| `minara chat --history <chatId>` | View messages in a conversation               |
+| `minara chat -c <chatId>`        | Continue an existing conversation             |
 
 ```bash
-minara chat "What is the current BTC price?"   # Single question, streamed answer
 minara chat                                    # Enter interactive REPL mode
+minara chat "What is the current BTC price?"   # Single question, streamed answer
+minara chat --quality "Analyze ETH outlook"     # Quality mode (default: fast)
 minara chat --thinking "Analyze ETH outlook"   # Enable reasoning mode
-minara chat --deep-research "DeFi yield trends"# Deep research mode
+minara chat -c <chatId>                        # Continue a specific chat in REPL
 minara chat --list                             # List past conversations
 minara chat --history <chatId>                 # Replay a specific conversation
 ```
 
+**Interactive REPL mode** — When launched without a message argument, the chat enters an interactive session:
+
+```
+Minara AI Chat session:a1b2c3d4
+──────────────────────────────────────────────────
+Type a message to chat. /help for commands, Ctrl+C to exit.
+
+>>> What's the price of BTC?
+Minara: Bitcoin is currently trading at $95,432...
+
+>>> /help
+
+  Commands:
+  /new        Start a new conversation
+  /continue   Continue an existing conversation
+  /list       List all historical chats
+  /id         Show current chat ID
+  exit        Quit the chat
+```
+
 ### Market Discovery
 
-| Command | Description |
-|---------|-------------|
-| `minara discover trending` | View currently trending tokens |
-| `minara discover search <keyword>` | Search for tokens or stocks by name |
-| `minara discover fear-greed` | View the crypto Fear & Greed Index |
-| `minara discover btc-metrics` | View Bitcoin on-chain and market metrics |
+| Command                            | Description                              |
+| ---------------------------------- | ---------------------------------------- |
+| `minara discover trending`         | View currently trending tokens           |
+| `minara discover search <keyword>` | Search for tokens or stocks by name      |
+| `minara discover fear-greed`       | View the crypto Fear & Greed Index       |
+| `minara discover btc-metrics`      | View Bitcoin on-chain and market metrics |
 
 ```bash
 minara discover trending           # Top trending tokens right now
@@ -193,11 +222,86 @@ minara discover fear-greed         # Current market sentiment index
 minara discover btc-metrics        # Bitcoin hashrate, supply, dominance, etc.
 ```
 
+### Premium & Subscription
+
+| Command                      | Description                                     |
+| ---------------------------- | ----------------------------------------------- |
+| `minara premium plans`       | View all subscription plans and credit packages |
+| `minara premium status`      | View your current subscription status           |
+| `minara premium subscribe`   | Subscribe or change plan (upgrade / downgrade)  |
+| `minara premium buy-credits` | Buy a one-time credit package                   |
+| `minara premium cancel`      | Cancel your current subscription                |
+
+```bash
+minara premium plans              # Compare Free, Lite, Starter, Pro, Partner plans
+minara premium status             # Check your current plan and billing info
+minara premium subscribe          # Interactive: select plan → Stripe or Crypto payment
+minara premium buy-credits        # Buy additional credits (one-time purchase)
+minara premium cancel             # Cancel subscription (keeps access until period ends)
+```
+
+### Output Format
+
+By default, all commands display data using formatted tables, colored text, and human-friendly numbers (e.g. `$1.23M`, `+3.46%`). To get raw JSON output for scripting or piping, add the `--json` flag to any command:
+
+```bash
+minara discover trending --json    # Raw JSON array of trending tokens
+minara discover btc-metrics --json # Full BTC metrics with OHLCV data
+minara assets spot --json          # Raw JSON asset list
+```
+
 ### Configuration
 
-| Command | Description |
-|---------|-------------|
-| `minara config` | View or update CLI settings (e.g. API base URL) |
+| Command         | Description                                                            |
+| --------------- | ---------------------------------------------------------------------- |
+| `minara config` | View or update CLI settings (base URL, Touch ID, transaction confirm…) |
+
+```bash
+minara config                     # Interactive settings menu
+```
+
+Available settings:
+
+| Setting                  | Default | Description                                          |
+| ------------------------ | ------- | ---------------------------------------------------- |
+| Base URL                 | —       | API endpoint                                         |
+| Touch ID                 | Off     | Biometric verification for fund operations (macOS)   |
+| Transaction Confirmation | **On**  | Mandatory second confirmation before fund operations |
+
+### Transaction Safety
+
+All fund-related operations go through a multi-layer safety flow:
+
+```
+1. First confirmation      (skippable with -y flag)
+2. Transaction confirmation (mandatory — configurable in minara config)
+3. Touch ID verification   (optional — macOS only)
+4. Execute
+```
+
+The **transaction confirmation** shows the token ticker, name, full contract address, and operation details before asking for final approval:
+
+```
+⚠ Transaction confirmation
+  Token    : $BONK — Bonk
+  Address  : DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
+  Action   : BUY swap · 100 USD · solana
+? Are you sure you want to proceed? (y/N)
+```
+
+This step is independent of the `-y` flag and Touch ID — it serves as an extra safety net. Disable it via `minara config` if not needed.
+
+### Touch ID (macOS)
+
+Minara CLI supports macOS Touch ID to protect all fund-related operations. When enabled, transfers, withdrawals, swaps, orders, and other financial actions require fingerprint verification before execution.
+
+```bash
+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`
+
+> **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.
 
 ## Supported Chains
 
@@ -235,6 +339,9 @@ npm run test:coverage   # With coverage report
 
 ## Security
 
+- **Transaction Confirmation** — Mandatory second confirmation before all fund operations, showing full token details and contract addresses (default: enabled, configurable)
+- **Touch ID** — Optional biometric protection for all fund operations (macOS only). A native Swift helper binary is compiled on first use and cached in `~/.minara/`
+- **Token Verification** — Token ticker, name, and full contract address are always displayed before any transaction to prevent wrong-token mistakes
 - Credentials are stored in `~/.minara/credentials.json` with `0600` file permissions
 - The `~/.minara/` directory is created with `0700` permissions
 - Tokens are never logged or printed to the console

package/dist/api/auth.d.ts

@@ -1,4 +1,4 @@
-import type { EmailCodeDto, EmailVerifyDto, AuthUser, FavoriteTokensPayload, OAuthProvider } from '../types.js';
+import type { EmailCodeDto, EmailVerifyDto, AuthUser, FavoriteTokensPayload, OAuthProvider, DeviceAuthStartResponse, DeviceAuthStatusResponse } from '../types.js';
 /** Send email verification code */
 export declare function sendEmailCode(dto: EmailCodeDto): Promise<import("../types.js").ApiResponse<void>>;
 /** Verify email code → returns user + access_token */
@@ -28,3 +28,7 @@ export declare function addFavoriteTokens(token: string, payload: FavoriteTokens
 }>>;
 /** Get invite history */
 export declare function getInviteHistory(token: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>[]>>;
+/** Start device authorization flow */
+export declare function startDeviceAuth(): Promise<import("../types.js").ApiResponse<DeviceAuthStartResponse>>;
+/** Poll device authorization status */
+export declare function getDeviceAuthStatus(deviceCode: string): Promise<import("../types.js").ApiResponse<DeviceAuthStatusResponse>>;

package/dist/api/auth.js

@@ -44,3 +44,14 @@ export function addFavoriteTokens(token, payload) {
 export function getInviteHistory(token) {
     return get('/auth/invite-history', { token });
 }
+// ─── Device Authorization Flow (RFC 8628) ─────────────────────────────────
+/** Start device authorization flow */
+export function startDeviceAuth() {
+    return post('/auth/device/start');
+}
+/** Poll device authorization status */
+export function getDeviceAuthStatus(deviceCode) {
+    return post('/auth/device/status', {
+        body: { device_code: deviceCode },
+    });
+}

package/dist/api/payment.d.ts

@@ -0,0 +1,17 @@
+import type { PlansResponse, CheckoutSession, CryptoCheckout } from '../types.js';
+/** Get all subscription plans and credit packages */
+export declare function getPlans(): Promise<import("../types.js").ApiResponse<PlansResponse>>;
+/** Create a Stripe checkout session for a subscription plan */
+export declare function checkoutPlan(token: string, planId: string, successUrl: string, cancelUrl: string): Promise<import("../types.js").ApiResponse<CheckoutSession>>;
+/** Create a crypto checkout for a subscription plan */
+export declare function cryptoCheckoutPlan(token: string, planId: string): Promise<import("../types.js").ApiResponse<CryptoCheckout>>;
+/** Get crypto checkout pay amount for a plan */
+export declare function getCryptoPayAmount(token: string, planId: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
+/** Simulate crypto checkout for a plan */
+export declare function simulateCryptoCheckout(token: string, planId: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
+/** Create a Stripe checkout session for a credit package */
+export declare function checkoutPackage(token: string, packageId: string, successUrl: string, cancelUrl: string): Promise<import("../types.js").ApiResponse<CheckoutSession>>;
+/** Create a crypto checkout for a credit package */
+export declare function cryptoCheckoutPackage(token: string, packageId: string): Promise<import("../types.js").ApiResponse<CryptoCheckout>>;
+/** Cancel current subscription */
+export declare function cancelSubscription(token: string): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;

package/dist/api/payment.js

@@ -0,0 +1,39 @@
+import { get, del } from './client.js';
+/** Get all subscription plans and credit packages */
+export function getPlans() {
+    return get('/payment/plans');
+}
+/** Create a Stripe checkout session for a subscription plan */
+export function checkoutPlan(token, planId, successUrl, cancelUrl) {
+    return get(`/payment/plans/${planId}/checkout`, {
+        token,
+        query: { successUrl, cancelUrl },
+    });
+}
+/** Create a crypto checkout for a subscription plan */
+export function cryptoCheckoutPlan(token, planId) {
+    return get(`/payment/plans/${planId}/crypto-checkout`, { token });
+}
+/** Get crypto checkout pay amount for a plan */
+export function getCryptoPayAmount(token, planId) {
+    return get(`/payment/plans/${planId}/crypto-checkout/payAmount`, { token });
+}
+/** Simulate crypto checkout for a plan */
+export function simulateCryptoCheckout(token, planId) {
+    return get(`/payment/plans/${planId}/crypto-checkout/simulate`, { token });
+}
+/** Create a Stripe checkout session for a credit package */
+export function checkoutPackage(token, packageId, successUrl, cancelUrl) {
+    return get(`/payment/packages/${packageId}/checkout`, {
+        token,
+        query: { successUrl, cancelUrl },
+    });
+}
+/** Create a crypto checkout for a credit package */
+export function cryptoCheckoutPackage(token, packageId) {
+    return get(`/payment/packages/${packageId}/crypto-checkout`, { token });
+}
+/** Cancel current subscription */
+export function cancelSubscription(token) {
+    return del('/payment/subscription', { token });
+}

package/dist/api/perps.d.ts

@@ -11,6 +11,8 @@ 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 */

package/dist/api/perps.js

@@ -23,6 +23,10 @@ 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 });

package/dist/api/tokens.d.ts

@@ -19,3 +19,7 @@ export declare function getEvents(page: string, pageSize: string, version: strin
 export declare function getFearGreedIndex(): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
 /** Get bitcoin metrics */
 export declare function getBitcoinMetrics(): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
+/** Get ethereum metrics */
+export declare function getEthereumMetrics(): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;
+/** Get solana metrics */
+export declare function getSolanaMetrics(): Promise<import("../types.js").ApiResponse<Record<string, unknown>>>;

package/dist/api/tokens.js

@@ -39,3 +39,11 @@ export function getFearGreedIndex() {
 export function getBitcoinMetrics() {
     return get('/discover/bitcoin-metrics');
 }
+/** Get ethereum metrics */
+export function getEthereumMetrics() {
+    return get('/discover/ethereum-metrics');
+}
+/** Get solana metrics */
+export function getSolanaMetrics() {
+    return get('/discover/solana-metrics');
+}

package/dist/commands/assets.js

@@ -1,22 +1,103 @@
 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 { requireAuth } from '../config.js';
 import { spinner, unwrapApi, wrapAction } from '../utils.js';
-export const assetsCommand = new Command('assets')
-    .description('View your wallet assets across chains')
+import { printKV, printTable, ASSET_COLUMNS, POSITION_COLUMNS } from '../formatters.js';
+// ─── spot ────────────────────────────────────────────────────────────────
+const spotCmd = new Command('spot')
+    .description('View spot wallet assets across chains')
     .action(wrapAction(async () => {
     const creds = requireAuth();
-    const spin = spinner('Fetching assets…');
-    const res = await getAssets(creds.accessToken);
+    await showSpotAssets(creds.accessToken);
+}));
+async function showSpotAssets(token) {
+    const spin = spinner('Fetching spot assets…');
+    const res = await getAssets(token);
     spin.stop();
-    const data = unwrapApi(res, 'Failed to fetch assets');
+    const data = unwrapApi(res, 'Failed to fetch spot assets');
     if (Array.isArray(data) && data.length === 0) {
-        console.log(chalk.dim('No assets found.'));
+        console.log(chalk.dim('No spot assets found.'));
         return;
     }
     console.log('');
-    console.log(chalk.bold('Your Assets:'));
-    console.log(JSON.stringify(data, null, 2));
+    console.log(chalk.bold('Spot Wallet Assets:'));
+    if (Array.isArray(data)) {
+        printTable(data, ASSET_COLUMNS);
+    }
+    else {
+        printKV(data);
+    }
+    console.log('');
+}
+// ─── perps ───────────────────────────────────────────────────────────────
+const perpsCmd = new Command('perps')
+    .description('View perps account balance and positions')
+    .action(wrapAction(async () => {
+    const creds = requireAuth();
+    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),
+    ]);
+    spin.stop();
+    // ── Account state ───────────────────────────────────────────────────
+    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}`));
+        }
+    }
+    // ── 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}`));
+        }
+    }
+    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);
+        }
+    }
     console.log('');
+}
+// ─── parent ──────────────────────────────────────────────────────────────
+export const assetsCommand = new Command('assets')
+    .description('View your wallet assets (spot & perps)')
+    .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);
+    }
 }));