perp-cli 0.4.0 → 0.4.8

package/dist/commands/trade.js

@@ -5,6 +5,7 @@ import { printJson, errorAndExit, withJsonErrors, jsonOk, jsonError, symbolMatch
 import { logExecution } from "../execution-log.js";
 import { validateTrade } from "../trade-validator.js";
 import { generateClientId, logClientId, isOrderDuplicate } from "../client-id-tracker.js";
+import { smartOrder } from "../smart-order.js";
 import chalk from "chalk";
 function pac(adapter) {
     if (!(adapter instanceof PacificaAdapter))
@@ -46,6 +47,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         .description("Place a market order (side: buy/sell)")
         .option("-s, --slippage <pct>", "Slippage percent", "1")
         .option("--reduce-only", "Reduce only order")
+        .option("--smart", "Smart execution: IOC limit at best bid/ask + 1 tick (reduces slippage)")
         .option("--client-id <id>", "Client order ID for idempotent tracking")
         .option("--auto-id", "Auto-generate a client order ID")
         .action(async (symbol, side, size, opts) => {
@@ -60,7 +62,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
             return;
         }
         const adapter = await getAdapter();
-        if (dryRunGuard("market_order", { exchange: adapter.name, symbol: symbol.toUpperCase(), side: s, size }))
+        if (dryRunGuard("market_order", { exchange: adapter.name, symbol: symbol.toUpperCase(), side: s, size, smart: !!opts.smart }))
             return;
         if (clientId) {
             logClientId({
@@ -71,11 +73,17 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         }
         let result;
         try {
-            result = await adapter.marketOrder(symbol.toUpperCase(), s, size);
+            if (opts.smart) {
+                const sr = await smartOrder(adapter, symbol.toUpperCase(), s, size);
+                result = { ...sr.result, smartOrder: { method: sr.method, price: sr.price, bestBookPrice: sr.bestBookPrice, tickSize: sr.tickSize } };
+            }
+            else {
+                result = await adapter.marketOrder(symbol.toUpperCase(), s, size);
+            }
             logExecution({
                 type: "market_order", exchange: adapter.name, symbol: symbol.toUpperCase(),
                 side: s, size, status: "success", dryRun: false,
-                meta: clientId ? { clientOrderId: clientId } : undefined,
+                meta: { ...(clientId ? { clientOrderId: clientId } : {}), ...(opts.smart ? { smart: true } : {}) },
             });
         }
         catch (err) {
@@ -83,7 +91,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
                 type: "market_order", exchange: adapter.name, symbol: symbol.toUpperCase(),
                 side: s, size, status: "failed", dryRun: false,
                 error: err instanceof Error ? err.message : String(err),
-                meta: clientId ? { clientOrderId: clientId } : undefined,
+                meta: { ...(clientId ? { clientOrderId: clientId } : {}), ...(opts.smart ? { smart: true } : {}) },
             });
             throw err;
         }
@@ -96,7 +104,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         }
         if (isJson())
             return printJson(jsonOk(clientId ? { ...result, clientOrderId: clientId } : result));
-        console.log(chalk.green(`\n  Market ${s.toUpperCase()} ${size} ${symbol.toUpperCase()} placed on ${adapter.name}.${clientId ? ` (id: ${clientId})` : ""}\n`));
+        console.log(chalk.green(`\n  Market ${s.toUpperCase()} ${size} ${symbol.toUpperCase()} placed on ${adapter.name}.${opts.smart ? " (smart)" : ""}${clientId ? ` (id: ${clientId})` : ""}\n`));
         printJson(jsonOk(result));
     });
     // Shortcuts: trade buy / trade sell
@@ -105,6 +113,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         .description("Market buy (shortcut for: trade market <symbol> buy <size>)")
         .option("-s, --slippage <pct>", "Slippage percent", "1")
         .option("--reduce-only", "Reduce only order")
+        .option("--smart", "Smart execution: IOC limit at best ask + 1 tick")
         .option("--client-id <id>", "Client order ID")
         .option("--auto-id", "Auto-generate client order ID")
         .action(async (symbol, size, opts) => {
@@ -116,12 +125,18 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
             return;
         }
         const adapter = await getAdapter();
-        if (dryRunGuard("market_order", { exchange: adapter.name, symbol: symbol.toUpperCase(), side: "buy", size }))
+        if (dryRunGuard("market_order", { exchange: adapter.name, symbol: symbol.toUpperCase(), side: "buy", size, smart: !!opts.smart }))
             return;
         let result;
         try {
-            result = await adapter.marketOrder(symbol.toUpperCase(), "buy", size);
-            logExecution({ type: "market_order", exchange: adapter.name, symbol: symbol.toUpperCase(), side: "buy", size, status: "success", dryRun: false });
+            if (opts.smart) {
+                const sr = await smartOrder(adapter, symbol.toUpperCase(), "buy", size);
+                result = { ...sr.result, smartOrder: { method: sr.method, price: sr.price, bestBookPrice: sr.bestBookPrice, tickSize: sr.tickSize } };
+            }
+            else {
+                result = await adapter.marketOrder(symbol.toUpperCase(), "buy", size);
+            }
+            logExecution({ type: "market_order", exchange: adapter.name, symbol: symbol.toUpperCase(), side: "buy", size, status: "success", dryRun: false, meta: opts.smart ? { smart: true } : undefined });
         }
         catch (err) {
             logExecution({ type: "market_order", exchange: adapter.name, symbol: symbol.toUpperCase(), side: "buy", size, status: "failed", dryRun: false, error: err instanceof Error ? err.message : String(err) });
@@ -129,7 +144,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         }
         if (isJson())
             return printJson(jsonOk(clientId ? { ...result, clientOrderId: clientId } : result));
-        console.log(chalk.green(`\n  Market BUY ${size} ${symbol.toUpperCase()} placed on ${adapter.name}.\n`));
+        console.log(chalk.green(`\n  Market BUY ${size} ${symbol.toUpperCase()} placed on ${adapter.name}.${opts.smart ? " (smart)" : ""}\n`));
         printJson(jsonOk(result));
     });
     trade
@@ -137,6 +152,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         .description("Market sell (shortcut for: trade market <symbol> sell <size>)")
         .option("-s, --slippage <pct>", "Slippage percent", "1")
         .option("--reduce-only", "Reduce only order")
+        .option("--smart", "Smart execution: IOC limit at best bid - 1 tick")
         .option("--client-id <id>", "Client order ID")
         .option("--auto-id", "Auto-generate client order ID")
         .action(async (symbol, size, opts) => {
@@ -148,12 +164,18 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
             return;
         }
         const adapter = await getAdapter();
-        if (dryRunGuard("market_order", { exchange: adapter.name, symbol: symbol.toUpperCase(), side: "sell", size }))
+        if (dryRunGuard("market_order", { exchange: adapter.name, symbol: symbol.toUpperCase(), side: "sell", size, smart: !!opts.smart }))
             return;
         let result;
         try {
-            result = await adapter.marketOrder(symbol.toUpperCase(), "sell", size);
-            logExecution({ type: "market_order", exchange: adapter.name, symbol: symbol.toUpperCase(), side: "sell", size, status: "success", dryRun: false });
+            if (opts.smart) {
+                const sr = await smartOrder(adapter, symbol.toUpperCase(), "sell", size);
+                result = { ...sr.result, smartOrder: { method: sr.method, price: sr.price, bestBookPrice: sr.bestBookPrice, tickSize: sr.tickSize } };
+            }
+            else {
+                result = await adapter.marketOrder(symbol.toUpperCase(), "sell", size);
+            }
+            logExecution({ type: "market_order", exchange: adapter.name, symbol: symbol.toUpperCase(), side: "sell", size, status: "success", dryRun: false, meta: opts.smart ? { smart: true } : undefined });
         }
         catch (err) {
             logExecution({ type: "market_order", exchange: adapter.name, symbol: symbol.toUpperCase(), side: "sell", size, status: "failed", dryRun: false, error: err instanceof Error ? err.message : String(err) });
@@ -161,7 +183,7 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         }
         if (isJson())
             return printJson(jsonOk(clientId ? { ...result, clientOrderId: clientId } : result));
-        console.log(chalk.green(`\n  Market SELL ${size} ${symbol.toUpperCase()} placed on ${adapter.name}.\n`));
+        console.log(chalk.green(`\n  Market SELL ${size} ${symbol.toUpperCase()} placed on ${adapter.name}.${opts.smart ? " (smart)" : ""}\n`));
         printJson(jsonOk(result));
     });
     trade
@@ -223,21 +245,42 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
         printJson(jsonOk(result));
     });
     trade
-        .command("cancel <symbol> <orderId>")
-        .description("Cancel a specific order")
-        .action(async (symbol, orderId) => {
+        .command("cancel <symbolOrOrderId> [orderId]")
+        .description("Cancel an order by orderId (auto-detects symbol), or by symbol + orderId")
+        .action(async (symbolOrOrderId, orderId) => {
         const adapter = await getAdapter();
-        if (dryRunGuard("cancel", { exchange: adapter.name, symbol: symbol.toUpperCase(), orderId }))
+        let symbol;
+        let oid;
+        if (orderId) {
+            // cancel <symbol> <orderId>
+            symbol = symbolOrOrderId.toUpperCase();
+            oid = orderId;
+        }
+        else {
+            // cancel <orderId> — look up symbol from open orders
+            oid = symbolOrOrderId;
+            const orders = await adapter.getOpenOrders();
+            const match = orders.find((o) => String(o.orderId) === oid);
+            if (!match) {
+                const err = `Order ${oid} not found in open orders`;
+                if (isJson())
+                    return printJson(jsonOk({ cancelled: false, reason: err }));
+                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.toUpperCase(), orderId);
-            logExecution({ type: "cancel", exchange: adapter.name, symbol: symbol.toUpperCase(), side: "cancel", size: "0", status: "success", dryRun: false, meta: { orderId } });
+            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 ${orderId} cancelled on ${adapter.name}.\n`));
+            console.log(chalk.green(`\n  Order ${oid} cancelled on ${adapter.name}.\n`));
         }
         catch (err) {
-            logExecution({ type: "cancel", exchange: adapter.name, symbol: symbol.toUpperCase(), side: "cancel", size: "0", status: "failed", dryRun: false, error: err instanceof Error ? err.message : String(err), meta: { orderId } });
+            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;
         }
     });
@@ -697,10 +740,11 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
     trade
         .command("close-all")
         .description("Close all open positions (market orders on opposite side)")
-        .action(async () => {
+        .option("--smart", "Smart execution: IOC limit at best bid/ask + 1 tick")
+        .action(async (opts) => {
         await withJsonErrors(isJson(), async () => {
             const adapter = await getAdapter();
-            if (dryRunGuard("close_all", { exchange: adapter.name }))
+            if (dryRunGuard("close_all", { exchange: adapter.name, smart: !!opts.smart }))
                 return;
             const positions = await adapter.getPositions();
             if (positions.length === 0) {
@@ -710,18 +754,25 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
                 return;
             }
             if (!isJson())
-                console.log(chalk.cyan(`\n  Closing ${positions.length} position(s) on ${adapter.name}...\n`));
+                console.log(chalk.cyan(`\n  Closing ${positions.length} position(s) on ${adapter.name}...${opts.smart ? " (smart)" : ""}\n`));
             const results = [];
             for (const pos of positions) {
                 const closeSide = pos.side === "long" ? "sell" : "buy";
                 if (!isJson())
                     console.log(chalk.gray(`  ${closeSide.toUpperCase()} ${pos.size} ${pos.symbol} (closing ${pos.side})...`));
-                const result = await adapter.marketOrder(pos.symbol, closeSide, pos.size);
+                let result;
+                if (opts.smart) {
+                    const sr = await smartOrder(adapter, pos.symbol, closeSide, pos.size, { reduceOnly: true });
+                    result = { ...sr.result, smartOrder: { method: sr.method, price: sr.price, bestBookPrice: sr.bestBookPrice } };
+                }
+                else {
+                    result = await adapter.marketOrder(pos.symbol, closeSide, pos.size);
+                }
                 results.push(result);
                 logExecution({
                     type: "market_order", exchange: adapter.name, symbol: pos.symbol,
                     side: closeSide, size: pos.size, status: "success", dryRun: false,
-                    meta: { action: "close-all", originalSide: pos.side },
+                    meta: { action: "close-all", originalSide: pos.side, smart: !!opts.smart },
                 });
             }
             if (isJson())
@@ -732,7 +783,8 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
     trade
         .command("close <symbol>")
         .description("Close a specific symbol's position")
-        .action(async (symbol) => {
+        .option("--smart", "Smart execution: IOC limit at best bid/ask + 1 tick")
+        .action(async (symbol, opts) => {
         await withJsonErrors(isJson(), async () => {
             const sym = symbol.toUpperCase();
             const adapter = await getAdapter();
@@ -744,31 +796,39 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
                 errorAndExit(`No open position for ${sym}`);
             }
             const closeSide = pos.side === "long" ? "sell" : "buy";
-            if (dryRunGuard("close", { exchange: adapter.name, symbol: sym, side: closeSide, size: pos.size, originalSide: pos.side }))
+            if (dryRunGuard("close", { exchange: adapter.name, symbol: sym, side: closeSide, size: pos.size, originalSide: pos.side, smart: !!opts.smart }))
                 return;
             if (!isJson())
-                console.log(chalk.cyan(`\n  Closing ${pos.side} ${pos.size} ${sym} on ${adapter.name}...\n`));
-            const result = await adapter.marketOrder(sym, closeSide, pos.size);
+                console.log(chalk.cyan(`\n  Closing ${pos.side} ${pos.size} ${sym} on ${adapter.name}...${opts.smart ? " (smart)" : ""}\n`));
+            let result;
+            if (opts.smart) {
+                const sr = await smartOrder(adapter, sym, closeSide, pos.size, { reduceOnly: true });
+                result = { ...sr.result, smartOrder: { method: sr.method, price: sr.price, bestBookPrice: sr.bestBookPrice } };
+            }
+            else {
+                result = await adapter.marketOrder(sym, closeSide, pos.size);
+            }
             logExecution({
                 type: "market_order", exchange: adapter.name, symbol: sym,
                 side: closeSide, size: pos.size, status: "success", dryRun: false,
-                meta: { action: "close", originalSide: pos.side },
+                meta: { action: "close", originalSide: pos.side, smart: !!opts.smart },
             });
             if (isJson())
                 return printJson(jsonOk(result));
-            console.log(chalk.green(`\n  Closed ${pos.side} ${pos.size} ${sym} on ${adapter.name}.\n`));
+            console.log(chalk.green(`\n  Closed ${pos.side} ${pos.size} ${sym} on ${adapter.name}.${opts.smart ? " (smart)" : ""}\n`));
         });
     });
     trade
         .command("flatten")
         .description("Cancel all orders AND close all positions (full cleanup)")
-        .action(async () => {
+        .option("--smart", "Smart execution: IOC limit at best bid/ask + 1 tick")
+        .action(async (opts) => {
         await withJsonErrors(isJson(), async () => {
             const adapter = await getAdapter();
-            if (dryRunGuard("flatten", { exchange: adapter.name }))
+            if (dryRunGuard("flatten", { exchange: adapter.name, smart: !!opts.smart }))
                 return;
             if (!isJson())
-                console.log(chalk.cyan(`\n  Flattening account on ${adapter.name}...\n`));
+                console.log(chalk.cyan(`\n  Flattening account on ${adapter.name}...${opts.smart ? " (smart)" : ""}\n`));
             // Step 1: Cancel all orders
             if (!isJson())
                 console.log(chalk.gray("  Cancelling all open orders..."));
@@ -780,12 +840,19 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
                 const closeSide = pos.side === "long" ? "sell" : "buy";
                 if (!isJson())
                     console.log(chalk.gray(`  ${closeSide.toUpperCase()} ${pos.size} ${pos.symbol} (closing ${pos.side})...`));
-                const result = await adapter.marketOrder(pos.symbol, closeSide, pos.size);
+                let result;
+                if (opts.smart) {
+                    const sr = await smartOrder(adapter, pos.symbol, closeSide, pos.size, { reduceOnly: true });
+                    result = sr.result;
+                }
+                else {
+                    result = await adapter.marketOrder(pos.symbol, closeSide, pos.size);
+                }
                 closeResults.push(result);
                 logExecution({
                     type: "market_order", exchange: adapter.name, symbol: pos.symbol,
                     side: closeSide, size: pos.size, status: "success", dryRun: false,
-                    meta: { action: "flatten", originalSide: pos.side },
+                    meta: { action: "flatten", originalSide: pos.side, smart: !!opts.smart },
                 });
             }
             if (isJson())
@@ -796,7 +863,8 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
     trade
         .command("reduce <symbol> <percent>")
         .description("Reduce a position by a percentage (e.g., perp trade reduce BTC 50)")
-        .action(async (symbol, percent) => {
+        .option("--smart", "Smart execution: IOC limit at best bid/ask + 1 tick")
+        .action(async (symbol, percent, opts) => {
         await withJsonErrors(isJson(), async () => {
             const sym = symbol.toUpperCase();
             const pct = parseFloat(percent);
@@ -813,19 +881,26 @@ export function registerTradeCommands(program, getAdapter, isJson, isDryRun = ()
             const fullSize = parseFloat(pos.size);
             const reduceSize = (fullSize * pct / 100).toString();
             const closeSide = pos.side === "long" ? "sell" : "buy";
-            if (dryRunGuard("reduce", { exchange: adapter.name, symbol: sym, side: closeSide, size: reduceSize, percent: pct, originalSize: pos.size }))
+            if (dryRunGuard("reduce", { exchange: adapter.name, symbol: sym, side: closeSide, size: reduceSize, percent: pct, originalSize: pos.size, smart: !!opts.smart }))
                 return;
             if (!isJson())
-                console.log(chalk.cyan(`\n  Reducing ${sym} ${pos.side} by ${pct}% (${reduceSize} of ${pos.size}) on ${adapter.name}...\n`));
-            const result = await adapter.marketOrder(sym, closeSide, reduceSize);
+                console.log(chalk.cyan(`\n  Reducing ${sym} ${pos.side} by ${pct}% (${reduceSize} of ${pos.size}) on ${adapter.name}...${opts.smart ? " (smart)" : ""}\n`));
+            let result;
+            if (opts.smart) {
+                const sr = await smartOrder(adapter, sym, closeSide, reduceSize, { reduceOnly: true });
+                result = sr.result;
+            }
+            else {
+                result = await adapter.marketOrder(sym, closeSide, reduceSize);
+            }
             logExecution({
                 type: "market_order", exchange: adapter.name, symbol: sym,
                 side: closeSide, size: reduceSize, status: "success", dryRun: false,
-                meta: { action: "reduce", percent: pct, originalSize: pos.size, originalSide: pos.side },
+                meta: { action: "reduce", percent: pct, originalSize: pos.size, originalSide: pos.side, smart: !!opts.smart },
             });
             if (isJson())
                 return printJson(jsonOk({ reduced: true, percent: pct, sizeReduced: reduceSize, originalSize: pos.size, result }));
-            console.log(chalk.green(`\n  Reduced ${sym} by ${pct}% (${closeSide} ${reduceSize}) on ${adapter.name}.\n`));
+            console.log(chalk.green(`\n  Reduced ${sym} by ${pct}% (${closeSide} ${reduceSize}) on ${adapter.name}.${opts.smart ? " (smart)" : ""}\n`));
         });
     });
     // ── Order Status Query ──

package/dist/commands/wallet.js

@@ -389,7 +389,7 @@ export function registerWalletCommands(program, isJson) {
                 const { LighterAdapter } = await import("../exchanges/lighter.js");
                 const adapter = new LighterAdapter(normalized);
                 await adapter.init();
-                const apiKeyIndex = 2;
+                const apiKeyIndex = 4;
                 const { privateKey: apiKey } = await adapter.setupApiKey(apiKeyIndex);
                 setEnvVar("LIGHTER_API_KEY", apiKey);
                 setEnvVar("LIGHTER_ACCOUNT_INDEX", String(adapter.accountIndex));

package/dist/config.d.ts

@@ -1,5 +1,10 @@
 import { Keypair } from "@solana/web3.js";
 export type Exchange = "pacifica" | "hyperliquid" | "lighter";
+/**
+ * Try to load a private key without throwing if none is found.
+ * Returns null if no key is configured.
+ */
+export declare function tryLoadPrivateKey(exchange: Exchange, pkOverride?: string): Promise<string | null>;
 export declare function loadPrivateKey(exchange: Exchange, pkOverride?: string): Promise<string>;
 export declare function parseSolanaKeypair(input: string): Keypair;
 export declare function isEvmPrivateKey(input: string): boolean;

package/dist/config.js

@@ -3,6 +3,18 @@ import bs58 from "bs58";
 import chalk from "chalk";
 import { resolve } from "path";
 import { existsSync, readFileSync } from "fs";
+/**
+ * Try to load a private key without throwing if none is found.
+ * Returns null if no key is configured.
+ */
+export async function tryLoadPrivateKey(exchange, pkOverride) {
+    try {
+        return await loadPrivateKey(exchange, pkOverride);
+    }
+    catch {
+        return null;
+    }
+}
 export async function loadPrivateKey(exchange, pkOverride) {
     // 1. CLI flag
     if (pkOverride)

package/dist/constants.d.ts

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

package/dist/constants.js

@@ -0,0 +1,40 @@
+/**
+ * Shared constants for perp-cli.
+ */
+import { loadSettings } from "./settings.js";
+/** Default taker fee per exchange (as fraction, e.g. 0.00035 = 0.035%) */
+export const TAKER_FEES = {
+    hyperliquid: 0.00035,
+    pacifica: 0.00035,
+    lighter: 0,
+};
+/** Get taker fee for an exchange. Uses settings if available, falls back to defaults. */
+export function getTakerFee(exchange) {
+    const key = exchange.toLowerCase();
+    try {
+        const settings = loadSettings();
+        if (settings.fees[key]?.taker !== undefined) {
+            return settings.fees[key].taker;
+        }
+    }
+    catch { /* fallback to hardcoded */ }
+    return TAKER_FEES[key] ?? 0.00035;
+}
+/** Get maker fee for an exchange. Uses settings if available. */
+export function getMakerFee(exchange) {
+    const key = exchange.toLowerCase();
+    try {
+        const settings = loadSettings();
+        if (settings.fees[key]?.maker !== undefined) {
+            return settings.fees[key].maker;
+        }
+    }
+    catch { /* fallback */ }
+    return 0;
+}
+/** Get full fee info for an exchange. */
+export function getExchangeFees(exchange) {
+    return { taker: getTakerFee(exchange), maker: getMakerFee(exchange) };
+}
+/** Default taker fee for single-exchange use (when exchange is unknown). */
+export const DEFAULT_TAKER_FEE = 0.00035;

package/dist/dashboard/ws-feeds.js

@@ -569,7 +569,7 @@ class LighterFeed extends ExchangeWsFeed {
                         liquidationPrice: String(p.liquidation_price || "N/A"),
                         unrealizedPnl: String(p.unrealized_pnl ?? "0"),
                         leverage: Number(p.initial_margin_fraction ?? 0) > 0
-                            ? Math.round(100 / Number(p.initial_margin_fraction))
+                            ? Math.round(10000 / Number(p.initial_margin_fraction))
                             : 1,
                     };
                 });

package/dist/equity-tracker.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Equity Tracker — time-series equity snapshots for PnL analysis.
+ *
+ * Stores snapshots in ~/.perp/equity-history/YYYY-MM.jsonl (monthly files).
+ * Computes daily PnL, Sharpe ratio, max drawdown, win/loss stats.
+ */
+export interface EquitySnapshot {
+    ts: string;
+    exchange: string;
+    equity: number;
+    available: number;
+    marginUsed: number;
+    unrealizedPnl: number;
+    positionCount: number;
+}
+export interface DailyPnl {
+    date: string;
+    exchange: string;
+    startEquity: number;
+    endEquity: number;
+    pnl: number;
+    pnlPct: number;
+}
+export interface PnlMetrics {
+    totalReturn: number;
+    totalReturnPct: number;
+    dailyReturns: DailyPnl[];
+    sharpeRatio: number;
+    maxDrawdown: number;
+    maxDrawdownPct: number;
+    winDays: number;
+    lossDays: number;
+    winRate: number;
+    peakEquity: number;
+    currentDrawdown: number;
+    currentDrawdownPct: number;
+    bestDay: DailyPnl | null;
+    worstDay: DailyPnl | null;
+    avgDailyPnl: number;
+    period: {
+        from: string;
+        to: string;
+        days: number;
+    };
+}
+export declare function saveEquitySnapshot(snap: EquitySnapshot): void;
+export declare function readEquityHistory(opts?: {
+    exchange?: string;
+    since?: Date;
+    until?: Date;
+}): EquitySnapshot[];
+/** Group snapshots by date, take first and last per day for daily PnL. */
+export declare function computeDailyPnl(snapshots: EquitySnapshot[], exchange?: string): DailyPnl[];
+/** Compute comprehensive PnL metrics from equity snapshots. */
+export declare function computePnlMetrics(snapshots: EquitySnapshot[], exchange?: string): PnlMetrics;
+/** Compute weekly PnL from daily PnL data. */
+export declare function aggregateWeekly(daily: DailyPnl[]): DailyPnl[];