perp-cli 0.14.1 → 0.14.3

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);

package/dist/commands/arb/index.d.ts

@@ -12,10 +12,30 @@ export declare function listArbVenues(): Promise<string[]>;
  * positions read fails is an error (Rule #2): an unread venue is not "no positions" —
  * a hidden leg would make a live pair look closed.
  */
+/**
+ * Adapters for `arb rebalance`. A venue the user listed explicitly (--exchanges) that cannot
+ * be opened is refused with a PerpError naming venue + cause; from the default list it is
+ * skipped with a stderr warning naming venue + cause (never silently).
+ */
+export declare function resolveRebalanceAdapters(names: readonly string[], explicit: boolean, getAdapter: (exchange: string) => Promise<ExchangeAdapter>, warn?: (msg: string) => void): Promise<Map<string, ExchangeAdapter>>;
 export declare function readArbVenuePositions(venues: readonly string[], getAdapter: (exchange: string) => Promise<ExchangeAdapter>): Promise<{
     exchange: string;
     position: ExchangePosition;
 }[]>;
+/**
+ * Spot-perp funding view from the perp venue's current rate entry. A missing entry → every
+ * field null ("unknown"): never a 0 rate / 0 daily income / a guessed direction.
+ */
+export declare function spotPerpFundingView(perpRate: {
+    exchange: string;
+    rate: number;
+    fundingHours: number | null;
+} | undefined, perpNotional: number): {
+    hourlyRate: number | null;
+    annualPct: number | null;
+    direction: "long-spot-short-perp" | "sell-spot-long-perp" | null;
+    dailyFundingEstimate: number | null;
+};
 /**
  * State-file entries the venues do not confirm: no live pair with the same symbol and
  * legs. `arb status` reports them apart from the live pairs (the venue is the source of truth).

package/dist/commands/arb/index.js

@@ -7,7 +7,7 @@ import { toHourlyRate } from "../../funding.js";
 import { fetchPacificaPrices, fetchHyperliquidMeta, fetchLighterOrderBookDetails, fetchLighterFundingRates, } from "../../shared-api.js";
 import { computeBasisRisk } from "../../arb-utils.js";
 import { removePosition as persistRemovePosition, getPositions as getArbStatePositions, loadArbState } from "../../arb-state.js";
-import { fetchAllBalances, computeRebalancePlan } from "../../rebalance.js";
+import { fetchBalancesWithFailures, computeRebalancePlan } from "../../rebalance.js";
 import { EXCHANGE_TO_CHAIN, getBestQuote } from "../../bridge-engine.js";
 import { computeEnhancedStats } from "../../arb-history-stats.js";
 import { listBotSpotVenues, nonQuoteSpotBalances, requireSpotAdapter, spotNetworkOf } from "../../exchanges/spot-factory.js";
@@ -33,6 +33,30 @@ export async function listArbVenues() {
  * positions read fails is an error (Rule #2): an unread venue is not "no positions" —
  * a hidden leg would make a live pair look closed.
  */
+/**
+ * Adapters for `arb rebalance`. A venue the user listed explicitly (--exchanges) that cannot
+ * be opened is refused with a PerpError naming venue + cause; from the default list it is
+ * skipped with a stderr warning naming venue + cause (never silently).
+ */
+export async function resolveRebalanceAdapters(names, explicit, getAdapter, warn = (m) => process.stderr.write(`${m}\n`)) {
+    const out = new Map();
+    for (const name of names) {
+        try {
+            out.set(name, await getAdapter(name));
+        }
+        catch (e) {
+            const c = classifyError(e, name);
+            if (explicit) {
+                throw new PerpError(c.code, `Cannot open ${name}: ${c.message}`, {
+                    exchange: name,
+                    remediation: `Check ${name} credentials / connectivity (perp account balance -e ${name}), or drop it from --exchanges`,
+                });
+            }
+            warn(`[arb rebalance] ${name} unavailable — skipped: ${c.message}`);
+        }
+    }
+    return out;
+}
 export async function readArbVenuePositions(venues, getAdapter) {
     const out = [];
     for (const exchange of venues) {
@@ -64,6 +88,21 @@ function formatDuration(ms) {
     const minutes = Math.floor(ms / (1000 * 60));
     return `${minutes}m`;
 }
+/**
+ * Spot-perp funding view from the perp venue's current rate entry. A missing entry → every
+ * field null ("unknown"): never a 0 rate / 0 daily income / a guessed direction.
+ */
+export function spotPerpFundingView(perpRate, perpNotional) {
+    if (perpRate === undefined)
+        return { hourlyRate: null, annualPct: null, direction: null, dailyFundingEstimate: null };
+    const hourlyRate = entryHourly(perpRate);
+    return {
+        hourlyRate,
+        annualPct: hourlyRate * 8760 * 100,
+        direction: hourlyRate >= 0 ? "long-spot-short-perp" : "sell-spot-long-perp",
+        dailyFundingEstimate: Math.abs(hourlyRate) * perpNotional * 24,
+    };
+}
 /** hourly rate of a rate entry: the entry's own interval (Aster, per symbol) or the venue basis. */
 function entryHourly(e) {
     return e.fundingHours !== null ? e.rate / e.fundingHours : toHourlyRate(e.rate, e.exchange);
@@ -279,7 +318,9 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
         try {
             rateMap = await fetchFundingRatesMap();
         }
-        catch {
+        catch (e) {
+            // Reported, not silent: every spread / funding rate below shows as unknown (null), never 0.
+            process.stderr.write(`[warn] funding rates unavailable — spreads and daily funding shown as unknown: ${e instanceof Error ? e.message : String(e)}\n`);
             rateMap = new Map();
         }
         for (const [symbol, positions] of bySymbol) {
@@ -429,16 +470,18 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
                     // Get current perp funding rate for this symbol on this exchange
                     const rates = rateMap.get(perpSymbol);
                     const perpRate = rates?.find(r => r.exchange === shortPos.exchange);
-                    const fundingRate = perpRate?.rate ?? 0;
-                    const hourlyRate = perpRate && fundingRate ? entryHourly(perpRate) : 0;
-                    const annualPct = hourlyRate * 8760 * 100;
                     const perpNotional = shortPos.size * shortPos.markPrice;
+                    // Unknown rate → hourlyRate / annualPct / direction / dailyFundingEstimate are null (never 0).
+                    const { hourlyRate, annualPct, direction, dailyFundingEstimate } = spotPerpFundingView(perpRate, perpNotional);
                     const spotValueUsd = arbSpotAmount * shortPos.markPrice; // approx using perp mark price
                     // Funding income: fetch actual payments from exchange API
                     let actualFundingIncome = 0;
+                    let fundingSource = "actual";
+                    let fundingError = null;
                     try {
                         const perpAdapter = await getAdapterForExchange(shortPos.exchange);
-                        const payments = await perpAdapter.getFundingPayments(200);
+                        const FUNDING_PAGE = 200;
+                        const payments = await perpAdapter.getFundingPayments(FUNDING_PAGE);
                         // Filter from entry time minus 1h buffer (multi-leg entry takes time)
                         const entryTime = persisted ? new Date(persisted.entryTime).getTime() - 3600000 : 0;
                         for (const p of payments) {
@@ -446,10 +489,22 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
                                 actualFundingIncome += Number(p.payment);
                             }
                         }
+                        // The read may not reach back to the entry: a full page, or Aster's 7-day income window.
+                        const sevenDaysAgo = Date.now() - 7 * 86_400_000;
+                        if (payments.length >= FUNDING_PAGE) {
+                            fundingSource = "partial";
+                            fundingError = `${FUNDING_PAGE} payments returned (page full) — older funding since entry may be missing`;
+                        }
+                        else if (shortPos.exchange === "aster" && (!entryTime || entryTime < sevenDaysAgo)) {
+                            fundingSource = "partial";
+                            fundingError = "Aster funding history covers the last 7 days only — funding before that is not included";
+                        }
                     }
-                    catch {
-                        // Fallback to estimate if API fails
-                        if (holdDurationMs && hourlyRate !== 0) {
+                    catch (e) {
+                        // History unreadable: an explicit, labelled estimate (fundingSource / fundingError), never a silent one.
+                        fundingSource = "estimate";
+                        fundingError = e instanceof Error ? e.message : String(e);
+                        if (holdDurationMs && hourlyRate !== null && hourlyRate !== 0) {
                             const holdHours = holdDurationMs / (1000 * 60 * 60);
                             actualFundingIncome = Math.abs(hourlyRate) * perpNotional * holdHours;
                             if (hourlyRate < 0)
@@ -462,8 +517,6 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
                     const spotFee = getTakerFee(spotEx);
                     const perpFee = getTakerFee(shortPos.exchange);
                     const entryFees = (spotValueUsd * spotFee) + (perpNotional * perpFee);
-                    const direction = hourlyRate >= 0 ? "long-spot-short-perp" : "sell-spot-long-perp";
-                    const dailyFundingEstimate = Math.abs(hourlyRate) * perpNotional * 24;
                     spotPerpPositions.push({
                         symbol: perpSymbol,
                         mode: "spot-perp",
@@ -483,10 +536,12 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
                         perpLeverage: shortPos.leverage,
                         perpNotionalUsd: perpNotional,
                         direction,
-                        currentSpread: annualPct || null,
+                        currentSpread: annualPct,
                         holdDuration,
                         holdDurationMs,
                         estimatedFundingIncome,
+                        fundingSource,
+                        fundingError,
                         estimatedFees: entryFees,
                         netPnl: (spotValueUsd - shortPos.entryPrice * arbSpotAmount) + shortPos.unrealizedPnl + estimatedFundingIncome - entryFees,
                         dailyFundingEstimate,
@@ -507,8 +562,8 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
             const holdDurationMs = Date.now() - new Date(persisted.entryTime).getTime();
             const rates = rateMap.get(sym);
             const perpRate = rates?.find(r => r.exchange === persisted.shortExchange);
-            const hourlyRate = perpRate ? entryHourly(perpRate) : 0;
             const perpNotional = shortPos.size * shortPos.markPrice;
+            const fv = spotPerpFundingView(perpRate, perpNotional);
             spotPerpPositions.push({
                 symbol: sym,
                 mode: "spot-perp",
@@ -527,14 +582,16 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
                 perpUnrealizedPnl: shortPos.unrealizedPnl,
                 perpLeverage: shortPos.leverage,
                 perpNotionalUsd: perpNotional,
-                direction: hourlyRate >= 0 ? "long-spot-short-perp" : "sell-spot-long-perp",
-                currentSpread: hourlyRate ? Math.abs(hourlyRate) * 8760 * 100 : null,
+                direction: fv.direction,
+                currentSpread: fv.annualPct === null ? null : Math.abs(fv.annualPct),
                 holdDuration: formatDuration(holdDurationMs),
                 holdDurationMs,
                 estimatedFundingIncome: persisted.accumulatedFunding ?? 0,
+                fundingSource: "recorded",
+                fundingError: null,
                 estimatedFees: 0,
                 netPnl: shortPos.unrealizedPnl + (persisted.accumulatedFunding ?? 0),
-                dailyFundingEstimate: Math.abs(hourlyRate) * perpNotional * 24,
+                dailyFundingEstimate: fv.dailyFundingEstimate,
             });
         }
         // State vs venue: the venue is the source of truth. A pair is reported only when the
@@ -544,12 +601,13 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
         // Pairs only inferred from a long and a short sharing the symbol are reported apart (never as arb positions).
         const unconfirmedPairs = arbPairs.filter(p => p.provenance === "inferred");
         arbPairs.splice(0, arbPairs.length, ...arbPairs.filter(p => p.provenance !== "inferred"));
+        const fundingUnknownSP = spotPerpPositions.filter(p => p.dailyFundingEstimate === null).map(p => `${p.perpExchange}:${p.symbol}`);
         // ── JSON output ──
         if (isJson()) {
             const totalNotionalPP = arbPairs.reduce((s, p) => s + (p.longPosition.notionalUsd + p.shortPosition.notionalUsd) / 2, 0);
             const totalDailyPP = arbPairs.reduce((s, p) => s + p.dailyFundingEstimate, 0);
             const totalNotionalSP = spotPerpPositions.reduce((s, p) => s + p.perpNotionalUsd, 0);
-            const totalDailySP = spotPerpPositions.reduce((s, p) => s + p.dailyFundingEstimate, 0);
+            const totalDailySP = spotPerpPositions.reduce((s, p) => s + (p.dailyFundingEstimate ?? 0), 0);
             const totalNotionalJ = totalNotionalPP + totalNotionalSP;
             const totalDailyJ = totalDailyPP + totalDailySP;
             return printJson(jsonOk({
@@ -569,6 +627,9 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
                     netPnl: arbPairs.reduce((s, p) => s + p.netPnl, 0) + spotPerpPositions.reduce((s, p) => s + p.netPnl, 0),
                     dailyFundingEstimate: totalDailyJ,
                     annualizedApr: totalNotionalJ > 0 ? (totalDailyJ * 365 / totalNotionalJ) * 100 : 0,
+                    // Spot-perp positions whose funding rate is unknown are excluded from the daily / APR sums.
+                    dailyFundingIncomplete: fundingUnknownSP.length > 0,
+                    fundingUnknown: fundingUnknownSP,
                 },
             }));
         }
@@ -647,12 +708,12 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
                 console.log(chalk.white.bold("  PnL Breakdown:"));
                 console.log(`    Spot PnL:        ${formatPnl(spotPnl)}`);
                 console.log(`    Perp PnL:        ${formatPnl(sp.perpUnrealizedPnl)}`);
-                console.log(`    Funding Earned:  ${chalk.yellow(`$${sp.estimatedFundingIncome.toFixed(4)}`)}`);
+                console.log(`    Funding Earned:  ${chalk.yellow(`$${sp.estimatedFundingIncome.toFixed(4)}`)}${sp.fundingSource === "estimate" ? chalk.yellow(` (estimate — funding history unavailable: ${sp.fundingError})`) : sp.fundingSource === "partial" ? chalk.yellow(` (partial: ${sp.fundingError})`) : ""}`);
                 console.log(`    Trading Fees:    ${chalk.red(`-$${sp.estimatedFees.toFixed(4)}`)}`);
                 console.log(`    ${chalk.white.bold("Total PnL:")}       ${formatPnl(sp.netPnl)}${roi !== 0 ? chalk.gray(` (ROI: ${roi >= 0 ? "+" : ""}${roi.toFixed(2)}%)`) : ""}`);
                 console.log("");
                 console.log(`    Current Spread:  ${spreadStr}`);
-                console.log(`    Daily Income:    ${chalk.cyan(`$${sp.dailyFundingEstimate.toFixed(4)}/day`)}`);
+                console.log(`    Daily Income:    ${sp.dailyFundingEstimate === null ? chalk.yellow(`unknown (no current ${sp.perpExchange} funding rate)`) : chalk.cyan(`$${sp.dailyFundingEstimate.toFixed(4)}/day`)}`);
                 if (annRoi !== 0)
                     console.log(`    Annualized ROI:  ${chalk.cyan(`${annRoi >= 0 ? "+" : ""}${annRoi.toFixed(1)}%`)}`);
             }
@@ -668,7 +729,7 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
         const totalNet = arbPairs.reduce((s, p) => s + p.netPnl, 0)
             + spotPerpPositions.reduce((s, p) => s + p.netPnl, 0);
         const totalDailyFunding = arbPairs.reduce((s, p) => s + p.dailyFundingEstimate, 0)
-            + spotPerpPositions.reduce((s, p) => s + p.dailyFundingEstimate, 0);
+            + spotPerpPositions.reduce((s, p) => s + (p.dailyFundingEstimate ?? 0), 0);
         const totalNotional = arbPairs.reduce((s, p) => s + (p.longPosition.notionalUsd + p.shortPosition.notionalUsd) / 2, 0)
             + spotPerpPositions.reduce((s, p) => s + p.perpNotionalUsd, 0);
         const portfolioApr = totalNotional > 0 ? (totalDailyFunding * 365 / totalNotional) * 100 : 0;
@@ -680,7 +741,7 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
         console.log(`    Est. Funding:    ${chalk.yellow(`$${totalFunding.toFixed(4)}`)}`);
         console.log(`    Est. Fees:       ${chalk.red(`-$${totalFees.toFixed(4)}`)}`);
         console.log(`    Net PnL:         ${formatPnl(totalNet)}`);
-        console.log(`    Daily Income:    ${chalk.cyan(`$${totalDailyFunding.toFixed(4)}/day`)}`);
+        console.log(`    Daily Income:    ${chalk.cyan(`$${totalDailyFunding.toFixed(4)}/day`)}${fundingUnknownSP.length > 0 ? chalk.yellow(` (incomplete — funding rate unknown: ${fundingUnknownSP.join(", ")})`) : ""}`);
         if (portfolioApr > 0) {
             console.log(`    Portfolio APR:   ${chalk.cyan(`${portfolioApr.toFixed(1)}%`)}`);
         }
@@ -1296,12 +1357,10 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
         const dryRun = isDryRun(cmd);
         const exchangeNames = opts.exchanges.split(",").map(e => e.trim());
         const adapters = new Map();
-        for (const name of exchangeNames) {
-            try {
-                adapters.set(name, await getAdapterForExchange(name));
-            }
-            catch { /* skip unavailable */ }
-        }
+        // Explicit --exchanges → an unavailable venue refuses (PerpError); the default list → skipped with a stderr warning.
+        const explicitExchanges = cmd.getOptionValueSource("exchanges") === "cli";
+        for (const [name, adapter] of await resolveRebalanceAdapters(exchangeNames, explicitExchanges, getAdapterForExchange))
+            adapters.set(name, adapter);
         if (adapters.size === 0) {
             if (isJson())
                 return printJson(jsonOk({ error: "No exchanges available" }));
@@ -1312,7 +1371,8 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
         if (!opts.target && !opts.check) {
             opts.check = true;
         }
-        const snapshots = await fetchAllBalances(adapters);
+        // A venue whose balance read failed is reported (never dropped from the totals silently).
+        const { snapshots, failed: unavailable, notConfigured } = await fetchBalancesWithFailures(adapters);
         const totalEquity = snapshots.reduce((s, e) => s + e.equity, 0);
         const totalAvailable = snapshots.reduce((s, e) => s + e.available, 0);
         const exAbbr = (e) => e === "pacifica" ? "PAC" : e === "hyperliquid" ? "HL" : e === "lighter" ? "LT" : e === "aster" ? "AST" : e.toUpperCase();
@@ -1333,6 +1393,9 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
                     })),
                     totalEquity,
                     totalAvailable,
+                    unavailable,
+                    notConfigured,
+                    partial: unavailable.length > 0,
                 }));
             }
             console.log(chalk.cyan("\n  Cross-Exchange Balance Distribution\n"));
@@ -1355,8 +1418,20 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
             console.log(`  Total Equity:    $${formatUsd(totalEquity)}`);
             console.log(`  Total Available: $${formatUsd(totalAvailable)}`);
             console.log(`  Exchanges:       ${snapshots.length}\n`);
+            for (const f of unavailable)
+                console.log(chalk.yellow(`  ⚠ ${f.exchange} balance unavailable (not in the totals): ${f.error}`));
+            for (const n of notConfigured)
+                console.log(chalk.gray(`  ${n}: not configured (no credentials) — left out`));
+            if (unavailable.length > 0)
+                console.log();
             return;
         }
+        // A plan over fewer venues than requested would move funds on a wrong picture — refuse.
+        if (unavailable.length > 0) {
+            throw new PerpError("EXCHANGE_ERROR", `Rebalance plan refused: balance unavailable on ${unavailable.map(f => f.exchange).join(", ")}`, {
+                remediation: `Retry when every venue answers, or limit the plan to readable venues with --exchanges (errors: ${unavailable.map(f => `${f.exchange}: ${f.error}`).join("; ")})`,
+            });
+        }
         // Parse target ratios
         if (!opts.target) {
             console.error(chalk.red("  --target required (e.g., '50:50' or '33:33:33')"));
@@ -1394,9 +1469,11 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
         const moveDetails = await Promise.all(moves.map(async (m) => {
             const srcChain = EXCHANGE_TO_CHAIN[m.from] ?? "unknown";
             const dstChain = EXCHANGE_TO_CHAIN[m.to] ?? "unknown";
+            // null = no quote could be read (quoteError says why) — never a made-up fee / provider.
             let bridgeFee = 0;
             let bridgeProvider = "same-chain";
             let bridgeTime = "instant";
+            let quoteError = null;
             if (srcChain !== dstChain && srcChain !== "unknown" && dstChain !== "unknown") {
                 try {
                     const quote = await getBestQuote(srcChain, dstChain, m.amount, "0x0000000000000000000000000000000000000000", "0x0000000000000000000000000000000000000000");
@@ -1404,10 +1481,11 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
                     bridgeProvider = quote.provider;
                     bridgeTime = `~${Math.ceil(quote.estimatedTime / 60)}min`;
                 }
-                catch {
-                    bridgeFee = 0.5; // fallback estimate
-                    bridgeProvider = "cctp";
-                    bridgeTime = "~3min";
+                catch (e) {
+                    bridgeFee = null;
+                    bridgeProvider = null;
+                    bridgeTime = null;
+                    quoteError = e instanceof Error ? e.message : String(e);
                 }
             }
             return {
@@ -1417,6 +1495,7 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
                 bridgeFee,
                 bridgeProvider,
                 bridgeTime,
+                quoteError,
             };
         }));
         if (isJson()) {
@@ -1453,12 +1532,18 @@ export function registerArbManageCommands(program, getAdapterForExchange, isJson
         for (let i = 0; i < moveDetails.length; i++) {
             const m = moveDetails[i];
             console.log(chalk.white.bold(`  Move ${i + 1}: $${m.amount} ${exAbbr(m.from)} -> ${exAbbr(m.to)}`));
-            console.log(chalk.gray(`    Route: ${m.srcChain} -> ${m.dstChain} via ${m.bridgeProvider}`));
-            console.log(chalk.gray(`    Fee: ~$${m.bridgeFee.toFixed(2)} | Time: ${m.bridgeTime}`));
+            if (m.bridgeFee === null) {
+                console.log(chalk.yellow(`    Route: ${m.srcChain} -> ${m.dstChain} — no bridge quote (${m.quoteError})`));
+            }
+            else {
+                console.log(chalk.gray(`    Route: ${m.srcChain} -> ${m.dstChain} via ${m.bridgeProvider}`));
+                console.log(chalk.gray(`    Fee: ~$${m.bridgeFee.toFixed(2)} | Time: ${m.bridgeTime}`));
+            }
             console.log();
         }
-        const totalFees = moveDetails.reduce((s, m) => s + m.bridgeFee, 0);
-        console.log(chalk.gray(`  Total bridge fees: ~$${totalFees.toFixed(2)}`));
+        const totalFees = moveDetails.reduce((s, m) => s + (m.bridgeFee ?? 0), 0);
+        const unquoted = moveDetails.filter(m => m.bridgeFee === null).length;
+        console.log(chalk.gray(`  Total bridge fees: ~$${totalFees.toFixed(2)}`) + (unquoted > 0 ? chalk.yellow(` (excludes ${unquoted} move(s) without a quote)`) : ""));
         if (dryRun) {
             console.log(chalk.yellow("\n  [DRY RUN] No transfers executed.\n"));
         }