perp-cli 0.7.2 → 0.7.4

package/dist/bot/strategies/grid-strategy.js

@@ -25,6 +25,8 @@ export class GridStrategy {
     async init(ctx, snapshot) {
         this._config = ctx.config;
         const params = this.params;
+        if (params.grids < 2)
+            throw new Error("Grid strategy requires at least 2 grid lines");
         // Determine price range
         if (params.range_mode === "auto") {
             const pct = params.range_pct ?? 3;
@@ -40,12 +42,12 @@ export class GridStrategy {
             ctx.state.set("gridUpper", params.upper);
             ctx.state.set("gridLower", params.lower);
         }
-        ctx.state.set("gridOrders", new Map());
+        ctx.state.set("gridLevels", []);
+        ctx.state.set("gridInitialized", false);
     }
     async onTick(ctx, snapshot) {
         const params = this.params;
         const actions = [];
-        const gridOrders = ctx.state.get("gridOrders");
         const gridUpper = ctx.state.get("gridUpper");
         const gridLower = ctx.state.get("gridLower");
         // First tick: set leverage + place initial grid
@@ -53,59 +55,62 @@ export class GridStrategy {
             if (params.leverage) {
                 actions.push({ type: "set_leverage", leverage: params.leverage });
             }
-            return [...actions, ...this.buildGridOrders(ctx, snapshot.price)];
+            const gridActions = this.buildGridOrders(ctx, snapshot.price);
+            ctx.state.set("gridInitialized", true);
+            return [...actions, ...gridActions];
+        }
+        // Wait one tick after init/rebalance for orders to settle on exchange
+        if (!ctx.state.get("gridInitialized")) {
+            ctx.state.set("gridInitialized", true);
+            return [];
         }
         if (params.grids < 2)
             throw new Error("Grid requires at least 2 grid lines");
         const step = (gridUpper - gridLower) / (params.grids - 1);
         const sizePerGrid = params.size / params.grids;
-        // Check for fills
+        // Price tolerance for matching: half a grid step
+        const tolerance = step * 0.5;
+        const gridLevels = ctx.state.get("gridLevels");
+        // Check for fills by comparing expected grid levels against actual open orders
         try {
             const openOrders = await ctx.adapter.getOpenOrders();
-            const openIds = new Set(openOrders.filter(o => o.symbol.toUpperCase() === ctx.symbol.toUpperCase()).map(o => o.orderId));
-            // Build filled order IDs from order history for accurate fill detection
-            let filledIds = null;
-            try {
-                const history = await ctx.adapter.getOrderHistory(100);
-                filledIds = new Set(history.filter(o => o.status === "filled").map(o => o.orderId));
-            }
-            catch { /* non-critical -- fall back to assuming fills */ }
-            let newFills = 0;
-            for (const [idx, orderId] of gridOrders.entries()) {
-                if (!openIds.has(orderId)) {
-                    // Verify the order was actually filled (not just cancelled)
-                    if (filledIds && !filledIds.has(orderId)) {
-                        ctx.log(`  [GRID] Order ${orderId} missing -- likely cancelled, skipping`);
-                        gridOrders.delete(idx);
-                        continue;
-                    }
-                    // Order filled -- place opposite order
-                    newFills++;
-                    // Determine new side and price
-                    const oldPrice = gridLower + step * idx;
-                    const wasBuy = oldPrice < snapshot.price;
-                    const newSide = wasBuy ? "sell" : "buy";
-                    const newPrice = wasBuy ? oldPrice + step : oldPrice - step;
-                    if (newPrice >= gridLower && newPrice <= gridUpper) {
-                        actions.push({
-                            type: "place_order",
-                            side: newSide,
-                            price: newPrice.toFixed(2),
-                            size: String(sizePerGrid),
-                            orderType: "limit",
-                        });
-                        // We'll update gridOrders when the action is executed
-                        // For now mark this index as pending -- use a sentinel
-                        gridOrders.set(idx, `pending-${idx}`);
-                    }
-                    else {
-                        gridOrders.delete(idx);
-                    }
+            const symbolOrders = openOrders.filter(o => o.symbol.toUpperCase() === ctx.symbol.toUpperCase());
+            // For each grid level, check if a matching open order exists (by price proximity)
+            const unmatchedLevels = [];
+            const matchedLevels = [];
+            for (const level of gridLevels) {
+                const hasMatch = symbolOrders.some(o => {
+                    const orderPrice = parseFloat(o.price);
+                    return Math.abs(orderPrice - level.price) < tolerance && o.side === level.side;
+                });
+                if (hasMatch) {
+                    matchedLevels.push(level);
                 }
+                else {
+                    unmatchedLevels.push(level);
+                }
+            }
+            if (unmatchedLevels.length > 0) {
+                ctx.log(`  [GRID] ${unmatchedLevels.length} fill(s) detected`);
             }
-            if (newFills > 0) {
-                ctx.log(`  [GRID] ${newFills} fill(s) detected`);
+            // For each filled level, place the opposite (counter) order
+            const newLevels = [...matchedLevels];
+            for (const filled of unmatchedLevels) {
+                const wasBuy = filled.side === "buy";
+                const newSide = wasBuy ? "sell" : "buy";
+                const newPrice = wasBuy ? filled.price + step : filled.price - step;
+                if (newPrice >= gridLower && newPrice <= gridUpper) {
+                    actions.push({
+                        type: "place_order",
+                        side: newSide,
+                        price: newPrice.toFixed(2),
+                        size: String(sizePerGrid),
+                        orderType: "limit",
+                    });
+                    newLevels.push({ price: newPrice, side: newSide });
+                }
             }
+            ctx.state.set("gridLevels", newLevels);
         }
         catch { /* retry next loop */ }
         // Auto-rebalance if price exits range
@@ -120,12 +125,12 @@ export class GridStrategy {
                 ctx.state.set("gridUpper", newUpper);
                 ctx.state.set("gridLower", newLower);
                 ctx.state.set("lastRebalance", Date.now());
+                ctx.state.set("gridInitialized", false);
                 const rebalanceCount = (ctx.state.get("rebalanceCount") ?? 0) + 1;
                 ctx.state.set("rebalanceCount", rebalanceCount);
                 ctx.log(`  [GRID] Rebalance #${rebalanceCount}: price $${snapshot.price.toFixed(2)} outside range -> new $${newLower.toFixed(2)} - $${newUpper.toFixed(2)}`);
                 // Cancel all and rebuild
                 actions.push({ type: "cancel_all" });
-                gridOrders.clear();
                 return [...actions, ...this.buildGridOrders(ctx, snapshot.price)];
             }
         }
@@ -144,11 +149,11 @@ export class GridStrategy {
         const step = (gridUpper - gridLower) / (params.grids - 1);
         const sizePerGrid = params.size / params.grids;
         const actions = [];
+        const gridLevels = [];
         // Cancel existing orders first
-        const gridOrders = ctx.state.get("gridOrders");
-        if (gridOrders.size > 0) {
+        const existingLevels = ctx.state.get("gridLevels");
+        if (existingLevels && existingLevels.length > 0) {
             actions.push({ type: "cancel_all" });
-            gridOrders.clear();
         }
         for (let i = 0; i < params.grids; i++) {
             const price = gridLower + step * i;
@@ -166,9 +171,9 @@ export class GridStrategy {
                 size: String(sizePerGrid),
                 orderType: "limit",
             });
-            // Mark grid index with pending sentinel -- engine updates after execution
-            gridOrders.set(i, `pending-${i}`);
+            gridLevels.push({ price, side });
         }
+        ctx.state.set("gridLevels", gridLevels);
         ctx.log(`  [GRID] Placing ${params.grids} orders (step: $${step.toFixed(2)}, size: ${sizePerGrid.toFixed(6)})`);
         return actions;
     }

package/dist/cli-spec.js

@@ -38,7 +38,7 @@ export function getCliSpec(program) {
         description: "Multi-DEX Perpetual Futures CLI (Pacifica, Hyperliquid, Lighter)",
         globalOptions,
         commands,
-        exchanges: ["pacifica", "hyperliquid", "lighter"],
+        exchanges: ["pacifica", "hyperliquid", "lighter", "aster"],
         envelope: {
             success: "{ ok: true, data: T, meta: { timestamp } }",
             error: "{ ok: false, error: { code, message, retryable?, retryAfterMs? }, meta: { timestamp } }",

package/dist/commands/account.js

@@ -2,7 +2,7 @@ import { makeTable, formatUsd, formatPnl, printJson, jsonOk, jsonError, symbolMa
 import chalk from "chalk";
 import { assessRisk } from "../risk.js";
 import { hasPacificaSdk, isDexCapable } from "../exchanges/capabilities.js";
-const EXCHANGES = ["pacifica", "hyperliquid", "lighter"];
+const EXCHANGES = ["pacifica", "hyperliquid", "lighter", "aster"];
 async function fetchExchangeSnapshot(name, getAdapter) {
     try {
         const adapter = await getAdapter(name);

package/dist/commands/arb/index.js

@@ -26,11 +26,12 @@ function formatDuration(ms) {
 }
 async function fetchFundingRatesMap() {
     const rateMap = new Map();
-    const [pacAssets, hlAssets, ltDetails, ltFunding] = await Promise.all([
+    const [pacAssets, hlAssets, ltDetails, ltFunding, asterPremiums] = await Promise.all([
         fetchPacificaPrices(),
         fetchHyperliquidMeta(),
         fetchLighterOrderBookDetails(),
         fetchLighterFundingRates(),
+        fetch("https://fapi.asterdex.com/fapi/v1/premiumIndex").then(r => r.json()).catch(() => []),
     ]);
     const addRate = (sym, exchange, rate, markPrice) => {
         if (!sym)
@@ -51,6 +52,13 @@ async function fetchFundingRatesMap() {
         const mp = fr.markPrice || ltPriceMap.get(fr.marketId) || 0;
         addRate(sym, "lighter", fr.rate, mp);
     }
+    // Aster: premiumIndex
+    for (const p of asterPremiums ?? []) {
+        const rawSym = String(p.symbol ?? "");
+        if (!rawSym.endsWith("USDT"))
+            continue;
+        addRate(rawSym.replace(/USDT$/, ""), "aster", Number(p.lastFundingRate ?? 0), Number(p.markPrice ?? 0));
+    }
     return rateMap;
 }
 function findArbEntryForPair(symbol, longExchange, shortExchange) {
@@ -454,7 +462,7 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
         // ── Spot-Perp detailed view ──
         if (spotPerpPositions.length > 0) {
             for (const sp of spotPerpPositions) {
-                const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : "LT";
+                const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e === "aster" ? "AST" : e.toUpperCase();
                 const spreadStr = sp.currentSpread !== null ? `${sp.currentSpread.toFixed(1)}%` : "-";
                 const spotPriceEach = sp.spotAmount > 0 ? sp.spotValueUsd / sp.spotAmount : 0;
                 const spotPnl = sp.spotValueUsd - (sp.perpEntryPrice * sp.spotAmount); // spot value vs entry
@@ -1272,8 +1280,8 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
         const snapshots = await fetchAllBalances(adapters);
         const totalEquity = snapshots.reduce((s, e) => s + e.equity, 0);
         const totalAvailable = snapshots.reduce((s, e) => s + e.available, 0);
-        const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e.toUpperCase();
-        const exChain = (e) => e === "pacifica" ? "Solana" : e === "hyperliquid" ? "Hyperliquid" : e === "lighter" ? "Arbitrum" : "unknown";
+        const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e === "aster" ? "AST" : e.toUpperCase();
+        const exChain = (e) => e === "pacifica" ? "Solana" : e === "hyperliquid" ? "Hyperliquid" : e === "lighter" ? "Arbitrum" : e === "aster" ? "BNB" : "unknown";
         if (opts.check) {
             // Show current balance distribution
             if (isJson()) {

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

@@ -5,6 +5,7 @@ interface FundingSnapshot {
     pacRate: number;
     hlRate: number;
     ltRate: number;
+    astRate: number;
     spread: number;
     longExch: string;
     shortExch: string;
@@ -12,6 +13,7 @@ interface FundingSnapshot {
     pacMarkPrice: number;
     hlMarkPrice: number;
     ltMarkPrice: number;
+    astMarkPrice: number;
 }
 /**
  * Compute the estimated round-trip cost as a percentage of notional.

package/dist/commands/arb-auto.js

@@ -98,28 +98,41 @@ export function isNearSettlement(longExchange, shortExchange, bufferMinutes = 5,
  * meaning we're now paying on both sides instead of collecting.
  */
 export function isSpreadReversed(longExchange, shortExchange, snapshot) {
-    const rateFor = (e) => e === "pacifica" ? snapshot.pacRate : e === "hyperliquid" ? snapshot.hlRate : snapshot.ltRate;
+    const rateFor = (e) => e === "pacifica" ? snapshot.pacRate : e === "hyperliquid" ? snapshot.hlRate : e === "aster" ? snapshot.astRate : snapshot.ltRate;
     const longHourly = toHourlyRate(rateFor(longExchange), longExchange);
     const shortHourly = toHourlyRate(rateFor(shortExchange), shortExchange);
     // Reversed if the long side rate exceeds the short side rate
     return longHourly > shortHourly;
 }
 async function fetchFundingSpreads() {
-    const [pacRes, hlRes, ltDetailsRes, ltFundingRes] = await Promise.all([
+    const [pacRes, hlRes, ltDetailsRes, ltFundingRes, astPremiums] = await Promise.all([
         fetchPacificaPricesRaw(),
         fetchHyperliquidMetaRaw(),
         fetchLighterOrderBookDetailsRaw(),
         fetchLighterFundingRatesRaw(),
+        fetch("https://fapi.asterdex.com/fapi/v1/premiumIndex").then(r => r.json()).catch(() => []),
     ]);
     const { rates: pacRates, prices: pacPrices } = parsePacificaRaw(pacRes);
     const { rates: hlRates, prices: hlPrices } = parseHyperliquidMetaRaw(hlRes);
     const { rates: ltRates, prices: ltPrices } = parseLighterRaw(ltDetailsRes, ltFundingRes);
+    // Aster: parse premiumIndex
+    const astRates = new Map();
+    const astPrices = new Map();
+    for (const p of astPremiums ?? []) {
+        const rawSym = String(p.symbol ?? "");
+        if (!rawSym.endsWith("USDT"))
+            continue;
+        const sym = rawSym.replace(/USDT$/, "");
+        astRates.set(sym, Number(p.lastFundingRate ?? 0));
+        astPrices.set(sym, Number(p.markPrice ?? 0));
+    }
     const snapshots = [];
-    const allSymbols = new Set([...pacRates.keys(), ...hlRates.keys(), ...ltRates.keys()]);
+    const allSymbols = new Set([...pacRates.keys(), ...hlRates.keys(), ...ltRates.keys(), ...astRates.keys()]);
     for (const sym of allSymbols) {
         const pac = pacRates.get(sym);
         const hl = hlRates.get(sym);
         const lt = ltRates.get(sym);
+        const ast = astRates.get(sym);
         // Need at least 2 exchanges
         const available = [];
         if (pac !== undefined)
@@ -128,6 +141,8 @@ async function fetchFundingSpreads() {
             available.push({ exchange: "hyperliquid", rate: hl });
         if (lt !== undefined)
             available.push({ exchange: "lighter", rate: lt });
+        if (ast !== undefined)
+            available.push({ exchange: "aster", rate: ast });
         if (available.length < 2)
             continue;
         const norm = (r) => toHourlyRate(r.rate, r.exchange);
@@ -135,13 +150,14 @@ async function fetchFundingSpreads() {
         const lowest = available[0];
         const highest = available[available.length - 1];
         const spread = computeAnnualSpread(highest.rate, highest.exchange, lowest.rate, lowest.exchange);
-        // Use best available mark price (prefer HL as most liquid, then PAC, then LT)
-        const markPrice = hlPrices.get(sym) ?? pacPrices.get(sym) ?? ltPrices.get(sym) ?? 0;
+        // Use best available mark price (prefer HL as most liquid, then PAC, then LT, then AST)
+        const markPrice = hlPrices.get(sym) ?? pacPrices.get(sym) ?? ltPrices.get(sym) ?? astPrices.get(sym) ?? 0;
         snapshots.push({
             symbol: sym,
             pacRate: pac ?? 0,
             hlRate: hl ?? 0,
             ltRate: lt ?? 0,
+            astRate: ast ?? 0,
             spread,
             longExch: lowest.exchange, // long where funding is lowest
             shortExch: highest.exchange, // short where funding is highest
@@ -149,6 +165,7 @@ async function fetchFundingSpreads() {
             pacMarkPrice: pacPrices.get(sym) ?? 0,
             hlMarkPrice: hlPrices.get(sym) ?? 0,
             ltMarkPrice: ltPrices.get(sym) ?? 0,
+            astMarkPrice: astPrices.get(sym) ?? 0,
         });
     }
     return snapshots.sort((a, b) => Math.abs(b.spread) - Math.abs(a.spread));
@@ -541,7 +558,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
                 // Log next settlement times and funding estimation
                 if (!isJson() && settleStrategy !== "off") {
                     const nowDate = new Date();
-                    const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : "LT";
+                    const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e === "aster" ? "AST" : e.toUpperCase();
                     const nextHL = getNextSettlement("hyperliquid", nowDate);
                     const nextPAC = getNextSettlement("pacifica", nowDate);
                     const nextLT = getNextSettlement("lighter", nowDate);
@@ -553,7 +570,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
                         const fSnap = filtered.find(s => s.symbol === fPos.symbol);
                         if (!fSnap)
                             continue;
-                        const fRateFor = (e) => e === "pacifica" ? fSnap.pacRate : e === "hyperliquid" ? fSnap.hlRate : fSnap.ltRate;
+                        const fRateFor = (e) => e === "pacifica" ? fSnap.pacRate : e === "hyperliquid" ? fSnap.hlRate : e === "aster" ? fSnap.astRate : fSnap.ltRate;
                         const fHlHourly = toHourlyRate(fRateFor("hyperliquid"), "hyperliquid");
                         const fPacHourly = toHourlyRate(fRateFor("pacifica"), "pacifica");
                         const fNotional = fPos.size * fSnap.markPrice;
@@ -679,7 +696,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
                         const effectiveNetSpread = netSpread * settleBoostMultiplier;
                         if (effectiveNetSpread < minSpread)
                             continue;
-                        const rateForExch = (e) => e === "pacifica" ? snap.pacRate : e === "hyperliquid" ? snap.hlRate : snap.ltRate;
+                        const rateForExch = (e) => e === "pacifica" ? snap.pacRate : e === "hyperliquid" ? snap.hlRate : e === "aster" ? snap.astRate : snap.ltRate;
                         console.log(chalk.green(`  ${now} ENTER ${snap.symbol} — gross ${grossSpread.toFixed(1)}% net ${netSpread.toFixed(1)}%` +
                             ` | Long ${longExchange} (${(rateForExch(longExchange) * 100).toFixed(4)}%)` +
                             ` | Short ${shortExchange} (${(rateForExch(shortExchange) * 100).toFixed(4)}%)`));
@@ -885,7 +902,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
                         const elapsedHours = (nowMs - pos.lastCheckTime) / (1000 * 60 * 60);
                         const notional = pos.size * current.markPrice;
                         // Estimate funding collected: normalize all rates to hourly before comparing
-                        const rateFor = (e) => e === "pacifica" ? current.pacRate : e === "hyperliquid" ? current.hlRate : current.ltRate;
+                        const rateFor = (e) => e === "pacifica" ? current.pacRate : e === "hyperliquid" ? current.hlRate : e === "aster" ? current.astRate : current.ltRate;
                         const longHourly = toHourlyRate(rateFor(pos.longExchange), pos.longExchange);
                         const shortHourly = toHourlyRate(rateFor(pos.shortExchange), pos.shortExchange);
                         // Income = short gets paid positive funding, long pays; net = (shortRate - longRate) * notional * hours
@@ -1074,7 +1091,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
                     console.log(chalk.gray(`  Liquidity check: ON`));
                 console.log(chalk.gray(`  Press Ctrl+C to stop\n`));
             }
-            const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : "LT";
+            const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e === "aster" ? "AST" : e.toUpperCase();
             while (true) {
                 cycle++;
                 const ts = new Date().toLocaleTimeString();
@@ -1191,7 +1208,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
                     console.log(chalk.gray(`  No spot+perp opportunities above ${minSpread}%\n`));
                 }
                 else {
-                    const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : "LT";
+                    const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e === "aster" ? "AST" : e.toUpperCase();
                     const rows = spotSpreads.slice(0, parseInt(opts.top ?? "30")).map(s => {
                         const spotEx = s.spotExchanges[0] || "lighter";
                         const rtCost = computeRoundTripCostPct(spotEx, s.perpExchange);
@@ -1235,8 +1252,9 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
                 const rtCost = computeRoundTripCostPct(s.longExch, s.shortExch);
                 const net = computeNetSpread(grossSpread, holdDays, rtCost, bridgeCostUsd, sizeUsd);
                 // Compute price gap between long and short exchanges
-                const longPrice = s.longExch === "pacifica" ? s.pacMarkPrice : s.longExch === "hyperliquid" ? s.hlMarkPrice : s.ltMarkPrice;
-                const shortPrice = s.shortExch === "pacifica" ? s.pacMarkPrice : s.shortExch === "hyperliquid" ? s.hlMarkPrice : s.ltMarkPrice;
+                const pFor = (ex) => ex === "pacifica" ? s.pacMarkPrice : ex === "hyperliquid" ? s.hlMarkPrice : ex === "lighter" ? s.ltMarkPrice : s.astMarkPrice;
+                const longPrice = pFor(s.longExch);
+                const shortPrice = pFor(s.shortExch);
                 const mid = (longPrice + shortPrice) / 2;
                 const priceGapPct = mid > 0 ? Math.abs(longPrice - shortPrice) / mid * 100 : 0;
                 return { mode: "perp-perp", symbol: s.symbol, longExch: s.longExch, shortExch: s.shortExch, markPrice: s.markPrice, grossSpread, netSpread: net, estFeesPct: rtCost, priceGapPct: Math.round(priceGapPct * 10000) / 10000 };
@@ -1264,7 +1282,7 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
             console.log(chalk.gray(`  No perp-perp spreads above ${minSpread}%\n`));
             return;
         }
-        const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : "LT";
+        const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e === "aster" ? "AST" : e.toUpperCase();
         const rows = filtered.map(s => {
             const direction = `${exAbbr(s.shortExch)}>${exAbbr(s.longExch)}`;
             const grossSpread = Math.abs(s.spread);
@@ -1272,8 +1290,9 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
             const netSpread = computeNetSpread(grossSpread, holdDays, rtCost, bridgeCostUsd, sizeUsd);
             const grossColor = grossSpread >= 50 ? chalk.green.bold : grossSpread >= 30 ? chalk.green : chalk.yellow;
             const netColor = netSpread >= 20 ? chalk.green : netSpread >= 0 ? chalk.yellow : chalk.red;
-            const longPrice = s.longExch === "pacifica" ? s.pacMarkPrice : s.longExch === "hyperliquid" ? s.hlMarkPrice : s.ltMarkPrice;
-            const shortPrice = s.shortExch === "pacifica" ? s.pacMarkPrice : s.shortExch === "hyperliquid" ? s.hlMarkPrice : s.ltMarkPrice;
+            const priceFor = (ex) => ex === "pacifica" ? s.pacMarkPrice : ex === "hyperliquid" ? s.hlMarkPrice : ex === "lighter" ? s.ltMarkPrice : s.astMarkPrice;
+            const longPrice = priceFor(s.longExch);
+            const shortPrice = priceFor(s.shortExch);
             const mid = (longPrice + shortPrice) / 2;
             const priceGapPct = mid > 0 ? Math.abs(longPrice - shortPrice) / mid * 100 : 0;
             const gapColor = priceGapPct >= 0.5 ? chalk.red : priceGapPct >= 0.1 ? chalk.yellow : chalk.gray;
@@ -1284,6 +1303,8 @@ export function registerArbAutoCommands(program, getAdapterForExchange, isJson,
                 rates.push(`HL:${(s.hlRate * 100).toFixed(4)}%`);
             if (s.ltRate)
                 rates.push(`LT:${(s.ltRate * 100).toFixed(4)}%`);
+            if (s.astRate)
+                rates.push(`AST:${(s.astRate * 100).toFixed(4)}%`);
             return [
                 chalk.white.bold(s.symbol),
                 grossColor(`${grossSpread.toFixed(1)}%`),

package/dist/commands/arb.js

@@ -24,6 +24,23 @@ async function fetchHyperliquidRates() {
         markPrice: a.markPx,
     }));
 }
+async function fetchAsterRates() {
+    try {
+        const premiums = await fetch("https://fapi.asterdex.com/fapi/v1/premiumIndex").then(r => r.json());
+        return (premiums ?? [])
+            .filter(p => String(p.symbol ?? "").endsWith("USDT"))
+            .map(p => ({
+            exchange: "aster",
+            symbol: String(p.symbol ?? "").replace(/USDT$/, ""),
+            fundingRate: Number(p.lastFundingRate ?? 0),
+            markPrice: Number(p.markPrice ?? 0),
+            nextFunding: Number(p.nextFundingTime ?? 0),
+        }));
+    }
+    catch {
+        return [];
+    }
+}
 async function fetchLighterRates() {
     try {
         const [details, funding] = await Promise.all([
@@ -222,18 +239,20 @@ function printSnapshotTable(snapshot) {
         const pacRate = s.rates.find(r => r.exchange === "pacifica");
         const hlRate = s.rates.find(r => r.exchange === "hyperliquid");
         const ltRate = s.rates.find(r => r.exchange === "lighter");
+        const astRate = s.rates.find(r => r.exchange === "aster");
         const spreadColor = s.maxSpreadAnnual >= 30 ? chalk.green : s.maxSpreadAnnual >= 10 ? chalk.yellow : chalk.white;
-        const bestRate = hlRate ?? pacRate ?? ltRate;
+        const bestRate = hlRate ?? pacRate ?? ltRate ?? astRate;
         const trend = trendMap.get(s.symbol) ?? chalk.gray("-");
         return [
             chalk.white.bold(s.symbol), pacRate ? formatPercent(pacRate.fundingRate) : chalk.gray("-"),
             hlRate ? formatPercent(hlRate.fundingRate) : chalk.gray("-"), ltRate ? formatPercent(ltRate.fundingRate) : chalk.gray("-"),
+            astRate ? formatPercent(astRate.fundingRate) : chalk.gray("-"),
             spreadColor(`${s.maxSpreadAnnual.toFixed(1)}%`), trend,
             s.maxSpreadAnnual >= 5 ? `${exAbbr(s.shortExchange)}>${exAbbr(s.longExchange)}` : chalk.gray("-"),
             formatAvgRate(bestRate?.historicalAvg?.avg8h), formatAvgRate(bestRate?.historicalAvg?.avg24h), formatAvgRate(bestRate?.historicalAvg?.avg7d),
         ];
     });
-    console.log(makeTable(["Symbol", "Pacifica", "Hyperliquid", "Lighter", "Spread", "24h", "Direction", "Avg 8h", "Avg 24h", "Avg 7d"], rows));
+    console.log(makeTable(["Symbol", "Pacifica", "Hyperliquid", "Lighter", "Aster", "Spread", "24h", "Direction", "Avg 8h", "Avg 24h", "Avg 7d"], rows));
     console.log(chalk.gray(`\n  ${snapshot.symbols.length} symbols compared across exchanges.\n`));
 }
 function printFundingExchangeStatus(snapshot) {
@@ -244,7 +263,7 @@ function printFundingExchangeStatus(snapshot) {
     console.log(chalk.gray(`  Exchange status: ${statuses.join("  ")}\n`));
 }
 function printDetailedComparison(comparison) {
-    const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : "LT";
+    const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e === "aster" ? "AST" : e.toUpperCase();
     console.log(chalk.cyan.bold(`  ${comparison.symbol} Funding Rate Comparison\n`));
     console.log(`  Mark Price: $${formatUsd(comparison.bestMarkPrice)}\n`);
     for (const r of comparison.rates) {
@@ -301,10 +320,10 @@ export async function handleRates(isJson, opts) {
 export async function handleBasisScan(isJson, opts) {
     if (!isJson())
         console.log(chalk.cyan("  Fetching prices for basis calculation...\n"));
-    const [pacRates, hlRates, ltRates] = await Promise.all([fetchPacificaRates(), fetchHyperliquidRates(), fetchLighterRates()]);
+    const [pacRates, hlRates, ltRates, astRates] = await Promise.all([fetchPacificaRates(), fetchHyperliquidRates(), fetchLighterRates(), fetchAsterRates()]);
     const exchangePrices = new Map();
     const filterSymbol = opts.symbol?.toUpperCase();
-    for (const r of [...pacRates, ...hlRates, ...ltRates]) {
+    for (const r of [...pacRates, ...hlRates, ...ltRates, ...astRates]) {
         if (r.markPrice <= 0)
             continue;
         if (filterSymbol && r.symbol.toUpperCase() !== filterSymbol)
@@ -508,7 +527,7 @@ export async function handleFundingPositions(isJson, getAdapterForExchange, opts
         const tA = results.reduce((s, r) => s + r.actualNet24h, 0);
         if (isJson())
             return printJson(jsonOk({ positions: results.map(r => ({ exchange: r.exchange, symbol: r.symbol, side: r.side, size: r.size, notionalUsd: +r.notionalUsd.toFixed(2), fundingRate: r.fundingRate, annualPct: +r.annualPct.toFixed(2), predicted: { hourly: +r.hourlyPayment.toFixed(6), daily: +r.dailyPayment.toFixed(4) }, actual24h: { received: +r.actualReceived24h.toFixed(6), paid: +r.actualPaid24h.toFixed(6), net: +r.actualNet24h.toFixed(6) }, unrealizedPnl: r.unrealizedPnl })), totals: { predicted: { hourly: +tH.toFixed(6), daily: +tD.toFixed(4) }, actual24h: { net: +tA.toFixed(6) }, notionalUsd: +tN.toFixed(2) }, errors: Object.keys(exchangeErrors).length > 0 ? exchangeErrors : undefined }));
-        const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e.toUpperCase();
+        const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e === "aster" ? "AST" : e.toUpperCase();
         console.log(chalk.cyan.bold("  Position Funding Impact\n"));
         const rows = results.map(r => { const sc = r.side === "long" ? chalk.green : chalk.red; const rc = r.fundingRate > 0 ? chalk.red : r.fundingRate < 0 ? chalk.green : chalk.white; const as = r.actualNet24h !== 0 ? (r.actualNet24h > 0 ? chalk.green : chalk.red)(`${r.actualNet24h > 0 ? "+" : ""}$${r.actualNet24h.toFixed(4)}`) : chalk.gray("-"); return [chalk.white.bold(exAbbr(r.exchange)), chalk.white.bold(r.symbol), sc(r.side.toUpperCase()), `$${formatUsd(r.notionalUsd)}`, rc(formatPercent(r.fundingRate)), rc(`${r.annualPct.toFixed(1)}%`), as, formatPnl(r.unrealizedPnl)]; });
         console.log(makeTable(["Ex", "Symbol", "Side", "Notional", "Rate(now)", "Annual(now)", "Actual 24h", "uPnL"], rows));

package/dist/commands/bot.js

@@ -140,7 +140,7 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         .option("--close-spread <pct>", "Close when spread drops below (%)", "5")
         .option("--size <usd>", "Position size per leg ($)", "50")
         .option("--max-positions <n>", "Max simultaneous positions", "3")
-        .option("--exchanges <list>", "Comma-separated exchanges", "pacifica,hyperliquid,lighter")
+        .option("--exchanges <list>", "Comma-separated exchanges", "pacifica,hyperliquid,lighter,aster")
         .option("--interval <sec>", "Check interval in seconds", "60")
         .option("--max-drawdown <usd>", "Stop if drawdown exceeds ($)", "200")
         .option("--background", "Run in background (tmux)")
@@ -446,8 +446,7 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         if (sym === "ALL" && symbolRequiredStrategies.includes(strategyName)) {
             console.error(chalk.red(`\n  Error: The '${strategyName}' strategy requires a <symbol> argument.`));
             console.error(chalk.gray(`  Usage: perp bot run ${strategyName} <symbol>\n`));
-            process.exitCode = 1;
-            return;
+            return process.exit(1);
         }
         // Load or build config
         let config;
@@ -505,7 +504,7 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
             for (const s of available)
                 console.error(chalk.gray(`    - ${s}`));
             console.error();
-            return;
+            return process.exit(1);
         }
         const adapter = await getAdapter();
         config.exchange = adapter.name;
@@ -516,7 +515,7 @@ export function registerBotCommands(program, getAdapter, getAdapterFor, isJson)
         const multiExchangeStrategies = ["funding-auto", "funding-arb", "funding-arb-v2", "basis-arb", "hedge-agent"];
         if (multiExchangeStrategies.includes(strategyName) && getAdapterFor) {
             extraAdapters = new Map();
-            for (const ex of ["pacifica", "hyperliquid", "lighter"]) {
+            for (const ex of ["pacifica", "hyperliquid", "lighter", "aster"]) {
                 if (ex === adapter.name)
                     continue;
                 try {
@@ -684,7 +683,7 @@ function registerRunSubcommands(parent, getAdapter, getAdapterFor, isJson) {
         .option("--interval <sec>", "Check interval in seconds", "60")
         .option("--auto-execute", "Actually place trades (default: monitor only)")
         .option("--max-positions <n>", "Max simultaneous positions", "3")
-        .option("--exchanges <list>", "Comma-separated exchanges to use", "pacifica,hyperliquid,lighter")
+        .option("--exchanges <list>", "Comma-separated exchanges to use", "pacifica,hyperliquid,lighter,aster")
         .option("--auto-rebalance", "Trigger rebalance alerts when exchange balance is low")
         .option("--rebalance-threshold <usd>", "Rebalance when available < this ($)", "100")
         .option("--max-drawdown <usd>", "Close all positions if total uPnL exceeds this loss ($)")

package/dist/commands/dashboard.js

@@ -50,7 +50,7 @@ export function registerDashboardCommands(program, getAdapterForExchange, isJson
         .description("Launch live web dashboard for real-time portfolio monitoring")
         .option("-p, --port <port>", "Port to serve dashboard on (auto-finds free port)", "3456")
         .option("--interval <ms>", "Poll interval in milliseconds", "5000")
-        .option("--exchanges <list>", "Comma-separated exchanges to monitor", "pacifica,hyperliquid,lighter")
+        .option("--exchanges <list>", "Comma-separated exchanges to monitor", "pacifica,hyperliquid,lighter,aster")
         .option("--dex <list>", "Comma-separated HIP-3 dexes to monitor (e.g. xyz,flx,hyna)")
         .option("--no-auto-dex", "Disable auto-detection of HIP-3 dexes with active positions")
         .action(async (opts) => {

package/dist/commands/history.js

@@ -4,7 +4,7 @@ import { readExecutionLog, getExecutionStats, pruneExecutionLog } from "../execu
 import { loadArbState } from "../arb/index.js";
 import { readPositionHistory, getPositionStats } from "../position-history.js";
 import { saveEquitySnapshot, readEquityHistory, computePnlMetrics, computeDailyPnl, aggregateWeekly, } from "../equity-tracker.js";
-const EXCHANGES = ["pacifica", "hyperliquid", "lighter"];
+const EXCHANGES = ["pacifica", "hyperliquid", "lighter", "aster"];
 function parseSince(since) {
     if (!since)
         return undefined;

package/dist/commands/init.d.ts

@@ -5,10 +5,10 @@ declare function loadEnvFile(): Record<string, string>;
 declare function setEnvVar(key: string, value: string): void;
 export declare const EXCHANGE_ENV_MAP: Record<string, {
     envKey: string;
-    chain: "solana" | "evm";
+    chain: "solana" | "evm" | "apikey";
     label: string;
 }>;
-export declare function validateKey(chain: "solana" | "evm", key: string): Promise<{
+export declare function validateKey(chain: "solana" | "evm" | "apikey", key: string): Promise<{
     valid: boolean;
     address: string;
 }>;

package/dist/commands/init.js

@@ -70,6 +70,7 @@ export const EXCHANGE_ENV_MAP = {
     pacifica: { envKey: "PACIFICA_PRIVATE_KEY", chain: "solana", label: "Pacifica (Solana)" },
     hyperliquid: { envKey: "HL_PRIVATE_KEY", chain: "evm", label: "Hyperliquid (EVM)" },
     lighter: { envKey: "LIGHTER_PRIVATE_KEY", chain: "evm", label: "Lighter (EVM)" },
+    aster: { envKey: "ASTER_API_KEY", chain: "apikey", label: "Aster (BNB Chain)" },
 };
 // ── Validate keys ─────────────────────────────────────────────
 export async function validateKey(chain, key) {
@@ -91,6 +92,10 @@ export async function validateKey(chain, key) {
             return { valid: false, address: "" };
         }
     }
+    else if (chain === "apikey") {
+        // API key validation: just check it's a non-empty hex-like string
+        return { valid: key.length >= 16, address: key.slice(0, 8) + "..." + key.slice(-4) };
+    }
     else {
         try {
             const { ethers } = await import("ethers");

package/dist/commands/market.js

@@ -1,7 +1,7 @@
 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"];
+const EXCHANGES = ["pacifica", "hyperliquid", "lighter", "aster"];
 export function registerMarketCommands(program, getAdapter, isJson, getAdapterForExchange) {
     const market = program.command("market").description("Market data commands");
     market