perp-cli 0.4.12 → 0.5.2

package/dist/commands/market.js

@@ -8,47 +8,55 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
     market
         .command("list")
         .description("List all available markets")
-        .action(async () => {
+        .option("--hip3", "Include HIP-3 dex markets (Hyperliquid)")
+        .action(async (opts) => {
         const explicitExchange = program.getOptionValueSource?.("exchange") === "cli";
+        const HEADERS = ["Symbol", "Mark", "Index", "Funding", "24h Vol", "OI", "Max Lev"];
+        const marketRow = (m) => [
+            chalk.white.bold(m.symbol),
+            `$${formatUsd(m.markPrice)}`,
+            `$${formatUsd(m.indexPrice)}`,
+            formatPercent(m.fundingRate),
+            `$${formatUsd(m.volume24h)}`,
+            `$${formatUsd(m.openInterest)}`,
+            String(m.maxLeverage) + "x",
+        ];
         // Multi-exchange mode
         if (!explicitExchange && getAdapterForExchange) {
-            const allRows = [];
+            const grouped = {};
             const errors = {};
             await Promise.all(EXCHANGES.map(async (ex) => {
                 try {
                     const adapter = await getAdapterForExchange(ex);
-                    const markets = await adapter.getMarkets();
-                    for (const m of markets) {
-                        allRows.push([
-                            chalk.white.bold(m.symbol),
-                            chalk.gray(ex.slice(0, 3).toUpperCase()),
-                            `$${formatUsd(m.markPrice)}`,
-                            `$${formatUsd(m.indexPrice)}`,
-                            formatPercent(m.fundingRate),
-                            `$${formatUsd(m.volume24h)}`,
-                            `$${formatUsd(m.openInterest)}`,
-                            String(m.maxLeverage) + "x",
-                        ]);
+                    grouped[ex] = await adapter.getMarkets();
+                    // --hip3: fetch HIP-3 dex markets
+                    if (opts.hip3 && ex === "hyperliquid" && adapter instanceof HyperliquidAdapter) {
+                        const dexes = await adapter.listDeployedDexes();
+                        await Promise.allSettled(dexes.map(async (d) => {
+                            const dexAdapter = Object.create(adapter);
+                            dexAdapter.setDex(d.name);
+                            const markets = await dexAdapter.getMarkets();
+                            if (markets.length > 0)
+                                grouped[`hip3:${d.name}`] = markets;
+                        }));
                     }
                 }
                 catch (err) {
                     errors[ex] = err instanceof Error ? err.message : String(err);
                 }
             }));
-            // Sort by symbol name
-            allRows.sort((a, b) => a[0].localeCompare(b[0]));
             if (isJson()) {
-                const grouped = {};
-                await Promise.all(EXCHANGES.map(async (ex) => {
-                    try {
-                        const adapter = await getAdapterForExchange(ex);
-                        grouped[ex] = await adapter.getMarkets();
-                    }
-                    catch { /* skip */ }
-                }));
                 return printJson(jsonOk({ exchanges: grouped, errors: Object.keys(errors).length > 0 ? errors : undefined }));
             }
-            console.log(makeTable(["Symbol", "Exch", "Mark", "Index", "Funding", "24h Vol", "OI", "Max Lev"], allRows));
+            // Per-exchange tables
+            for (const [ex, markets] of Object.entries(grouped)) {
+                if (markets.length === 0)
+                    continue;
+                const isHip3 = ex.startsWith("hip3:");
+                const label = isHip3 ? chalk.magenta.bold(`  HIP-3: ${ex.slice(5)}`) : chalk.cyan.bold(`  ${ex.toUpperCase()}`);
+                console.log(`\n${label} ${chalk.gray(`(${markets.length} markets)`)}`);
+                console.log(makeTable(HEADERS, markets.map(marketRow)));
+            }
             for (const [ex, msg] of Object.entries(errors)) {
                 console.log(chalk.gray(`  ${ex}: ${msg}`));
             }
@@ -57,58 +65,63 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
         // Single exchange mode
         const adapter = await getAdapter();
         const markets = await adapter.getMarkets();
-        if (isJson())
+        // --hip3: fetch HIP-3 dex markets
+        const hip3 = {};
+        if (opts.hip3 && adapter instanceof HyperliquidAdapter) {
+            const dexes = await adapter.listDeployedDexes();
+            await Promise.allSettled(dexes.map(async (d) => {
+                const dexAdapter = Object.create(adapter);
+                dexAdapter.setDex(d.name);
+                const m = await dexAdapter.getMarkets();
+                if (m.length > 0)
+                    hip3[d.name] = m;
+            }));
+        }
+        if (isJson()) {
+            if (Object.keys(hip3).length > 0) {
+                return printJson(jsonOk({ main: markets, hip3 }));
+            }
             return printJson(jsonOk(markets));
-        const rows = markets.map((m) => [
-            chalk.white.bold(m.symbol),
-            `$${formatUsd(m.markPrice)}`,
-            `$${formatUsd(m.indexPrice)}`,
-            formatPercent(m.fundingRate),
-            `$${formatUsd(m.volume24h)}`,
-            `$${formatUsd(m.openInterest)}`,
-            String(m.maxLeverage) + "x",
-        ]);
-        console.log(makeTable(["Symbol", "Mark", "Index", "Funding", "24h Vol", "OI", "Max Lev"], rows));
+        }
+        console.log(makeTable(HEADERS, markets.map(marketRow)));
+        for (const [dex, m] of Object.entries(hip3)) {
+            console.log(chalk.magenta.bold(`\n  HIP-3: ${dex}`) + chalk.gray(` (${m.length} markets)`));
+            console.log(makeTable(HEADERS, m.map(marketRow)));
+        }
     });
     market
         .command("prices")
         .description("Get current prices for all markets")
         .action(async () => {
         const explicitExchange = program.getOptionValueSource?.("exchange") === "cli";
+        const PRICE_HEADERS = ["Symbol", "Mark", "Index", "Funding"];
+        const priceRow = (m) => [
+            chalk.white.bold(m.symbol),
+            `$${formatUsd(m.markPrice)}`,
+            `$${formatUsd(m.indexPrice)}`,
+            formatPercent(m.fundingRate),
+        ];
         if (!explicitExchange && getAdapterForExchange) {
-            const allRows = [];
+            const grouped = {};
             const errors = {};
             await Promise.all(EXCHANGES.map(async (ex) => {
                 try {
                     const adapter = await getAdapterForExchange(ex);
-                    const markets = await adapter.getMarkets();
-                    for (const m of markets) {
-                        allRows.push([
-                            chalk.white.bold(m.symbol),
-                            chalk.gray(ex.slice(0, 3).toUpperCase()),
-                            `$${formatUsd(m.markPrice)}`,
-                            `$${formatUsd(m.indexPrice)}`,
-                            formatPercent(m.fundingRate),
-                        ]);
-                    }
+                    grouped[ex] = await adapter.getMarkets();
                 }
                 catch (err) {
                     errors[ex] = err instanceof Error ? err.message : String(err);
                 }
             }));
-            allRows.sort((a, b) => a[0].localeCompare(b[0]));
             if (isJson()) {
-                const grouped = {};
-                await Promise.all(EXCHANGES.map(async (ex) => {
-                    try {
-                        const adapter = await getAdapterForExchange(ex);
-                        grouped[ex] = await adapter.getMarkets();
-                    }
-                    catch { /* skip */ }
-                }));
                 return printJson(jsonOk({ exchanges: grouped, errors: Object.keys(errors).length > 0 ? errors : undefined }));
             }
-            console.log(makeTable(["Symbol", "Exch", "Mark", "Index", "Funding"], allRows));
+            for (const [ex, markets] of Object.entries(grouped)) {
+                if (markets.length === 0)
+                    continue;
+                console.log(chalk.cyan.bold(`\n  ${ex.toUpperCase()}`) + chalk.gray(` (${markets.length} markets)`));
+                console.log(makeTable(PRICE_HEADERS, markets.map(priceRow)));
+            }
             for (const [ex, msg] of Object.entries(errors))
                 console.log(chalk.gray(`  ${ex}: ${msg}`));
             return;
@@ -128,17 +141,10 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
             console.log(makeTable(["Symbol", "Mark", "Mid", "Oracle", "Funding"], rows));
         }
         else {
-            // Generic: use getMarkets as price source
             const markets = await adapter.getMarkets();
             if (isJson())
                 return printJson(jsonOk(markets));
-            const rows = markets.map((m) => [
-                chalk.white.bold(m.symbol),
-                `$${formatUsd(m.markPrice)}`,
-                `$${formatUsd(m.indexPrice)}`,
-                formatPercent(m.fundingRate),
-            ]);
-            console.log(makeTable(["Symbol", "Mark", "Index", "Funding"], rows));
+            console.log(makeTable(PRICE_HEADERS, markets.map(priceRow)));
         }
     });
     market
@@ -148,7 +154,11 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
         const adapter = await getAdapter();
         const markets = await adapter.getMarkets();
         const sym = symbol.toUpperCase();
-        const m = markets.find((mk) => mk.symbol === sym || mk.symbol === `${sym}-PERP` || mk.symbol.replace(/-PERP$/, "") === sym);
+        const m = markets.find((mk) => {
+            const s = mk.symbol.toUpperCase();
+            return s === sym || s === `${sym}-PERP` || s.replace(/-PERP$/, "") === sym
+                || s.split(":").pop() === sym; // HIP-3: "km:US500" matches "US500"
+        });
         if (!m) {
             if (isJson())
                 return printJson(jsonError("SYMBOL_NOT_FOUND", `Market ${sym} not found`));
@@ -178,15 +188,40 @@ export function registerMarketCommands(program, getAdapter, isJson, getAdapterFo
         const depth = parseInt(opts.depth);
         const asks = book.asks.slice(0, depth).reverse();
         const bids = book.bids.slice(0, depth);
+        // Compute spread
+        const bestBid = bids[0] ? Number(bids[0][0]) : 0;
+        const bestAsk = asks[asks.length - 1] ? Number(asks[asks.length - 1][0]) : 0;
+        const midPrice = bestBid && bestAsk ? (bestBid + bestAsk) / 2 : bestBid || bestAsk;
+        const spreadAbs = bestBid && bestAsk ? bestAsk - bestBid : 0;
+        const spreadPct = midPrice > 0 ? (spreadAbs / midPrice) * 100 : 0;
+        // Compute cumulative sizes + max for bar scaling
+        let askCum = 0;
+        const askCums = asks.map(([, a]) => { askCum += Number(a); return askCum; });
+        let bidCum = 0;
+        const bidCums = bids.map(([, a]) => { bidCum += Number(a); return bidCum; });
+        const maxCum = Math.max(askCums[askCums.length - 1] || 0, bidCums[bidCums.length - 1] || 0);
+        const BAR_WIDTH = 20;
+        const bar = (cum) => {
+            const len = maxCum > 0 ? Math.round((cum / maxCum) * BAR_WIDTH) : 0;
+            return "█".repeat(len);
+        };
         console.log(chalk.cyan.bold(`\n  Orderbook: ${symbol.toUpperCase()} (${adapter.name})\n`));
-        console.log(chalk.gray("  Price          Size"));
-        console.log(chalk.gray("  ─────────────────────"));
-        asks.forEach(([p, a]) => {
-            console.log(chalk.red(`  ${formatUsd(p).padStart(12)}  ${a}`));
+        console.log(chalk.gray("  Price          Size          Cum$              Depth"));
+        console.log(chalk.gray("  " + "─".repeat(60)));
+        asks.forEach(([p, a], i) => {
+            const cumUsd = askCums[i] * (Number(p));
+            console.log(chalk.red(`  ${formatUsd(p).padStart(12)}  ${String(a).padEnd(12)}  $${formatUsd(cumUsd).padEnd(14)}`) +
+                chalk.red.dim(bar(askCums[i])));
         });
-        console.log(chalk.gray("  ─── spread ───"));
-        bids.forEach(([p, a]) => {
-            console.log(chalk.green(`  ${formatUsd(p).padStart(12)}  ${a}`));
+        // Spread line
+        const spreadStr = spreadAbs > 0
+            ? `$${formatUsd(spreadAbs)} (${spreadPct.toFixed(3)}%)`
+            : "─";
+        console.log(chalk.gray(`  ${"─".repeat(16)} spread: ${spreadStr} ${"─".repeat(10)}`));
+        bids.forEach(([p, a], i) => {
+            const cumUsd = bidCums[i] * (Number(p));
+            console.log(chalk.green(`  ${formatUsd(p).padStart(12)}  ${String(a).padEnd(12)}  $${formatUsd(cumUsd).padEnd(14)}`) +
+                chalk.green.dim(bar(bidCums[i])));
         });
         console.log();
     });

package/dist/commands/trade.js

@@ -312,19 +312,33 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
     });
     trade
         .command("cancel <symbolOrOrderId> [orderId]")
-        .description("Cancel an order by orderId (auto-detects symbol), or by symbol + orderId")
+        .description("Cancel order(s) — by orderId, by symbol + orderId, or by symbol name (cancels all orders for that symbol)")
         .action(async (symbolOrOrderId, orderId) => {
         const adapter = await getAdapter();
-        let symbol;
-        let oid;
         if (orderId) {
             // cancel <symbol> <orderId>
-            symbol = symbolOrOrderId.toUpperCase();
-            oid = orderId;
+            const symbol = symbolOrOrderId.toUpperCase();
+            const oid = orderId;
+            if (dryRunGuard("cancel", { exchange: adapter.name, symbol, orderId: oid }))
+                return;
+            try {
+                const result = await adapter.cancelOrder(symbol, oid);
+                logExecution({ type: "cancel", exchange: adapter.name, symbol, side: "cancel", size: "0", status: "success", dryRun: false, meta: { orderId: oid } });
+                if (isJson())
+                    return printJson(jsonOk(result));
+                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 } });
+                throw err;
+            }
+            return;
         }
-        else {
+        // Single argument — is it an orderId (numeric) or a symbol name?
+        const isNumeric = /^\d+$/.test(symbolOrOrderId);
+        if (isNumeric) {
             // cancel <orderId> — look up symbol from open orders
-            oid = symbolOrOrderId;
+            const oid = symbolOrOrderId;
             const orders = await adapter.getOpenOrders();
             const match = orders.find((o) => String(o.orderId) === oid);
             if (!match) {
@@ -334,20 +348,46 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
                 console.log(chalk.yellow(`\n  ${err}\n`));
                 return;
             }
-            symbol = match.symbol;
-        }
-        if (dryRunGuard("cancel", { exchange: adapter.name, symbol, orderId: oid }))
-            return;
-        try {
-            const result = await adapter.cancelOrder(symbol, oid);
-            logExecution({ type: "cancel", exchange: adapter.name, symbol, side: "cancel", size: "0", status: "success", dryRun: false, meta: { orderId: oid } });
-            if (isJson())
-                return printJson(jsonOk(result));
-            console.log(chalk.green(`\n  Order ${oid} cancelled on ${adapter.name}.\n`));
+            const symbol = match.symbol;
+            if (dryRunGuard("cancel", { exchange: adapter.name, symbol, orderId: oid }))
+                return;
+            try {
+                const result = await adapter.cancelOrder(symbol, oid);
+                logExecution({ type: "cancel", exchange: adapter.name, symbol, side: "cancel", size: "0", status: "success", dryRun: false, meta: { orderId: oid } });
+                if (isJson())
+                    return printJson(jsonOk(result));
+                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 } });
+                throw err;
+            }
         }
-        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 } });
-            throw err;
+        else {
+            // cancel <symbol> — cancel all open orders for this symbol
+            const symbol = symbolOrOrderId.toUpperCase();
+            const orders = await adapter.getOpenOrders();
+            const matching = orders.filter((o) => symbolMatch(o.symbol, symbol));
+            if (matching.length === 0) {
+                const err = `No open orders found for ${symbol}`;
+                if (isJson())
+                    return printJson(jsonOk({ cancelled: false, symbol, reason: err }));
+                console.log(chalk.yellow(`\n  ${err}\n`));
+                return;
+            }
+            if (dryRunGuard("cancel_by_symbol", { exchange: adapter.name, symbol, count: matching.length }))
+                return;
+            try {
+                const result = await adapter.cancelAllOrders(symbol);
+                logExecution({ type: "cancel", exchange: adapter.name, symbol, side: "cancel", size: "0", status: "success", dryRun: false, meta: { bySymbol: true, count: matching.length } });
+                if (isJson())
+                    return printJson(jsonOk({ cancelled: true, symbol, count: matching.length, result }));
+                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 } });
+                throw err;
+            }
         }
     });
     trade

package/dist/exchanges/hyperliquid.d.ts

@@ -59,6 +59,15 @@ export declare class HyperliquidAdapter implements ExchangeAdapter {
      * Bypasses the SDK entirely — works for order, batchModify, twapOrder, etc.
      */
     private ensureSigner;
+    /**
+     * Normalize trailing zeros from price ('p') and size ('s') string fields
+     * in an action object, recursively. Matches the SDK's normalizeTrailingZeros.
+     *
+     * The HL validator normalizes these fields before hashing; if we hash without
+     * normalizing, the recovered signer address won't match → "User or API Wallet
+     * does not exist" error.
+     */
+    private static _normalizeAction;
     private _signAndSendAction;
     /**
      * Place an order via raw exchange API with EIP-712 signing.
@@ -69,8 +78,8 @@ export declare class HyperliquidAdapter implements ExchangeAdapter {
         reduceOnly?: boolean;
         tif?: string;
     }): Promise<unknown>;
-    cancelOrder(symbol: string, orderId: string): Promise<import("hyperliquid").CancelOrderResponse>;
-    cancelAllOrders(symbol?: string): Promise<import("hyperliquid").CancelOrderResponse[]>;
+    cancelOrder(symbol: string, orderId: string): Promise<unknown>;
+    cancelAllOrders(symbol?: string): Promise<unknown[]>;
     editOrder(symbol: string, orderId: string, price: string, size: string): Promise<unknown>;
     setLeverage(symbol: string, leverage: number, marginMode?: "cross" | "isolated"): Promise<any>;
     stopOrder(symbol: string, side: "buy" | "sell", size: string, triggerPrice: string, opts?: {