bandkit 1.0.2 → 1.0.3

package/README.md

@@ -10,6 +10,7 @@ The package ships:
 - Live market widgets: `<OrderBookWidget />`, `<TradeTape />`
 - On-chain feed: `<ContractEventFeed />` (watches your deployed strategy contract's events)
 - Context badges: `<RegimeBadge />` (volatility regime), `<GasBadge />` (mainnet gas price)
+- Decision proxy: `<BotDecisionPanel />` — live BUY/SELL/WAIT/STAND-DOWN preview from Binance + Coinbase data (preview only, not the on-chain bot)
 - A dark UI throughout
 
 It does **not** ship trading strategy logic, signal generation, risk management, or the off-chain trade-execution daemon — those are out of scope.
@@ -47,19 +48,23 @@ max-width 1100px, gap 20px, system font stack:
   │                                                     │
   ├──────────────────────┬──────────────────────────────┤
   │                      │                              │
-  │     <BandPanel />    │     <OrderBookWidget />      │  ← two-column split
+  │     <BandPanel />    │     <BotDecisionPanel />     │  ← two-column split
   │   (the bot UI: it    │                              │     on >=900px wide,
   │   has its own deploy,├──────────────────────────────┤     stacked below
-  │   fund, start, stop, │      <TradeTape />           │
+  │   fund, start, stop, │     <OrderBookWidget />      │
   │   withdraw buttons.  │                              │
   │   Default title is   ├──────────────────────────────┤
-  │   "Get started")     │   <ContractEventFeed         │
+  │   "Get started")     │      <TradeTape />           │
+  │                      │                              │
+  │                      ├──────────────────────────────┤
+  │                      │   <ContractEventFeed         │
   │                      │     strategyContractAddress= │
   │                      │     {deployedAddress} />     │
   └──────────────────────┴──────────────────────────────┘
 
 Components to import from bandkit:
   - BandPanel                (the main staged UI)
+  - BotDecisionPanel         (live BUY/SELL/WAIT decision preview — top of right column)
   - OrderBookWidget          (live Binance ETH/USDT depth)
   - TradeTape                (live recent trades)
   - ContractEventFeed        (on-chain events from the deployed strategy)
@@ -224,6 +229,25 @@ type RegimeBadgeProps = {
 };
 ```
 
+### `<BotDecisionPanel />`
+
+Live decision proxy. Combines Binance order book imbalance + recent trade flow + volatility regime + Coinbase cross-venue divergence into a `BUY` / `SELL` / `WAIT` / `STAND DOWN` decision with a 0–100 confidence score and human-readable reasons. **Preview only — does not execute trades.**
+
+```ts
+type BotDecisionPanelProps = {
+  className?: string;
+  title?: string;                           // default: "Bot Decision (live)"
+  evaluationIntervalMs?: number;            // default: 2000
+  flowWindowMs?: number;                    // default: 60000
+  historyLimit?: number;                    // default: 30
+  thresholds?: Partial<DecisionThresholds>; // override imbalance/flow/spread/divergence/depth cutoffs
+  enabled?: boolean;
+  // plus sub-options: orderBook, trades, coinbase, regime
+};
+```
+
+The pure decision function `computeBotDecision()` is also exported, so you can re-use the same logic in a Node script or backtest without React.
+
 ### `<GasBadge />`
 
 Current mainnet gas price, color-coded by tier (low/normal/high/spike).

package/dist/BotDecisionPanel.d.ts

@@ -0,0 +1,7 @@
+import { type UseBotDecisionOptions } from "./useBotDecision.js";
+export type BotDecisionPanelProps = UseBotDecisionOptions & {
+    className?: string;
+    title?: string;
+};
+export declare function BotDecisionPanel({ className, title, ...hookOptions }: BotDecisionPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=BotDecisionPanel.d.ts.map

package/dist/BotDecisionPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BotDecisionPanel.d.ts","sourceRoot":"","sources":["../src/BotDecisionPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAGjF,MAAM,MAAM,qBAAqB,GAAG,qBAAqB,GAAG;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAsCF,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,EAAE,KAA6B,EAAE,GAAG,WAAW,EAAE,EAAE,qBAAqB,2CA2HnH"}

package/dist/BotDecisionPanel.js

@@ -0,0 +1,124 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useBotDecision } from "./useBotDecision.js";
+const palette = {
+    bg: "#0a0a0a",
+    surface: "#111113",
+    surfaceMuted: "#0f0f11",
+    border: "#1f1f23",
+    text: "#f5f5f7",
+    textMuted: "#9ca3af",
+    textDim: "#52525b",
+    buy: "#10b981",
+    sell: "#ef4444",
+    wait: "#fbbf24",
+    standdown: "#6b7280",
+    good: "#10b981",
+    bad: "#ef4444",
+    neutral: "#9ca3af"
+};
+const decisionMeta = {
+    BUY: { label: "WOULD BUY", color: palette.buy, arrow: "▲" },
+    SELL: { label: "WOULD SELL", color: palette.sell, arrow: "▼" },
+    WAIT: { label: "WAIT", color: palette.wait, arrow: "•" },
+    "STAND DOWN": { label: "STAND DOWN", color: palette.standdown, arrow: "■" }
+};
+const reasonColor = {
+    good: palette.good,
+    bad: palette.bad,
+    neutral: palette.neutral
+};
+const reasonSymbol = {
+    good: "✓",
+    bad: "✗",
+    neutral: "•"
+};
+export function BotDecisionPanel({ className, title = "Bot Decision (live)", ...hookOptions }) {
+    const result = useBotDecision(hookOptions);
+    const meta = decisionMeta[result.decision];
+    const recent = result.history.slice(0, 20);
+    const tally = recent.reduce((acc, h) => {
+        acc[h.decision] = (acc[h.decision] ?? 0) + 1;
+        return acc;
+    }, { BUY: 0, SELL: 0, WAIT: 0, "STAND DOWN": 0 });
+    return (_jsxs("section", { className: className, style: {
+            background: palette.bg,
+            border: `1px solid ${palette.border}`,
+            borderRadius: 14,
+            boxShadow: "0 20px 60px rgba(0, 0, 0, 0.55)",
+            color: palette.text,
+            display: "grid",
+            fontFamily: "system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif",
+            gap: 14,
+            maxWidth: 420,
+            padding: 18
+        }, children: [_jsxs("header", { style: { alignItems: "center", display: "flex", justifyContent: "space-between" }, children: [_jsx("h3", { style: { fontSize: 14, fontWeight: 700, letterSpacing: "0.02em", margin: 0 }, children: title }), _jsx("span", { style: { color: palette.textDim, fontSize: 11 }, children: result.evaluatedAt ? `updated ${timeAgoShort(result.evaluatedAt.getTime())}` : "warming up" })] }), _jsxs("div", { style: {
+                    alignItems: "center",
+                    background: palette.surface,
+                    border: `1px solid ${meta.color}55`,
+                    borderRadius: 10,
+                    display: "flex",
+                    gap: 12,
+                    padding: "12px 14px"
+                }, children: [_jsx("span", { "aria-hidden": true, style: {
+                            color: meta.color,
+                            fontSize: 22,
+                            fontWeight: 800,
+                            lineHeight: 1,
+                            width: 22
+                        }, children: meta.arrow }), _jsxs("div", { style: { display: "grid", flex: 1, gap: 2 }, children: [_jsx("strong", { style: { color: meta.color, fontSize: 15, fontWeight: 700, letterSpacing: "0.04em" }, children: meta.label }), _jsxs("span", { style: { color: palette.textMuted, fontSize: 11 }, children: ["confidence ", result.confidence, "%"] })] }), _jsx(ConfidenceBar, { value: result.confidence, color: meta.color })] }), _jsx("ul", { style: { display: "grid", gap: 4, listStyle: "none", margin: 0, padding: 0 }, children: result.reasons.map((reason, idx) => (_jsxs("li", { style: {
+                        alignItems: "baseline",
+                        color: palette.text,
+                        display: "grid",
+                        fontSize: 12,
+                        gap: 8,
+                        gridTemplateColumns: "12px 1fr"
+                    }, children: [_jsx("span", { style: { color: reasonColor[reason.tone] }, children: reasonSymbol[reason.tone] }), _jsx("span", { style: { color: reason.tone === "bad" ? palette.textMuted : palette.text }, children: reason.text })] }, `${reason.text}-${idx}`))) }), _jsxs("div", { style: {
+                    alignItems: "center",
+                    background: palette.surfaceMuted,
+                    border: `1px solid ${palette.border}`,
+                    borderRadius: 8,
+                    color: palette.textMuted,
+                    display: "flex",
+                    fontSize: 11,
+                    fontVariantNumeric: "tabular-nums",
+                    gap: 10,
+                    justifyContent: "space-between",
+                    padding: "8px 12px"
+                }, children: [_jsxs("span", { children: ["Last ", recent.length, ":"] }), _jsx(Pill, { label: "BUY", count: tally.BUY, color: palette.buy }), _jsx(Pill, { label: "WAIT", count: tally.WAIT, color: palette.wait }), _jsx(Pill, { label: "SELL", count: tally.SELL, color: palette.sell }), _jsx(Pill, { label: "OFF", count: tally["STAND DOWN"], color: palette.standdown })] }), _jsx("div", { style: {
+                    color: palette.textDim,
+                    fontSize: 10,
+                    lineHeight: 1.4
+                }, children: "Preview only. Decisions here describe what the strategy would do given live Binance + Coinbase data \u2014 they do not execute on-chain trades. The actual bot runs as a separate Node process against Uniswap." })] }));
+}
+function Pill({ label, count, color }) {
+    return (_jsxs("span", { style: {
+            alignItems: "center",
+            background: `${color}1f`,
+            border: `1px solid ${color}55`,
+            borderRadius: 6,
+            color,
+            display: "inline-flex",
+            fontSize: 10,
+            fontWeight: 700,
+            gap: 4,
+            padding: "2px 8px"
+        }, children: [label, " ", _jsx("strong", { children: count })] }));
+}
+function ConfidenceBar({ value, color }) {
+    const safe = Math.max(0, Math.min(100, value));
+    return (_jsx("div", { "aria-hidden": true, style: {
+            background: palette.surfaceMuted,
+            border: `1px solid ${palette.border}`,
+            borderRadius: 6,
+            height: 6,
+            overflow: "hidden",
+            width: 72
+        }, children: _jsx("div", { style: { background: color, height: "100%", width: `${safe}%` } }) }));
+}
+function timeAgoShort(ts) {
+    const seconds = Math.max(0, (Date.now() - ts) / 1000);
+    if (seconds < 60)
+        return `${seconds.toFixed(0)}s ago`;
+    return `${Math.floor(seconds / 60)}m ago`;
+}
+//# sourceMappingURL=BotDecisionPanel.js.map

package/dist/BotDecisionPanel.js.map

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

package/dist/decisionEngine.d.ts

@@ -0,0 +1,41 @@
+import type { Regime } from "./useVolatilityRegime.js";
+export type BotDecision = "BUY" | "SELL" | "WAIT" | "STAND DOWN";
+export type DecisionReason = {
+    text: string;
+    tone: "good" | "bad" | "neutral";
+};
+export type DecisionInputs = {
+    regime: Regime;
+    bookImbalance: number;
+    tradeImbalance: number;
+    spreadPct: number;
+    venueDivergenceBps: number | null;
+    bookDepthWithinHalfPctEth: number;
+    midPrice: number | null;
+};
+export type DecisionResult = {
+    decision: BotDecision;
+    confidence: number;
+    reasons: DecisionReason[];
+};
+export type DecisionThresholds = {
+    imbalanceThreshold: number;
+    flowThreshold: number;
+    spreadWidePct: number;
+    divergenceBps: number;
+    minDepthEth: number;
+};
+export declare const DEFAULT_DECISION_THRESHOLDS: DecisionThresholds;
+export declare function computeBotDecision(inputs: DecisionInputs, thresholds?: DecisionThresholds): DecisionResult;
+export type BookLevel = {
+    price: number;
+    size: number;
+};
+export declare function computeBookImbalance(bids: BookLevel[], asks: BookLevel[], midPrice: number, withinPct?: number): number;
+export declare function computeBookDepth(bids: BookLevel[], asks: BookLevel[], midPrice: number, withinPct?: number): number;
+export declare function computeTradeImbalance(trades: {
+    side: "buy" | "sell";
+    size: number;
+    timestamp: number;
+}[], windowMs?: number, nowMs?: number): number;
+//# sourceMappingURL=decisionEngine.d.ts.map

package/dist/decisionEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisionEngine.d.ts","sourceRoot":"","sources":["../src/decisionEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;AAEjE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;IAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,WAAW,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,kBAMzC,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,EACtB,UAAU,GAAE,kBAAgD,GAC3D,cAAc,CA2HhB;AAKD,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,EAAE,EACjB,IAAI,EAAE,SAAS,EAAE,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,SAAQ,GAChB,MAAM,CASR;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,EAAE,EACjB,IAAI,EAAE,SAAS,EAAE,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,SAAQ,GAChB,MAAM,CAMR;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE;IAAE,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,EACnE,QAAQ,SAAS,EACjB,KAAK,SAAa,GACjB,MAAM,CAYR"}

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

@@ -21,6 +21,10 @@ export { useVolatilityRegime, type Regime, type UseVolatilityRegimeOptions, type
 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":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -24,6 +24,11 @@ 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,4EAA4E;AAC5E,OAAO,EACL,mBAAmB,EAMpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,eAAe,EAA6B,MAAM,sBAAsB,CAAC;AAElF,OAAO,EACL,gBAAgB,EAMjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAuB,MAAM,gBAAgB,CAAC;AAEhE,4EAA4E;AAC5E,OAAO,EACL,yBAAyB,EAK1B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAA+B,MAAM,wBAAwB,CAAC;AAExF,4EAA4E;AAC5E,OAAO,EACL,mBAAmB,EAIpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AAEtE,OAAO,EACL,WAAW,EAIZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAsB,MAAM,eAAe,CAAC;AAE7D,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/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

package/dist/useBotDecision.js.map

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

package/dist/useCoinbaseTicker.d.ts

@@ -0,0 +1,28 @@
+export type CoinbaseTickerStatus = "connecting" | "live" | "stale" | "error";
+export type CoinbaseTickerMessage = {
+    type: string;
+    product_id: string;
+    price?: string;
+    best_bid?: string;
+    best_ask?: string;
+    side?: "buy" | "sell";
+    time?: string;
+};
+export type UseCoinbaseTickerOptions = {
+    enabled?: boolean;
+    productId?: string;
+    reconnectDelayMs?: number;
+};
+export type UseCoinbaseTickerResult = {
+    price: number | null;
+    bestBid: number | null;
+    bestAsk: number | null;
+    midPrice: number | null;
+    lastSide?: "buy" | "sell";
+    status: CoinbaseTickerStatus;
+    error?: string;
+    productId: string;
+    updatedAt?: Date;
+};
+export declare function useCoinbaseTicker(options?: UseCoinbaseTickerOptions): UseCoinbaseTickerResult;
+//# sourceMappingURL=useCoinbaseTicker.d.ts.map

package/dist/useCoinbaseTicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCoinbaseTicker.d.ts","sourceRoot":"","sources":["../src/useCoinbaseTicker.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE7E,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC1B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB,CAAC;AAIF,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,uBAAuB,CA+FjG"}

package/dist/useCoinbaseTicker.js

@@ -0,0 +1,87 @@
+import { useEffect, useMemo, useState } from "react";
+const DEFAULT_URL = "wss://ws-feed.exchange.coinbase.com";
+export function useCoinbaseTicker(options = {}) {
+    const enabled = options.enabled ?? true;
+    const productId = options.productId ?? "ETH-USD";
+    const reconnectDelayMs = options.reconnectDelayMs ?? 3000;
+    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(DEFAULT_URL);
+            socket.onopen = () => {
+                socket?.send(JSON.stringify({
+                    type: "subscribe",
+                    product_ids: [productId],
+                    channels: ["ticker"]
+                }));
+                setStatus("live");
+                setError(undefined);
+            };
+            socket.onmessage = (event) => {
+                try {
+                    const parsed = JSON.parse(String(event.data));
+                    if (parsed.type === "ticker" && parsed.product_id === productId) {
+                        setMessage(parsed);
+                        setStatus("live");
+                        setUpdatedAt(new Date());
+                    }
+                }
+                catch {
+                    setStatus("error");
+                    setError("Could not parse Coinbase ticker message.");
+                }
+            };
+            socket.onerror = () => {
+                setStatus("error");
+                setError("Coinbase ticker connection failed.");
+            };
+            socket.onclose = () => {
+                if (closedByHook)
+                    return;
+                setStatus("stale");
+                reconnectTimer = setTimeout(connect, reconnectDelayMs);
+            };
+        }
+        connect();
+        return () => {
+            closedByHook = true;
+            if (reconnectTimer)
+                clearTimeout(reconnectTimer);
+            socket?.close();
+        };
+    }, [enabled, productId, reconnectDelayMs]);
+    return useMemo(() => {
+        const price = message?.price ? Number(message.price) : null;
+        const bestBid = message?.best_bid ? Number(message.best_bid) : null;
+        const bestAsk = message?.best_ask ? Number(message.best_ask) : null;
+        const midPrice = bestBid !== null && bestAsk !== null ? (bestBid + bestAsk) / 2 : null;
+        return {
+            price: price !== null && Number.isFinite(price) ? price : null,
+            bestBid: bestBid !== null && Number.isFinite(bestBid) ? bestBid : null,
+            bestAsk: bestAsk !== null && Number.isFinite(bestAsk) ? bestAsk : null,
+            midPrice: midPrice !== null && Number.isFinite(midPrice) ? midPrice : null,
+            lastSide: message?.side,
+            status,
+            error,
+            productId,
+            updatedAt
+        };
+    }, [error, message, productId, status, updatedAt]);
+}
+//# sourceMappingURL=useCoinbaseTicker.js.map

package/dist/useCoinbaseTicker.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bandkit",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Open-source scaffolding for Ethereum range-bound trading strategies: strategy contract deployment, restricted executor, and React hooks. Strategy logic is not included.",
   "license": "MIT",
   "type": "module",
@@ -63,6 +63,7 @@
     "@tanstack/react-query": "^5.0.0",
     "@types/node": "^22.0.0",
     "@types/react": "^19.0.0",
+    "@types/ws": "^8.18.1",
     "chai": "^6.2.2",
     "dotenv": "^16.4.7",
     "fp-ts": "^2.16.11",
@@ -73,7 +74,8 @@
     "ts-node": "^10.9.2",
     "typescript": "^5.7.0",
     "viem": "^2.0.0",
-    "wagmi": "^2.0.0"
+    "wagmi": "^2.0.0",
+    "ws": "^8.21.0"
   },
   "keywords": [
     "ethereum",

package/scripts/test-decision-stream.cjs

@@ -0,0 +1,417 @@
+/* eslint-disable */
+//
+// test-decision-stream.cjs
+//
+// Standalone Node script that streams live Binance ETH/USDT order book + trades
+// and Coinbase ETH-USD ticker, and runs the same decision logic as
+// src/decisionEngine.ts. Prints live decisions; after the run window,
+// prints a summary tally and a diagnostic signal-vs-forward-price comparison.
+//
+// IMPORTANT — what this proves and does NOT prove:
+//   - It DOES verify the decision logic responds to live data without crashing.
+//   - It DOES show the cadence and balance of signals.
+//   - It DOES report a crude correlation between BUY/SELL signals and the
+//     next minute's price change.
+//   - It DOES NOT prove the strategy is profitable.
+//     Real validation needs months of historical data, realistic slippage and
+//     gas modelling, out-of-sample windows, and statistical significance tests.
+//
+// Usage:
+//   node scripts/test-decision-stream.cjs [durationMinutes]
+//   default duration: 7 minutes
+//
+
+const WebSocket = require("ws");
+
+const DURATION_MIN = Number(process.argv[2] ?? 7);
+const BINANCE_DEPTH_URL = "wss://stream.binance.com:9443/ws/ethusdt@depth20@100ms";
+const BINANCE_TRADE_URL = "wss://stream.binance.com:9443/ws/ethusdt@trade";
+const COINBASE_URL = "wss://ws-feed.exchange.coinbase.com";
+
+// ---- State ----------------------------------------------------------------
+const state = {
+  binanceBook: { bids: [], asks: [], midPrice: null, spreadPct: null, ts: 0 },
+  coinbaseMid: null,
+  recentTrades: [], // { price, size, side, ts }
+  priceTicks: [], // for volatility regime
+  decisions: [], // { at, decision, confidence, midPrice, reasons }
+  startedAt: Date.now()
+};
+
+const PRICE_TICK_WINDOW = 60;
+const FLOW_WINDOW_MS = 60_000;
+const EVAL_INTERVAL_MS = 2000;
+const FORWARD_PRICE_DELAY_MS = 60_000;
+
+// ---- Decision logic (mirrors src/decisionEngine.ts) ----------------------
+function computeBookImbalance(bids, asks, mid, withinPct = 0.005) {
+  const lo = mid * (1 - withinPct);
+  const hi = mid * (1 + withinPct);
+  let bidSum = 0;
+  let askSum = 0;
+  for (const b of bids) if (b.price >= lo) bidSum += b.size;
+  for (const a of asks) if (a.price <= hi) askSum += a.size;
+  const total = bidSum + askSum;
+  return total > 0 ? (bidSum - askSum) / total : 0;
+}
+
+function computeBookDepth(bids, asks, mid, withinPct = 0.005) {
+  const lo = mid * (1 - withinPct);
+  const hi = mid * (1 + withinPct);
+  let total = 0;
+  for (const b of bids) if (b.price >= lo) total += b.size;
+  for (const a of asks) if (a.price <= hi) total += a.size;
+  return total;
+}
+
+function computeTradeImbalance(trades, windowMs, nowMs) {
+  const cutoff = nowMs - windowMs;
+  let buyVol = 0;
+  let sellVol = 0;
+  for (const t of trades) {
+    if (t.ts < cutoff) continue;
+    if (t.side === "buy") buyVol += t.size;
+    else sellVol += t.size;
+  }
+  const total = buyVol + sellVol;
+  return total > 0 ? (buyVol - sellVol) / total : 0;
+}
+
+function classifyRegime(prices) {
+  if (prices.length < Math.max(8, Math.floor(PRICE_TICK_WINDOW / 4))) {
+    return { regime: "UNKNOWN", stddevPct: null, driftPct: null };
+  }
+  const mean = prices.reduce((s, v) => s + v, 0) / prices.length;
+  const variance = prices.reduce((s, v) => s + (v - mean) ** 2, 0) / prices.length;
+  const stddev = Math.sqrt(variance);
+  const stddevPct = mean > 0 ? (stddev / mean) * 100 : null;
+  const drift = prices[prices.length - 1] - prices[0];
+  const driftPct = mean > 0 ? (drift / mean) * 100 : null;
+  const absDriftPct = driftPct === null ? null : Math.abs(driftPct);
+
+  let regime = "MIXED";
+  if (stddevPct !== null && absDriftPct !== null) {
+    if (absDriftPct >= 0.45) regime = "TRENDING";
+    else if (stddevPct <= 0.15 && absDriftPct < 0.45) regime = "RANGING";
+  }
+  return { regime, stddevPct, driftPct };
+}
+
+function computeDecision(inputs) {
+  const reasons = [];
+  if (inputs.regime === "UNKNOWN") {
+    return { decision: "WAIT", confidence: 0, reasons: ["Warming up"] };
+  }
+  if (inputs.regime === "TRENDING") {
+    return {
+      decision: "STAND DOWN",
+      confidence: 90,
+      reasons: ["TRENDING regime — bot sits out"]
+    };
+  }
+
+  let scoreBuy = 0;
+  let scoreSell = 0;
+  let confidence = inputs.regime === "RANGING" ? 45 : 30;
+  reasons.push(`Regime: ${inputs.regime}`);
+
+  if (inputs.bookImbalance >= 0.15) {
+    scoreBuy += 25;
+    reasons.push(`Book +${(inputs.bookImbalance * 100).toFixed(0)}% bid`);
+  } else if (inputs.bookImbalance <= -0.15) {
+    scoreSell += 25;
+    reasons.push(`Book ${(inputs.bookImbalance * 100).toFixed(0)}% ask`);
+  } else {
+    reasons.push(`Book ${(inputs.bookImbalance * 100).toFixed(0)}%`);
+  }
+
+  if (inputs.tradeImbalance >= 0.10) {
+    scoreBuy += 20;
+    reasons.push(`Flow ${((0.5 + inputs.tradeImbalance / 2) * 100).toFixed(0)}% buys`);
+  } else if (inputs.tradeImbalance <= -0.10) {
+    scoreSell += 20;
+    reasons.push(`Flow ${((0.5 - inputs.tradeImbalance / 2) * 100).toFixed(0)}% sells`);
+  } else {
+    reasons.push("Flow balanced");
+  }
+
+  if (inputs.spreadPct > 0.05) {
+    confidence -= 10;
+    reasons.push(`Spread wide ${inputs.spreadPct.toFixed(3)}%`);
+  } else {
+    confidence += 5;
+  }
+
+  if (inputs.venueDivergenceBps !== null && Number.isFinite(inputs.venueDivergenceBps)) {
+    if (inputs.venueDivergenceBps > 5) {
+      scoreBuy += 12;
+      reasons.push(`BIN +${inputs.venueDivergenceBps.toFixed(1)}bps`);
+    } else if (inputs.venueDivergenceBps < -5) {
+      scoreSell += 12;
+      reasons.push(`BIN ${inputs.venueDivergenceBps.toFixed(1)}bps`);
+    }
+  }
+
+  if (inputs.bookDepth < 50) {
+    confidence -= 15;
+    reasons.push(`Thin book (${inputs.bookDepth.toFixed(0)} ETH)`);
+  } else {
+    confidence += 5;
+  }
+
+  let decision = "WAIT";
+  if (scoreBuy > scoreSell + 12) {
+    decision = "BUY";
+    confidence = Math.min(100, Math.max(0, confidence + scoreBuy));
+  } else if (scoreSell > scoreBuy + 12) {
+    decision = "SELL";
+    confidence = Math.min(100, Math.max(0, confidence + scoreSell));
+  } else {
+    confidence = Math.min(100, Math.max(0, confidence + Math.max(scoreBuy, scoreSell) / 2));
+  }
+
+  return { decision, confidence: Math.round(confidence), reasons };
+}
+
+// ---- WebSocket setup -----------------------------------------------------
+function connectBinanceDepth() {
+  const ws = new WebSocket(BINANCE_DEPTH_URL);
+  ws.on("message", (raw) => {
+    try {
+      const msg = JSON.parse(raw.toString());
+      const bids = (msg.bids || [])
+        .map(([p, q]) => ({ price: Number(p), size: Number(q) }))
+        .filter((l) => l.size > 0);
+      const asks = (msg.asks || [])
+        .map(([p, q]) => ({ price: Number(p), size: Number(q) }))
+        .filter((l) => l.size > 0);
+      const bestBid = bids[0]?.price ?? null;
+      const bestAsk = asks[0]?.price ?? null;
+      if (bestBid && bestAsk) {
+        const mid = (bestBid + bestAsk) / 2;
+        state.binanceBook = {
+          bids,
+          asks,
+          midPrice: mid,
+          spreadPct: ((bestAsk - bestBid) / mid) * 100,
+          ts: Date.now()
+        };
+        // Sample price tick (rate-limited)
+        if (
+          state.priceTicks.length === 0 ||
+          Date.now() - (state.priceTicks._lastSampleAt || 0) > 1000
+        ) {
+          state.priceTicks.push(mid);
+          if (state.priceTicks.length > PRICE_TICK_WINDOW) state.priceTicks.shift();
+          state.priceTicks._lastSampleAt = Date.now();
+        }
+      }
+    } catch (err) {
+      /* swallow parse */
+    }
+  });
+  ws.on("error", () => {});
+  ws.on("close", () => setTimeout(connectBinanceDepth, 3000));
+  return ws;
+}
+
+function connectBinanceTrades() {
+  const ws = new WebSocket(BINANCE_TRADE_URL);
+  ws.on("message", (raw) => {
+    try {
+      const msg = JSON.parse(raw.toString());
+      const trade = {
+        price: Number(msg.p),
+        size: Number(msg.q),
+        side: msg.m ? "sell" : "buy",
+        ts: Number(msg.T)
+      };
+      if (Number.isFinite(trade.price) && Number.isFinite(trade.size)) {
+        state.recentTrades.push(trade);
+        // Prune
+        const cutoff = Date.now() - FLOW_WINDOW_MS * 2;
+        while (state.recentTrades.length > 0 && state.recentTrades[0].ts < cutoff) {
+          state.recentTrades.shift();
+        }
+      }
+    } catch (err) {
+      /* swallow */
+    }
+  });
+  ws.on("error", () => {});
+  ws.on("close", () => setTimeout(connectBinanceTrades, 3000));
+  return ws;
+}
+
+function connectCoinbase() {
+  const ws = new WebSocket(COINBASE_URL);
+  ws.on("open", () => {
+    ws.send(
+      JSON.stringify({
+        type: "subscribe",
+        product_ids: ["ETH-USD"],
+        channels: ["ticker"]
+      })
+    );
+  });
+  ws.on("message", (raw) => {
+    try {
+      const msg = JSON.parse(raw.toString());
+      if (msg.type === "ticker" && msg.product_id === "ETH-USD") {
+        const bid = Number(msg.best_bid);
+        const ask = Number(msg.best_ask);
+        if (Number.isFinite(bid) && Number.isFinite(ask)) {
+          state.coinbaseMid = (bid + ask) / 2;
+        }
+      }
+    } catch (err) {
+      /* swallow */
+    }
+  });
+  ws.on("error", () => {});
+  ws.on("close", () => setTimeout(connectCoinbase, 3000));
+  return ws;
+}
+
+// ---- Main loop -----------------------------------------------------------
+function pad(s, n) {
+  s = String(s);
+  return s.length >= n ? s : s + " ".repeat(n - s.length);
+}
+
+function evaluate() {
+  const mid = state.binanceBook.midPrice;
+  if (!mid) return;
+
+  const bookImbalance = computeBookImbalance(state.binanceBook.bids, state.binanceBook.asks, mid);
+  const bookDepth = computeBookDepth(state.binanceBook.bids, state.binanceBook.asks, mid);
+  const tradeImbalance = computeTradeImbalance(state.recentTrades, FLOW_WINDOW_MS, Date.now());
+  const { regime, stddevPct, driftPct } = classifyRegime(state.priceTicks);
+  const venueDivergenceBps =
+    state.coinbaseMid && state.coinbaseMid > 0
+      ? ((mid - state.coinbaseMid) / state.coinbaseMid) * 10000
+      : null;
+
+  const result = computeDecision({
+    regime,
+    bookImbalance,
+    tradeImbalance,
+    spreadPct: state.binanceBook.spreadPct ?? 0,
+    venueDivergenceBps,
+    bookDepth
+  });
+
+  const entry = {
+    at: Date.now(),
+    decision: result.decision,
+    confidence: result.confidence,
+    midPrice: mid,
+    reasons: result.reasons,
+    regime,
+    bookImbalance,
+    tradeImbalance,
+    venueDivergenceBps,
+    stddevPct,
+    driftPct
+  };
+  state.decisions.push(entry);
+
+  const elapsedSec = ((Date.now() - state.startedAt) / 1000).toFixed(0);
+  console.log(
+    `[t+${pad(elapsedSec, 4)}s] ${pad(result.decision, 11)} conf=${pad(result.confidence, 3)}` +
+      ` mid=${mid.toFixed(2)} regime=${pad(regime, 8)}` +
+      ` book=${pad((bookImbalance * 100).toFixed(0) + "%", 5)}` +
+      ` flow=${pad((tradeImbalance * 100).toFixed(0) + "%", 5)}` +
+      ` div=${venueDivergenceBps === null ? " — " : (venueDivergenceBps.toFixed(1) + "bps")}` +
+      `  ${result.reasons.slice(0, 3).join(", ")}`
+  );
+}
+
+function printSummary() {
+  console.log("\n" + "=".repeat(80));
+  console.log(`SUMMARY  (duration ${DURATION_MIN} min, ${state.decisions.length} evaluations)`);
+  console.log("=".repeat(80));
+
+  const tally = { BUY: 0, SELL: 0, WAIT: 0, "STAND DOWN": 0 };
+  const regimeTally = { RANGING: 0, MIXED: 0, TRENDING: 0, UNKNOWN: 0 };
+  for (const d of state.decisions) {
+    tally[d.decision]++;
+    regimeTally[d.regime]++;
+  }
+
+  console.log("\nDecision tally:");
+  for (const [k, v] of Object.entries(tally)) {
+    const pct = state.decisions.length > 0 ? ((v / state.decisions.length) * 100).toFixed(1) : "0.0";
+    console.log(`  ${pad(k, 12)}  ${pad(v, 5)}  (${pct}%)`);
+  }
+
+  console.log("\nRegime time-in-state:");
+  for (const [k, v] of Object.entries(regimeTally)) {
+    const pct = state.decisions.length > 0 ? ((v / state.decisions.length) * 100).toFixed(1) : "0.0";
+    console.log(`  ${pad(k, 12)}  ${pad(v, 5)}  (${pct}%)`);
+  }
+
+  // Forward-price diagnostic: for each BUY/SELL signal, look at the price
+  // ~60s later and tally whether it moved in the signal's favor.
+  const directional = state.decisions.filter((d) => d.decision === "BUY" || d.decision === "SELL");
+  let evaluated = 0;
+  let correct = 0;
+  let totalForwardBps = 0;
+  for (const d of directional) {
+    const targetTs = d.at + FORWARD_PRICE_DELAY_MS;
+    // find first decision at or after target
+    const futureIdx = state.decisions.findIndex((x) => x.at >= targetTs);
+    if (futureIdx === -1) continue;
+    const futurePrice = state.decisions[futureIdx].midPrice;
+    const moveBps = ((futurePrice - d.midPrice) / d.midPrice) * 10000;
+    evaluated++;
+    const signedMove = d.decision === "BUY" ? moveBps : -moveBps;
+    totalForwardBps += signedMove;
+    if (signedMove > 0) correct++;
+  }
+  console.log("\nDirectional diagnostic (60s-forward, NOT a profitability test):");
+  if (evaluated === 0) {
+    console.log("  no eligible directional signals with forward window");
+  } else {
+    const hitRate = ((correct / evaluated) * 100).toFixed(1);
+    const avgSignedBps = (totalForwardBps / evaluated).toFixed(2);
+    console.log(`  signals scored:        ${evaluated}`);
+    console.log(`  moved in our favour:   ${correct}  (${hitRate}%)`);
+    console.log(`  avg signed move:       ${avgSignedBps} bps`);
+    console.log(
+      `  ↳ baseline ~50% means no edge; small samples (<50) are noise; gas + slippage`
+    );
+    console.log(`     would eat anything below ~10 bps on Uniswap mainnet.`);
+  }
+
+  console.log("\nReminders:");
+  console.log("  - This verifies the logic responds. It does NOT prove profitability.");
+  console.log("  - Binance signals ≠ Uniswap fills. Cross-venue + AMM curves differ.");
+  console.log("  - Real validation needs months of historical data + walk-forward.\n");
+}
+
+// ---- Run ------------------------------------------------------------------
+console.log(`Starting decision stream test for ${DURATION_MIN} minutes…`);
+console.log(`Streams: Binance depth + trade (ETHUSDT), Coinbase ticker (ETH-USD)`);
+console.log(`Evaluating every ${EVAL_INTERVAL_MS}ms. Press Ctrl-C to abort.\n`);
+
+connectBinanceDepth();
+connectBinanceTrades();
+connectCoinbase();
+
+const evalTimer = setInterval(evaluate, EVAL_INTERVAL_MS);
+const stopAt = Date.now() + DURATION_MIN * 60_000;
+const stopTimer = setInterval(() => {
+  if (Date.now() >= stopAt) {
+    clearInterval(evalTimer);
+    clearInterval(stopTimer);
+    printSummary();
+    process.exit(0);
+  }
+}, 1000);
+
+process.on("SIGINT", () => {
+  console.log("\n\nAborted by user. Printing partial summary…");
+  printSummary();
+  process.exit(0);
+});