bandkit 1.0.1 → 1.0.3

package/dist/decisionEngine.js

@@ -0,0 +1,166 @@
+export const DEFAULT_DECISION_THRESHOLDS = {
+    imbalanceThreshold: 0.15,
+    flowThreshold: 0.1,
+    spreadWidePct: 0.05,
+    divergenceBps: 5,
+    minDepthEth: 50
+};
+export function computeBotDecision(inputs, thresholds = DEFAULT_DECISION_THRESHOLDS) {
+    const reasons = [];
+    // Regime gate
+    if (inputs.regime === "UNKNOWN") {
+        return {
+            decision: "WAIT",
+            confidence: 0,
+            reasons: [{ text: "Volatility classifier still warming up", tone: "neutral" }]
+        };
+    }
+    if (inputs.regime === "TRENDING") {
+        return {
+            decision: "STAND DOWN",
+            confidence: 90,
+            reasons: [
+                { text: "Regime: TRENDING — range bot sits out", tone: "bad" },
+                { text: "Re-engages when price stabilises in a range", tone: "neutral" }
+            ]
+        };
+    }
+    let scoreBuy = 0;
+    let scoreSell = 0;
+    let confidence = inputs.regime === "RANGING" ? 45 : 30;
+    if (inputs.regime === "RANGING") {
+        reasons.push({ text: "Regime: RANGING (favourable)", tone: "good" });
+    }
+    else {
+        reasons.push({ text: "Regime: MIXED", tone: "neutral" });
+    }
+    // Book imbalance
+    if (inputs.bookImbalance >= thresholds.imbalanceThreshold) {
+        const pct = inputs.bookImbalance * 100;
+        scoreBuy += 25;
+        reasons.push({ text: `Book imbalance +${pct.toFixed(0)}% bid-heavy`, tone: "good" });
+    }
+    else if (inputs.bookImbalance <= -thresholds.imbalanceThreshold) {
+        const pct = inputs.bookImbalance * 100;
+        scoreSell += 25;
+        reasons.push({ text: `Book imbalance ${pct.toFixed(0)}% ask-heavy`, tone: "good" });
+    }
+    else {
+        reasons.push({
+            text: `Book imbalance balanced (${(inputs.bookImbalance * 100).toFixed(0)}%)`,
+            tone: "neutral"
+        });
+    }
+    // Trade flow (last 60s)
+    if (inputs.tradeImbalance >= thresholds.flowThreshold) {
+        const buyPct = (0.5 + inputs.tradeImbalance / 2) * 100;
+        scoreBuy += 20;
+        reasons.push({ text: `Recent flow ${buyPct.toFixed(0)}% buys`, tone: "good" });
+    }
+    else if (inputs.tradeImbalance <= -thresholds.flowThreshold) {
+        const sellPct = (0.5 - inputs.tradeImbalance / 2) * 100;
+        scoreSell += 20;
+        reasons.push({ text: `Recent flow ${sellPct.toFixed(0)}% sells`, tone: "good" });
+    }
+    else {
+        reasons.push({ text: "Recent flow balanced", tone: "neutral" });
+    }
+    // Spread
+    if (inputs.spreadPct > thresholds.spreadWidePct) {
+        confidence -= 10;
+        reasons.push({ text: `Spread wide (${inputs.spreadPct.toFixed(3)}%)`, tone: "bad" });
+    }
+    else {
+        confidence += 5;
+        reasons.push({ text: `Spread tight (${inputs.spreadPct.toFixed(3)}%)`, tone: "good" });
+    }
+    // Cross-venue divergence
+    if (inputs.venueDivergenceBps !== null && Number.isFinite(inputs.venueDivergenceBps)) {
+        if (inputs.venueDivergenceBps > thresholds.divergenceBps) {
+            scoreBuy += 12;
+            reasons.push({
+                text: `Binance leading +${inputs.venueDivergenceBps.toFixed(1)} bps vs Coinbase`,
+                tone: "good"
+            });
+        }
+        else if (inputs.venueDivergenceBps < -thresholds.divergenceBps) {
+            scoreSell += 12;
+            reasons.push({
+                text: `Binance lagging ${inputs.venueDivergenceBps.toFixed(1)} bps vs Coinbase`,
+                tone: "good"
+            });
+        }
+        else {
+            reasons.push({
+                text: `Venue divergence ${inputs.venueDivergenceBps.toFixed(1)} bps (aligned)`,
+                tone: "neutral"
+            });
+        }
+    }
+    // Depth check
+    if (inputs.bookDepthWithinHalfPctEth < thresholds.minDepthEth) {
+        confidence -= 15;
+        reasons.push({
+            text: `Thin book — ${inputs.bookDepthWithinHalfPctEth.toFixed(0)} ETH within ±0.5%`,
+            tone: "bad"
+        });
+    }
+    else {
+        confidence += 5;
+        reasons.push({
+            text: `Book depth healthy (${inputs.bookDepthWithinHalfPctEth.toFixed(0)} ETH within ±0.5%)`,
+            tone: "good"
+        });
+    }
+    let decision;
+    let finalConfidence = confidence;
+    if (scoreBuy > scoreSell + 12) {
+        decision = "BUY";
+        finalConfidence = Math.min(100, Math.max(0, confidence + scoreBuy));
+    }
+    else if (scoreSell > scoreBuy + 12) {
+        decision = "SELL";
+        finalConfidence = Math.min(100, Math.max(0, confidence + scoreSell));
+    }
+    else {
+        decision = "WAIT";
+        finalConfidence = Math.min(100, Math.max(0, confidence + Math.max(scoreBuy, scoreSell) / 2));
+        reasons.push({ text: "Signals mixed — no clear direction", tone: "neutral" });
+    }
+    return { decision, confidence: finalConfidence, reasons };
+}
+export function computeBookImbalance(bids, asks, midPrice, withinPct = 0.005) {
+    const lowerBound = midPrice * (1 - withinPct);
+    const upperBound = midPrice * (1 + withinPct);
+    const bidSize = bids.filter((b) => b.price >= lowerBound).reduce((sum, b) => sum + b.size, 0);
+    const askSize = asks.filter((a) => a.price <= upperBound).reduce((sum, a) => sum + a.size, 0);
+    const total = bidSize + askSize;
+    if (total <= 0)
+        return 0;
+    return (bidSize - askSize) / total;
+}
+export function computeBookDepth(bids, asks, midPrice, withinPct = 0.005) {
+    const lowerBound = midPrice * (1 - withinPct);
+    const upperBound = midPrice * (1 + withinPct);
+    const bidSize = bids.filter((b) => b.price >= lowerBound).reduce((sum, b) => sum + b.size, 0);
+    const askSize = asks.filter((a) => a.price <= upperBound).reduce((sum, a) => sum + a.size, 0);
+    return bidSize + askSize;
+}
+export function computeTradeImbalance(trades, windowMs = 60_000, nowMs = Date.now()) {
+    const cutoff = nowMs - windowMs;
+    let buyVolume = 0;
+    let sellVolume = 0;
+    for (const t of trades) {
+        if (t.timestamp < cutoff)
+            continue;
+        if (t.side === "buy")
+            buyVolume += t.size;
+        else
+            sellVolume += t.size;
+    }
+    const total = buyVolume + sellVolume;
+    if (total <= 0)
+        return 0;
+    return (buyVolume - sellVolume) / total;
+}
+//# sourceMappingURL=decisionEngine.js.map

package/dist/decisionEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisionEngine.js","sourceRoot":"","sources":["../src/decisionEngine.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -11,6 +11,20 @@ export { approveUniswapV2RoundTripToken, previewUniswapV2RoundTrip, type Ethereu
 export { useEthPriceTicker, type BinanceMiniTickerMessage, type EthPriceTickerStatus, type UseEthPriceTickerOptions, type UseEthPriceTickerResult } from "./useEthPriceTicker.js";
 export { useStrategyContract, type StrategyContractAction, type UseStrategyContractOptions, type UseStrategyContractResult } from "./useStrategyContract.js";
 export { useWalletEthBalance, type UseWalletEthBalanceOptions, type UseWalletEthBalanceResult } from "./useWalletEthBalance.js";
+export { useBinanceOrderBook, type OrderBookLevel, type OrderBookSnapshot, type OrderBookStatus, type UseBinanceOrderBookOptions, type UseBinanceOrderBookResult } from "./useBinanceOrderBook.js";
+export { OrderBookWidget, type OrderBookWidgetProps } from "./OrderBookWidget.js";
+export { useBinanceTrades, type Trade, type TradeSide, type TradesStatus, type UseBinanceTradesOptions, type UseBinanceTradesResult } from "./useBinanceTrades.js";
+export { TradeTape, type TradeTapeProps } from "./TradeTape.js";
+export { useStrategyContractEvents, type StrategyEvent, type StrategyEventKind, type UseStrategyContractEventsOptions, type UseStrategyContractEventsResult } from "./useStrategyContractEvents.js";
+export { ContractEventFeed, type ContractEventFeedProps } from "./ContractEventFeed.js";
+export { useVolatilityRegime, type Regime, type UseVolatilityRegimeOptions, type UseVolatilityRegimeResult } from "./useVolatilityRegime.js";
+export { RegimeBadge, type RegimeBadgeProps } from "./RegimeBadge.js";
+export { useGasPrice, type GasTier, type UseGasPriceOptions, type UseGasPriceResult } from "./useGasPrice.js";
+export { GasBadge, type GasBadgeProps } from "./GasBadge.js";
+export { useCoinbaseTicker, type CoinbaseTickerStatus, type CoinbaseTickerMessage, type UseCoinbaseTickerOptions, type UseCoinbaseTickerResult } from "./useCoinbaseTicker.js";
+export { useBotDecision, type BotDecision, type DecisionResult, type DecisionThresholds, type DecisionHistoryEntry, type UseBotDecisionOptions, type UseBotDecisionResult } from "./useBotDecision.js";
+export { computeBotDecision, computeBookImbalance, computeBookDepth, computeTradeImbalance, DEFAULT_DECISION_THRESHOLDS, type DecisionInputs, type DecisionReason, type BookLevel } from "./decisionEngine.js";
+export { BotDecisionPanel, type BotDecisionPanelProps } from "./BotDecisionPanel.js";
 /** @deprecated Use BAND_STRATEGY_ABI. Will be removed in v1.0. */
 export { BAND_STRATEGY_ABI as ETH_BOT_VAULT_ABI } from "./bandStrategyAbi.js";
 /** @deprecated Use BAND_STRATEGY_BYTECODE. Will be removed in v1.0. */

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,EACL,iCAAiC,EACjC,6BAA6B,EAC7B,KAAK,oCAAoC,EACzC,KAAK,mCAAmC,EACzC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC/B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,KAAK,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAEhI,kEAAkE;AAClE,OAAO,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,uEAAuE;AACvE,OAAO,EAAE,sBAAsB,IAAI,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAC7F,kEAAkE;AAClE,OAAO,EAAE,iBAAiB,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnF,uEAAuE;AACvE,OAAO,EAAE,sBAAsB,IAAI,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAClG,0DAA0D;AAC1D,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,KAAK,cAAc,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACnG,kEAAkE;AAClE,OAAO,EAAE,iBAAiB,IAAI,aAAa,EAAE,KAAK,sBAAsB,IAAI,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC/H,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,IAAI,4BAA4B,EAAE,KAAK,0BAA0B,IAAI,mCAAmC,EAAE,MAAM,iBAAiB,CAAC;AAC9J,kFAAkF;AAClF,OAAO,EAAE,iCAAiC,IAAI,iCAAiC,EAAE,MAAM,oCAAoC,CAAC;AAC5H,8EAA8E;AAC9E,OAAO,EACL,6BAA6B,IAAI,wBAAwB,EACzD,KAAK,oCAAoC,IAAI,+BAA+B,EAC5E,KAAK,mCAAmC,IAAI,8BAA8B,EAC3E,MAAM,oCAAoC,CAAC;AAC5C,iEAAiE;AACjE,OAAO,EAAE,gBAAgB,IAAI,kBAAkB,EAAE,KAAK,uBAAuB,IAAI,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAC1I,oEAAoE;AACpE,OAAO,EACL,mBAAmB,IAAI,WAAW,EAClC,KAAK,sBAAsB,IAAI,cAAc,EAC7C,KAAK,0BAA0B,IAAI,kBAAkB,EACrD,KAAK,yBAAyB,IAAI,iBAAiB,EACpD,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -11,6 +11,24 @@ export { approveUniswapV2RoundTripToken, previewUniswapV2RoundTrip } from "./tra
 export { useEthPriceTicker } from "./useEthPriceTicker.js";
 export { useStrategyContract } from "./useStrategyContract.js";
 export { useWalletEthBalance } from "./useWalletEthBalance.js";
+// --- Market widgets ------------------------------------------------------
+export { useBinanceOrderBook } from "./useBinanceOrderBook.js";
+export { OrderBookWidget } from "./OrderBookWidget.js";
+export { useBinanceTrades } from "./useBinanceTrades.js";
+export { TradeTape } from "./TradeTape.js";
+// --- On-chain event feed -------------------------------------------------
+export { useStrategyContractEvents } from "./useStrategyContractEvents.js";
+export { ContractEventFeed } from "./ContractEventFeed.js";
+// --- Market context badges -----------------------------------------------
+export { useVolatilityRegime } from "./useVolatilityRegime.js";
+export { RegimeBadge } from "./RegimeBadge.js";
+export { useGasPrice } from "./useGasPrice.js";
+export { GasBadge } from "./GasBadge.js";
+// --- Cross-venue + decision proxy ---------------------------------------
+export { useCoinbaseTicker } from "./useCoinbaseTicker.js";
+export { useBotDecision } from "./useBotDecision.js";
+export { computeBotDecision, computeBookImbalance, computeBookDepth, computeTradeImbalance, DEFAULT_DECISION_THRESHOLDS } from "./decisionEngine.js";
+export { BotDecisionPanel } from "./BotDecisionPanel.js";
 /** @deprecated Use BAND_STRATEGY_ABI. Will be removed in v1.0. */
 export { BAND_STRATEGY_ABI as ETH_BOT_VAULT_ABI } from "./bandStrategyAbi.js";
 /** @deprecated Use BAND_STRATEGY_BYTECODE. Will be removed in v1.0. */

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,SAAS,EAAuB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAA+B,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAmC,MAAM,iBAAiB,CAAC;AACvF,OAAO,EACL,iCAAiC,EACjC,6BAA6B,EAG9B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAgC,MAAM,uBAAuB,CAAC;AACvF,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EAI1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,iBAAiB,EAKlB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,mBAAmB,EAIpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAmE,MAAM,0BAA0B,CAAC;AAEhI,kEAAkE;AAClE,OAAO,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,uEAAuE;AACvE,OAAO,EAAE,sBAAsB,IAAI,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAC7F,kEAAkE;AAClE,OAAO,EAAE,iBAAiB,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnF,uEAAuE;AACvE,OAAO,EAAE,sBAAsB,IAAI,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAClG,0DAA0D;AAC1D,OAAO,EAAE,SAAS,IAAI,WAAW,EAA2C,MAAM,gBAAgB,CAAC;AACnG,kEAAkE;AAClE,OAAO,EAAE,iBAAiB,IAAI,aAAa,EAAqD,MAAM,wBAAwB,CAAC;AAC/H,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,IAAI,4BAA4B,EAA0E,MAAM,iBAAiB,CAAC;AAC9J,kFAAkF;AAClF,OAAO,EAAE,iCAAiC,IAAI,iCAAiC,EAAE,MAAM,oCAAoC,CAAC;AAC5H,8EAA8E;AAC9E,OAAO,EACL,6BAA6B,IAAI,wBAAwB,EAG1D,MAAM,oCAAoC,CAAC;AAC5C,iEAAiE;AACjE,OAAO,EAAE,gBAAgB,IAAI,kBAAkB,EAA6D,MAAM,uBAAuB,CAAC;AAC1I,oEAAoE;AACpE,OAAO,EACL,mBAAmB,IAAI,WAAW,EAInC,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/useBinanceOrderBook.d.ts

@@ -0,0 +1,27 @@
+export type OrderBookLevel = {
+    price: number;
+    size: number;
+    total: number;
+};
+export type OrderBookSnapshot = {
+    bids: OrderBookLevel[];
+    asks: OrderBookLevel[];
+    spread: number | null;
+    spreadPercent: number | null;
+    midPrice: number | null;
+};
+export type OrderBookStatus = "connecting" | "live" | "stale" | "error";
+export type UseBinanceOrderBookOptions = {
+    enabled?: boolean;
+    symbol?: string;
+    depth?: 5 | 10 | 20;
+    reconnectDelayMs?: number;
+};
+export type UseBinanceOrderBookResult = OrderBookSnapshot & {
+    status: OrderBookStatus;
+    error?: string;
+    symbol: string;
+    updatedAt?: Date;
+};
+export declare function useBinanceOrderBook(options?: UseBinanceOrderBookOptions): UseBinanceOrderBookResult;
+//# sourceMappingURL=useBinanceOrderBook.d.ts.map

package/dist/useBinanceOrderBook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBinanceOrderBook.d.ts","sourceRoot":"","sources":["../src/useBinanceOrderBook.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAExE,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,GAAG;IAC1D,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB,CAAC;AAoBF,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,yBAAyB,CA4FvG"}

package/dist/useBinanceOrderBook.js

@@ -0,0 +1,95 @@
+import { useEffect, useMemo, useState } from "react";
+function buildLevels(raw) {
+    let running = 0;
+    return raw
+        .map(([priceStr, sizeStr]) => {
+        const price = Number(priceStr);
+        const size = Number(sizeStr);
+        running += size;
+        return { price, size, total: running };
+    })
+        .filter((level) => Number.isFinite(level.price) && Number.isFinite(level.size) && level.size > 0);
+}
+export function useBinanceOrderBook(options = {}) {
+    const enabled = options.enabled ?? true;
+    const symbol = (options.symbol ?? "ethusdt").toLowerCase();
+    const depth = options.depth ?? 20;
+    const reconnectDelayMs = options.reconnectDelayMs ?? 3000;
+    const streamUrl = `wss://stream.binance.com:9443/ws/${symbol}@depth${depth}@100ms`;
+    const [message, setMessage] = useState();
+    const [status, setStatus] = useState("connecting");
+    const [error, setError] = useState();
+    const [updatedAt, setUpdatedAt] = useState();
+    useEffect(() => {
+        if (!enabled) {
+            setStatus("stale");
+            return;
+        }
+        if (typeof WebSocket === "undefined") {
+            setStatus("error");
+            setError("WebSocket is not available in this runtime.");
+            return;
+        }
+        let reconnectTimer;
+        let closedByHook = false;
+        let socket;
+        function connect() {
+            setStatus("connecting");
+            socket = new WebSocket(streamUrl);
+            socket.onopen = () => {
+                setStatus("live");
+                setError(undefined);
+            };
+            socket.onmessage = (event) => {
+                try {
+                    const parsed = JSON.parse(String(event.data));
+                    setMessage(parsed);
+                    setStatus("live");
+                    setUpdatedAt(new Date());
+                }
+                catch {
+                    setStatus("error");
+                    setError("Could not parse order book message.");
+                }
+            };
+            socket.onerror = () => {
+                setStatus("error");
+                setError("Order book connection failed.");
+            };
+            socket.onclose = () => {
+                if (closedByHook)
+                    return;
+                setStatus("stale");
+                reconnectTimer = setTimeout(connect, reconnectDelayMs);
+            };
+        }
+        connect();
+        return () => {
+            closedByHook = true;
+            if (reconnectTimer)
+                clearTimeout(reconnectTimer);
+            socket?.close();
+        };
+    }, [enabled, reconnectDelayMs, streamUrl]);
+    return useMemo(() => {
+        const bids = message ? buildLevels(message.bids) : [];
+        const asks = message ? buildLevels(message.asks) : [];
+        const bestBid = bids[0]?.price ?? null;
+        const bestAsk = asks[0]?.price ?? null;
+        const spread = bestBid !== null && bestAsk !== null ? bestAsk - bestBid : null;
+        const midPrice = bestBid !== null && bestAsk !== null ? (bestBid + bestAsk) / 2 : null;
+        const spreadPercent = spread !== null && midPrice !== null && midPrice > 0 ? (spread / midPrice) * 100 : null;
+        return {
+            bids,
+            asks,
+            spread,
+            spreadPercent,
+            midPrice,
+            status,
+            error,
+            symbol: symbol.toUpperCase(),
+            updatedAt
+        };
+    }, [error, message, status, symbol, updatedAt]);
+}
+//# sourceMappingURL=useBinanceOrderBook.js.map

package/dist/useBinanceOrderBook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBinanceOrderBook.js","sourceRoot":"","sources":["../src/useBinanceOrderBook.ts"],"names":[],"mappings":"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"}

package/dist/useBinanceTrades.d.ts

@@ -0,0 +1,23 @@
+export type TradeSide = "buy" | "sell";
+export type Trade = {
+    id: number;
+    price: number;
+    size: number;
+    side: TradeSide;
+    timestamp: number;
+};
+export type TradesStatus = "connecting" | "live" | "stale" | "error";
+export type UseBinanceTradesOptions = {
+    enabled?: boolean;
+    symbol?: string;
+    maxTrades?: number;
+    reconnectDelayMs?: number;
+};
+export type UseBinanceTradesResult = {
+    trades: Trade[];
+    status: TradesStatus;
+    error?: string;
+    symbol: string;
+};
+export declare function useBinanceTrades(options?: UseBinanceTradesOptions): UseBinanceTradesResult;
+//# sourceMappingURL=useBinanceTrades.d.ts.map

package/dist/useBinanceTrades.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBinanceTrades.d.ts","sourceRoot":"","sources":["../src/useBinanceTrades.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEvC,MAAM,MAAM,KAAK,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAErE,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAaF,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,sBAAsB,CAqF9F"}

package/dist/useBinanceTrades.js

@@ -0,0 +1,77 @@
+import { useEffect, useMemo, useState } from "react";
+export function useBinanceTrades(options = {}) {
+    const enabled = options.enabled ?? true;
+    const symbol = (options.symbol ?? "ethusdt").toLowerCase();
+    const maxTrades = options.maxTrades ?? 30;
+    const reconnectDelayMs = options.reconnectDelayMs ?? 3000;
+    const streamUrl = `wss://stream.binance.com:9443/ws/${symbol}@trade`;
+    const [trades, setTrades] = useState([]);
+    const [status, setStatus] = useState("connecting");
+    const [error, setError] = useState();
+    useEffect(() => {
+        if (!enabled) {
+            setStatus("stale");
+            return;
+        }
+        if (typeof WebSocket === "undefined") {
+            setStatus("error");
+            setError("WebSocket is not available in this runtime.");
+            return;
+        }
+        let reconnectTimer;
+        let closedByHook = false;
+        let socket;
+        function connect() {
+            setStatus("connecting");
+            socket = new WebSocket(streamUrl);
+            socket.onopen = () => {
+                setStatus("live");
+                setError(undefined);
+            };
+            socket.onmessage = (event) => {
+                try {
+                    const parsed = JSON.parse(String(event.data));
+                    const trade = {
+                        id: parsed.t,
+                        price: Number(parsed.p),
+                        size: Number(parsed.q),
+                        side: parsed.m ? "sell" : "buy",
+                        timestamp: parsed.T
+                    };
+                    if (!Number.isFinite(trade.price) || !Number.isFinite(trade.size))
+                        return;
+                    setTrades((prev) => [trade, ...prev].slice(0, maxTrades));
+                    setStatus("live");
+                }
+                catch {
+                    setStatus("error");
+                    setError("Could not parse trade message.");
+                }
+            };
+            socket.onerror = () => {
+                setStatus("error");
+                setError("Trade stream connection failed.");
+            };
+            socket.onclose = () => {
+                if (closedByHook)
+                    return;
+                setStatus("stale");
+                reconnectTimer = setTimeout(connect, reconnectDelayMs);
+            };
+        }
+        connect();
+        return () => {
+            closedByHook = true;
+            if (reconnectTimer)
+                clearTimeout(reconnectTimer);
+            socket?.close();
+        };
+    }, [enabled, maxTrades, reconnectDelayMs, streamUrl]);
+    return useMemo(() => ({
+        trades,
+        status,
+        error,
+        symbol: symbol.toUpperCase()
+    }), [trades, status, error, symbol]);
+}
+//# sourceMappingURL=useBinanceTrades.js.map

package/dist/useBinanceTrades.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBinanceTrades.js","sourceRoot":"","sources":["../src/useBinanceTrades.ts"],"names":[],"mappings":"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"}

package/dist/useBotDecision.d.ts

@@ -0,0 +1,32 @@
+import { type UseBinanceOrderBookOptions } from "./useBinanceOrderBook.js";
+import { type UseBinanceTradesOptions } from "./useBinanceTrades.js";
+import { type UseCoinbaseTickerOptions } from "./useCoinbaseTicker.js";
+import { type UseVolatilityRegimeOptions } from "./useVolatilityRegime.js";
+import { type BotDecision, type DecisionResult, type DecisionThresholds } from "./decisionEngine.js";
+export type { BotDecision, DecisionResult, DecisionThresholds } from "./decisionEngine.js";
+export type DecisionHistoryEntry = {
+    at: number;
+    decision: BotDecision;
+    confidence: number;
+};
+export type UseBotDecisionOptions = {
+    enabled?: boolean;
+    evaluationIntervalMs?: number;
+    flowWindowMs?: number;
+    historyLimit?: number;
+    thresholds?: Partial<DecisionThresholds>;
+    orderBook?: UseBinanceOrderBookOptions;
+    trades?: UseBinanceTradesOptions;
+    coinbase?: UseCoinbaseTickerOptions;
+    regime?: UseVolatilityRegimeOptions;
+};
+export type UseBotDecisionResult = DecisionResult & {
+    midPriceBinance: number | null;
+    midPriceCoinbase: number | null;
+    venueDivergenceBps: number | null;
+    bookDepthWithinHalfPctEth: number;
+    history: DecisionHistoryEntry[];
+    evaluatedAt?: Date;
+};
+export declare function useBotDecision(options?: UseBotDecisionOptions): UseBotDecisionResult;
+//# sourceMappingURL=useBotDecision.d.ts.map

package/dist/useBotDecision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBotDecision.d.ts","sourceRoot":"","sources":["../src/useBotDecision.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAChG,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAqB,KAAK,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAuB,KAAK,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAChG,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE3F,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,WAAW,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,0BAA0B,CAAC;IACvC,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG;IAClD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;IAClC,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB,CAAC;AAQF,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,oBAAoB,CAqHxF"}

package/dist/useBotDecision.js

@@ -0,0 +1,104 @@
+import { useEffect, useMemo, useRef, useState } from "react";
+import { useBinanceOrderBook } from "./useBinanceOrderBook.js";
+import { useBinanceTrades } from "./useBinanceTrades.js";
+import { useCoinbaseTicker } from "./useCoinbaseTicker.js";
+import { useVolatilityRegime } from "./useVolatilityRegime.js";
+import { computeBookDepth, computeBookImbalance, computeBotDecision, computeTradeImbalance, DEFAULT_DECISION_THRESHOLDS } from "./decisionEngine.js";
+const EMPTY_RESULT = {
+    decision: "WAIT",
+    confidence: 0,
+    reasons: [{ text: "Waiting for live data", tone: "neutral" }]
+};
+export function useBotDecision(options = {}) {
+    const enabled = options.enabled ?? true;
+    const evaluationIntervalMs = options.evaluationIntervalMs ?? 2000;
+    const flowWindowMs = options.flowWindowMs ?? 60_000;
+    const historyLimit = options.historyLimit ?? 30;
+    const thresholds = { ...DEFAULT_DECISION_THRESHOLDS, ...(options.thresholds ?? {}) };
+    const book = useBinanceOrderBook({ ...options.orderBook, enabled });
+    const trades = useBinanceTrades({ ...options.trades, enabled });
+    const coinbase = useCoinbaseTicker({ ...options.coinbase, enabled });
+    const regime = useVolatilityRegime({ ...options.regime, enabled });
+    const bookRef = useRef(book);
+    const tradesRef = useRef(trades);
+    const coinbaseRef = useRef(coinbase);
+    const regimeRef = useRef(regime);
+    useEffect(() => {
+        bookRef.current = book;
+    }, [book]);
+    useEffect(() => {
+        tradesRef.current = trades;
+    }, [trades]);
+    useEffect(() => {
+        coinbaseRef.current = coinbase;
+    }, [coinbase]);
+    useEffect(() => {
+        regimeRef.current = regime;
+    }, [regime]);
+    const [snapshot, setSnapshot] = useState({
+        result: EMPTY_RESULT,
+        midBinance: null,
+        midCoinbase: null,
+        divergenceBps: null,
+        depthEth: 0
+    });
+    const [history, setHistory] = useState([]);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        function evaluate() {
+            const b = bookRef.current;
+            const t = tradesRef.current;
+            const c = coinbaseRef.current;
+            const r = regimeRef.current;
+            const midBinance = b.midPrice;
+            if (midBinance === null) {
+                setSnapshot((prev) => ({ ...prev, evaluatedAt: new Date() }));
+                return;
+            }
+            const bookImbalance = computeBookImbalance(b.bids, b.asks, midBinance);
+            const depthEth = computeBookDepth(b.bids, b.asks, midBinance);
+            const tradeImbalance = computeTradeImbalance(t.trades, flowWindowMs);
+            const spreadPct = b.spreadPercent ?? 0;
+            const midCoinbase = c.midPrice;
+            const divergenceBps = midCoinbase !== null && midCoinbase > 0
+                ? ((midBinance - midCoinbase) / midCoinbase) * 10000
+                : null;
+            const result = computeBotDecision({
+                regime: r.regime,
+                bookImbalance,
+                tradeImbalance,
+                spreadPct,
+                venueDivergenceBps: divergenceBps,
+                bookDepthWithinHalfPctEth: depthEth,
+                midPrice: midBinance
+            }, thresholds);
+            const now = Date.now();
+            setSnapshot({
+                result,
+                midBinance,
+                midCoinbase,
+                divergenceBps,
+                depthEth,
+                evaluatedAt: new Date(now)
+            });
+            setHistory((prev) => [
+                { at: now, decision: result.decision, confidence: result.confidence },
+                ...prev
+            ].slice(0, historyLimit));
+        }
+        evaluate();
+        const id = window.setInterval(evaluate, evaluationIntervalMs);
+        return () => window.clearInterval(id);
+    }, [enabled, evaluationIntervalMs, flowWindowMs, historyLimit, thresholds]);
+    return useMemo(() => ({
+        ...snapshot.result,
+        midPriceBinance: snapshot.midBinance,
+        midPriceCoinbase: snapshot.midCoinbase,
+        venueDivergenceBps: snapshot.divergenceBps,
+        bookDepthWithinHalfPctEth: snapshot.depthEth,
+        history,
+        evaluatedAt: snapshot.evaluatedAt
+    }), [history, snapshot]);
+}
+//# sourceMappingURL=useBotDecision.js.map