perp-cli 0.6.3 → 0.7.1

package/dist/commands/market.js

@@ -1,7 +1,6 @@
-import { PacificaAdapter } from "../exchanges/pacifica.js";
-import { HyperliquidAdapter } from "../exchanges/hyperliquid.js";
 import { makeTable, formatUsd, formatPercent, printJson, jsonOk, jsonError, withJsonErrors } from "../utils.js";
 import chalk from "chalk";
+import { hasPacificaSdk, isDexCapable } from "../exchanges/capabilities.js";
 const EXCHANGES = ["pacifica", "hyperliquid", "lighter"];
 export function registerMarketCommands(program, getAdapter, isJson, getAdapterForExchange) {
     const market = program.command("market").description("Market data commands");
@@ -30,7 +29,7 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
                     const adapter = await getAdapterForExchange(ex);
                     grouped[ex] = await adapter.getMarkets();
                     // --hip3: fetch HIP-3 dex markets
-                    if (opts.hip3 && ex === "hyperliquid" && adapter instanceof HyperliquidAdapter) {
+                    if (opts.hip3 && ex === "hyperliquid" && isDexCapable(adapter)) {
                         const dexes = await adapter.listDeployedDexes();
                         await Promise.allSettled(dexes.map(async (d) => {
                             const dexAdapter = Object.create(adapter);
@@ -67,7 +66,7 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
         const markets = await adapter.getMarkets();
         // --hip3: fetch HIP-3 dex markets
         const hip3 = {};
-        if (opts.hip3 && adapter instanceof HyperliquidAdapter) {
+        if (opts.hip3 && isDexCapable(adapter)) {
             const dexes = await adapter.listDeployedDexes();
             await Promise.allSettled(dexes.map(async (d) => {
                 const dexAdapter = Object.create(adapter);
@@ -127,8 +126,9 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
             return;
         }
         const adapter = await getAdapter();
-        if (adapter instanceof PacificaAdapter) {
-            const prices = await adapter.sdk.getPrices();
+        if (hasPacificaSdk(adapter)) {
+            const sdk = adapter.sdk;
+            const prices = await sdk.getPrices();
             if (isJson())
                 return printJson(jsonOk(prices));
             const rows = prices.map((p) => [
@@ -351,7 +351,7 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
         .action(async () => {
         await withJsonErrors(isJson(), async () => {
             const adapter = await getAdapter();
-            if (!(adapter instanceof HyperliquidAdapter)) {
+            if (!(isDexCapable(adapter))) {
                 if (isJson())
                     return printJson(jsonError("INVALID_EXCHANGE", "HIP-3 dexes are only available on Hyperliquid. Use -e hyperliquid."));
                 console.error(chalk.red("\n  HIP-3 dexes are only available on Hyperliquid. Use -e hyperliquid.\n"));

package/dist/commands/plan.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 registerPlanCommands(program: Command, getAdapter: () => Promise<ExchangeAdapter>, isJson: () => boolean): void;

package/dist/commands/rebalance.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 registerRebalanceCommands(program: Command, getAdapterForExchange: (exchange: string) => Promise<ExchangeAdapter>, isJson: () => boolean): void;

package/dist/commands/rebalance.js

@@ -229,29 +229,28 @@ export function registerRebalanceCommands(program, getAdapterForExchange, isJson
  * Execute a withdrawal from a source exchange.
  */
 async function executeWithdraw(move, adapters) {
+    const { hasPacificaSdk, isWithdrawCapable, hasEvmAddress } = await import("../exchanges/capabilities.js");
     const adapter = adapters.get(move.from);
     if (!adapter)
         throw new Error(`No adapter for ${move.from}`);
-    switch (move.from) {
+    switch (adapter.name) {
         case "pacifica": {
-            const { PacificaAdapter } = await import("../exchanges/pacifica.js");
-            if (!(adapter instanceof PacificaAdapter))
+            if (!hasPacificaSdk(adapter))
                 throw new Error("Invalid adapter");
-            await adapter.sdk.withdraw({ amount: String(move.amount), dest_address: adapter.publicKey }, adapter.publicKey, adapter.signer);
+            const sdk = adapter.sdk;
+            await sdk.withdraw({ amount: String(move.amount), dest_address: adapter.publicKey }, adapter.publicKey, adapter.signer);
             break;
         }
         case "hyperliquid": {
-            const { HyperliquidAdapter } = await import("../exchanges/hyperliquid.js");
-            if (!(adapter instanceof HyperliquidAdapter))
+            if (!isWithdrawCapable(adapter) || !hasEvmAddress(adapter))
                 throw new Error("Invalid adapter");
             await adapter.withdraw(String(move.amount), adapter.address);
             break;
         }
         case "lighter": {
-            const { LighterAdapter } = await import("../exchanges/lighter.js");
-            if (!(adapter instanceof LighterAdapter))
+            if (!isWithdrawCapable(adapter))
                 throw new Error("Invalid adapter");
-            await adapter.withdraw(move.amount);
+            await adapter.withdraw(String(move.amount), "");
             break;
         }
         default:

package/dist/commands/risk.d.ts

@@ -1,5 +1,5 @@
 import { Command } from "commander";
-import type { ExchangeAdapter } from "../exchanges/interface.js";
+import type { ExchangeAdapter } from "../exchanges/index.js";
 /** Run health check and return results + render. Exported for use by status --health. */
 export declare function runHealthCheck(isJson: () => boolean): Promise<void>;
 export declare function registerRiskCommands(program: Command, getAdapterForExchange: (exchange: string) => Promise<ExchangeAdapter>, isJson: () => boolean): void;

package/dist/commands/settings.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 registerSettingsCommands(program: Command, isJson: () => boolean, getAdapterForExchange?: (exchange: string) => Promise<ExchangeAdapter>): void;

package/dist/commands/settings.js

@@ -1,5 +1,5 @@
 import chalk from "chalk";
-import { printJson, jsonOk, withJsonErrors } from "../utils.js";
+import { printJson, jsonOk, jsonError, 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
@@ -80,6 +80,8 @@ export function registerSettingsCommands(program, isJson, getAdapterForExchange)
                 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`));
             }
         });

package/dist/commands/trade.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 registerTradeCommands(program: Command, getAdapter: () => Promise<ExchangeAdapter>, isJson: () => boolean, isDryRun?: () => boolean, getAdapterForExchange?: (exchange: string) => Promise<ExchangeAdapter>): void;

package/dist/commands/trade.js

@@ -1,17 +1,10 @@
-import { PacificaAdapter } from "../exchanges/pacifica.js";
-import { HyperliquidAdapter } from "../exchanges/hyperliquid.js";
-import { LighterAdapter } from "../exchanges/lighter.js";
 import { printJson, errorAndExit, withJsonErrors, jsonOk, jsonError, symbolMatch, formatUsd } from "../utils.js";
 import { logExecution } from "../execution-log.js";
 import { validateTrade } from "../trade-validator.js";
 import { generateClientId, logClientId, isOrderDuplicate } from "../client-id-tracker.js";
 import { smartOrder } from "../smart-order.js";
 import chalk from "chalk";
-function pac(adapter) {
-    if (!(adapter instanceof PacificaAdapter))
-        throw new Error("This command requires --exchange pacifica");
-    return adapter;
-}
+import { hasPacificaSdk, isTwapCapable, isTriggerOrderCapable, isQueryOrderCapable } from "../exchanges/capabilities.js";
 export function registerTradeCommands(program, getAdapter, isJson, isDryRun = () => false, getAdapterForExchange) {
     /** Guard: if --dry-run is active, log the intended action and return without executing. */
     function dryRunGuard(action, details) {
@@ -130,7 +123,6 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         if (isJson())
             return printJson(jsonOk(clientId ? { ...result, clientOrderId: clientId } : result));
         console.log(chalk.green(`\n  Market ${s.toUpperCase()} ${size} ${symbol.toUpperCase()} placed on ${adapter.name}.${opts.smart ? " (smart)" : ""}${clientId ? ` (id: ${clientId})` : ""}\n`));
-        printJson(jsonOk(result));
     });
     // Shortcuts: trade buy / trade sell
     trade
@@ -170,7 +162,6 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         if (isJson())
             return printJson(jsonOk(clientId ? { ...result, clientOrderId: clientId } : result));
         console.log(chalk.green(`\n  Market BUY ${size} ${symbol.toUpperCase()} placed on ${adapter.name}.${opts.smart ? " (smart)" : ""}\n`));
-        printJson(jsonOk(result));
     });
     trade
         .command("sell <symbol> <size>")
@@ -209,7 +200,6 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         if (isJson())
             return printJson(jsonOk(clientId ? { ...result, clientOrderId: clientId } : result));
         console.log(chalk.green(`\n  Market SELL ${size} ${symbol.toUpperCase()} placed on ${adapter.name}.${opts.smart ? " (smart)" : ""}\n`));
-        printJson(jsonOk(result));
     });
     // ── Split Order (orderbook-aware) ──
     trade
@@ -227,10 +217,9 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
             errorAndExit("Side must be 'buy' or 'sell'");
         if (isNaN(totalUsd) || totalUsd <= 0)
             errorAndExit("USD amount must be > 0");
-        const exchange = program.opts().exchange ?? "unknown";
-        if (dryRunGuard("split-order", { exchange, symbol: sym, side: orderSide, totalUsd, ...opts }))
-            return;
         const adapter = await getAdapter();
+        if (dryRunGuard("split-order", { exchange: adapter.name, symbol: sym, side: orderSide, totalUsd, ...opts }))
+            return;
         const { runSplitOrder } = await import("../strategies/split-order.js");
         const result = await runSplitOrder(adapter, {
             symbol: sym,
@@ -308,7 +297,6 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         if (isJson())
             return printJson(jsonOk(clientId ? { ...result, clientOrderId: clientId } : result));
         console.log(chalk.green(`\n  Limit ${s.toUpperCase()} ${size} ${symbol.toUpperCase()} @ $${price} placed on ${adapter.name}.${clientId ? ` (id: ${clientId})` : ""}\n`));
-        printJson(jsonOk(result));
     });
     trade
         .command("cancel <symbolOrOrderId> [orderId]")
@@ -439,23 +427,12 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
             return;
         }
         const adapter = await getAdapter();
-        // Lighter or any exchange without native TWAP → client-side TWAP (foreground)
-        if (adapter instanceof LighterAdapter) {
-            const { runTWAP } = await import("../strategies/twap.js");
-            const result = await runTWAP(adapter, {
-                symbol: symbol.toUpperCase(),
-                side: s,
-                totalSize: parseFloat(size),
-                durationSec: parseInt(duration),
-                slices: opts.slices ? parseInt(opts.slices) : undefined,
-            });
-            if (isJson())
-                return printJson(jsonOk(result));
-            return;
-        }
+        // Native TWAP: Pacifica (SDK) or Hyperliquid (twapOrder)
+        // Fallback: client-side TWAP for any exchange without native support
         let result;
-        if (adapter instanceof PacificaAdapter) {
-            result = await adapter.sdk.createTWAP({
+        if (hasPacificaSdk(adapter)) {
+            const sdk = adapter.sdk;
+            result = await sdk.createTWAP({
                 symbol: symbol.toUpperCase(),
                 amount: size,
                 side: s === "buy" ? "bid" : "ask",
@@ -464,27 +441,37 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
                 duration_in_seconds: parseInt(duration),
             }, adapter.publicKey, adapter.signer);
         }
-        else if (adapter instanceof HyperliquidAdapter) {
+        else if (isTwapCapable(adapter)) {
             const minutes = parseInt(duration);
             if (minutes < 5 || minutes > 1440)
                 errorAndExit("HL TWAP duration must be 5-1440 minutes");
             result = await adapter.twapOrder(symbol.toUpperCase(), s, size, minutes, { reduceOnly: opts.reduceOnly });
         }
         else {
-            errorAndExit("TWAP orders require --exchange pacifica, hyperliquid, or lighter");
+            // Client-side TWAP (foreground) for exchanges without native TWAP
+            const { runTWAP } = await import("../strategies/twap.js");
+            const twapResult = await runTWAP(adapter, {
+                symbol: symbol.toUpperCase(),
+                side: s,
+                totalSize: parseFloat(size),
+                durationSec: parseInt(duration),
+                slices: opts.slices ? parseInt(opts.slices) : undefined,
+            });
+            if (isJson())
+                return printJson(jsonOk(twapResult));
+            return;
         }
         if (isJson())
             return printJson(jsonOk(result));
         console.log(chalk.green(`\n  TWAP ${s.toUpperCase()} ${size} ${symbol.toUpperCase()} over ${duration} placed on ${adapter.name}.\n`));
-        printJson(jsonOk(result));
     });
     // === Stop / Trigger orders — Pacifica + Hyperliquid ===
     trade
-        .command("stop <symbol> <side> <stopPrice> <size>")
+        .command("stop <symbol> <side> <size> <stopPrice>")
         .description("Place a stop order")
         .option("--limit-price <price>", "Limit price (makes it stop-limit)")
         .option("--reduce-only", "Reduce only order")
-        .action(async (symbol, side, stopPrice, size, opts) => {
+        .action(async (symbol, side, size, stopPrice, opts) => {
         const s = side.toLowerCase();
         if (s !== "buy" && s !== "sell")
             errorAndExit("Side must be buy or sell");
@@ -503,7 +490,6 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         if (isJson())
             return printJson(jsonOk(result));
         console.log(chalk.green(`\n  Stop order placed on ${adapter.name}.\n`));
-        printJson(jsonOk(result));
     });
     // === TP/SL — Pacifica + Hyperliquid ===
     trade
@@ -522,7 +508,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         const adapter = await getAdapter();
         if (dryRunGuard("tpsl", { exchange: adapter.name, symbol: symbol.toUpperCase(), side: s, tp: opts.tp ?? "none", sl: opts.sl ?? "none" }))
             return;
-        if (adapter instanceof PacificaAdapter) {
+        if (hasPacificaSdk(adapter)) {
             // TP/SL side is opposite of position: LONG position → "ask" to close
             const params = {
                 symbol: symbol.toUpperCase(),
@@ -532,12 +518,13 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
                 params.take_profit = { stop_price: opts.tp, limit_price: opts.tpLimit };
             if (opts.sl)
                 params.stop_loss = { stop_price: opts.sl };
-            const result = await adapter.sdk.setTPSL(params, adapter.publicKey, adapter.signer);
+            const sdk = adapter.sdk;
+            const result = await sdk.setTPSL(params, adapter.publicKey, adapter.signer);
             if (isJson())
                 return printJson(jsonOk(result));
             console.log(chalk.green(`\n  TP/SL set for ${symbol.toUpperCase()} on Pacifica.\n`));
         }
-        else if (adapter instanceof HyperliquidAdapter) {
+        else if (isTriggerOrderCapable(adapter)) {
             // HL uses trigger orders for TP/SL
             const results = [];
             const posSize = opts.size || "0"; // 0 = full position via positionTpsl grouping
@@ -552,8 +539,8 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
                 return printJson(jsonOk(results));
             console.log(chalk.green(`\n  TP/SL set for ${symbol.toUpperCase()} on Hyperliquid.\n`));
         }
-        else if (adapter instanceof LighterAdapter) {
-            // Lighter uses triggerPrice in signCreateOrder for TP/SL
+        else {
+            // Fallback: use stopOrder for TP/SL (Lighter and others)
             const closeSide = s === "buy" ? "sell" : "buy"; // Close opposite side
             const results = [];
             if (opts.tp) {
@@ -564,10 +551,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
             }
             if (isJson())
                 return printJson(jsonOk(results));
-            console.log(chalk.green(`\n  TP/SL set for ${symbol.toUpperCase()} on Lighter.\n`));
-        }
-        else {
-            errorAndExit("TP/SL requires --exchange pacifica, hyperliquid, or lighter");
+            console.log(chalk.green(`\n  TP/SL set for ${symbol.toUpperCase()} on ${adapter.name}.\n`));
         }
     });
     // === Scaled Take-Profit (분할익절) ===
@@ -672,8 +656,10 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         .description("Cancel a stop order (Pacifica)")
         .action(async (symbol, stopOrderId) => {
         const adapter = await getAdapter();
-        const p = pac(adapter);
-        const result = await p.sdk.cancelStopOrder({ symbol: symbol.toUpperCase(), order_id: Number(stopOrderId) }, p.publicKey, p.signer);
+        if (!hasPacificaSdk(adapter))
+            throw new Error("This command requires --exchange pacifica");
+        const sdk = adapter.sdk;
+        const result = await sdk.cancelStopOrder({ symbol: symbol.toUpperCase(), order_id: Number(stopOrderId) }, adapter.publicKey, adapter.signer);
         if (isJson())
             return printJson(jsonOk(result));
         console.log(chalk.green(`\n  Stop order ${stopOrderId} cancelled.\n`));
@@ -684,10 +670,11 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         .action(async (symbol, twapOrderId) => {
         const adapter = await getAdapter();
         let result;
-        if (adapter instanceof PacificaAdapter) {
-            result = await adapter.sdk.cancelTWAP({ symbol: symbol.toUpperCase(), twap_order_id: Number(twapOrderId) }, adapter.publicKey, adapter.signer);
+        if (hasPacificaSdk(adapter)) {
+            const sdk = adapter.sdk;
+            result = await sdk.cancelTWAP({ symbol: symbol.toUpperCase(), twap_order_id: Number(twapOrderId) }, adapter.publicKey, adapter.signer);
         }
-        else if (adapter instanceof HyperliquidAdapter) {
+        else if (isTwapCapable(adapter)) {
             result = await adapter.twapCancel(symbol.toUpperCase(), Number(twapOrderId));
         }
         else {
@@ -903,7 +890,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         .action(async (orderId) => {
         await withJsonErrors(isJson(), async () => {
             const adapter = await getAdapter();
-            if (adapter instanceof HyperliquidAdapter) {
+            if (isQueryOrderCapable(adapter)) {
                 const result = await adapter.queryOrder(Number(orderId));
                 if (isJson())
                     return printJson(jsonOk(result));

package/dist/commands/wallet.d.ts

@@ -13,6 +13,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;
-/** Get all wallet names. */
-export declare function getWalletNames(): string[];
 export declare function registerWalletCommands(program: Command, isJson: () => boolean): void;

package/dist/commands/wallet.js

@@ -47,11 +47,6 @@ export function getWalletKeyByName(name) {
     const store = loadStore();
     return store.wallets[name]?.privateKey ?? null;
 }
-/** Get all wallet names. */
-export function getWalletNames() {
-    const store = loadStore();
-    return Object.keys(store.wallets);
-}
 async function getSolanaBalances(address, isTestnet) {
     const { Connection, PublicKey } = await import("@solana/web3.js");
     const rpcUrl = isTestnet

package/dist/constants.d.ts

@@ -1,14 +1,11 @@
 /**
  * Shared constants for perp-cli.
  */
-import { type ExchangeFees } from "./settings.js";
 /** Default taker fee per exchange (as fraction, e.g. 0.00035 = 0.035%) */
 export declare const TAKER_FEES: Record<string, number>;
 /** Get taker fee for an exchange. Uses settings if available, falls back to defaults. */
 export declare function getTakerFee(exchange: string): number;
 /** Get maker fee for an exchange. Uses settings if available. */
 export declare function getMakerFee(exchange: string): number;
-/** Get full fee info for an exchange. */
-export declare function getExchangeFees(exchange: string): ExchangeFees;
 /** Default taker fee for single-exchange use (when exchange is unknown). */
 export declare const DEFAULT_TAKER_FEE = 0.00035;

package/dist/constants.js

@@ -32,9 +32,5 @@ export function getMakerFee(exchange) {
     catch { /* fallback */ }
     return 0;
 }
-/** Get full fee info for an exchange. */
-export function getExchangeFees(exchange) {
-    return { taker: getTakerFee(exchange), maker: getMakerFee(exchange) };
-}
 /** Default taker fee for single-exchange use (when exchange is unknown). */
 export const DEFAULT_TAKER_FEE = 0.00035;

package/dist/cross-chain-margin.d.ts

@@ -5,7 +5,7 @@
  * - Per-exchange margin status checking
  * - Auto-size computation based on orderbook depth and margin limits
  */
-import type { ExchangeAdapter } from "./exchanges/interface.js";
+import type { ExchangeAdapter } from "./exchanges/index.js";
 export interface ChainMarginStatus {
     exchange: string;
     chain: string;

package/dist/dashboard/index.d.ts

@@ -0,0 +1,4 @@
+export { startDashboard } from "./server.js";
+export type { DashboardExchange, DashboardOpts, DashboardSnapshot } from "./server.js";
+export { WsFeedManager } from "./ws-feeds.js";
+export type { WsFeedState, WsFeedManagerOpts } from "./ws-feeds.js";

package/dist/dashboard/index.js

@@ -0,0 +1,3 @@
+// dashboard/ barrel — public API
+export { startDashboard } from "./server.js";
+export { WsFeedManager } from "./ws-feeds.js";

package/dist/dashboard/server.d.ts

@@ -4,7 +4,7 @@
  * Polls all configured exchange adapters and pushes updates to connected clients.
  * Includes cross-exchange arb data: funding rate comparison + dex arb scan.
  */
-import type { ExchangeAdapter, ExchangeBalance, ExchangePosition, ExchangeOrder, ExchangeMarketInfo } from "../exchanges/interface.js";
+import type { ExchangeAdapter, ExchangeBalance, ExchangePosition, ExchangeOrder, ExchangeMarketInfo } from "../exchanges/index.js";
 export interface DashboardExchange {
     name: string;
     adapter: ExchangeAdapter;

package/dist/dashboard/server.js

@@ -318,7 +318,7 @@ export async function startDashboard(exchanges, opts = {}) {
         }, { once: true });
     }
     return new Promise((resolve) => {
-        server.listen(port, async () => {
+        server.listen(port, "127.0.0.1", async () => {
             // Start WS feeds (connects to exchange WS APIs)
             await feedMgr.start();
             // Start arb REST polling (30s cycle)

package/dist/dashboard/ws-feeds.d.ts

@@ -5,7 +5,7 @@
  * Falls back to REST polling if WS connection fails.
  * Arb/market data stays on REST (cross-exchange aggregation, no single WS covers it).
  */
-import type { ExchangeBalance, ExchangePosition, ExchangeOrder } from "../exchanges/interface.js";
+import type { ExchangeBalance, ExchangePosition, ExchangeOrder } from "../exchanges/index.js";
 import type { DashboardExchange } from "./server.js";
 export interface WsFeedState {
     balance: ExchangeBalance;

package/dist/event-stream.d.ts

@@ -4,7 +4,7 @@
  * Streams normalized account events as NDJSON (one JSON per line).
  * Uses poll-based diffing for cross-exchange compatibility.
  */
-import type { ExchangeAdapter } from "./exchanges/interface.js";
+import type { ExchangeAdapter } from "./exchanges/index.js";
 export type EventType = "position_opened" | "position_closed" | "position_updated" | "order_placed" | "order_filled" | "order_cancelled" | "balance_update" | "liquidation_warning" | "margin_call" | "heartbeat" | "error";
 export interface StreamEvent {
     type: EventType;

package/dist/exchanges/aster.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Aster DEX adapter — Binance Futures API compatible REST wrapper.
+ * Docs: https://docs.asterdex.com/product/aster-perpetuals/api/api-documentation
+ * Base: https://fapi.asterdex.com
+ */
+import type { ExchangeAdapter, ExchangeMarketInfo, ExchangePosition, ExchangeOrder, ExchangeBalance, ExchangeTrade, ExchangeFundingPayment, ExchangeKline } from "./interface.js";
+export declare class AsterAdapter implements ExchangeAdapter {
+    readonly name = "aster";
+    readonly chain = "bnb";
+    readonly aliases: readonly ["ast"];
+    private _apiKey;
+    private _apiSecret;
+    private _baseUrl;
+    private _testnet;
+    constructor(apiKey?: string, apiSecret?: string, testnet?: boolean);
+    get isReadOnly(): boolean;
+    init(): Promise<void>;
+    getMarkets(): Promise<ExchangeMarketInfo[]>;
+    getOrderbook(symbol: string): Promise<{
+        bids: [string, string][];
+        asks: [string, string][];
+    }>;
+    getRecentTrades(symbol: string, limit?: number): Promise<ExchangeTrade[]>;
+    getFundingHistory(symbol: string, limit?: number): Promise<{
+        time: number;
+        rate: string;
+        price: string | null;
+    }[]>;
+    getKlines(symbol: string, interval: string, startTime: number, endTime: number): Promise<ExchangeKline[]>;
+    getBalance(): Promise<ExchangeBalance>;
+    getPositions(): Promise<ExchangePosition[]>;
+    getOpenOrders(): Promise<ExchangeOrder[]>;
+    getOrderHistory(limit?: number): Promise<ExchangeOrder[]>;
+    getTradeHistory(limit?: number): Promise<ExchangeTrade[]>;
+    getFundingPayments(limit?: number): Promise<ExchangeFundingPayment[]>;
+    marketOrder(symbol: string, side: "buy" | "sell", size: string): Promise<unknown>;
+    limitOrder(symbol: string, side: "buy" | "sell", price: string, size: string, opts?: {
+        reduceOnly?: boolean;
+        tif?: string;
+    }): Promise<unknown>;
+    editOrder(symbol: string, orderId: string, price: string, size: string): Promise<unknown>;
+    cancelOrder(symbol: string, orderId: string): Promise<unknown>;
+    cancelAllOrders(symbol?: string): Promise<unknown>;
+    setLeverage(symbol: string, leverage: number, marginMode?: "cross" | "isolated"): Promise<unknown>;
+    stopOrder(symbol: string, side: "buy" | "sell", size: string, triggerPrice: string, opts?: {
+        limitPrice?: string;
+        reduceOnly?: boolean;
+    }): Promise<unknown>;
+    withdraw(amount: string, _destination: string, _opts?: {
+        assetId?: number;
+        routeType?: number;
+    }): Promise<unknown>;
+    private _sign;
+    private _publicGet;
+    private _signedGet;
+    private _signedPost;
+    private _signedDelete;
+}