perp-cli 0.4.12 → 0.5.0

package/dist/commands/account.js

@@ -1,4 +1,5 @@
 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";
@@ -239,7 +240,14 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                     exchanges: results,
                     errors: Object.keys(errors).length > 0 ? errors : undefined,
                     totalEquity: results.reduce((s, r) => s + Number(r.perp.equity), 0),
-                    totalSpotValueUsd: results.reduce((s, r) => s + r.totalSpotValueUsd, 0),
+                    totalSpotValueUsd: results.reduce((s, r) => {
+                        if (r.unifiedAccount) {
+                            return s + r.spot
+                                .filter(b => b.token.replace(/-SPOT$/i, "").toUpperCase() !== "USDC")
+                                .reduce((ss, b) => ss + (b.valueUsd ?? 0), 0);
+                        }
+                        return s + r.totalSpotValueUsd;
+                    }, 0),
                     totalAccountValueUsd: grandTotal,
                     totalFunding24h: results.reduce((s, r) => s + r.funding24h, 0),
                 }));
@@ -318,10 +326,26 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
         printSingleBalance(exName, result);
         console.log();
     });
+    // ── HIP-3 dex helper: fetch data from all deployed dexes in parallel ──
+    async function fetchHip3Data(hlAdapter, fetcher) {
+        const dexes = await hlAdapter.listDeployedDexes();
+        const results = await Promise.allSettled(dexes.map(async (d) => {
+            // Clone adapter with dex set
+            const dexAdapter = Object.create(hlAdapter);
+            dexAdapter.setDex(d.name);
+            const items = await fetcher(dexAdapter);
+            return { dex: d.name, items };
+        }));
+        return results
+            .filter((r) => r.status === "fulfilled")
+            .map(r => r.value)
+            .filter(r => r.items.length > 0);
+    }
     account
         .command("positions")
         .description("Show open positions")
-        .action(async () => {
+        .option("--hip3", "Include HIP-3 dex positions (Hyperliquid)")
+        .action(async (opts) => {
         const explicitExchange = program.getOptionValueSource?.("exchange") === "cli";
         if (!explicitExchange && getAdapterForExchange) {
             const allRows = [];
@@ -343,6 +367,25 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                             `${p.leverage}x`,
                         ]);
                     }
+                    // --hip3: fetch HIP-3 dex positions for HL
+                    if (opts.hip3 && ex === "hyperliquid" && adapter instanceof HyperliquidAdapter) {
+                        const hip3 = await fetchHip3Data(adapter, a => a.getPositions());
+                        for (const { dex, items } of hip3) {
+                            for (const p of items) {
+                                allRows.push([
+                                    chalk.white.bold(p.symbol),
+                                    chalk.magenta(dex),
+                                    p.side === "long" ? chalk.green("LONG") : chalk.red("SHORT"),
+                                    p.size,
+                                    `$${formatUsd(p.entryPrice)}`,
+                                    `$${formatUsd(p.markPrice)}`,
+                                    p.liquidationPrice === "N/A" ? chalk.gray("N/A") : `$${formatUsd(p.liquidationPrice)}`,
+                                    formatPnl(p.unrealizedPnl),
+                                    `${p.leverage}x`,
+                                ]);
+                            }
+                        }
+                    }
                 }
                 catch (err) {
                     errors[ex] = err instanceof Error ? err.message : String(err);
@@ -354,6 +397,11 @@ 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) {
+                            const hip3 = await fetchHip3Data(adapter, a => a.getPositions());
+                            for (const { dex, items } of hip3)
+                                grouped[`hip3:${dex}`] = items;
+                        }
                     }
                     catch { /* skip */ }
                 }));
@@ -370,11 +418,24 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                 console.log(chalk.gray(`  ${ex}: ${msg}`));
             return;
         }
+        // Single exchange mode
         const adapter = await getAdapter();
         const positions = await adapter.getPositions();
-        if (isJson())
+        // --hip3: append HIP-3 dex positions
+        const hip3Positions = [];
+        if (opts.hip3 && adapter instanceof HyperliquidAdapter) {
+            hip3Positions.push(...await fetchHip3Data(adapter, a => a.getPositions()));
+        }
+        if (isJson()) {
+            if (hip3Positions.length > 0) {
+                const hip3Map = {};
+                for (const { dex, items } of hip3Positions)
+                    hip3Map[dex] = items;
+                return printJson(jsonOk({ main: positions, hip3: hip3Map }));
+            }
             return printJson(jsonOk(positions));
-        if (positions.length === 0) {
+        }
+        if (positions.length === 0 && hip3Positions.length === 0) {
             console.log(chalk.gray("\n  No open positions.\n"));
             return;
         }
@@ -388,12 +449,29 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
             formatPnl(p.unrealizedPnl),
             `${p.leverage}x`,
         ]);
-        console.log(makeTable(["Symbol", "Side", "Size", "Entry", "Mark", "Liq", "PnL", "Lev"], rows));
+        if (rows.length > 0) {
+            console.log(makeTable(["Symbol", "Side", "Size", "Entry", "Mark", "Liq", "PnL", "Lev"], rows));
+        }
+        for (const { dex, items } of hip3Positions) {
+            console.log(chalk.magenta.bold(`\n  HIP-3: ${dex}`));
+            const dexRows = items.map((p) => [
+                chalk.white.bold(p.symbol),
+                p.side === "long" ? chalk.green("LONG") : chalk.red("SHORT"),
+                p.size,
+                `$${formatUsd(p.entryPrice)}`,
+                `$${formatUsd(p.markPrice)}`,
+                p.liquidationPrice === "N/A" ? chalk.gray("N/A") : `$${formatUsd(p.liquidationPrice)}`,
+                formatPnl(p.unrealizedPnl),
+                `${p.leverage}x`,
+            ]);
+            console.log(makeTable(["Symbol", "Side", "Size", "Entry", "Mark", "Liq", "PnL", "Lev"], dexRows));
+        }
     });
     account
         .command("orders")
         .description("Show open orders")
-        .action(async () => {
+        .option("--hip3", "Include HIP-3 dex orders (Hyperliquid)")
+        .action(async (opts) => {
         const explicitExchange = program.getOptionValueSource?.("exchange") === "cli";
         if (!explicitExchange && getAdapterForExchange) {
             const allRows = [];
@@ -415,6 +493,25 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                             o.status,
                         ]);
                     }
+                    // --hip3: fetch HIP-3 dex orders for HL
+                    if (opts.hip3 && ex === "hyperliquid" && adapter instanceof HyperliquidAdapter) {
+                        const hip3 = await fetchHip3Data(adapter, a => a.getOpenOrders());
+                        for (const { dex, items } of hip3) {
+                            for (const o of items) {
+                                allRows.push([
+                                    o.orderId,
+                                    chalk.white.bold(o.symbol),
+                                    chalk.magenta(dex),
+                                    o.side === "buy" ? chalk.green("BUY") : chalk.red("SELL"),
+                                    o.type,
+                                    `$${formatUsd(o.price)}`,
+                                    o.size,
+                                    o.filled,
+                                    o.status,
+                                ]);
+                            }
+                        }
+                    }
                 }
                 catch (err) {
                     errors[ex] = err instanceof Error ? err.message : String(err);
@@ -426,6 +523,11 @@ 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) {
+                            const hip3 = await fetchHip3Data(adapter, a => a.getOpenOrders());
+                            for (const { dex, items } of hip3)
+                                grouped[`hip3:${dex}`] = items;
+                        }
                     }
                     catch { /* skip */ }
                 }));
@@ -442,25 +544,54 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
                 console.log(chalk.gray(`  ${ex}: ${msg}`));
             return;
         }
+        // Single exchange mode
         const adapter = await getAdapter();
         const orders = await adapter.getOpenOrders();
-        if (isJson())
+        // --hip3: append HIP-3 dex orders
+        const hip3Orders = [];
+        if (opts.hip3 && adapter instanceof HyperliquidAdapter) {
+            hip3Orders.push(...await fetchHip3Data(adapter, a => a.getOpenOrders()));
+        }
+        if (isJson()) {
+            if (hip3Orders.length > 0) {
+                const hip3Map = {};
+                for (const { dex, items } of hip3Orders)
+                    hip3Map[dex] = items;
+                return printJson(jsonOk({ main: orders, hip3: hip3Map }));
+            }
             return printJson(jsonOk(orders));
-        if (orders.length === 0) {
+        }
+        if (orders.length === 0 && hip3Orders.length === 0) {
             console.log(chalk.gray("\n  No open orders.\n"));
             return;
         }
-        const rows = orders.map((o) => [
-            o.orderId,
-            chalk.white.bold(o.symbol),
-            o.side === "buy" ? chalk.green("BUY") : chalk.red("SELL"),
-            o.type,
-            `$${formatUsd(o.price)}`,
-            o.size,
-            o.filled,
-            o.status,
-        ]);
-        console.log(makeTable(["ID", "Symbol", "Side", "Type", "Price", "Size", "Filled", "Status"], rows));
+        if (orders.length > 0) {
+            const rows = orders.map((o) => [
+                o.orderId,
+                chalk.white.bold(o.symbol),
+                o.side === "buy" ? chalk.green("BUY") : chalk.red("SELL"),
+                o.type,
+                `$${formatUsd(o.price)}`,
+                o.size,
+                o.filled,
+                o.status,
+            ]);
+            console.log(makeTable(["ID", "Symbol", "Side", "Type", "Price", "Size", "Filled", "Status"], rows));
+        }
+        for (const { dex, items } of hip3Orders) {
+            console.log(chalk.magenta.bold(`\n  HIP-3: ${dex}`));
+            const dexRows = items.map((o) => [
+                o.orderId,
+                chalk.white.bold(o.symbol),
+                o.side === "buy" ? chalk.green("BUY") : chalk.red("SELL"),
+                o.type,
+                `$${formatUsd(o.price)}`,
+                o.size,
+                o.filled,
+                o.status,
+            ]);
+            console.log(makeTable(["ID", "Symbol", "Side", "Type", "Price", "Size", "Filled", "Status"], dexRows));
+        }
     });
     account
         .command("history")
@@ -495,7 +626,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
         const settings = await p.sdk.getAccountSettings(p.publicKey);
         if (isJson())
             return printJson(jsonOk(settings));
-        if (settings.length === 0) {
+        if (!Array.isArray(settings) || settings.length === 0) {
             console.log(chalk.gray("\n  No market settings configured.\n"));
             return;
         }

package/dist/commands/agent.js

@@ -184,14 +184,14 @@ export function registerAgentCommands(program, getAdapter, isJson) {
                         "perp arb close <SYM> --json",
                         "perp arb close <SYM> --dry-run --json",
                         "perp arb close <SYM> --pair <longEx>:<shortEx> --json",
-                        "perp arb funding-earned --json",
-                        "perp arb funding-earned --period 30 --json",
+                        "perp arb status --funding --json",
+                        "perp arb status --funding --period 30 --json",
                         "perp arb history --json",
-                        "perp arb dex --json",
-                        "perp arb dex-monitor --min 10",
+                        "perp arb scan --hip3 --json",
+                        "perp arb monitor --hip3 --min 10",
                         "perp gap show --json",
                     ],
-                    description: "Cross-exchange funding arb: scan → exec → status → funding-earned → close. Plus cross-dex arb and price gaps.",
+                    description: "Cross-exchange funding arb: scan → exec → status → close. Plus cross-dex arb (--hip3) and price gaps.",
                 },
                 {
                     category: "risk_management",

package/dist/commands/arb/index.js

@@ -5,7 +5,7 @@ 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 } from "../../arb-state.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";
@@ -90,8 +90,10 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
     // ── arb status ──
     arb
         .command("status")
-        .description("Show open arb positions (perp-perp + spot-perp) with PnL breakdown")
-        .action(async () => {
+        .description("Show open arb positions with PnL breakdown + actual funding earned")
+        .option("--period <days>", "Funding lookback period in days", "7")
+        .option("--symbol <symbol>", "Filter funding data by symbol")
+        .action(async (opts) => {
         if (!isJson())
             console.log(chalk.cyan("\n  Checking arb positions across exchanges...\n"));
         // Fetch positions from all exchanges
@@ -482,6 +484,8 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
             console.log(`    Portfolio APR:   ${chalk.cyan(`${portfolioApr.toFixed(1)}%`)}`);
         }
         console.log(chalk.gray(`    (Fees assume ${(TAKER_FEE * 100).toFixed(3)}% taker for entry + exit.)\n`));
+        // Always show actual funding payments earned
+        await printFundingEarned(getAdapterForExchange, isJson, { period: opts.period, symbol: opts.symbol });
     });
     // ── arb close ──
     arb
@@ -490,9 +494,174 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
         .option("--dry-run", "Show what would happen without executing")
         .option("--pair <pair>", "Specify arb pair as longExchange:shortExchange (e.g. pacifica:hyperliquid)")
         .option("--smart", "Smart execution: IOC limit at best bid/ask + 1 tick (reduces slippage)")
+        .option("--spot-exch <exchange>", "Override spot exchange for spot-perp close (hl or lt)")
+        .option("--perp-exch <exchange>", "Override perp exchange for spot-perp close")
         .action(async (symbol, opts) => {
         const sym = symbol.toUpperCase();
         const dryRun = !!opts.dryRun || process.argv.includes("--dry-run");
+        // Check if this is a spot-perp position (auto-detect from arb state)
+        const arbState = loadArbState();
+        const statePos = arbState?.positions?.find(p => p.symbol.toUpperCase() === sym && p.mode === "spot-perp");
+        if (statePos) {
+            // ── Inline spot-perp close logic ──
+            const aliasMap = { hl: "hyperliquid", pac: "pacifica", lt: "lighter" };
+            const spotExch = aliasMap[opts.spotExch?.toLowerCase() ?? ""] || opts.spotExch?.toLowerCase() || statePos.spotExchange || statePos.longExchange;
+            const perpExch = aliasMap[opts.perpExch?.toLowerCase() ?? ""] || opts.perpExch?.toLowerCase() || statePos.shortExchange;
+            if (!spotExch || !perpExch) {
+                const msg = "Cannot determine exchanges. Specify --spot-exch and --perp-exch, or ensure the position is tracked in state.";
+                if (isJson())
+                    return printJson(jsonOk({ error: msg }));
+                console.log(chalk.red(`  ${msg}`));
+                return;
+            }
+            // Load spot adapter
+            const { HyperliquidSpotAdapter } = await import("../../exchanges/hyperliquid-spot.js");
+            const { LighterSpotAdapter } = await import("../../exchanges/lighter-spot.js");
+            let spotAdapter;
+            if (spotExch === "hyperliquid") {
+                const hlAdapter = await getAdapterForExchange("hyperliquid");
+                const hlSpot = new HyperliquidSpotAdapter(hlAdapter);
+                await hlSpot.init();
+                spotAdapter = hlSpot;
+            }
+            else {
+                const ltAdapter = await getAdapterForExchange("lighter");
+                const ltSpot = new LighterSpotAdapter(ltAdapter);
+                await ltSpot.init();
+                spotAdapter = ltSpot;
+            }
+            const perpAdapter = await getAdapterForExchange(perpExch);
+            const spotSymbol = `${sym}/USDC`;
+            // Find how much to close
+            const perpPositions = await perpAdapter.getPositions();
+            const perpPos = perpPositions.find(p => p.symbol.replace("-PERP", "").toUpperCase() === sym && p.side === "short");
+            if (!perpPos) {
+                const msg = `No short perp position found for ${sym} on ${perpExch}`;
+                if (isJson())
+                    return printJson(jsonOk({ error: msg }));
+                console.log(chalk.red(`  ${msg}`));
+                return;
+            }
+            const closeSize = perpPos.size;
+            if (!isJson()) {
+                console.log(chalk.cyan(`\n  Closing Spot+Perp Arb: ${sym}`));
+                console.log(chalk.gray(`    SPOT  ${spotExch}: sell ${closeSize}`));
+                console.log(chalk.gray(`    PERP  ${perpExch}: buy  ${closeSize} (close short)`));
+                console.log(chalk.gray(`    Executing...\n`));
+            }
+            // Same exchange -> sequential (nonce collision), different -> parallel
+            let spotResult;
+            let perpResult;
+            if (spotExch === perpExch) {
+                spotResult = await spotAdapter.spotMarketOrder(spotSymbol, "sell", closeSize)
+                    .then(r => ({ status: "fulfilled", value: r }))
+                    .catch(e => ({ status: "rejected", reason: e }));
+                perpResult = await perpAdapter.marketOrder(sym, "buy", closeSize)
+                    .then(r => ({ status: "fulfilled", value: r }))
+                    .catch(e => ({ status: "rejected", reason: e }));
+            }
+            else {
+                [spotResult, perpResult] = await Promise.allSettled([
+                    spotAdapter.spotMarketOrder(spotSymbol, "sell", closeSize),
+                    perpAdapter.marketOrder(sym, "buy", closeSize),
+                ]);
+            }
+            const spotOk = spotResult.status === "fulfilled";
+            const perpOk = perpResult.status === "fulfilled";
+            if (spotOk && perpOk) {
+                // Post-close fill verification
+                let closeVerified = true;
+                const closeWarnings = [];
+                try {
+                    await new Promise(r => setTimeout(r, 800));
+                    const spotBals = await spotAdapter.getSpotBalances();
+                    const spotTokenBal = spotBals.find(b => b.token.toUpperCase().startsWith(sym));
+                    const remainingSpotAmt = Number(spotTokenBal?.total ?? 0);
+                    const closedSize = parseFloat(closeSize);
+                    if (remainingSpotAmt > closedSize * 0.5) {
+                        closeVerified = false;
+                        closeWarnings.push(`Spot sell may not have filled: still have ${remainingSpotAmt.toFixed(6)} ${sym} (expected ~0)`);
+                    }
+                    const perpPositionsAfter = await perpAdapter.getPositions();
+                    const remainingPerpPos = perpPositionsAfter.find(p => p.symbol.replace("-PERP", "").toUpperCase() === sym && p.side === "short");
+                    if (remainingPerpPos && Number(remainingPerpPos.size) > closedSize * 0.5) {
+                        closeVerified = false;
+                        closeWarnings.push(`Perp short still open: ${remainingPerpPos.size} ${sym} on ${perpExch} (expected closed)`);
+                    }
+                }
+                catch (verifyErr) {
+                    closeWarnings.push(`Close verification failed: ${verifyErr instanceof Error ? verifyErr.message : String(verifyErr)}`);
+                }
+                if (closeWarnings.length > 0 && !isJson()) {
+                    for (const w of closeWarnings)
+                        console.log(chalk.yellow(`  Warning: ${w}`));
+                }
+                persistRemovePosition(sym);
+                logExecution({
+                    type: "arb_close", exchange: `spot:${spotExch}+${perpExch}`,
+                    symbol: sym, side: "exit", size: closeSize,
+                    status: closeVerified ? "success" : "unverified", dryRun: false,
+                    meta: { mode: "spot-perp", ...(closeWarnings.length > 0 && { warnings: closeWarnings }) },
+                });
+                // Return spot USDC proceeds back to perp account
+                if (spotExch === "lighter") {
+                    try {
+                        const ltSpot = spotAdapter;
+                        const bals = await ltSpot.getSpotBalances();
+                        const usdcBal = bals.find(b => b.token === "USDC");
+                        const leftover = Number(usdcBal?.available ?? 0);
+                        if (leftover > 0.01) {
+                            await ltSpot.transferUsdcToPerp(leftover);
+                            if (!isJson())
+                                console.log(chalk.gray(`  Returned ~$${leftover.toFixed(2)} USDC spot->perp on Lighter`));
+                        }
+                    }
+                    catch { /* non-critical */ }
+                }
+                else if (spotExch === "hyperliquid") {
+                    try {
+                        const hlSpot = spotAdapter;
+                        const bals = await hlSpot.getSpotBalances();
+                        const usdcBal = bals.find(b => b.token.startsWith("USDC"));
+                        const leftover = Number(usdcBal?.available ?? 0);
+                        if (leftover > 1)
+                            await hlSpot.transferUsdcToPerp(Math.floor(leftover));
+                    }
+                    catch { /* non-critical */ }
+                }
+                const closeResult = {
+                    status: closeVerified ? "closed" : "closed_unverified",
+                    mode: "spot-perp", symbol: sym, size: closeSize,
+                    ...(closeWarnings.length > 0 && { warnings: closeWarnings }),
+                };
+                if (isJson())
+                    return printJson(jsonOk(closeResult));
+                if (closeVerified) {
+                    console.log(chalk.green(`  CLOSED (verified): ${sym} ${closeSize} units`));
+                }
+                else {
+                    console.log(chalk.yellow(`  CLOSED (unverified): ${sym} ${closeSize} units -- check positions manually`));
+                }
+                console.log(chalk.green(`    SPOT  ${spotExch}: sold`));
+                console.log(chalk.green(`    PERP  ${perpExch}: bought (closed short)\n`));
+            }
+            else {
+                const errors = [];
+                if (!spotOk)
+                    errors.push(`Spot sell failed: ${spotResult.reason}`);
+                if (!perpOk)
+                    errors.push(`Perp buy failed: ${perpResult.reason}`);
+                const result = { status: "partial_close", symbol: sym, spotOk, perpOk, errors };
+                if (isJson())
+                    return printJson(jsonOk(result));
+                console.log(chalk.red(`  Close partially failed:`));
+                for (const e of errors)
+                    console.log(chalk.red(`    ${e}`));
+                console.log(chalk.yellow(`  Manual intervention may be needed.\n`));
+            }
+            return;
+        }
+        // ── Perp-perp close logic (original) ──
         if (!isJson()) {
             console.log(chalk.cyan(`\n  Closing arb position for ${sym}...\n`));
             if (dryRun)
@@ -1189,26 +1358,21 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
             console.log(chalk.yellow("\n  To execute, use: perp rebalance execute --auto-bridge\n"));
         }
     });
-    // ── arb funding-earned ──
-    arb
-        .command("funding-earned")
-        .description("Actual funding payments received/paid for arb positions")
-        .option("--period <days>", "Number of days to look back", "7")
-        .option("--symbol <symbol>", "Filter by symbol")
-        .action(async (opts) => {
+    // ── printFundingEarned helper (used by arb status --funding) ──
+    async function printFundingEarned(getAdapter, isJsonFn, opts) {
         const periodDays = parseInt(opts.period);
         const filterSym = opts.symbol?.toUpperCase();
-        if (!isJson())
+        if (!isJsonFn())
             console.log(chalk.cyan(`\n  Fetching funding payments (last ${periodDays} days)...\n`));
         // Fetch positions to identify arb pairs
-        const allPositions = [];
+        const fundingPositions = [];
         for (const exName of EXCHANGES) {
             try {
-                const adapter = await getAdapterForExchange(exName);
+                const adapter = await getAdapter(exName);
                 const positions = await adapter.getPositions();
                 for (const p of positions) {
                     const normalized = p.symbol.replace("-PERP", "").toUpperCase();
-                    allPositions.push({
+                    fundingPositions.push({
                         exchange: exName,
                         symbol: normalized,
                         side: p.side,
@@ -1224,10 +1388,10 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
         // Identify arb pairs (long on one exchange, short on another)
         const arbPairKeys = new Set();
         const arbPairInfo = new Map();
-        const longs = allPositions.filter(p => p.side === "long");
-        const shorts = allPositions.filter(p => p.side === "short");
-        for (const l of longs) {
-            for (const s of shorts) {
+        const fLongs = fundingPositions.filter(p => p.side === "long");
+        const fShorts = fundingPositions.filter(p => p.side === "short");
+        for (const l of fLongs) {
+            for (const s of fShorts) {
                 if (l.exchange !== s.exchange && l.symbol === s.symbol) {
                     const key = l.symbol;
                     arbPairKeys.add(key);
@@ -1243,7 +1407,7 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
         const cutoff = Date.now() - periodDays * 24 * 60 * 60 * 1000;
         for (const exName of EXCHANGES) {
             try {
-                const adapter = await getAdapterForExchange(exName);
+                const adapter = await getAdapter(exName);
                 const payments = await adapter.getFundingPayments(200);
                 for (const p of payments) {
                     if (p.time < cutoff)
@@ -1331,11 +1495,14 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
         const portfolioApr = totalArbNotional > 0
             ? (totals.dailyAvg * 365 / totalArbNotional) * 100
             : 0;
-        if (isJson()) {
-            return printJson(jsonOk({
-                pairs,
-                totals: { ...totals, annualizedApr: portfolioApr },
+        if (isJsonFn()) {
+            printJson(jsonOk({
+                fundingEarned: {
+                    pairs,
+                    totals: { ...totals, annualizedApr: portfolioApr },
+                },
             }));
+            return;
         }
         if (pairs.length === 0) {
             console.log(chalk.gray("  No funding payments found.\n"));
@@ -1368,5 +1535,5 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
             console.log(`    Portfolio APR: ${chalk.cyan(`${portfolioApr.toFixed(1)}%`)} (on $${formatUsd(totalArbNotional)} arb notional)`);
         }
         console.log();
-    });
+    }
 }

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

@@ -50,5 +50,14 @@ export declare function isNearSettlement(longExchange: string, shortExchange: st
  * meaning we're now paying on both sides instead of collecting.
  */
 export declare function isSpreadReversed(longExchange: string, shortExchange: string, snapshot: FundingSnapshot): boolean;
+export declare let handleSpotClose: ((sym: string, opts: {
+    spotExch?: string;
+    perpExch?: string;
+}, getAdapterForExchange: (exchange: string) => Promise<import("../exchanges/interface.js").ExchangeAdapter>, isJson: () => boolean) => Promise<void>) | undefined;
 export declare function registerArbAutoCommands(program: Command, getAdapterForExchange: (exchange: string) => Promise<ExchangeAdapter>, isJson: () => boolean, getHLAdapterForDex?: (dex: string) => Promise<import("../exchanges/hyperliquid.js").HyperliquidAdapter>): void;
+export declare let handleArbPnlRef: (() => Promise<void>) | undefined;
+/**
+ * Exported wrapper for handleArbPnl.
+ */
+export declare function handleArbPnl(getAdapterForExchange: (exchange: string) => Promise<import("../exchanges/interface.js").ExchangeAdapter>, isJson: () => boolean): Promise<void>;
 export {};