bandkit 1.0.1 → 1.0.2

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/useGasPrice.d.ts

@@ -0,0 +1,18 @@
+export type GasTier = "low" | "normal" | "high" | "spike";
+export type UseGasPriceOptions = {
+    chainId?: number;
+    enabled?: boolean;
+    pollingIntervalMs?: number;
+    lowThresholdGwei?: number;
+    highThresholdGwei?: number;
+    spikeThresholdGwei?: number;
+};
+export type UseGasPriceResult = {
+    gwei: number | null;
+    gweiText: string;
+    tier: GasTier | "unknown";
+    isLoading: boolean;
+    error?: Error;
+};
+export declare function useGasPrice(options?: UseGasPriceOptions): UseGasPriceResult;
+//# sourceMappingURL=useGasPrice.d.ts.map

package/dist/useGasPrice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGasPrice.d.ts","sourceRoot":"","sources":["../src/useGasPrice.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CA4C/E"}

package/dist/useGasPrice.js

@@ -0,0 +1,44 @@
+import { useMemo } from "react";
+import { formatGwei } from "viem";
+import { useGasPrice as useWagmiGasPrice } from "wagmi";
+import { mainnet } from "wagmi/chains";
+export function useGasPrice(options = {}) {
+    const { chainId = mainnet.id, enabled = true, pollingIntervalMs = 12_000, lowThresholdGwei = 15, highThresholdGwei = 40, spikeThresholdGwei = 100 } = options;
+    const query = useWagmiGasPrice({
+        chainId,
+        query: {
+            enabled,
+            refetchInterval: pollingIntervalMs
+        }
+    });
+    return useMemo(() => {
+        if (query.data === undefined) {
+            return {
+                gwei: null,
+                gweiText: "—",
+                tier: "unknown",
+                isLoading: query.isLoading,
+                error: query.error ?? undefined
+            };
+        }
+        const gweiStr = formatGwei(query.data);
+        const gwei = Number(gweiStr);
+        let tier = "normal";
+        if (gwei <= lowThresholdGwei)
+            tier = "low";
+        else if (gwei >= spikeThresholdGwei)
+            tier = "spike";
+        else if (gwei >= highThresholdGwei)
+            tier = "high";
+        else
+            tier = "normal";
+        return {
+            gwei,
+            gweiText: `${gwei.toFixed(1)} gwei`,
+            tier,
+            isLoading: query.isLoading,
+            error: query.error ?? undefined
+        };
+    }, [highThresholdGwei, lowThresholdGwei, query.data, query.error, query.isLoading, spikeThresholdGwei]);
+}
+//# sourceMappingURL=useGasPrice.js.map

package/dist/useGasPrice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGasPrice.js","sourceRoot":"","sources":["../src/useGasPrice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAqBvC,MAAM,UAAU,WAAW,CAAC,UAA8B,EAAE;IAC1D,MAAM,EACJ,OAAO,GAAG,OAAO,CAAC,EAAE,EACpB,OAAO,GAAG,IAAI,EACd,iBAAiB,GAAG,MAAM,EAC1B,gBAAgB,GAAG,EAAE,EACrB,iBAAiB,GAAG,EAAE,EACtB,kBAAkB,GAAG,GAAG,EACzB,GAAG,OAAO,CAAC;IAEZ,MAAM,KAAK,GAAG,gBAAgB,CAAC;QAC7B,OAAO;QACP,KAAK,EAAE;YACL,OAAO;YACP,eAAe,EAAE,iBAAiB;SACnC;KACF,CAAC,CAAC;IAEH,OAAO,OAAO,CAAoB,GAAG,EAAE;QACrC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO;gBACL,IAAI,EAAE,IAAI;gBACV,QAAQ,EAAE,GAAG;gBACb,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,SAAS;aAChC,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,IAAI,GAAY,QAAQ,CAAC;QAC7B,IAAI,IAAI,IAAI,gBAAgB;YAAE,IAAI,GAAG,KAAK,CAAC;aACtC,IAAI,IAAI,IAAI,kBAAkB;YAAE,IAAI,GAAG,OAAO,CAAC;aAC/C,IAAI,IAAI,IAAI,iBAAiB;YAAE,IAAI,GAAG,MAAM,CAAC;;YAC7C,IAAI,GAAG,QAAQ,CAAC;QAErB,OAAO;YACL,IAAI;YACJ,QAAQ,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;YACnC,IAAI;YACJ,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,SAAS;SAChC,CAAC;IACJ,CAAC,EAAE,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAC1G,CAAC"}

package/dist/useStrategyContractEvents.d.ts

@@ -0,0 +1,23 @@
+import { type Address } from "viem";
+export type StrategyEventKind = "Deposited" | "Withdrawn" | "StrategyEngineActivated" | "StrategyEngineDeactivated";
+export type StrategyEvent = {
+    id: string;
+    kind: StrategyEventKind;
+    user: Address;
+    amountEth?: string;
+    blockNumber?: bigint;
+    transactionHash?: `0x${string}`;
+    timestamp: number;
+};
+export type UseStrategyContractEventsOptions = {
+    strategyContractAddress?: Address;
+    chainId?: number;
+    maxEvents?: number;
+    enabled?: boolean;
+};
+export type UseStrategyContractEventsResult = {
+    events: StrategyEvent[];
+    clear: () => void;
+};
+export declare function useStrategyContractEvents(options: UseStrategyContractEventsOptions): UseStrategyContractEventsResult;
+//# sourceMappingURL=useStrategyContractEvents.d.ts.map

package/dist/useStrategyContractEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStrategyContractEvents.d.ts","sourceRoot":"","sources":["../src/useStrategyContractEvents.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAIjD,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,WAAW,GACX,yBAAyB,GACzB,2BAA2B,CAAC;AAEhC,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAeF,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,+BAA+B,CA8EjC"}

package/dist/useStrategyContractEvents.js

@@ -0,0 +1,79 @@
+import { useCallback, useEffect, useState } from "react";
+import { formatEther } from "viem";
+import { useWatchContractEvent } from "wagmi";
+import { BAND_STRATEGY_ABI } from "./bandStrategyAbi.js";
+function makeId(log, fallback) {
+    return log.transactionHash && log.logIndex !== undefined
+        ? `${log.transactionHash}-${log.logIndex}`
+        : `local-${fallback}`;
+}
+export function useStrategyContractEvents(options) {
+    const { strategyContractAddress, chainId, maxEvents = 25, enabled = true } = options;
+    const [events, setEvents] = useState([]);
+    const handleEvent = useCallback((kind, logs) => {
+        setEvents((prev) => {
+            const now = Date.now();
+            const next = [];
+            logs.forEach((log, idx) => {
+                const event = {
+                    id: makeId(log, now + idx),
+                    kind,
+                    user: (log.args?.user ?? "0x0000000000000000000000000000000000000000"),
+                    amountEth: log.args?.amount !== undefined ? formatEther(log.args.amount) : undefined,
+                    blockNumber: log.blockNumber,
+                    transactionHash: log.transactionHash,
+                    timestamp: now
+                };
+                next.push(event);
+            });
+            const merged = [...next.reverse(), ...prev];
+            const dedupKeys = new Set();
+            const deduped = merged.filter((event) => {
+                if (dedupKeys.has(event.id))
+                    return false;
+                dedupKeys.add(event.id);
+                return true;
+            });
+            return deduped.slice(0, maxEvents);
+        });
+    }, [maxEvents]);
+    useWatchContractEvent({
+        abi: BAND_STRATEGY_ABI,
+        address: strategyContractAddress,
+        chainId,
+        eventName: "Deposited",
+        enabled: enabled && Boolean(strategyContractAddress),
+        onLogs: (logs) => handleEvent("Deposited", logs)
+    });
+    useWatchContractEvent({
+        abi: BAND_STRATEGY_ABI,
+        address: strategyContractAddress,
+        chainId,
+        eventName: "Withdrawn",
+        enabled: enabled && Boolean(strategyContractAddress),
+        onLogs: (logs) => handleEvent("Withdrawn", logs)
+    });
+    useWatchContractEvent({
+        abi: BAND_STRATEGY_ABI,
+        address: strategyContractAddress,
+        chainId,
+        eventName: "StrategyEngineActivated",
+        enabled: enabled && Boolean(strategyContractAddress),
+        onLogs: (logs) => handleEvent("StrategyEngineActivated", logs)
+    });
+    useWatchContractEvent({
+        abi: BAND_STRATEGY_ABI,
+        address: strategyContractAddress,
+        chainId,
+        eventName: "StrategyEngineDeactivated",
+        enabled: enabled && Boolean(strategyContractAddress),
+        onLogs: (logs) => handleEvent("StrategyEngineDeactivated", logs)
+    });
+    useEffect(() => {
+        if (!strategyContractAddress)
+            setEvents([]);
+    }, [strategyContractAddress]);
+    const clear = useCallback(() => setEvents([]), []);
+    return { events, clear };
+}
+//# sourceMappingURL=useStrategyContractEvents.js.map

package/dist/useStrategyContractEvents.js.map

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

package/dist/useVolatilityRegime.d.ts

@@ -0,0 +1,17 @@
+import { type UseEthPriceTickerOptions } from "./useEthPriceTicker.js";
+export type Regime = "RANGING" | "MIXED" | "TRENDING" | "UNKNOWN";
+export type UseVolatilityRegimeOptions = {
+    enabled?: boolean;
+    windowSize?: number;
+    rangingThresholdPct?: number;
+    trendingThresholdPct?: number;
+    ticker?: UseEthPriceTickerOptions;
+};
+export type UseVolatilityRegimeResult = {
+    regime: Regime;
+    stddevPct: number | null;
+    driftPct: number | null;
+    sampleCount: number;
+};
+export declare function useVolatilityRegime(options?: UseVolatilityRegimeOptions): UseVolatilityRegimeResult;
+//# sourceMappingURL=useVolatilityRegime.d.ts.map

package/dist/useVolatilityRegime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVolatilityRegime.d.ts","sourceRoot":"","sources":["../src/useVolatilityRegime.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAE1F,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAElE,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,yBAAyB,CAoDvG"}

package/dist/useVolatilityRegime.js

@@ -0,0 +1,48 @@
+import { useEffect, useMemo, useRef, useState } from "react";
+import { useEthPriceTicker } from "./useEthPriceTicker.js";
+export function useVolatilityRegime(options = {}) {
+    const { enabled = true, windowSize = 60, rangingThresholdPct = 0.15, trendingThresholdPct = 0.45, ticker } = options;
+    const ethTicker = useEthPriceTicker(ticker);
+    const samples = useRef([]);
+    const [tickCount, setTickCount] = useState(0);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        if (ethTicker.price === null)
+            return;
+        samples.current.push(ethTicker.price);
+        if (samples.current.length > windowSize)
+            samples.current.shift();
+        setTickCount((c) => c + 1);
+    }, [enabled, ethTicker.price, windowSize]);
+    return useMemo(() => {
+        void tickCount;
+        const data = samples.current;
+        if (data.length < Math.max(8, Math.floor(windowSize / 4))) {
+            return { regime: "UNKNOWN", stddevPct: null, driftPct: null, sampleCount: data.length };
+        }
+        const mean = data.reduce((sum, v) => sum + v, 0) / data.length;
+        const variance = data.reduce((sum, v) => sum + (v - mean) ** 2, 0) / data.length;
+        const stddev = Math.sqrt(variance);
+        const stddevPct = mean > 0 ? (stddev / mean) * 100 : null;
+        const drift = data[data.length - 1] - data[0];
+        const driftPct = mean > 0 ? (drift / mean) * 100 : null;
+        const absDriftPct = driftPct !== null ? Math.abs(driftPct) : null;
+        let regime = "MIXED";
+        if (stddevPct !== null && absDriftPct !== null) {
+            if (absDriftPct >= trendingThresholdPct)
+                regime = "TRENDING";
+            else if (stddevPct <= rangingThresholdPct && absDriftPct < trendingThresholdPct)
+                regime = "RANGING";
+            else
+                regime = "MIXED";
+        }
+        return {
+            regime,
+            stddevPct,
+            driftPct,
+            sampleCount: data.length
+        };
+    }, [rangingThresholdPct, tickCount, trendingThresholdPct, windowSize]);
+}
+//# sourceMappingURL=useVolatilityRegime.js.map

package/dist/useVolatilityRegime.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bandkit",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "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",