perp-cli 0.6.4 → 0.7.2

package/dist/commands/account.js

@@ -1,8 +1,7 @@
-import { PacificaAdapter } from "../exchanges/pacifica.js";
-import { HyperliquidAdapter } from "../exchanges/hyperliquid.js";
 import { makeTable, formatUsd, formatPnl, printJson, jsonOk, jsonError, symbolMatch, withJsonErrors } from "../utils.js";
 import chalk from "chalk";
 import { assessRisk } from "../risk.js";
+import { hasPacificaSdk, isDexCapable } from "../exchanges/capabilities.js";
 const EXCHANGES = ["pacifica", "hyperliquid", "lighter"];
 async function fetchExchangeSnapshot(name, getAdapter) {
     try {
@@ -96,7 +95,7 @@ function buildSummary(snapshots) {
     };
 }
 function pac(adapter) {
-    if (!(adapter instanceof PacificaAdapter))
+    if (!hasPacificaSdk(adapter))
         throw new Error("Market settings are only available on Pacifica.");
     return adapter;
 }
@@ -112,6 +111,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
         try {
             if (name === "hyperliquid") {
                 const { HyperliquidSpotAdapter } = await import("../exchanges/hyperliquid-spot.js");
+                const { HyperliquidAdapter } = await import("../exchanges/hyperliquid.js");
                 const hlSpot = new HyperliquidSpotAdapter(adapter);
                 await hlSpot.init();
                 const raw = await hlSpot.getSpotBalances();
@@ -149,7 +149,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
         catch { /* spot not available */ }
         // HL unified account: perp equity already includes spot USDC balance.
         // Detect by checking if adapter is HL without a dex override.
-        const isUnified = name === "hyperliquid" && !adapter.dex;
+        const isUnified = name === "hyperliquid" && (!isDexCapable(adapter) || !adapter.dex);
         const cutoff24h = Date.now() - 24 * 60 * 60 * 1000;
         const recent = fundingPayments.filter(f => f.time >= cutoff24h);
         const funding24h = recent.reduce((sum, f) => sum + Number(f.payment), 0);
@@ -368,7 +368,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                         ]);
                     }
                     // --hip3: fetch HIP-3 dex positions for HL
-                    if (opts.hip3 && ex === "hyperliquid" && adapter instanceof HyperliquidAdapter) {
+                    if (opts.hip3 && ex === "hyperliquid" && isDexCapable(adapter)) {
                         const hip3 = await fetchHip3Data(adapter, a => a.getPositions());
                         for (const { dex, items } of hip3) {
                             for (const p of items) {
@@ -397,7 +397,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                     try {
                         const adapter = await getAdapterForExchange(ex);
                         grouped[ex] = await adapter.getPositions();
-                        if (opts.hip3 && ex === "hyperliquid" && adapter instanceof HyperliquidAdapter) {
+                        if (opts.hip3 && ex === "hyperliquid" && isDexCapable(adapter)) {
                             const hip3 = await fetchHip3Data(adapter, a => a.getPositions());
                             for (const { dex, items } of hip3)
                                 grouped[`hip3:${dex}`] = items;
@@ -423,7 +423,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
         const positions = await adapter.getPositions();
         // --hip3: append HIP-3 dex positions
         const hip3Positions = [];
-        if (opts.hip3 && adapter instanceof HyperliquidAdapter) {
+        if (opts.hip3 && isDexCapable(adapter)) {
             hip3Positions.push(...await fetchHip3Data(adapter, a => a.getPositions()));
         }
         if (isJson()) {
@@ -494,7 +494,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                         ]);
                     }
                     // --hip3: fetch HIP-3 dex orders for HL
-                    if (opts.hip3 && ex === "hyperliquid" && adapter instanceof HyperliquidAdapter) {
+                    if (opts.hip3 && ex === "hyperliquid" && isDexCapable(adapter)) {
                         const hip3 = await fetchHip3Data(adapter, a => a.getOpenOrders());
                         for (const { dex, items } of hip3) {
                             for (const o of items) {
@@ -523,7 +523,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                     try {
                         const adapter = await getAdapterForExchange(ex);
                         grouped[ex] = await adapter.getOpenOrders();
-                        if (opts.hip3 && ex === "hyperliquid" && adapter instanceof HyperliquidAdapter) {
+                        if (opts.hip3 && ex === "hyperliquid" && isDexCapable(adapter)) {
                             const hip3 = await fetchHip3Data(adapter, a => a.getOpenOrders());
                             for (const { dex, items } of hip3)
                                 grouped[`hip3:${dex}`] = items;
@@ -549,7 +549,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
         const orders = await adapter.getOpenOrders();
         // --hip3: append HIP-3 dex orders
         const hip3Orders = [];
-        if (opts.hip3 && adapter instanceof HyperliquidAdapter) {
+        if (opts.hip3 && isDexCapable(adapter)) {
             hip3Orders.push(...await fetchHip3Data(adapter, a => a.getOpenOrders()));
         }
         if (isJson()) {
@@ -623,8 +623,9 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
         .action(async () => {
         const adapter = await getAdapter();
         // Pacifica: use dedicated SDK endpoint
-        if (adapter instanceof PacificaAdapter) {
-            const settings = await adapter.sdk.getAccountSettings(adapter.publicKey);
+        if (hasPacificaSdk(adapter)) {
+            const sdk = adapter.sdk;
+            const settings = await sdk.getAccountSettings(adapter.publicKey);
             if (isJson())
                 return printJson(jsonOk(settings));
             if (!Array.isArray(settings) || settings.length === 0) {
@@ -902,9 +903,19 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
         .command("twap-orders")
         .description("Active TWAP orders")
         .action(async () => {
-        const adapter = await getAdapter();
-        const p = pac(adapter);
-        const orders = await p.sdk.getTWAPOrders(p.publicKey);
+        let p;
+        try {
+            const adapter = await getAdapter();
+            p = pac(adapter);
+        }
+        catch (err) {
+            if (isJson())
+                return printJson(jsonError("EXCHANGE_ERROR", err instanceof Error ? err.message : String(err)));
+            console.error(chalk.red(`\n  ${err instanceof Error ? err.message : String(err)}\n`));
+            return;
+        }
+        const sdk = p.sdk;
+        const orders = await sdk.getTWAPOrders(p.publicKey);
         if (isJson())
             return printJson(jsonOk(orders));
         if (!orders || orders.length === 0) {
@@ -932,7 +943,73 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                 const exchanges = opts.exchange
                     ? opts.exchange.split(",").map(e => e.trim())
                     : [...EXCHANGES];
-                const snapshots = await Promise.all(exchanges.map(ex => fetchExchangeSnapshot(ex, getAdapterForExchange)));
+                // Fetch snapshots + funding + spot ALL in parallel
+                const fundingByExSym = new Map();
+                const spotRows = [];
+                let totalSpotValue = 0;
+                const [snapshots] = await Promise.all([
+                    // Phase 1: balance + positions + orders
+                    Promise.all(exchanges.map(ex => fetchExchangeSnapshot(ex, getAdapterForExchange))),
+                    // Phase 2: funding payments (parallel with Phase 1)
+                    Promise.allSettled(exchanges.map(async (exName) => {
+                        try {
+                            const adapter = await getAdapterForExchange(exName);
+                            const payments = await adapter.getFundingPayments(200);
+                            for (const p of payments) {
+                                const sym = p.symbol.replace("-PERP", "").toUpperCase();
+                                const key = `${exName}:${sym}`;
+                                fundingByExSym.set(key, (fundingByExSym.get(key) ?? 0) + Number(p.payment));
+                            }
+                        }
+                        catch { /* skip */ }
+                    })),
+                    // Phase 3: spot balances (parallel with Phase 1+2)
+                    Promise.allSettled(exchanges.map(async (exName) => {
+                        try {
+                            const adapter = await getAdapterForExchange(exName);
+                            if (exName === "hyperliquid") {
+                                const { HyperliquidSpotAdapter } = await import("../exchanges/hyperliquid-spot.js");
+                                const { HyperliquidAdapter } = await import("../exchanges/hyperliquid.js");
+                                const hlSpot = new HyperliquidSpotAdapter(adapter);
+                                await hlSpot.init();
+                                const bals = await hlSpot.getSpotBalances();
+                                const markets = await hlSpot.getSpotMarkets();
+                                const priceMap = new Map(markets.map(m => [m.baseToken.toUpperCase(), Number(m.markPrice)]));
+                                for (const b of bals) {
+                                    const base = b.token.replace(/-SPOT$/i, "").toUpperCase();
+                                    if (base === "USDC" || Number(b.total) <= 0)
+                                        continue;
+                                    const price = priceMap.get(base) ?? 0;
+                                    const value = price * Number(b.total);
+                                    if (value < 1)
+                                        continue;
+                                    totalSpotValue += value;
+                                    spotRows.push([chalk.white.bold(base), chalk.gray("hyperliquid"), b.total, `$${formatUsd(price)}`, `$${formatUsd(value)}`]);
+                                }
+                            }
+                            else if (exName === "lighter") {
+                                const { LighterAdapter } = await import("../exchanges/lighter.js");
+                                const { LighterSpotAdapter } = await import("../exchanges/lighter-spot.js");
+                                const ltSpot = new LighterSpotAdapter(adapter);
+                                await ltSpot.init();
+                                const bals = await ltSpot.getSpotBalances();
+                                const markets = await ltSpot.getSpotMarkets();
+                                const priceMap = new Map(markets.map(m => [m.baseToken.toUpperCase(), Number(m.markPrice)]));
+                                for (const b of bals) {
+                                    if (b.token === "USDC" || b.token === "USDC_SPOT" || Number(b.total) <= 0)
+                                        continue;
+                                    const price = priceMap.get(b.token.toUpperCase()) ?? 0;
+                                    const value = price * Number(b.total);
+                                    if (value < 1)
+                                        continue;
+                                    totalSpotValue += value;
+                                    spotRows.push([chalk.white.bold(b.token), chalk.gray("lighter"), b.total, `$${formatUsd(price)}`, `$${formatUsd(value)}`]);
+                                }
+                            }
+                        }
+                        catch { /* spot not available */ }
+                    })),
+                ]);
                 const summary = buildSummary(snapshots);
                 if (isJson()) {
                     return printJson(jsonOk(summary));
@@ -955,7 +1032,6 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                         chalk.green("connected"),
                     ];
                 });
-                // Totals row
                 balRows.push([
                     chalk.cyan.bold("TOTAL"),
                     chalk.cyan.bold(`$${formatUsd(summary.totalEquity)}`),
@@ -965,21 +1041,6 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                     "",
                 ]);
                 console.log(makeTable(["Exchange", "Equity", "Available", "Margin Used", "uPnL", "Status"], balRows));
-                // ── Positions + Funding ──
-                // Fetch funding per exchange in parallel
-                const fundingByExSym = new Map();
-                await Promise.allSettled(exchanges.map(async (exName) => {
-                    try {
-                        const adapter = await getAdapterForExchange(exName);
-                        const payments = await adapter.getFundingPayments(200);
-                        for (const p of payments) {
-                            const sym = p.symbol.replace("-PERP", "").toUpperCase();
-                            const key = `${exName}:${sym}`;
-                            fundingByExSym.set(key, (fundingByExSym.get(key) ?? 0) + Number(p.payment));
-                        }
-                    }
-                    catch { /* skip */ }
-                }));
                 if (summary.positions.length > 0) {
                     console.log(chalk.white.bold("\n  Open Positions"));
                     const posRows = summary.positions.map(p => {
@@ -1005,65 +1066,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                 else {
                     console.log(chalk.gray("\n  No open positions.\n"));
                 }
-                // ── Spot Holdings ──
-                const spotRows = [];
-                let totalSpotValue = 0;
-                for (const exName of exchanges) {
-                    try {
-                        const adapter = await getAdapterForExchange(exName);
-                        if (exName === "hyperliquid") {
-                            const { HyperliquidSpotAdapter } = await import("../exchanges/hyperliquid-spot.js");
-                            const hlSpot = new HyperliquidSpotAdapter(adapter);
-                            await hlSpot.init();
-                            const bals = await hlSpot.getSpotBalances();
-                            const markets = await hlSpot.getSpotMarkets();
-                            const priceMap = new Map(markets.map(m => [m.baseToken.toUpperCase(), Number(m.markPrice)]));
-                            for (const b of bals) {
-                                const base = b.token.replace(/-SPOT$/i, "").toUpperCase();
-                                if (base === "USDC" || Number(b.total) <= 0)
-                                    continue;
-                                const price = priceMap.get(base) ?? 0;
-                                const value = price * Number(b.total);
-                                if (value < 1)
-                                    continue; // skip dust
-                                totalSpotValue += value;
-                                spotRows.push([
-                                    chalk.white.bold(base),
-                                    chalk.gray("hyperliquid"),
-                                    b.total,
-                                    `$${formatUsd(price)}`,
-                                    `$${formatUsd(value)}`,
-                                ]);
-                            }
-                        }
-                        else if (exName === "lighter") {
-                            const { LighterAdapter } = await import("../exchanges/lighter.js");
-                            const { LighterSpotAdapter } = await import("../exchanges/lighter-spot.js");
-                            const ltSpot = new LighterSpotAdapter(adapter);
-                            await ltSpot.init();
-                            const bals = await ltSpot.getSpotBalances();
-                            const markets = await ltSpot.getSpotMarkets();
-                            const priceMap = new Map(markets.map(m => [m.baseToken.toUpperCase(), Number(m.markPrice)]));
-                            for (const b of bals) {
-                                if (b.token === "USDC" || b.token === "USDC_SPOT" || Number(b.total) <= 0)
-                                    continue;
-                                const price = priceMap.get(b.token.toUpperCase()) ?? 0;
-                                const value = price * Number(b.total);
-                                if (value < 1)
-                                    continue;
-                                totalSpotValue += value;
-                                spotRows.push([
-                                    chalk.white.bold(b.token),
-                                    chalk.gray("lighter"),
-                                    b.total,
-                                    `$${formatUsd(price)}`,
-                                    `$${formatUsd(value)}`,
-                                ]);
-                            }
-                        }
-                    }
-                    catch { /* spot not available */ }
-                }
+                // ── Spot Holdings (already fetched in parallel above) ──
                 if (spotRows.length > 0) {
                     console.log(chalk.white.bold("\n  Spot Holdings"));
                     console.log(makeTable(["Token", "Exchange", "Amount", "Price", "Value"], spotRows));

package/dist/commands/agent.d.ts

@@ -1,3 +1,3 @@
 import { Command } from "commander";
-import type { ExchangeAdapter } from "../exchanges/interface.js";
+import type { ExchangeAdapter } from "../exchanges/index.js";
 export declare function registerAgentCommands(program: Command, getAdapter: () => Promise<ExchangeAdapter>, isJson: () => boolean): void;

package/dist/commands/arb/index.d.ts

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

package/dist/commands/arb/index.js

@@ -1,12 +1,12 @@
 import chalk from "chalk";
 import { makeTable, formatUsd, formatPnl, printJson, jsonOk } from "../../utils.js";
+import { SPOT_PERP_TOKEN_MAP } from "../../exchanges/index.js";
 import { readExecutionLog, logExecution } from "../../execution-log.js";
 import { toHourlyRate, computeAnnualSpread } from "../../funding.js";
 import { fetchPacificaPrices, fetchHyperliquidMeta, fetchLighterOrderBookDetails, fetchLighterFundingRates, } from "../../shared-api.js";
 import { computeBasisRisk } from "../../arb-utils.js";
 import { smartOrder } from "../../smart-order.js";
 import { removePosition as persistRemovePosition, getPositions as getArbStatePositions, loadArbState } from "../../arb-state.js";
-import { SPOT_PERP_TOKEN_MAP } from "../../exchanges/spot-interface.js";
 import { fetchAllBalances, computeRebalancePlan } from "../../rebalance.js";
 import { EXCHANGE_TO_CHAIN, getBestQuote } from "../../bridge-engine.js";
 import { computeEnhancedStats } from "../../arb-history-stats.js";

package/dist/commands/arb-auto.d.ts

@@ -1,5 +1,5 @@
 import { Command } from "commander";
-import type { ExchangeAdapter } from "../exchanges/interface.js";
+import type { ExchangeAdapter } from "../exchanges/index.js";
 interface FundingSnapshot {
     symbol: string;
     pacRate: number;

package/dist/commands/arb-auto.js

@@ -1,7 +1,7 @@
 import chalk from "chalk";
 import { formatUsd, printJson, jsonOk, makeTable } from "../utils.js";
 import { computeExecutableSize } from "../liquidity.js";
-import { computeMatchedSize, computeSpotPerpMatchedSize } from "../arb/sizing.js";
+import { computeMatchedSize, computeSpotPerpMatchedSize } from "../arb/index.js";
 import { computeAnnualSpread, toHourlyRate } from "../funding.js";
 import { fetchPacificaPricesRaw, parsePacificaRaw, fetchHyperliquidMetaRaw, parseHyperliquidMetaRaw, fetchLighterOrderBookDetailsRaw, fetchLighterFundingRatesRaw, parseLighterRaw, } from "../shared-api.js";
 import { scanDexArb } from "../dex-asset-map.js";
@@ -1144,7 +1144,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
         if (opts.compare)
             return handleCompare(isJson, opts.compare);
         if (opts.rates)
-            return handleRates(isJson, { symbol: opts.symbol, symbols: opts.symbols, all: opts.all, minSpread: opts.min });
+            return handleRates(isJson, { symbol: opts.symbol, symbols: opts.symbols, all: opts.all, minSpread: opts.min, top: opts.top });
         if (opts.basis)
             return handleBasisScan(isJson, { minBasis: opts.min, symbol: typeof opts.basis === "string" ? opts.basis : opts.symbol });
         if (opts.hip3)
@@ -1226,7 +1226,9 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
         if (!isJson())
             console.log(chalk.cyan("  Scanning perp-perp funding rate spreads...\n"));
         const spreads = await fetchFundingSpreads();
-        const filtered = spreads.filter(s => Math.abs(s.spread) >= minSpread);
+        let filtered = spreads.filter(s => Math.abs(s.spread) >= minSpread);
+        if (opts.top)
+            filtered = filtered.slice(0, parseInt(opts.top));
         if (isJson()) {
             const perpPerp = filtered.map(s => {
                 const grossSpread = Math.abs(s.spread);

package/dist/commands/arb.d.ts

@@ -1,5 +1,5 @@
 import { Command } from "commander";
-import type { ExchangeAdapter } from "../exchanges/interface.js";
+import type { ExchangeAdapter } from "../exchanges/index.js";
 export declare function registerArbCommands(program: Command, isJson: () => boolean, getAdapterForExchange?: (exchange: string) => Promise<ExchangeAdapter>): void;
 export interface PriceSnapshot {
     symbol: string;
@@ -25,6 +25,7 @@ export declare function handleRates(isJson: () => boolean, opts: {
     symbols?: string;
     all?: boolean;
     minSpread: string;
+    top?: string;
 }): Promise<void>;
 export declare function handleBasisScan(isJson: () => boolean, opts: {
     minBasis: string;

package/dist/commands/arb.js

@@ -278,6 +278,8 @@ export async function handleRates(isJson, opts) {
             saveFundingSnapshot(allRates);
     }
     catch { /* non-critical */ }
+    if (opts.top)
+        snapshot.symbols = snapshot.symbols.slice(0, parseInt(opts.top));
     if (isJson()) {
         // Enrich with 24h rate history for each symbol
         const now = new Date();

package/dist/commands/bot.d.ts

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