perp-cli 0.14.1 → 0.14.2

package/dist/bot/strategies/funding-auto.js

@@ -54,16 +54,22 @@ class FundingAutoStrategy {
     get defaultFeeRate() { return Number(this._config.defaultFeeRate ?? 0.0005); }
     get defaultSlippage() { return Number(this._config.defaultSlippage ?? 0.001); }
     get scanIntervalTicks() { return Number(this._config.scanIntervalTicks ?? 1); }
-    /** Position size: min of sizeUsd (if set) and maxCapitalPct% of total equity */
-    _cachedEquity = 0;
+    /** Total equity across all venues, read this tick; null = some venue's balance is unknown. */
+    _cachedEquity = null;
+    /**
+     * Position size: min of sizeUsd (if set) and maxCapitalPct% of total equity. null = cannot be
+     * sized (equity unknown, or no capital and no sizeUsd) — no entry, never a substituted size.
+     */
     getSizeUsd() {
+        if (this._cachedEquity === null)
+            return null;
         const fixedSize = Number(this._config.sizeUsd ?? 0);
         const capitalLimit = this._cachedEquity * (this.maxCapitalPct / 100);
         if (fixedSize > 0 && capitalLimit > 0)
             return Math.min(fixedSize, capitalLimit);
         if (capitalLimit > 0)
             return capitalLimit;
-        return fixedSize > 0 ? fixedSize : 100; // fallback
+        return null;
     }
     describe() {
         return {
@@ -96,22 +102,27 @@ class FundingAutoStrategy {
         ctx.log(`[funding-auto] Starting (perp-perp only; spot-perp mode is not supported by this strategy)`);
     }
     async onTick(ctx, _snapshot) {
-        // Cache total equity across ALL exchanges for capital-based sizing
-        try {
-            const adapters = this.getAdapters(ctx);
-            let totalEquity = 0;
-            for (const [, adapter] of adapters) {
-                try {
-                    const bal = await adapter.getBalance();
-                    totalEquity += Number(bal.equity) || 0;
-                }
-                catch { /* skip */ }
-            }
-            this._cachedEquity = totalEquity > 0 ? totalEquity : this._cachedEquity;
-        }
-        catch { /* keep previous cached value */ }
         // Get all adapters
         const adapters = this.getAdapters(ctx);
+        // Total equity across ALL exchanges for capital-based sizing, read fresh every tick.
+        // Any unknown balance → equity unknown (null): no new entry is sized this tick (never a
+        // stale value, a venue counted as $0, or a substituted size).
+        let totalEquity = 0;
+        for (const [name, adapter] of adapters) {
+            try {
+                const bal = await adapter.getBalance();
+                const eq = Number(bal.equity);
+                if (!Number.isFinite(eq))
+                    throw new Error(`equity "${bal.equity}" is not a number`);
+                if (totalEquity !== null)
+                    totalEquity += eq;
+            }
+            catch (e) {
+                totalEquity = null;
+                ctx.log(`[funding-auto] ${name} balance unreadable (${e instanceof Error ? e.message : String(e)}) — equity unknown, no new entries this tick`);
+            }
+        }
+        this._cachedEquity = totalEquity;
         if (adapters.size < 2) {
             ctx.log(`[funding-auto] Need 2+ exchanges, have ${adapters.size}. Skipping.`);
             return [];
@@ -123,6 +134,8 @@ class FundingAutoStrategy {
         // Fetch funding rates from all exchanges (price data cached for position sizing)
         const ratesByExchange = new Map();
         const priceCache = new Map(); // "exchange:symbol" -> price
+        // Venues whose markets could not be read this tick: no open / close decision touches them.
+        const ratesUnavailable = new Set();
         for (const [name, adapter] of adapters) {
             try {
                 const markets = await adapter.getMarkets();
@@ -144,17 +157,19 @@ class FundingAutoStrategy {
                 }
                 ratesByExchange.set(name, map);
             }
-            catch {
-                // Skip unavailable exchange
+            catch (e) {
+                ratesUnavailable.add(name);
+                ctx.log(`[funding-auto] ${name} markets unreadable (${e instanceof Error ? e.message : String(e)}) — no open / close decision on ${name} this tick`);
             }
         }
         // Store priceCache for use by openPosition/closePosition
         ctx.state.set("priceCache", priceCache);
         // Calculate notional for discovered positions (using current price)
+        // (unknown price → notional left unset, never valued at $0)
         for (const pos of positions) {
             const price = priceCache.get(`${pos.longExchange}:${pos.symbol}`)
-                || priceCache.get(`${pos.shortExchange}:${pos.symbol}`) || 0;
-            if (price > 0) {
+                ?? priceCache.get(`${pos.shortExchange}:${pos.symbol}`);
+            if (price !== undefined) {
                 pos.notional = Math.max(pos.longSize, pos.shortSize) * price;
             }
         }
@@ -171,12 +186,15 @@ class FundingAutoStrategy {
                 const longRates = ratesByExchange.get(pos.longExchange);
                 const shortRates = ratesByExchange.get(pos.shortExchange);
                 if (!longRates || !shortRates) {
+                    const down = [pos.longExchange, pos.shortExchange].filter(n => ratesUnavailable.has(n) || !ratesByExchange.has(n));
+                    ctx.log(`[funding-auto] ${pos.symbol}: rates unavailable on ${down.join(", ")} — skipping the exit decision this tick`);
                     surviving.push(pos);
                     continue;
                 }
                 const longInfo = longRates.get(pos.symbol);
                 const shortInfo = shortRates.get(pos.symbol);
                 if (!longInfo || !shortInfo) {
+                    ctx.log(`[funding-auto] ${pos.symbol}: market missing on ${!longInfo ? pos.longExchange : pos.shortExchange} — skipping the exit decision this tick`);
                     surviving.push(pos);
                     continue;
                 }
@@ -184,6 +202,11 @@ class FundingAutoStrategy {
                 // (each normalized by its own funding basis), annualized %. Positive = still
                 // earning; ≤ 0 = the pair has reversed and now pays.
                 const currentSpread = annualizeHourlyRate(hourlyOf(shortInfo, pos.shortExchange) - hourlyOf(longInfo, pos.longExchange));
+                if (!Number.isFinite(currentSpread)) {
+                    ctx.log(`[funding-auto] ${pos.symbol}: funding rate unknown (${pos.longExchange}↔${pos.shortExchange}) — skipping the exit decision this tick`);
+                    surviving.push(pos);
+                    continue;
+                }
                 // Calculate real P&L from exchange history. An unreadable history is never "0":
                 // no close decision for this pair this tick.
                 const [longPnl, shortPnl] = await Promise.all([
@@ -219,8 +242,14 @@ class FundingAutoStrategy {
             return surviving.length > 0 ? [{ type: "noop" }] : [];
         if (surviving.length >= this.maxPositions)
             return [{ type: "noop" }];
+        // Unknown sizing (equity unknown, or no capital and no sizeUsd): no new entries this tick.
+        const sizeUsd = this.getSizeUsd();
+        if (sizeUsd === null) {
+            ctx.log(`[funding-auto] No new entries: position size unknown (equity ${this._cachedEquity === null ? "unknown" : `$${this._cachedEquity.toFixed(2)}`}, sizeUsd ${Number(this._config.sizeUsd ?? 0)})`);
+            return surviving.length > 0 ? [{ type: "noop" }] : [];
+        }
         ctx.state.set("lastScan", Date.now());
-        ctx.log(`[funding-auto] Scanning ${ratesByExchange.size} exchanges, equity: $${this._cachedEquity.toFixed(2)}, size: $${this.getSizeUsd().toFixed(2)}/pos, active: ${surviving.length}`);
+        ctx.log(`[funding-auto] Scanning ${ratesByExchange.size} exchanges, equity: $${this._cachedEquity.toFixed(2)}, size: $${sizeUsd.toFixed(2)}/pos, active: ${surviving.length}`);
         const activeSymbols = new Set(surviving.map(p => `${p.symbol}:${p.mode}`));
         // Also block symbols we already tried to enter (prevents re-entry on failed/tiny orders)
         const attempted = ctx.state.get("attemptedSymbols") ?? new Set();
@@ -263,7 +292,7 @@ class FundingAutoStrategy {
             if (annualSpread < this.perpPerpMinSpread)
                 continue;
             // Calculate cost and break-even
-            const notional = this.getSizeUsd();
+            const notional = sizeUsd;
             const hourlyIncome = Math.abs(maxRate - minRate) * notional;
             const { totalCost } = calculateCosts(notional, this.defaultFeeRate, this.defaultFeeRate, this.defaultSlippage, this.defaultSlippage);
             const breakEvenHours = calculateBreakEven(totalCost, hourlyIncome);
@@ -314,7 +343,7 @@ class FundingAutoStrategy {
             // Track attempted symbols to prevent re-entry on same tick cycle
             attempted.add(`${opp.symbol}:${opp.mode}`);
             ctx.state.set("attemptedSymbols", attempted);
-            const success = await this.openPosition(ctx, opp, adapters);
+            const success = await this.openPosition(ctx, opp, adapters, sizeUsd);
             if (success) {
                 currentCount++;
                 perpPerpOpened++;
@@ -362,16 +391,10 @@ class FundingAutoStrategy {
         }
         return adapters;
     }
-    /** Resolve cached price for a symbol on a given exchange */
+    /** Cached (this tick's) price for a symbol on a given exchange; undefined = unknown. */
     getCachedPrice(ctx, exchange, symbol) {
         const cache = ctx.state.get("priceCache");
-        return cache?.get(`${exchange}:${symbol}`) ?? 0;
-    }
-    /** Format size with exchange-appropriate precision based on asset price */
-    formatSize(rawSize, _symbol) {
-        // Use price to determine precision
-        const price = rawSize > 0 ? this.getSizeUsd() / rawSize : 0;
-        return formatSizeForPrice(rawSize, price);
+        return cache?.get(`${exchange}:${symbol}`);
     }
     /** Discover existing arb pairs from live exchange positions; `unreadable` = venues whose positions failed to load. */
     async discoverArbPairs(adapters, log) {
@@ -458,7 +481,7 @@ class FundingAutoStrategy {
      * (reduce-only, verified). A definite short failure rolls the long back reduce-only.
      * An unknown outcome or a failed rollback / trim quarantines the symbol.
      */
-    async openPosition(ctx, opp, adapters) {
+    async openPosition(ctx, opp, adapters, notionalUsd) {
         // Engine: equity unknown → no new entries (closes still run).
         if (ctx.state.get("equityUnknown") === true) {
             ctx.log(`[funding-auto] Skip ${opp.symbol}: equity unknown — no new entries`);
@@ -469,11 +492,12 @@ class FundingAutoStrategy {
         if (!longAdapter || !shortAdapter)
             return false;
         const price = this.getCachedPrice(ctx, opp.longExchange, opp.symbol)
-            || this.getCachedPrice(ctx, opp.shortExchange, opp.symbol);
-        if (price <= 0)
+            ?? this.getCachedPrice(ctx, opp.shortExchange, opp.symbol);
+        if (price === undefined) {
+            ctx.log(`[funding-auto] Skip ${opp.symbol}: price unknown on ${opp.longExchange} / ${opp.shortExchange}`);
             return false;
-        const notionalUsd = this.getSizeUsd();
-        const size = this.formatSize(notionalUsd / price, opp.symbol);
+        }
+        const size = formatSizeForPrice(notionalUsd / price, price);
         // Minimum notional check — skip if below exchange minimums
         if (notionalUsd < MIN_NOTIONAL_USD) {
             ctx.log(`[funding-auto] Skip ${opp.symbol}: notional $${notionalUsd.toFixed(0)} < min $${MIN_NOTIONAL_USD}`);

package/dist/bot/strategies/grid-strategy.d.ts

@@ -1,4 +1,6 @@
 import type { Strategy, StrategyContext, StrategyAction, EnrichedSnapshot } from "../strategy-types.js";
+/** Consecutive failed open-order reads after which every tick logs a loud warning. */
+export declare const GRID_READ_FAILURE_WARN = 5;
 export declare class GridStrategy implements Strategy {
     readonly name = "grid";
     describe(): {

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

@@ -1,4 +1,6 @@
 import { registerStrategy } from "../strategy-registry.js";
+/** Consecutive failed open-order reads after which every tick logs a loud warning. */
+export const GRID_READ_FAILURE_WARN = 5;
 export class GridStrategy {
     name = "grid";
     describe() {
@@ -95,12 +97,13 @@ export class GridStrategy {
             }
             // For each filled level, place the opposite (counter) order
             const newLevels = [...matchedLevels];
+            const counterOrders = [];
             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({
+                    counterOrders.push({
                         type: "place_order",
                         side: newSide,
                         price: newPrice.toFixed(2),
@@ -111,8 +114,24 @@ export class GridStrategy {
                 }
             }
             ctx.state.set("gridLevels", newLevels);
+            actions.push(...counterOrders);
+            const prevFailures = ctx.state.get("gridReadFailures") ?? 0;
+            if (prevFailures > 0)
+                ctx.log(`  [GRID] Open orders readable again after ${prevFailures} failed read(s)`);
+            ctx.state.set("gridReadFailures", 0);
+        }
+        catch (e) {
+            // No fill detection / counter orders on an unread book (never on stale data); retried next tick.
+            const failures = (ctx.state.get("gridReadFailures") ?? 0) + 1;
+            ctx.state.set("gridReadFailures", failures);
+            const reason = e instanceof Error ? e.message : String(e);
+            if (failures >= GRID_READ_FAILURE_WARN) {
+                ctx.log(`  [GRID] WARNING: open orders unreadable for ${failures} consecutive ticks (${reason}) — the grid is NOT placing counter orders; check: perp -e ${ctx.adapter.name} account orders`);
+            }
+            else {
+                ctx.log(`  [GRID] Open orders read failed (${failures}/${GRID_READ_FAILURE_WARN}): ${reason} — fill detection skipped this tick`);
+            }
         }
-        catch { /* retry next loop */ }
         // Auto-rebalance if price exits range
         if (params.rebalance) {
             const lastRebalance = ctx.state.get("lastRebalance") ?? 0;

package/dist/bot/strategies/spot-perp-arb-strategy.js

@@ -12,7 +12,7 @@ import { registerStrategy } from "../strategy-registry.js";
 import { getFundingHours } from "../../funding.js";
 import { annualizeHourlyRate } from "../../funding/normalize.js";
 import { pruneExecutionLog } from "../../execution-log.js";
-import { buildAdapterMap, getPerpSymbol, findRate, matchSymbol, fetchRates, scoreFunding, botSpotPerpMatches, assertFundingArbLegs, cancelBotSymbols } from "./funding-arb-utils.js";
+import { buildAdapterMap, getPerpSymbol, findRate, matchSymbol, fetchRates, scoreFunding, botSpotPerpMatches, assertFundingArbLegs, cancelBotSymbols, collectFundingSince } from "./funding-arb-utils.js";
 import { SpotPerpExecutor } from "./spot-perp-executor.js";
 import { findSpotQuoteBalance, getBotSpotAdapter, nonQuoteSpotBalances, spotNetworkOf, spotSharesPerpMargin, spotTokenBase } from "../../exchanges/spot-factory.js";
 import { getVenue } from "../../exchanges/venue.js";
@@ -84,6 +84,9 @@ export class SpotPerpArbStrategy {
         ctx.state.set("spaPositions", []);
         ctx.state.set("arbPositions", 0);
         ctx.state.set("fundingIncome", 0);
+        // Payments up to this instant are covered by the startup recovery (last 24 h); the periodic
+        // check books only payments newer than it (collectFundingSince high-water mark).
+        ctx.state.set("fundingStartTime", Date.now());
         ctx.state.set("fundingLastCheck", Date.now());
         ctx.log(`  [SPA] Ready | rate >= ${p.min_rate}% | close < ${p.close_rate}% | size $${p.size_usd}`);
         ctx.log(`  [SPA] Consistency >= ${(p.min_consistency * 100).toFixed(0)}% | history ${p.history_periods} periods | rotation ${p.rotation_threshold}%`);
@@ -103,13 +106,16 @@ export class SpotPerpArbStrategy {
                 try {
                     const payments = await a.getFundingPayments(200);
                     const oneDayAgo = Date.now() - 24 * 60 * 60 * 1000;
-                    const sum = payments.filter(fp => fp.time > oneDayAgo).reduce((s, fp) => s + parseFloat(fp.payment), 0);
+                    const startedAt = ctx.state.get("fundingStartTime");
+                    const sum = payments.filter(fp => fp.time > oneDayAgo && fp.time <= startedAt).reduce((s, fp) => s + parseFloat(fp.payment), 0);
                     if (Math.abs(sum) > 0.001) {
                         historicalFunding += sum;
                         ctx.log(`  [FUND] ${name}: $${sum.toFixed(4)} historical`);
                     }
                 }
-                catch { /* not supported */ }
+                catch (e) {
+                    ctx.log(`  [FUND] ${name}: funding history unavailable — historical funding excludes it: ${e instanceof Error ? e.message : String(e)}`);
+                }
             }
             if (Math.abs(historicalFunding) > 0.001)
                 ctx.state.set("fundingIncome", historicalFunding);
@@ -181,22 +187,15 @@ export class SpotPerpArbStrategy {
         const lastCheck = ctx.state.get("fundingLastCheck");
         if (Date.now() - lastCheck > 5 * 60 * 1000) {
             try {
-                let total = 0;
-                for (const [name, a] of adapters) {
-                    try {
-                        const payments = await a.getFundingPayments(50);
-                        const start = ctx.state.get("fundingLastCheck");
-                        const sum = payments.filter(fp => fp.time > start - 5 * 60 * 1000).reduce((s, fp) => s + parseFloat(fp.payment), 0);
-                        total += sum;
-                        if (Math.abs(sum) > 0.001)
-                            ctx.log(`  [FUND] ${name}: $${sum.toFixed(4)}`);
-                    }
-                    catch { /* skip */ }
-                }
+                const since = ctx.state.get("fundingLastCheckByVenue") ?? {};
+                const { total } = await collectFundingSince(adapters, since, ctx.state.get("fundingStartTime"), ctx.log);
+                ctx.state.set("fundingLastCheckByVenue", since);
                 ctx.state.set("fundingIncome", ctx.state.get("fundingIncome") + total);
                 ctx.state.set("fundingLastCheck", Date.now());
             }
-            catch { /* non-critical */ }
+            catch (e) {
+                ctx.log(`  [FUND] funding check failed: ${e instanceof Error ? e.message : String(e)}`);
+            }
         }
         for (const pos of positions) {
             if (Date.now() - pos.lastFundingCheck < 10 * 60 * 1000)
@@ -213,7 +212,10 @@ export class SpotPerpArbStrategy {
                     pos.fundingHistory = recent.map(fp => ({ time: fp.time, amount: parseFloat(fp.payment) }));
                 pos.lastFundingCheck = Date.now();
             }
-            catch { /* non-critical */ }
+            catch (e) {
+                // lastFundingCheck is not advanced: retried next tick.
+                ctx.log(`  [FUND] ${pos.symbol} ${pos.perpExchange}: funding history unavailable: ${e instanceof Error ? e.message : String(e)}`);
+            }
         }
         const display = positions.map(pos => {
             const ann = this.calcAnnualized(pos, ratesByExchange);
@@ -589,11 +591,17 @@ export class SpotPerpArbStrategy {
             const maxTotalPositionUsd = riskConfig?.max_position_usd ?? Infinity;
             const positions = ctx.state.get("spaPositions");
             let currentTotalUsd = 0;
-            for (const pos of positions) {
+            // No cap (Infinity): exposure does not gate the entry.
+            for (const pos of Number.isFinite(maxTotalPositionUsd) ? positions : []) {
                 const ri = findRate(ratesByExchange, pos.perpExchange, getPerpSymbol(pos.symbol, pos.perpExchange))
                     ?? findRate(ratesByExchange, pos.perpExchange, pos.symbol);
-                const price = ri?.price ?? 0;
-                currentTotalUsd += price * parseFloat(pos.size);
+                // Unknown price of a held position → exposure unknown: no new entry this cycle (a $0
+                // valuation would understate exposure and let the max_position_usd cap be bypassed).
+                if (ri === undefined || !(ri.price > 0)) {
+                    ctx.log(`  [SPA] Skip ${symbol}: ${pos.symbol} ${pos.perpExchange} price unknown this cycle — total exposure unknown, no new entries`);
+                    return false;
+                }
+                currentTotalUsd += ri.price * parseFloat(pos.size);
             }
             const remainingBudget = maxTotalPositionUsd - currentTotalUsd;
             if (remainingBudget < 10) {

package/dist/bot/tui/BotDashboard.d.ts

@@ -1,7 +1,14 @@
 export interface ExchangeBalance {
     exchange: string;
-    equity: string;
-    available: string;
+    /** null = the balance read failed (`error` says why) — shown "unavailable", never $0. */
+    equity: string | null;
+    available: string | null;
+    error?: string;
+}
+/** A venue whose display read (positions / spot balances) failed this tick. */
+export interface VenueReadError {
+    exchange: string;
+    error: string;
 }
 export interface BotTuiState {
     phase: string;
@@ -29,6 +36,10 @@ export interface BotTuiState {
     strategyState: Record<string, unknown>;
     tick: number;
     exchangeBalances?: ExchangeBalance[];
+    /** Venues whose positions could not be read: their positions are unknown, not empty. */
+    positionErrors?: VenueReadError[];
+    /** Open orders read failure (null = read): the orders are unknown, not empty. */
+    openOrdersError?: string | null;
 }
 export interface Position {
     symbol: string;

package/dist/bot/tui/BotDashboard.js

@@ -68,15 +68,20 @@ export function BotDashboard({ initialState, onQuit, onPause, subscribe }) {
     const drawdown = state.equity !== null && state.peakEquity !== null ? state.peakEquity - state.equity : null;
     const drawdownPct = drawdown !== null && state.peakEquity !== null && state.peakEquity > 0 ? (drawdown / state.peakEquity) * 100 : 0;
     const usd = (v) => v === null ? "unknown" : `$${v.toFixed(2)}`;
-    const totalEquity = state.exchangeBalances !== undefined ? state.exchangeBalances.reduce((s, e) => s + parseFloat(e.equity), 0) : state.equity;
+    // Any unavailable venue balance → the total is unknown (never summed as if that venue were $0).
+    const totalEquity = state.exchangeBalances !== undefined
+        ? (state.exchangeBalances.some((e) => e.equity === null) ? null : state.exchangeBalances.reduce((s, e) => s + parseFloat(e.equity), 0))
+        : state.equity;
+    const positionErrors = state.positionErrors ?? [];
+    const openOrdersError = state.openOrdersError ?? null;
     const bidOrders = state.openOrders.filter((o) => o.side.toLowerCase() === "buy");
     const askOrders = state.openOrders.filter((o) => o.side.toLowerCase() === "sell");
     const hasMultiExchange = (state.exchangeBalances?.length ?? 0) > 1;
     const isMultiSymbol = state.symbol.toUpperCase() === "ALL";
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", marginBottom: 1, children: [_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, color: "cyan", children: [state.strategy, " | ", state.symbol, " | ", state.exchange] }), _jsxs(Text, { color: "gray", children: ["Runtime: ", formatDuration(state.runtime), " | Tick: ", state.tick] })] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: phaseColor(state.phase), children: phaseIndicator(state.phase) }) })] }), isMultiSymbol ? (_jsxs(Box, { borderStyle: "single", borderColor: "gray", paddingX: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Text, { children: ["Exchanges: ", _jsx(Text, { bold: true, color: "white", children: state.exchangeBalances?.length ?? 1 })] }), _jsxs(Text, { color: "gray", children: ["Positions: ", _jsx(Text, { bold: true, color: state.positions.length > 0 ? "yellow" : "white", children: state.positions.length })] }), _jsxs(Text, { color: "gray", children: ["Total Equity: ", _jsx(Text, { bold: true, color: "white", children: usd(totalEquity) })] }), _jsxs(Text, { color: "gray", children: ["PnL: ", _jsxs(Text, { bold: true, color: state.totalPnl >= 0 ? "green" : "red", children: ["$", state.totalPnl.toFixed(2)] })] })] })) : (_jsxs(Box, { borderStyle: "single", borderColor: "gray", paddingX: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Text, { children: ["Price: ", _jsxs(Text, { bold: true, color: "white", children: ["$", state.price.toFixed(2)] })] }), _jsxs(Text, { color: "gray", children: ["Vol24h: ", _jsxs(Text, { color: "white", children: [state.volatility24h.toFixed(1), "%"] })] }), _jsxs(Text, { color: "gray", children: ["FR: ", _jsxs(Text, { color: state.fundingRate >= 0 ? "green" : "red", children: [(state.fundingRate * 100).toFixed(4), "%"] })] }), _jsxs(Text, { color: "gray", children: ["OI: ", _jsx(Text, { color: "white", children: state.openInterest })] })] })), _jsxs(Box, { marginTop: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "Account" }), _jsxs(Text, { children: ["Equity: ", _jsx(Text, { bold: true, color: "white", children: usd(state.equity) }), _jsxs(Text, { color: "gray", children: [" (peak: ", usd(state.peakEquity), ")"] })] }), _jsxs(Text, { children: ["Daily P&L: ", _jsxs(Text, { bold: true, color: pnlColor(state.dailyPnl), children: ["$", state.dailyPnl.toFixed(2)] })] })] }), _jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: " " }), _jsxs(Text, { children: ["Drawdown: ", _jsx(Text, { bold: true, color: drawdown === null ? "gray" : drawdown > 0 ? "red" : "green", children: drawdown === null ? "unknown" : `${usd(drawdown)} (${drawdownPct.toFixed(1)}%)` })] }), _jsxs(Text, { children: ["Orders: ", _jsx(Text, { bold: true, color: "white", children: state.ordersPlaced }), _jsx(Text, { color: "gray", children: " | Fills: " }), _jsx(Text, { bold: true, color: "white", children: state.fills }), _jsx(Text, { color: "gray", children: " | Total P&L: " }), _jsxs(Text, { bold: true, color: pnlColor(state.totalPnl), children: ["$", state.totalPnl.toFixed(2)] })] })] })] }), state.exchangeBalances && state.exchangeBalances.length > 1 && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "Exchange Balances" }), _jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: "gray", children: pad("Exchange", 16) }), _jsx(Text, { color: "gray", children: pad("Equity", 14) }), _jsx(Text, { color: "gray", children: "Available" })] }), state.exchangeBalances.map((eb, i) => (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: "white", children: pad(eb.exchange, 16) }), _jsx(Text, { color: "white", children: pad(`$${parseFloat(eb.equity).toFixed(2)}`, 14) }), _jsxs(Text, { color: "gray", children: ["$", parseFloat(eb.available).toFixed(2)] })] }, i)))] })), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "Positions" }), state.positions.length === 0 ? (_jsx(Text, { color: "gray", children: "  No open positions" })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [hasMultiExchange && _jsx(Text, { color: "gray", children: pad("Exchange", 14) }), _jsx(Text, { color: "gray", children: pad("Symbol", 10) }), _jsx(Text, { color: "gray", children: pad("Side", 6) }), _jsx(Text, { color: "gray", children: pad("Size", 12) }), _jsx(Text, { color: "gray", children: pad("Entry", 12) }), _jsx(Text, { color: "gray", children: pad("Mark", 12) }), _jsx(Text, { color: "gray", children: "uPnL" })] }), state.positions.map((p, i) => {
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", marginBottom: 1, children: [_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, color: "cyan", children: [state.strategy, " | ", state.symbol, " | ", state.exchange] }), _jsxs(Text, { color: "gray", children: ["Runtime: ", formatDuration(state.runtime), " | Tick: ", state.tick] })] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: phaseColor(state.phase), children: phaseIndicator(state.phase) }) })] }), isMultiSymbol ? (_jsxs(Box, { borderStyle: "single", borderColor: "gray", paddingX: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Text, { children: ["Exchanges: ", _jsx(Text, { bold: true, color: "white", children: state.exchangeBalances?.length ?? 1 })] }), _jsxs(Text, { color: "gray", children: ["Positions: ", _jsx(Text, { bold: true, color: state.positions.length > 0 ? "yellow" : "white", children: state.positions.length })] }), _jsxs(Text, { color: "gray", children: ["Total Equity: ", _jsx(Text, { bold: true, color: "white", children: usd(totalEquity) })] }), _jsxs(Text, { color: "gray", children: ["PnL: ", _jsxs(Text, { bold: true, color: state.totalPnl >= 0 ? "green" : "red", children: ["$", state.totalPnl.toFixed(2)] })] })] })) : (_jsxs(Box, { borderStyle: "single", borderColor: "gray", paddingX: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Text, { children: ["Price: ", _jsxs(Text, { bold: true, color: "white", children: ["$", state.price.toFixed(2)] })] }), _jsxs(Text, { color: "gray", children: ["Vol24h: ", _jsx(Text, { color: "white", children: Number.isFinite(state.volatility24h) ? `${state.volatility24h.toFixed(1)}%` : "unknown" })] }), _jsxs(Text, { color: "gray", children: ["FR: ", _jsxs(Text, { color: state.fundingRate >= 0 ? "green" : "red", children: [(state.fundingRate * 100).toFixed(4), "%"] })] }), _jsxs(Text, { color: "gray", children: ["OI: ", _jsx(Text, { color: "white", children: state.openInterest })] })] })), _jsxs(Box, { marginTop: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "Account" }), _jsxs(Text, { children: ["Equity: ", _jsx(Text, { bold: true, color: "white", children: usd(state.equity) }), _jsxs(Text, { color: "gray", children: [" (peak: ", usd(state.peakEquity), ")"] })] }), _jsxs(Text, { children: ["Daily P&L: ", _jsxs(Text, { bold: true, color: pnlColor(state.dailyPnl), children: ["$", state.dailyPnl.toFixed(2)] })] })] }), _jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: " " }), _jsxs(Text, { children: ["Drawdown: ", _jsx(Text, { bold: true, color: drawdown === null ? "gray" : drawdown > 0 ? "red" : "green", children: drawdown === null ? "unknown" : `${usd(drawdown)} (${drawdownPct.toFixed(1)}%)` })] }), _jsxs(Text, { children: ["Orders: ", _jsx(Text, { bold: true, color: "white", children: state.ordersPlaced }), _jsx(Text, { color: "gray", children: " | Fills: " }), _jsx(Text, { bold: true, color: "white", children: state.fills }), _jsx(Text, { color: "gray", children: " | Total P&L: " }), _jsxs(Text, { bold: true, color: pnlColor(state.totalPnl), children: ["$", state.totalPnl.toFixed(2)] })] })] })] }), state.exchangeBalances && state.exchangeBalances.length > 1 && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "Exchange Balances" }), _jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: "gray", children: pad("Exchange", 16) }), _jsx(Text, { color: "gray", children: pad("Equity", 14) }), _jsx(Text, { color: "gray", children: "Available" })] }), state.exchangeBalances.map((eb, i) => (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: "white", children: pad(eb.exchange, 16) }), eb.equity === null ? (_jsxs(Text, { color: "red", children: ["unavailable", eb.error ? ` (${eb.error})` : ""] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: "white", children: pad(`$${parseFloat(eb.equity).toFixed(2)}`, 14) }), _jsx(Text, { color: "gray", children: eb.available === null ? "unavailable" : `$${parseFloat(eb.available).toFixed(2)}` })] }))] }, i)))] })), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "Positions" }), positionErrors.map((pe, i) => (_jsxs(Text, { color: "red", children: ["  ", pe.exchange, ": unavailable (", pe.error, ")"] }, `err-${i}`))), state.positions.length === 0 ? (positionErrors.length === 0 && _jsx(Text, { color: "gray", children: "  No open positions" })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [hasMultiExchange && _jsx(Text, { color: "gray", children: pad("Exchange", 14) }), _jsx(Text, { color: "gray", children: pad("Symbol", 10) }), _jsx(Text, { color: "gray", children: pad("Side", 6) }), _jsx(Text, { color: "gray", children: pad("Size", 12) }), _jsx(Text, { color: "gray", children: pad("Entry", 12) }), _jsx(Text, { color: "gray", children: pad("Mark", 12) }), _jsx(Text, { color: "gray", children: "uPnL" })] }), state.positions.map((p, i) => {
                                 const upnl = parseFloat(p.unrealizedPnl);
                                 return (_jsxs(Box, { flexDirection: "row", children: [hasMultiExchange && _jsx(Text, { color: "cyan", children: pad(p.exchange ?? "—", 14) }), _jsx(Text, { color: "white", children: pad(p.symbol, 10) }), _jsx(Text, { color: p.side.toLowerCase() === "long" ? "green" : "red", children: pad(p.side, 6) }), _jsx(Text, { color: "white", children: pad(p.size, 12) }), _jsx(Text, { color: "white", children: pad(p.entryPrice, 12) }), _jsx(Text, { color: "white", children: pad(p.markPrice, 12) }), _jsx(Text, { color: isNaN(upnl) ? "gray" : pnlColor(upnl), children: isNaN(upnl) ? "$—" : `$${upnl.toFixed(2)}` })] }, i));
-                            })] }))] }), _jsxs(Box, { marginTop: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Box, { flexDirection: "column", width: "50%", children: [_jsxs(Text, { color: "green", bold: true, children: ["Bids (", bidOrders.length, ")"] }), bidOrders.length === 0 ? (_jsx(Text, { color: "gray", children: "  --" })) : (bidOrders.slice(0, 8).map((o, i) => (_jsxs(Text, { color: "green", children: [pad(o.price, 12), " ", pad(o.size, 10), " ", o.type] }, i))))] }), _jsxs(Box, { flexDirection: "column", width: "50%", children: [_jsxs(Text, { color: "red", bold: true, children: ["Asks (", askOrders.length, ")"] }), askOrders.length === 0 ? (_jsx(Text, { color: "gray", children: "  --" })) : (askOrders.slice(0, 8).map((o, i) => (_jsxs(Text, { color: "red", children: [pad(o.price, 12), " ", pad(o.size, 10), " ", o.type] }, i))))] })] }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: state.strategyState.fundingTotal !== undefined ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: "cyan", bold: true, children: "Funding & Arb" }), _jsxs(Box, { flexDirection: "row", marginLeft: 2, children: [_jsx(Text, { color: "gray", children: "Funding Income: " }), _jsx(Text, { color: "white", children: String(state.strategyState.fundingTotal) }), _jsx(Text, { color: "gray", children: "        Positions: " }), _jsx(Text, { color: "white", children: String(state.strategyState.arbPositions ?? 0) })] }), Array.isArray(state.strategyState.arbPositionDetails) &&
+                            })] }))] }), openOrdersError !== null ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "red", children: ["Open orders unavailable (", openOrdersError, ")"] }) })) : (_jsxs(Box, { marginTop: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs(Box, { flexDirection: "column", width: "50%", children: [_jsxs(Text, { color: "green", bold: true, children: ["Bids (", bidOrders.length, ")"] }), bidOrders.length === 0 ? (_jsx(Text, { color: "gray", children: "  --" })) : (bidOrders.slice(0, 8).map((o, i) => (_jsxs(Text, { color: "green", children: [pad(o.price, 12), " ", pad(o.size, 10), " ", o.type] }, i))))] }), _jsxs(Box, { flexDirection: "column", width: "50%", children: [_jsxs(Text, { color: "red", bold: true, children: ["Asks (", askOrders.length, ")"] }), askOrders.length === 0 ? (_jsx(Text, { color: "gray", children: "  --" })) : (askOrders.slice(0, 8).map((o, i) => (_jsxs(Text, { color: "red", children: [pad(o.price, 12), " ", pad(o.size, 10), " ", o.type] }, i))))] })] })), _jsx(Box, { marginTop: 1, flexDirection: "column", children: state.strategyState.fundingTotal !== undefined ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: "cyan", bold: true, children: "Funding & Arb" }), _jsxs(Box, { flexDirection: "row", marginLeft: 2, children: [_jsx(Text, { color: "gray", children: "Funding Income: " }), _jsx(Text, { color: "white", children: String(state.strategyState.fundingTotal) }), _jsx(Text, { color: "gray", children: "        Positions: " }), _jsx(Text, { color: "white", children: String(state.strategyState.arbPositions ?? 0) })] }), Array.isArray(state.strategyState.arbPositionDetails) &&
                             state.strategyState.arbPositionDetails.map((detail, i) => (_jsx(Box, { marginLeft: 2, children: _jsx(Text, { color: "yellow", children: detail }) }, i)))] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: "cyan", bold: true, children: "Strategy State" }), _jsxs(Box, { flexDirection: "row", flexWrap: "wrap", children: [Object.entries(state.strategyState)
                                     .filter(([k, v]) => {
                                     if (k === 'arbRunning' || k === 'fundingLastCheck' || k === 'fundingHistory' || k === 'arbOpenPositions')

package/dist/bridge-engine.d.ts

@@ -65,6 +65,8 @@ export declare function getEvmUsdcBalance(chain: string, address: string): Promi
  * Returns balance in USDC (human-readable).
  */
 export declare function getSolanaUsdcBalance(ownerPubkey: string): Promise<number>;
+/** RPC "account not found" for getTokenAccountBalance (the ATA was never created ⇒ balance 0). */
+export declare function isSolanaAccountNotFound(e: unknown): boolean;
 /**
  * Check USDC balance for a bridge source chain + address.
  */

package/dist/bridge-engine.js

@@ -318,13 +318,32 @@ export async function getSolanaUsdcBalance(ownerPubkey) {
     const usdcMint = new PublicKey(USDC_ADDRESSES.solana);
     const tokenProgram = new PublicKey(SPL_TOKEN_PROGRAM);
     const [ata] = PublicKey.findProgramAddressSync([owner.toBuffer(), tokenProgram.toBuffer(), usdcMint.toBuffer()], new PublicKey(ASSOCIATED_TOKEN_PROGRAM));
+    let info;
     try {
-        const info = await connection.getTokenAccountBalance(ata);
-        return Number(info.value.uiAmount ?? 0);
+        info = await connection.getTokenAccountBalance(ata);
     }
-    catch {
-        return 0; // ATA doesn't exist
+    catch (e) {
+        // Only a missing USDC token account is a real 0 balance. Any other RPC failure is unknown:
+        // reporting it as 0 would read as "no USDC" (or, inverted, mask a balance check).
+        if (isSolanaAccountNotFound(e))
+            return 0;
+        throw new PerpError("EXCHANGE_UNREACHABLE", `Solana USDC balance of ${ownerPubkey} could not be read: ${e instanceof Error ? e.message : String(e)}`, {
+            remediation: "Retry, or set a working Solana RPC (settings rpc.solana) — the balance is unknown, not 0",
+        });
+    }
+    // Raw amount / decimals (uiAmount may be null) — a malformed answer is an error, not 0.
+    const raw = Number(info.value.amount);
+    if (!Number.isFinite(raw) || !Number.isInteger(info.value.decimals)) {
+        throw new PerpError("EXCHANGE_ERROR", `Solana RPC returned a malformed USDC balance for ${ownerPubkey}: ${JSON.stringify(info.value)}`, {
+            remediation: "Retry, or set a different Solana RPC (settings rpc.solana)",
+        });
     }
+    return raw / 10 ** info.value.decimals;
+}
+/** RPC "account not found" for getTokenAccountBalance (the ATA was never created ⇒ balance 0). */
+export function isSolanaAccountNotFound(e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    return /could not find account|account not found|AccountNotFound/i.test(msg);
 }
 /**
  * Check USDC balance for a bridge source chain + address.
@@ -412,38 +431,43 @@ function encodeHyperCoreHookData(recipientAddress, dexId = HYPERCORE_DEX_PERPS)
  * Get CCTP fees for a Solana/EVM → HyperCore transfer.
  */
 async function getHyperCoreCctpFees(srcDomain, amount) {
+    // SSOT rule #2 (same as getCctpRelayFee): the burn's maxFee comes from Circle's fee schedule.
+    // A hardcoded default (formerly 1bp + $0.20) could under-fee (transfer stuck) or over-fee —
+    // so an unreadable schedule is an error, never a silently-used guess.
     const url = `${HYPERCORE_FEES_API}/${srcDomain}/${HYPERCORE_CCTP_DOMAIN}?forward=true&hyperCoreDeposit=true`;
+    const fail = (why) => new PerpError("EXCHANGE_UNREACHABLE", `CCTP HyperCore fee schedule ${srcDomain}→${HYPERCORE_CCTP_DOMAIN} unavailable: ${why} — nothing was sent`, {
+        remediation: "Retry shortly (Circle iris-api); the bridge fee cannot be set without it",
+    });
+    let res;
     try {
-        const res = await fetch(url);
-        if (res.ok) {
-            // API returns array: [{finalityThreshold, minimumFee, forwardFee: {low, med, high}}, ...]
-            const schedules = await res.json();
-            // Use fast transfer schedule (threshold=1000) if available, else first
-            const fast = schedules.find(s => s.finalityThreshold === 1000) ?? schedules[0];
-            if (fast) {
-                const bps = Number(fast.feeRate ?? 1); // basis points, default 1bp
-                const forwardFee = Number(fast.forwardFee?.med ?? fast.forwardFee?.low ?? 200000); // subunits
-                const protocolFee = Math.ceil(amount * 1e6 * bps / 10000);
-                return {
-                    protocolFee: protocolFee / 1e6,
-                    forwardingFee: forwardFee / 1e6,
-                    totalFee: (protocolFee + forwardFee) / 1e6,
-                    maxFee: protocolFee + forwardFee, // in subunits for instruction
-                };
-            }
-        }
+        res = await fetch(url);
     }
-    catch {
-        // fallback to defaults
+    catch (e) {
+        throw fail(e instanceof Error ? e.message : String(e));
     }
-    // Default: 1bp + $0.20
-    const protocolFee = Math.ceil(amount * 1e6 / 10000);
-    const forwardingFee = 200000;
+    if (!res.ok)
+        throw fail(`HTTP ${res.status}`);
+    // API returns array: [{finalityThreshold, minimumFee, forwardFee: {low, med, high}}, ...]
+    const schedules = await res.json().catch((e) => { throw fail(`invalid JSON (${e instanceof Error ? e.message : String(e)})`); });
+    if (!Array.isArray(schedules))
+        throw fail(`unexpected response ${JSON.stringify(schedules).slice(0, 200)}`);
+    // Use fast transfer schedule (threshold=1000) if available, else the first published tier
+    const fast = schedules.find(s => s.finalityThreshold === 1000) ?? schedules[0];
+    if (!fast)
+        throw fail("no fee schedule");
+    // Protocol fee rate in basis points: feeRate when published, else minimumFee (Circle's bps field).
+    const bps = Number(fast.feeRate ?? fast.minimumFee);
+    const forwardFee = Number(fast.forwardFee?.med ?? fast.forwardFee?.low); // subunits
+    if (!Number.isFinite(bps) || bps < 0)
+        throw fail("schedule without a protocol fee rate");
+    if (!Number.isFinite(forwardFee) || forwardFee < 0)
+        throw fail("schedule without a forwarding fee");
+    const protocolFee = Math.ceil(amount * 1e6 * bps / 10000);
     return {
         protocolFee: protocolFee / 1e6,
-        forwardingFee: 0.20,
-        totalFee: (protocolFee + forwardingFee) / 1e6,
-        maxFee: protocolFee + forwardingFee,
+        forwardingFee: forwardFee / 1e6,
+        totalFee: (protocolFee + forwardFee) / 1e6,
+        maxFee: protocolFee + forwardFee, // in subunits for instruction
     };
 }
 // ── deBridge DLN API ──
@@ -1713,10 +1737,23 @@ export async function getAllQuotes(srcChain, dstChain, amount, senderAddress, re
         getDebridgeQuote(srcChain, dstChain, amount, senderAddress, recipientAddress),
     ]);
     const quotes = [];
-    for (const r of results) {
+    const failures = [];
+    const providers = ["cctp", "relay", "debridge"];
+    results.forEach((r, i) => {
         if (r.status === "fulfilled")
             quotes.push(r.value);
+        else
+            failures.push(`${providers[i]}: ${r.reason instanceof Error ? r.reason.message : String(r.reason)}`);
+    });
+    // A provider without this route is normal; still say which ones were left out and why, and
+    // never answer "no quotes" without the reasons.
+    if (quotes.length === 0) {
+        throw new PerpError("NO_BRIDGE_ROUTE", `No bridge quote for ${srcChain} → ${dstChain} (${failures.join("; ")})`, {
+            remediation: "Check the chains / amount, or retry if a provider was unreachable",
+        });
     }
+    if (failures.length > 0)
+        process.stderr.write(`[bridge] providers without a quote: ${failures.join("; ")}\n`);
     // Price native fees (deBridge fixFee) so quotes compare on the same basis; an unpriced native
     // fee ranks that quote last (its total cost is unknown), never as free.
     const symbols = [...new Set(quotes.flatMap(q => (q.nativeFee ? [q.nativeFee.symbol] : [])))];

package/dist/commands/account.js

@@ -288,7 +288,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
     });
     account
         .command("history")
-        .description("Order history")
+        .description("Order history (Aster: last 7 days, symbols with a position, open order or fill in that window)")
         .action(async () => {
         const adapter = await getAdapter();
         const orders = await adapter.getOrderHistory(30);
@@ -355,7 +355,7 @@ export function registerAccountCommands(program, getAdapter, isJson, getAdapterF
     });
     account
         .command("trades")
-        .description("Trade history (fills)")
+        .description("Trade history (fills) (Aster: last 7 days, symbols with a position, open order or fill in that window)")
         .action(async () => {
         const adapter = await getAdapter();
         const trades = await adapter.getTradeHistory(30);