perp-cli 0.11.0 → 0.12.0

package/dist/commands/rebalance.d.ts

@@ -1,3 +1,3 @@
 import { Command } from "commander";
 import type { ExchangeAdapter } from "../exchanges/index.js";
-export declare function registerRebalanceCommands(program: Command, getAdapterForExchange: (exchange: string) => Promise<ExchangeAdapter>, isJson: () => boolean): void;
+export declare function registerFundsRebalanceCommands(parent: Command, getAdapterForExchange: (exchange: string) => Promise<ExchangeAdapter>, isJson: () => boolean): void;

package/dist/commands/rebalance.js

@@ -3,8 +3,8 @@ import { formatUsd, makeTable, printJson, jsonOk } from "../utils.js";
 import { fetchAllBalances, computeRebalancePlan, describeBridgeRoute, estimateMoveTime, } from "../rebalance.js";
 import { EXCHANGE_TO_CHAIN, executeBestBridge } from "../bridge-engine.js";
 import { loadPrivateKey, parseSolanaKeypair } from "../config.js";
-export function registerRebalanceCommands(program, getAdapterForExchange, isJson) {
-    const rebalance = program.command("rebalance").description("Cross-exchange balance management");
+export function registerFundsRebalanceCommands(parent, getAdapterForExchange, isJson) {
+    const rebalance = parent.command("rebalance").description("Cross-exchange balance management");
     // ── rebalance check ──
     rebalance
         .command("check")
@@ -13,15 +13,18 @@ export function registerRebalanceCommands(program, getAdapterForExchange, isJson
         .action(async (opts) => {
         const exchangeNames = opts.exchanges.split(",").map((e) => e.trim());
         const adapters = new Map();
+        const unavailable = [];
         for (const name of exchangeNames) {
             try {
                 adapters.set(name, await getAdapterForExchange(name));
             }
-            catch {
-                // skip unavailable
+            catch (e) {
+                unavailable.push({ exchange: name, error: e instanceof Error ? e.message : String(e) });
             }
         }
         if (adapters.size === 0) {
+            if (isJson())
+                return printJson(jsonOk({ snapshots: [], unavailable }));
             console.error(chalk.red("\n  No exchanges available. Check credentials.\n"));
             return;
         }
@@ -29,7 +32,7 @@ export function registerRebalanceCommands(program, getAdapterForExchange, isJson
             console.log(chalk.cyan("\n  Fetching balances across exchanges...\n"));
         const snapshots = await fetchAllBalances(adapters);
         if (isJson())
-            return printJson(jsonOk(snapshots));
+            return printJson(jsonOk({ snapshots, unavailable }));
         const totalEquity = snapshots.reduce((s, e) => s + e.equity, 0);
         const totalAvailable = snapshots.reduce((s, e) => s + e.available, 0);
         const rows = snapshots.map((s) => {
@@ -61,15 +64,18 @@ export function registerRebalanceCommands(program, getAdapterForExchange, isJson
         .action(async (opts) => {
         const exchangeNames = opts.exchanges.split(",").map((e) => e.trim());
         const adapters = new Map();
+        const unavailable = [];
         for (const name of exchangeNames) {
             try {
                 adapters.set(name, await getAdapterForExchange(name));
             }
-            catch {
-                // skip unavailable
+            catch (e) {
+                unavailable.push({ exchange: name, error: e instanceof Error ? e.message : String(e) });
             }
         }
         if (adapters.size < 2) {
+            if (isJson())
+                return printJson(jsonOk({ moves: [], unavailable, error: "Need at least 2 exchanges for rebalancing" }));
             console.error(chalk.red("\n  Need at least 2 exchanges for rebalancing.\n"));
             return;
         }
@@ -81,7 +87,7 @@ export function registerRebalanceCommands(program, getAdapterForExchange, isJson
             reserve: parseFloat(opts.reserve),
         });
         if (isJson())
-            return printJson(jsonOk(plan));
+            return printJson(jsonOk({ ...plan, unavailable }));
         // Show current state
         const rows = plan.snapshots.map((s) => {
             const target = plan.targetPerExchange;
@@ -109,7 +115,7 @@ export function registerRebalanceCommands(program, getAdapterForExchange, isJson
             console.log(chalk.gray(`    Time:  ${estimateMoveTime(m)}`));
             console.log();
         }
-        console.log(chalk.yellow(`  To execute: perp rebalance execute --exchanges ${opts.exchanges}\n`));
+        console.log(chalk.yellow(`  To execute: perp funds rebalance execute --exchanges ${opts.exchanges}\n`));
     });
     // ── rebalance execute ──
     rebalance
@@ -207,14 +213,14 @@ export function registerRebalanceCommands(program, getAdapterForExchange, isJson
                 catch (err) {
                     console.error(chalk.red(`    Bridge failed: ${err instanceof Error ? err.message : err}`));
                     if (!isJson())
-                        console.log(chalk.yellow(`    Manual fallback: perp bridge exchange --from ${move.from} --to ${move.to} --amount ${move.amount}\n`));
+                        console.log(chalk.yellow(`    Manual fallback: perp funds bridge exchange --from ${move.from} --to ${move.to} --amount ${move.amount}\n`));
                     moveResults.push({ from: move.from, to: move.to, amount: move.amount, status: "bridge_failed", error: err instanceof Error ? err.message : String(err) });
                 }
             }
             else {
                 if (!isJson()) {
                     console.log(chalk.gray(`    Step 2: Bridge needed.`));
-                    console.log(chalk.gray(`    Run: perp bridge exchange --from ${move.from} --to ${move.to} --amount ${move.amount}`));
+                    console.log(chalk.gray(`    Run: perp funds bridge exchange --from ${move.from} --to ${move.to} --amount ${move.amount}`));
                     console.log();
                 }
                 moveResults.push({ from: move.from, to: move.to, amount: move.amount, status: "needs_bridge" });
@@ -222,7 +228,7 @@ export function registerRebalanceCommands(program, getAdapterForExchange, isJson
         }
         if (isJson())
             return printJson(jsonOk({ status: "executed", moves: moveResults }));
-        console.log(chalk.cyan("  Rebalance initiated. Monitor progress with 'perp rebalance check'.\n"));
+        console.log(chalk.cyan("  Rebalance initiated. Monitor progress with 'perp funds rebalance check'.\n"));
     });
 }
 /**

package/dist/commands/risk.js

@@ -336,14 +336,10 @@ export function registerRiskCommands(program, getAdapterForExchange, isJson) {
             }
         });
     });
-    // ── deprecated: health (merged into risk) ──
-    const healthCmd = program
+    program
         .command("health")
-        .description("Use 'perp status --health'")
+        .description("Adapter health check across all 4 DEX")
         .action(async () => {
-        if (!isJson())
-            console.log(chalk.yellow("  Use 'perp status --health' instead.\n"));
         await runHealthCheck(isJson);
     });
-    healthCmd._hidden = true;
 }

package/dist/commands/settings.js

@@ -1,5 +1,5 @@
 import chalk from "chalk";
-import { printJson, jsonOk, jsonError, withJsonErrors } from "../utils.js";
+import { printJson, jsonOk, withJsonErrors } from "../utils.js";
 import { loadSettings, saveSettings } from "../settings.js";
 import { ENV_FILE, loadEnvFile, setEnvVar, EXCHANGE_ENV_MAP, validateKey } from "./init.js";
 // Resolve exchange alias → env var key
@@ -34,7 +34,7 @@ export function registerSettingsCommands(program, isJson, getAdapterForExchange)
                 return printJson(jsonOk(s));
             console.log(chalk.cyan.bold("\n  CLI Settings\n"));
             console.log(`  Default Exchange: ${s.defaultExchange ? chalk.cyan(s.defaultExchange) : chalk.gray("pacifica (built-in)")}`);
-            console.log(`  Referrals:        ${s.referrals ? chalk.green("ON") : chalk.gray("OFF (opt-in)")}`);
+            console.log(`  Referrals:        ${chalk.green("MANDATORY (always on)")}`);
             console.log(chalk.white.bold("\n  Referral Codes:"));
             console.log(`    Pacifica:      ${s.referralCodes.pacifica || chalk.gray("(none)")}`);
             console.log(`    Hyperliquid:   ${s.referralCodes.hyperliquid || chalk.gray("(none)")}`);
@@ -48,52 +48,13 @@ export function registerSettingsCommands(program, isJson, getAdapterForExchange)
             console.log(chalk.gray(`\n  Config: ~/.perp/settings.json\n`));
         });
     });
-    // ── settings referrals ──
-    settings
-        .command("referrals")
-        .description("Enable or disable referral codes")
-        .argument("<action>", "on | off")
-        .action(async (action) => {
-        await withJsonErrors(isJson(), async () => {
-            const s = loadSettings();
-            if (action === "on") {
-                s.referrals = true;
-                // Reset applied flags so referrals get re-sent on next connection
-                s.referralApplied = { hyperliquid: false, lighter: false };
-                saveSettings(s);
-                if (isJson())
-                    return printJson(jsonOk({ referrals: true }));
-                console.log(chalk.green("\n  Referrals enabled. Codes will be sent on next connection.\n"));
-                if (s.referralCodes.pacifica)
-                    console.log(`  Pacifica builder code: ${s.referralCodes.pacifica}`);
-                if (s.referralCodes.hyperliquid)
-                    console.log(`  Hyperliquid referral:  ${s.referralCodes.hyperliquid}`);
-                if (s.referralCodes.lighter)
-                    console.log(`  Lighter referral:      ${s.referralCodes.lighter}`);
-                console.log();
-            }
-            else if (action === "off") {
-                s.referrals = false;
-                saveSettings(s);
-                if (isJson())
-                    return printJson(jsonOk({ referrals: false }));
-                console.log(chalk.yellow("\n  Referrals disabled. No codes will be sent.\n"));
-            }
-            else {
-                if (isJson())
-                    return printJson(jsonError("INVALID_ARGS", `Invalid action "${action}". Usage: perp settings referrals <on|off>`));
-                console.error(chalk.red(`\n  Usage: perp settings referrals <on|off>\n`));
-            }
-        });
-    });
+    // Note: `settings referrals on/off` removed in v0.12 — referral codes are
+    // now mandatory (SSOT-aligned with Pacifica's always-on builder code).
+    // To reset applied flags (force re-send on next connection):
+    //   perp settings set referralApplied.hyperliquid false   (and same for lighter)
     // ── settings fees ──
-    const fees = settings
-        .command("fees")
-        .description("Show or sync exchange fee tiers");
-    fees
-        .command("show")
-        .description("Show current fee tiers")
-        .action(async () => {
+    // Bare `settings fees` shows current tiers (same as `settings fees show`).
+    const showFees = async () => {
         await withJsonErrors(isJson(), async () => {
             const s = loadSettings();
             if (isJson())
@@ -107,7 +68,15 @@ export function registerSettingsCommands(program, isJson, getAdapterForExchange)
             console.log(chalk.gray(`\n  Sync from exchanges: perp settings fees sync`));
             console.log(chalk.gray(`  Manual set: perp settings fees set <exchange> <taker> <maker>\n`));
         });
-    });
+    };
+    const fees = settings
+        .command("fees")
+        .description("Show or sync exchange fee tiers (default action: show)")
+        .action(showFees);
+    fees
+        .command("show")
+        .description("Show current fee tiers")
+        .action(showFees);
     fees
         .command("sync")
         .description("Fetch fee tiers from exchange APIs and save")
@@ -228,9 +197,6 @@ export function registerSettingsCommands(program, isJson, getAdapterForExchange)
                 }
                 s.defaultExchange = value.toLowerCase();
             }
-            else if (key === "referrals") {
-                s.referrals = value === "true" || value === "on";
-            }
             else if (key.startsWith("referralCodes.")) {
                 const exchange = key.split(".")[1];
                 if (exchange in s.referralCodes) {
@@ -241,9 +207,20 @@ export function registerSettingsCommands(program, isJson, getAdapterForExchange)
                     return;
                 }
             }
+            else if (key.startsWith("referralApplied.")) {
+                // Force re-apply: `set referralApplied.hyperliquid false`
+                const exchange = key.split(".")[1];
+                if (exchange in s.referralApplied) {
+                    s.referralApplied[exchange] = value === "true" || value === "on";
+                }
+                else {
+                    console.error(chalk.red(`  Unknown exchange: ${exchange}`));
+                    return;
+                }
+            }
             else {
                 console.error(chalk.red(`  Unknown key: ${key}`));
-                console.log(chalk.gray("  Valid keys: default-exchange, referrals, referralCodes.pacifica, referralCodes.hyperliquid, referralCodes.lighter\n"));
+                console.log(chalk.gray("  Valid keys: default-exchange, referralCodes.{pacifica,hyperliquid,lighter}, referralApplied.{hyperliquid,lighter}\n"));
                 return;
             }
             saveSettings(s);
@@ -320,7 +297,7 @@ export function registerSettingsCommands(program, isJson, getAdapterForExchange)
             console.log(`  File:    ${chalk.gray("~/.perp/.env")}\n`);
         }
         else {
-            // Raw env var (e.g. LIGHTER_API_KEY, custom vars)
+            // Raw env var (e.g. LIGHTER_REFERRAL_CODE, custom vars)
             setEnvVar(name, value);
             if (isJson())
                 return printJson(jsonOk({ key: name, file: ENV_FILE }));

package/dist/commands/trade.js

@@ -1,4 +1,5 @@
 import { printJson, errorAndExit, withJsonErrors, jsonOk, jsonError, symbolMatch, formatUsd } from "../utils.js";
+import { extractErrorMessage } from "../errors.js";
 import { logExecution } from "../execution-log.js";
 import { validateTrade } from "../trade-validator.js";
 import { generateClientId, logClientId, isOrderDuplicate } from "../client-id-tracker.js";
@@ -108,7 +109,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
             logExecution({
                 type: "market_order", exchange: adapter.name, symbol: symbol.toUpperCase(),
                 side: s, size, status: "failed", dryRun: false,
-                error: err instanceof Error ? err.message : String(err),
+                error: extractErrorMessage(err),
                 meta: { ...(clientId ? { clientOrderId: clientId } : {}), ...(opts.smart ? { smart: true } : {}) },
             });
             throw err;
@@ -156,7 +157,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
             logExecution({ type: "market_order", exchange: adapter.name, symbol: symbol.toUpperCase(), side: "buy", size, status: "success", dryRun: false, meta: opts.smart ? { smart: true } : undefined });
         }
         catch (err) {
-            logExecution({ type: "market_order", exchange: adapter.name, symbol: symbol.toUpperCase(), side: "buy", size, status: "failed", dryRun: false, error: err instanceof Error ? err.message : String(err) });
+            logExecution({ type: "market_order", exchange: adapter.name, symbol: symbol.toUpperCase(), side: "buy", size, status: "failed", dryRun: false, error: extractErrorMessage(err) });
             throw err;
         }
         if (isJson())
@@ -194,7 +195,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
             logExecution({ type: "market_order", exchange: adapter.name, symbol: symbol.toUpperCase(), side: "sell", size, status: "success", dryRun: false, meta: opts.smart ? { smart: true } : undefined });
         }
         catch (err) {
-            logExecution({ type: "market_order", exchange: adapter.name, symbol: symbol.toUpperCase(), side: "sell", size, status: "failed", dryRun: false, error: err instanceof Error ? err.message : String(err) });
+            logExecution({ type: "market_order", exchange: adapter.name, symbol: symbol.toUpperCase(), side: "sell", size, status: "failed", dryRun: false, error: extractErrorMessage(err) });
             throw err;
         }
         if (isJson())
@@ -282,7 +283,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
             logExecution({
                 type: "limit_order", exchange: adapter.name, symbol: symbol.toUpperCase(),
                 side: s, size, price, status: "failed", dryRun: false,
-                error: err instanceof Error ? err.message : String(err),
+                error: extractErrorMessage(err),
                 meta: clientId ? { clientOrderId: clientId } : undefined,
             });
             throw err;
@@ -317,7 +318,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
                 console.log(chalk.green(`\n  Order ${oid} cancelled on ${adapter.name}.\n`));
             }
             catch (err) {
-                logExecution({ type: "cancel", exchange: adapter.name, symbol, side: "cancel", size: "0", status: "failed", dryRun: false, error: err instanceof Error ? err.message : String(err), meta: { orderId: oid } });
+                logExecution({ type: "cancel", exchange: adapter.name, symbol, side: "cancel", size: "0", status: "failed", dryRun: false, error: extractErrorMessage(err), meta: { orderId: oid } });
                 throw err;
             }
             return;
@@ -347,7 +348,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
                 console.log(chalk.green(`\n  Order ${oid} cancelled on ${adapter.name}.\n`));
             }
             catch (err) {
-                logExecution({ type: "cancel", exchange: adapter.name, symbol, side: "cancel", size: "0", status: "failed", dryRun: false, error: err instanceof Error ? err.message : String(err), meta: { orderId: oid } });
+                logExecution({ type: "cancel", exchange: adapter.name, symbol, side: "cancel", size: "0", status: "failed", dryRun: false, error: extractErrorMessage(err), meta: { orderId: oid } });
                 throw err;
             }
         }
@@ -373,7 +374,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
                 console.log(chalk.green(`\n  ${matching.length} order(s) for ${symbol} cancelled on ${adapter.name}.\n`));
             }
             catch (err) {
-                logExecution({ type: "cancel", exchange: adapter.name, symbol, side: "cancel", size: "0", status: "failed", dryRun: false, error: err instanceof Error ? err.message : String(err), meta: { bySymbol: true } });
+                logExecution({ type: "cancel", exchange: adapter.name, symbol, side: "cancel", size: "0", status: "failed", dryRun: false, error: extractErrorMessage(err), meta: { bySymbol: true } });
                 throw err;
             }
         }
@@ -422,8 +423,8 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
             console.log(chalk.green(`\n  TWAP job started in background.`));
             console.log(`  ID: ${chalk.white.bold(job.id)}`);
             console.log(`  Session: ${job.tmuxSession}`);
-            console.log(`  Logs: ${chalk.gray(`perp jobs logs ${job.id}`)}`);
-            console.log(`  Stop: ${chalk.gray(`perp jobs stop ${job.id}`)}\n`);
+            console.log(`  Logs: ${chalk.gray(`perp background logs ${job.id}`)}`);
+            console.log(`  Stop: ${chalk.gray(`perp background stop ${job.id}`)}\n`);
             return;
         }
         const adapter = await getAdapter();
@@ -484,7 +485,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
             logExecution({ type: "stop_order", exchange: adapter.name, symbol: symbol.toUpperCase(), side: s, size, price: stopPrice, status: "success", dryRun: false });
         }
         catch (err) {
-            logExecution({ type: "stop_order", exchange: adapter.name, symbol: symbol.toUpperCase(), side: s, size, price: stopPrice, status: "failed", dryRun: false, error: err instanceof Error ? err.message : String(err) });
+            logExecution({ type: "stop_order", exchange: adapter.name, symbol: symbol.toUpperCase(), side: s, size, price: stopPrice, status: "failed", dryRun: false, error: extractErrorMessage(err) });
             throw err;
         }
         if (isJson())
@@ -614,7 +615,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
                 });
             }
             catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
+                const msg = extractErrorMessage(err);
                 logExecution({
                     type: "limit_order", exchange: adapter.name, symbol: sym,
                     side: closeSide, size: levelSize, price: level.price,
@@ -709,13 +710,13 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
             logExecution({
                 type: "rebalance", exchange: adapter.name, symbol: symbol.toUpperCase(), side: mode,
                 size: leverage, status: "failed", dryRun: false,
-                error: err instanceof Error ? err.message : String(err),
+                error: extractErrorMessage(err),
                 meta: { action: "set_leverage", leverage: parseInt(leverage), mode },
             });
             throw err;
         }
     });
-    // grid/dca moved to 'perp bot grid' / 'perp bot dca'
+    // grid/dca moved to 'perp strategy grid' / 'perp strategy dca'
     // ── Position Management Shortcuts ──
     trade
         .command("close-all")
@@ -1080,7 +1081,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
                 });
             }
             catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
+                const msg = extractErrorMessage(err);
                 logExecution({
                     type: "limit_order", exchange: adapter.name, symbol: sym,
                     side: s, size: level.size, price: level.price,
@@ -1104,7 +1105,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         }
         console.log();
     });
-    // grid/dca/trailing-stop moved to 'perp bot'
+    // grid/dca/trailing-stop moved to 'perp strategy'
     // ── PnL Tracker ──
     trade
         .command("pnl-track")

package/dist/commands/wallet.d.ts

@@ -1,4 +1,5 @@
 import { Command } from "commander";
+import type { ExchangeAdapter } from "../exchanges/index.js";
 /** Exported for smart landing page in index.ts */
 export declare function getWalletSetupStatus(): {
     hasWallets: boolean;
@@ -13,4 +14,4 @@ export declare function getWalletSetupStatus(): {
 export declare function getActiveWalletKey(exchange: string): string | null;
 /** Get wallet key by name. Returns null if wallet doesn't exist. */
 export declare function getWalletKeyByName(name: string): string | null;
-export declare function registerWalletCommands(program: Command, isJson: () => boolean): void;
+export declare function registerWalletCommands(program: Command, isJson: () => boolean, getAdapter?: () => Promise<ExchangeAdapter>, getPacificaAdapter?: () => unknown): void;