perp-cli 0.7.2 → 0.7.4

package/dist/commands/rebalance.js

@@ -9,7 +9,7 @@ export function registerRebalanceCommands(program, getAdapterForExchange, isJson
     rebalance
         .command("check")
         .description("Show balances across all exchanges")
-        .option("--exchanges <list>", "Comma-separated exchanges", "pacifica,hyperliquid,lighter")
+        .option("--exchanges <list>", "Comma-separated exchanges", "pacifica,hyperliquid,lighter,aster")
         .action(async (opts) => {
         const exchangeNames = opts.exchanges.split(",").map((e) => e.trim());
         const adapters = new Map();
@@ -55,7 +55,7 @@ export function registerRebalanceCommands(program, getAdapterForExchange, isJson
     rebalance
         .command("plan")
         .description("Calculate optimal rebalancing moves")
-        .option("--exchanges <list>", "Comma-separated exchanges", "pacifica,hyperliquid,lighter")
+        .option("--exchanges <list>", "Comma-separated exchanges", "pacifica,hyperliquid,lighter,aster")
         .option("--min-move <usd>", "Minimum move amount ($)", "50")
         .option("--reserve <usd>", "Keep at least this much per exchange ($)", "20")
         .action(async (opts) => {
@@ -115,7 +115,7 @@ export function registerRebalanceCommands(program, getAdapterForExchange, isJson
     rebalance
         .command("execute")
         .description("Execute rebalancing (withdraw → bridge → deposit)")
-        .option("--exchanges <list>", "Comma-separated exchanges", "pacifica,hyperliquid,lighter")
+        .option("--exchanges <list>", "Comma-separated exchanges", "pacifica,hyperliquid,lighter,aster")
         .option("--min-move <usd>", "Minimum move amount ($)", "50")
         .option("--reserve <usd>", "Keep at least this much per exchange ($)", "20")
         .option("--dry-run", "Show what would happen without executing")

package/dist/commands/risk.js

@@ -47,7 +47,7 @@ export async function runHealthCheck(isJson) {
     const overall = allOk ? chalk.green("ALL HEALTHY") : chalk.red("ISSUES DETECTED");
     console.log(`\n  Overall: ${overall}\n`);
 }
-const EXCHANGES = ["pacifica", "hyperliquid", "lighter"];
+const EXCHANGES = ["pacifica", "hyperliquid", "lighter", "aster"];
 export function registerRiskCommands(program, getAdapterForExchange, isJson) {
     const risk = program.command("risk").description("Risk management and guardrails");
     // ── risk status ──

package/dist/commands/settings.js

@@ -15,7 +15,7 @@ function resolveEnvKey(nameOrKey) {
     if (info)
         return { envKey: info.envKey, chain: info.chain };
     // Common aliases
-    const aliases = { hl: "hyperliquid", pac: "pacifica", lt: "lighter" };
+    const aliases = { hl: "hyperliquid", pac: "pacifica", lt: "lighter", ast: "aster" };
     const aliased = aliases[nameOrKey.toLowerCase()];
     if (aliased)
         return resolveEnvKey(aliased);

package/dist/commands/wallet.js

@@ -363,10 +363,10 @@ export function registerWalletCommands(program, isJson) {
         if (!info) {
             if (isJson()) {
                 const { jsonError } = await import("../utils.js");
-                return printJson(jsonError("INVALID_PARAMS", `Unknown exchange: ${exchange}. Use: pacifica, hyperliquid, lighter (or hl, pac, lt)`));
+                return printJson(jsonError("INVALID_PARAMS", `Unknown exchange: ${exchange}. Use: pacifica, hyperliquid, lighter, aster (or hl, pac, lt, ast)`));
             }
             console.error(chalk.red(`\n  Unknown exchange: ${exchange}`));
-            console.error(chalk.gray(`  Use: pacifica, hyperliquid, lighter (or hl, pac, lt)\n`));
+            console.error(chalk.gray(`  Use: pacifica, hyperliquid, lighter, aster (or hl, pac, lt, ast)\n`));
             process.exit(1);
         }
         const { valid, address } = await validateKey(info.chain, key);

package/dist/config.d.ts

@@ -1,5 +1,5 @@
 import { Keypair } from "@solana/web3.js";
-export type Exchange = "pacifica" | "hyperliquid" | "lighter";
+export type Exchange = "pacifica" | "hyperliquid" | "lighter" | "aster";
 /**
  * Try to load a private key without throwing if none is found.
  * Returns null if no key is configured.

package/dist/config.js

@@ -32,6 +32,7 @@ export async function loadPrivateKey(exchange, pkOverride, walletName) {
         pacifica: ["PACIFICA_PRIVATE_KEY", "pk"],
         hyperliquid: ["HYPERLIQUID_PRIVATE_KEY", "HL_PRIVATE_KEY"],
         lighter: ["LIGHTER_PRIVATE_KEY"],
+        aster: ["ASTER_API_KEY"],
     };
     for (const envVar of envMap[exchange]) {
         if (process.env[envVar])

package/dist/constants.js

@@ -7,6 +7,7 @@ export const TAKER_FEES = {
     hyperliquid: 0.00035,
     pacifica: 0.00035,
     lighter: 0,
+    aster: 0.0004, // 0.04% taker fee
 };
 /** Get taker fee for an exchange. Uses settings if available, falls back to defaults. */
 export function getTakerFee(exchange) {

package/dist/exchanges/index.d.ts

@@ -7,5 +7,6 @@ export type { AdapterRegistration } from "./registry.js";
 export { PacificaAdapter } from "./pacifica.js";
 export { HyperliquidAdapter } from "./hyperliquid.js";
 export { LighterAdapter } from "./lighter.js";
+export { AsterAdapter } from "./aster.js";
 export { HyperliquidSpotAdapter } from "./hyperliquid-spot.js";
 export { LighterSpotAdapter } from "./lighter-spot.js";

package/dist/exchanges/index.js

@@ -6,5 +6,6 @@ export { registerAdapter, getAdapterRegistration, listExchanges, resolveExchange
 export { PacificaAdapter } from "./pacifica.js";
 export { HyperliquidAdapter } from "./hyperliquid.js";
 export { LighterAdapter } from "./lighter.js";
+export { AsterAdapter } from "./aster.js";
 export { HyperliquidSpotAdapter } from "./hyperliquid-spot.js";
 export { LighterSpotAdapter } from "./lighter-spot.js";

package/dist/exchanges/registry.js

@@ -35,3 +35,8 @@ registerAdapter({
     aliases: ["lt"],
     chain: "ethereum",
 });
+registerAdapter({
+    name: "aster",
+    aliases: ["ast"],
+    chain: "bnb",
+});

package/dist/funding/normalize.js

@@ -18,6 +18,7 @@ const EXCHANGE_FUNDING_HOURS = {
     hyperliquid: 1,
     pacifica: 1,
     lighter: 8,
+    aster: 8,
 };
 /**
  * Get funding period in hours for an exchange.

package/dist/funding/rates.d.ts

@@ -7,7 +7,7 @@
  */
 import { type HistoricalAverages } from "./history.js";
 export interface ExchangeFundingRate {
-    exchange: "pacifica" | "hyperliquid" | "lighter";
+    exchange: "pacifica" | "hyperliquid" | "lighter" | "aster";
     symbol: string;
     fundingRate: number;
     hourlyRate: number;

package/dist/funding/rates.js

@@ -81,6 +81,38 @@ async function fetchLighterRates() {
         return [];
     }
 }
+async function fetchAsterRates() {
+    try {
+        const [premiums, tickers] = await Promise.all([
+            fetch("https://fapi.asterdex.com/fapi/v1/premiumIndex").then(r => r.json()),
+            fetch("https://fapi.asterdex.com/fapi/v1/ticker/24hr").then(r => r.json()),
+        ]);
+        const priceMap = new Map();
+        for (const t of tickers ?? []) {
+            priceMap.set(String(t.symbol), Number(t.lastPrice ?? 0));
+        }
+        return (premiums ?? [])
+            .filter(p => String(p.symbol ?? "").endsWith("USDT"))
+            .map(p => {
+            const rawSymbol = String(p.symbol ?? "");
+            const symbol = rawSymbol.replace(/USDT$/, "");
+            const rate = Number(p.lastFundingRate ?? 0);
+            const hourly = toHourlyRate(rate, "aster");
+            return {
+                exchange: "aster",
+                symbol,
+                fundingRate: rate,
+                hourlyRate: hourly,
+                annualizedPct: annualizeRate(rate, "aster"),
+                markPrice: Number(p.markPrice ?? priceMap.get(rawSymbol) ?? 0),
+                nextFundingTime: Number(p.nextFundingTime ?? 0),
+            };
+        });
+    }
+    catch {
+        return [];
+    }
+}
 // ── Core comparison logic ──
 /**
  * Fetch funding rates from all 3 DEXs in parallel, normalize, and compare.
@@ -88,12 +120,13 @@ async function fetchLighterRates() {
  */
 export async function fetchAllFundingRates(opts) {
     const exchangeStatus = {};
-    const [pacRates, hlRates, ltRates] = await Promise.all([
+    const [pacRates, hlRates, ltRates, astRates] = await Promise.all([
         fetchPacificaRates().then(r => { exchangeStatus.pacifica = r.length > 0 ? "ok" : "error"; return r; }),
         fetchHyperliquidRates().then(r => { exchangeStatus.hyperliquid = r.length > 0 ? "ok" : "error"; return r; }),
         fetchLighterRates().then(r => { exchangeStatus.lighter = r.length > 0 ? "ok" : "error"; return r; }),
+        fetchAsterRates().then(r => { exchangeStatus.aster = r.length > 0 ? "ok" : "error"; return r; }),
     ]);
-    const allRates = [...pacRates, ...hlRates, ...ltRates];
+    const allRates = [...pacRates, ...hlRates, ...ltRates, ...astRates];
     // Build per-symbol rate map
     const rateMap = new Map();
     for (const r of allRates) {
@@ -109,7 +142,7 @@ export async function fetchAllFundingRates(opts) {
     // Attach historical averages when available
     try {
         const symbols = Array.from(rateMap.keys());
-        const exchanges = ["pacifica", "hyperliquid", "lighter"];
+        const exchanges = ["pacifica", "hyperliquid", "lighter", "aster"];
         const historicals = getHistoricalAverages(symbols, exchanges);
         for (const [, rates] of rateMap) {
             for (const r of rates) {

package/dist/index.js

@@ -50,7 +50,7 @@ program
     .name("perp")
     .description("Multi-DEX Perpetual Futures CLI (Pacifica, Hyperliquid, Lighter)")
     .version(_pkg.version)
-    .option("-e, --exchange <exchange>", `Exchange: pacifica, hyperliquid, lighter (default: ${_defaultExchange})`, _defaultExchange)
+    .option("-e, --exchange <exchange>", `Exchange: pacifica, hyperliquid, lighter, aster (default: ${_defaultExchange})`, _defaultExchange)
     .option("-n, --network <network>", "Network: mainnet or testnet", "mainnet")
     .option("-k, --private-key <key>", "Private key")
     .option("--json", "Output raw JSON (for piping)")
@@ -156,6 +156,13 @@ async function getAdapter() {
             _adapter = _lighterAdapter;
             break;
         }
+        case "aster": {
+            const { AsterAdapter } = await import("./exchanges/aster.js");
+            const ast = new AsterAdapter(undefined, undefined, isTestnet);
+            await ast.init();
+            _adapter = ast;
+            break;
+        }
         default:
             throw new Error(`Unknown exchange: ${exchange}`);
     }
@@ -271,6 +278,12 @@ async function getAdapterForExchange(rawExchange) {
                 _adapter = _lighterAdapter;
             return _lighterAdapter;
         }
+        case "aster": {
+            const { AsterAdapter } = await import("./exchanges/aster.js");
+            const ast = new AsterAdapter(undefined, undefined, isTestnet);
+            await ast.init();
+            return ast;
+        }
         default:
             throw new Error(`Unknown exchange: ${exchange}`);
     }
@@ -334,8 +347,8 @@ program.command("status")
     const { fetchAllFundingRates, TOP_SYMBOLS } = await import("./funding-rates.js");
     const { saveFundingSnapshot, getHistoricalRates } = await import("./funding-history.js");
     await withJsonErrors(json, async () => {
-        const EX_LIST = ["pacifica", "hyperliquid", "lighter"];
-        const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : "LT";
+        const EX_LIST = ["pacifica", "hyperliquid", "lighter", "aster"];
+        const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : "AST";
         const snapshotPromises = EX_LIST.map(async (ex) => {
             try {
                 const adapter = await getAdapterForExchange(ex);
@@ -606,7 +619,7 @@ program.hook("preAction", () => {
 });
 // Smart landing page: `perp` with no subcommand
 const rawArgs = process.argv.slice(2);
-const hasSubcommand = rawArgs.some((a) => !a.startsWith("-") && !["pacifica", "hyperliquid", "lighter", "hl", "lt", "pac", "mainnet", "testnet"].includes(a));
+const hasSubcommand = rawArgs.some((a) => !a.startsWith("-") && !["pacifica", "hyperliquid", "lighter", "aster", "hl", "lt", "pac", "ast", "mainnet", "testnet"].includes(a));
 if (rawArgs.length === 0 || (!hasSubcommand && !rawArgs.includes("-h") && !rawArgs.includes("--help") && !rawArgs.includes("-V") && !rawArgs.includes("--version"))) {
     // No subcommand — show smart landing instead of help dump
     (async () => {
@@ -638,8 +651,8 @@ if (rawArgs.length === 0 || (!hasSubcommand && !rawArgs.includes("-h") && !rawAr
             }
             else {
                 // Configured — show exchange status + balance
-                const EX_NAMES = ["pacifica", "hyperliquid", "lighter"];
-                const exLabel = (e) => e === "pacifica" ? "Pacifica" : e === "hyperliquid" ? "Hyperliquid" : "Lighter";
+                const EX_NAMES = ["pacifica", "hyperliquid", "lighter", "aster"];
+                const exLabel = (e) => e === "pacifica" ? "Pacifica" : e === "hyperliquid" ? "Hyperliquid" : e === "lighter" ? "Lighter" : "Aster";
                 // Ping + balance in parallel (with 5s timeout to keep landing fast)
                 const withTimeout = (p, ms) => Promise.race([p, new Promise((_, rej) => setTimeout(() => rej(new Error("timeout")), ms))]);
                 const statusResults = await Promise.allSettled(EX_NAMES.map(async (ex) => {

package/dist/strategies/funding-arb.js

@@ -184,7 +184,7 @@ export async function runFundingArb(adapters, params, jobId, log = console.log)
                                 if (!liq.viable)
                                     continue;
                                 // Compute matched size (same for both legs)
-                                const matched = computeMatchedSize(liq.adjustedSizeUsd, highest.markPrice, longEx, shortEx);
+                                let matched = computeMatchedSize(liq.adjustedSizeUsd, highest.markPrice, longEx, shortEx);
                                 if (!matched) {
                                     log(`[ARB] Skip ${symbol}: can't compute matched size (min notional or precision issue)`);
                                     continue;
@@ -199,10 +199,33 @@ export async function runFundingArb(adapters, params, jobId, log = console.log)
                                 }
                                 try {
                                     log(`[ARB] Opening: ${matched.size} ${symbol} on both legs ($${matched.notional.toFixed(0)}/leg, slippage ~${liq.longSlippage.toFixed(2)}%/${liq.shortSlippage.toFixed(2)}%)...`);
-                                    await Promise.all([
-                                        longAdapter.marketOrder(symbol, "buy", matched.size),
-                                        shortAdapter.marketOrder(symbol, "sell", matched.size),
-                                    ]);
+                                    try {
+                                        await Promise.all([
+                                            longAdapter.marketOrder(symbol, "buy", matched.size),
+                                            shortAdapter.marketOrder(symbol, "sell", matched.size),
+                                        ]);
+                                    }
+                                    catch (orderErr) {
+                                        const errMsg = orderErr instanceof Error ? orderErr.message : String(orderErr);
+                                        const lotMatch = errMsg.match(/not a multiple of lot size (\d+(?:\.\d+)?)/);
+                                        if (lotMatch) {
+                                            const lotSize = parseFloat(lotMatch[1]);
+                                            log(`[ARB] Lot size ${lotSize} detected, recalculating...`);
+                                            matched = computeMatchedSize(liq.adjustedSizeUsd, highest.markPrice, longEx, shortEx, { lotSize });
+                                            if (!matched) {
+                                                log(`[ARB] Skip ${symbol}: can't meet lot size ${lotSize}`);
+                                                continue;
+                                            }
+                                            log(`[ARB] Retry: ${matched.size} ${symbol} ($${matched.notional.toFixed(0)}/leg)`);
+                                            await Promise.all([
+                                                longAdapter.marketOrder(symbol, "buy", matched.size),
+                                                shortAdapter.marketOrder(symbol, "sell", matched.size),
+                                            ]);
+                                        }
+                                        else {
+                                            throw orderErr;
+                                        }
+                                    }
                                     // Verify fills match, correct if needed
                                     try {
                                         const recon = await reconcileArbFills(longAdapter, shortAdapter, symbol, log);

package/dist/utils.js

@@ -10,9 +10,14 @@ export function formatUsd(value) {
     const num = Number(value);
     if (isNaN(num))
         return String(value);
+    // Use more decimals for sub-cent values so they don't show as $0.00
+    const absNum = Math.abs(num);
+    const maxDecimals = absNum > 0 && absNum < 0.01 ? 6
+        : absNum < 1 ? 4
+            : 2;
     return num.toLocaleString("en-US", {
         minimumFractionDigits: 2,
-        maximumFractionDigits: 2,
+        maximumFractionDigits: maxDecimals,
     });
 }
 export function formatPnl(value) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perp-cli",
-  "version": "0.7.2",
+  "version": "0.7.4",
   "description": "Multi-DEX Perpetual Futures CLI - Pacifica, Hyperliquid, Lighter",
   "bin": {
     "perp": "dist/index.js",