bandkit 1.0.1 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/README.md +222 -77
  2. package/dist/BandPanel.d.ts.map +1 -1
  3. package/dist/BandPanel.js +23 -2
  4. package/dist/BandPanel.js.map +1 -1
  5. package/dist/BotDecisionPanel.d.ts +7 -0
  6. package/dist/BotDecisionPanel.d.ts.map +1 -0
  7. package/dist/BotDecisionPanel.js +124 -0
  8. package/dist/BotDecisionPanel.js.map +1 -0
  9. package/dist/ContractEventFeed.d.ts +7 -0
  10. package/dist/ContractEventFeed.d.ts.map +1 -0
  11. package/dist/ContractEventFeed.js +76 -0
  12. package/dist/ContractEventFeed.js.map +1 -0
  13. package/dist/GasBadge.d.ts +6 -0
  14. package/dist/GasBadge.d.ts.map +1 -0
  15. package/dist/GasBadge.js +37 -0
  16. package/dist/GasBadge.js.map +1 -0
  17. package/dist/OrderBookWidget.d.ts +8 -0
  18. package/dist/OrderBookWidget.d.ts.map +1 -0
  19. package/dist/OrderBookWidget.js +92 -0
  20. package/dist/OrderBookWidget.js.map +1 -0
  21. package/dist/RegimeBadge.d.ts +6 -0
  22. package/dist/RegimeBadge.d.ts.map +1 -0
  23. package/dist/RegimeBadge.js +39 -0
  24. package/dist/RegimeBadge.js.map +1 -0
  25. package/dist/TradeTape.d.ts +8 -0
  26. package/dist/TradeTape.d.ts.map +1 -0
  27. package/dist/TradeTape.js +67 -0
  28. package/dist/TradeTape.js.map +1 -0
  29. package/dist/decisionEngine.d.ts +41 -0
  30. package/dist/decisionEngine.d.ts.map +1 -0
  31. package/dist/decisionEngine.js +166 -0
  32. package/dist/decisionEngine.js.map +1 -0
  33. package/dist/index.d.ts +14 -0
  34. package/dist/index.d.ts.map +1 -1
  35. package/dist/index.js +18 -0
  36. package/dist/index.js.map +1 -1
  37. package/dist/useBinanceOrderBook.d.ts +27 -0
  38. package/dist/useBinanceOrderBook.d.ts.map +1 -0
  39. package/dist/useBinanceOrderBook.js +95 -0
  40. package/dist/useBinanceOrderBook.js.map +1 -0
  41. package/dist/useBinanceTrades.d.ts +23 -0
  42. package/dist/useBinanceTrades.d.ts.map +1 -0
  43. package/dist/useBinanceTrades.js +77 -0
  44. package/dist/useBinanceTrades.js.map +1 -0
  45. package/dist/useBotDecision.d.ts +32 -0
  46. package/dist/useBotDecision.d.ts.map +1 -0
  47. package/dist/useBotDecision.js +104 -0
  48. package/dist/useBotDecision.js.map +1 -0
  49. package/dist/useCoinbaseTicker.d.ts +28 -0
  50. package/dist/useCoinbaseTicker.d.ts.map +1 -0
  51. package/dist/useCoinbaseTicker.js +87 -0
  52. package/dist/useCoinbaseTicker.js.map +1 -0
  53. package/dist/useGasPrice.d.ts +18 -0
  54. package/dist/useGasPrice.d.ts.map +1 -0
  55. package/dist/useGasPrice.js +44 -0
  56. package/dist/useGasPrice.js.map +1 -0
  57. package/dist/useStrategyContractEvents.d.ts +23 -0
  58. package/dist/useStrategyContractEvents.d.ts.map +1 -0
  59. package/dist/useStrategyContractEvents.js +79 -0
  60. package/dist/useStrategyContractEvents.js.map +1 -0
  61. package/dist/useVolatilityRegime.d.ts +17 -0
  62. package/dist/useVolatilityRegime.d.ts.map +1 -0
  63. package/dist/useVolatilityRegime.js +48 -0
  64. package/dist/useVolatilityRegime.js.map +1 -0
  65. package/package.json +4 -2
  66. package/scripts/test-decision-stream.cjs +417 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useBotDecision.js","sourceRoot":"","sources":["../src/useBotDecision.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ export type CoinbaseTickerStatus = "connecting" | "live" | "stale" | "error";
2
+ export type CoinbaseTickerMessage = {
3
+ type: string;
4
+ product_id: string;
5
+ price?: string;
6
+ best_bid?: string;
7
+ best_ask?: string;
8
+ side?: "buy" | "sell";
9
+ time?: string;
10
+ };
11
+ export type UseCoinbaseTickerOptions = {
12
+ enabled?: boolean;
13
+ productId?: string;
14
+ reconnectDelayMs?: number;
15
+ };
16
+ export type UseCoinbaseTickerResult = {
17
+ price: number | null;
18
+ bestBid: number | null;
19
+ bestAsk: number | null;
20
+ midPrice: number | null;
21
+ lastSide?: "buy" | "sell";
22
+ status: CoinbaseTickerStatus;
23
+ error?: string;
24
+ productId: string;
25
+ updatedAt?: Date;
26
+ };
27
+ export declare function useCoinbaseTicker(options?: UseCoinbaseTickerOptions): UseCoinbaseTickerResult;
28
+ //# sourceMappingURL=useCoinbaseTicker.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,87 @@
1
+ import { useEffect, useMemo, useState } from "react";
2
+ const DEFAULT_URL = "wss://ws-feed.exchange.coinbase.com";
3
+ export function useCoinbaseTicker(options = {}) {
4
+ const enabled = options.enabled ?? true;
5
+ const productId = options.productId ?? "ETH-USD";
6
+ const reconnectDelayMs = options.reconnectDelayMs ?? 3000;
7
+ const [message, setMessage] = useState();
8
+ const [status, setStatus] = useState("connecting");
9
+ const [error, setError] = useState();
10
+ const [updatedAt, setUpdatedAt] = useState();
11
+ useEffect(() => {
12
+ if (!enabled) {
13
+ setStatus("stale");
14
+ return;
15
+ }
16
+ if (typeof WebSocket === "undefined") {
17
+ setStatus("error");
18
+ setError("WebSocket is not available in this runtime.");
19
+ return;
20
+ }
21
+ let reconnectTimer;
22
+ let closedByHook = false;
23
+ let socket;
24
+ function connect() {
25
+ setStatus("connecting");
26
+ socket = new WebSocket(DEFAULT_URL);
27
+ socket.onopen = () => {
28
+ socket?.send(JSON.stringify({
29
+ type: "subscribe",
30
+ product_ids: [productId],
31
+ channels: ["ticker"]
32
+ }));
33
+ setStatus("live");
34
+ setError(undefined);
35
+ };
36
+ socket.onmessage = (event) => {
37
+ try {
38
+ const parsed = JSON.parse(String(event.data));
39
+ if (parsed.type === "ticker" && parsed.product_id === productId) {
40
+ setMessage(parsed);
41
+ setStatus("live");
42
+ setUpdatedAt(new Date());
43
+ }
44
+ }
45
+ catch {
46
+ setStatus("error");
47
+ setError("Could not parse Coinbase ticker message.");
48
+ }
49
+ };
50
+ socket.onerror = () => {
51
+ setStatus("error");
52
+ setError("Coinbase ticker connection failed.");
53
+ };
54
+ socket.onclose = () => {
55
+ if (closedByHook)
56
+ return;
57
+ setStatus("stale");
58
+ reconnectTimer = setTimeout(connect, reconnectDelayMs);
59
+ };
60
+ }
61
+ connect();
62
+ return () => {
63
+ closedByHook = true;
64
+ if (reconnectTimer)
65
+ clearTimeout(reconnectTimer);
66
+ socket?.close();
67
+ };
68
+ }, [enabled, productId, reconnectDelayMs]);
69
+ return useMemo(() => {
70
+ const price = message?.price ? Number(message.price) : null;
71
+ const bestBid = message?.best_bid ? Number(message.best_bid) : null;
72
+ const bestAsk = message?.best_ask ? Number(message.best_ask) : null;
73
+ const midPrice = bestBid !== null && bestAsk !== null ? (bestBid + bestAsk) / 2 : null;
74
+ return {
75
+ price: price !== null && Number.isFinite(price) ? price : null,
76
+ bestBid: bestBid !== null && Number.isFinite(bestBid) ? bestBid : null,
77
+ bestAsk: bestAsk !== null && Number.isFinite(bestAsk) ? bestAsk : null,
78
+ midPrice: midPrice !== null && Number.isFinite(midPrice) ? midPrice : null,
79
+ lastSide: message?.side,
80
+ status,
81
+ error,
82
+ productId,
83
+ updatedAt
84
+ };
85
+ }, [error, message, productId, status, updatedAt]);
86
+ }
87
+ //# sourceMappingURL=useCoinbaseTicker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useCoinbaseTicker.js","sourceRoot":"","sources":["../src/useCoinbaseTicker.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ export type GasTier = "low" | "normal" | "high" | "spike";
2
+ export type UseGasPriceOptions = {
3
+ chainId?: number;
4
+ enabled?: boolean;
5
+ pollingIntervalMs?: number;
6
+ lowThresholdGwei?: number;
7
+ highThresholdGwei?: number;
8
+ spikeThresholdGwei?: number;
9
+ };
10
+ export type UseGasPriceResult = {
11
+ gwei: number | null;
12
+ gweiText: string;
13
+ tier: GasTier | "unknown";
14
+ isLoading: boolean;
15
+ error?: Error;
16
+ };
17
+ export declare function useGasPrice(options?: UseGasPriceOptions): UseGasPriceResult;
18
+ //# sourceMappingURL=useGasPrice.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,44 @@
1
+ import { useMemo } from "react";
2
+ import { formatGwei } from "viem";
3
+ import { useGasPrice as useWagmiGasPrice } from "wagmi";
4
+ import { mainnet } from "wagmi/chains";
5
+ export function useGasPrice(options = {}) {
6
+ const { chainId = mainnet.id, enabled = true, pollingIntervalMs = 12_000, lowThresholdGwei = 15, highThresholdGwei = 40, spikeThresholdGwei = 100 } = options;
7
+ const query = useWagmiGasPrice({
8
+ chainId,
9
+ query: {
10
+ enabled,
11
+ refetchInterval: pollingIntervalMs
12
+ }
13
+ });
14
+ return useMemo(() => {
15
+ if (query.data === undefined) {
16
+ return {
17
+ gwei: null,
18
+ gweiText: "—",
19
+ tier: "unknown",
20
+ isLoading: query.isLoading,
21
+ error: query.error ?? undefined
22
+ };
23
+ }
24
+ const gweiStr = formatGwei(query.data);
25
+ const gwei = Number(gweiStr);
26
+ let tier = "normal";
27
+ if (gwei <= lowThresholdGwei)
28
+ tier = "low";
29
+ else if (gwei >= spikeThresholdGwei)
30
+ tier = "spike";
31
+ else if (gwei >= highThresholdGwei)
32
+ tier = "high";
33
+ else
34
+ tier = "normal";
35
+ return {
36
+ gwei,
37
+ gweiText: `${gwei.toFixed(1)} gwei`,
38
+ tier,
39
+ isLoading: query.isLoading,
40
+ error: query.error ?? undefined
41
+ };
42
+ }, [highThresholdGwei, lowThresholdGwei, query.data, query.error, query.isLoading, spikeThresholdGwei]);
43
+ }
44
+ //# sourceMappingURL=useGasPrice.js.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,23 @@
1
+ import { type Address } from "viem";
2
+ export type StrategyEventKind = "Deposited" | "Withdrawn" | "StrategyEngineActivated" | "StrategyEngineDeactivated";
3
+ export type StrategyEvent = {
4
+ id: string;
5
+ kind: StrategyEventKind;
6
+ user: Address;
7
+ amountEth?: string;
8
+ blockNumber?: bigint;
9
+ transactionHash?: `0x${string}`;
10
+ timestamp: number;
11
+ };
12
+ export type UseStrategyContractEventsOptions = {
13
+ strategyContractAddress?: Address;
14
+ chainId?: number;
15
+ maxEvents?: number;
16
+ enabled?: boolean;
17
+ };
18
+ export type UseStrategyContractEventsResult = {
19
+ events: StrategyEvent[];
20
+ clear: () => void;
21
+ };
22
+ export declare function useStrategyContractEvents(options: UseStrategyContractEventsOptions): UseStrategyContractEventsResult;
23
+ //# sourceMappingURL=useStrategyContractEvents.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,79 @@
1
+ import { useCallback, useEffect, useState } from "react";
2
+ import { formatEther } from "viem";
3
+ import { useWatchContractEvent } from "wagmi";
4
+ import { BAND_STRATEGY_ABI } from "./bandStrategyAbi.js";
5
+ function makeId(log, fallback) {
6
+ return log.transactionHash && log.logIndex !== undefined
7
+ ? `${log.transactionHash}-${log.logIndex}`
8
+ : `local-${fallback}`;
9
+ }
10
+ export function useStrategyContractEvents(options) {
11
+ const { strategyContractAddress, chainId, maxEvents = 25, enabled = true } = options;
12
+ const [events, setEvents] = useState([]);
13
+ const handleEvent = useCallback((kind, logs) => {
14
+ setEvents((prev) => {
15
+ const now = Date.now();
16
+ const next = [];
17
+ logs.forEach((log, idx) => {
18
+ const event = {
19
+ id: makeId(log, now + idx),
20
+ kind,
21
+ user: (log.args?.user ?? "0x0000000000000000000000000000000000000000"),
22
+ amountEth: log.args?.amount !== undefined ? formatEther(log.args.amount) : undefined,
23
+ blockNumber: log.blockNumber,
24
+ transactionHash: log.transactionHash,
25
+ timestamp: now
26
+ };
27
+ next.push(event);
28
+ });
29
+ const merged = [...next.reverse(), ...prev];
30
+ const dedupKeys = new Set();
31
+ const deduped = merged.filter((event) => {
32
+ if (dedupKeys.has(event.id))
33
+ return false;
34
+ dedupKeys.add(event.id);
35
+ return true;
36
+ });
37
+ return deduped.slice(0, maxEvents);
38
+ });
39
+ }, [maxEvents]);
40
+ useWatchContractEvent({
41
+ abi: BAND_STRATEGY_ABI,
42
+ address: strategyContractAddress,
43
+ chainId,
44
+ eventName: "Deposited",
45
+ enabled: enabled && Boolean(strategyContractAddress),
46
+ onLogs: (logs) => handleEvent("Deposited", logs)
47
+ });
48
+ useWatchContractEvent({
49
+ abi: BAND_STRATEGY_ABI,
50
+ address: strategyContractAddress,
51
+ chainId,
52
+ eventName: "Withdrawn",
53
+ enabled: enabled && Boolean(strategyContractAddress),
54
+ onLogs: (logs) => handleEvent("Withdrawn", logs)
55
+ });
56
+ useWatchContractEvent({
57
+ abi: BAND_STRATEGY_ABI,
58
+ address: strategyContractAddress,
59
+ chainId,
60
+ eventName: "StrategyEngineActivated",
61
+ enabled: enabled && Boolean(strategyContractAddress),
62
+ onLogs: (logs) => handleEvent("StrategyEngineActivated", logs)
63
+ });
64
+ useWatchContractEvent({
65
+ abi: BAND_STRATEGY_ABI,
66
+ address: strategyContractAddress,
67
+ chainId,
68
+ eventName: "StrategyEngineDeactivated",
69
+ enabled: enabled && Boolean(strategyContractAddress),
70
+ onLogs: (logs) => handleEvent("StrategyEngineDeactivated", logs)
71
+ });
72
+ useEffect(() => {
73
+ if (!strategyContractAddress)
74
+ setEvents([]);
75
+ }, [strategyContractAddress]);
76
+ const clear = useCallback(() => setEvents([]), []);
77
+ return { events, clear };
78
+ }
79
+ //# sourceMappingURL=useStrategyContractEvents.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useStrategyContractEvents.js","sourceRoot":"","sources":["../src/useStrategyContractEvents.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ import { type UseEthPriceTickerOptions } from "./useEthPriceTicker.js";
2
+ export type Regime = "RANGING" | "MIXED" | "TRENDING" | "UNKNOWN";
3
+ export type UseVolatilityRegimeOptions = {
4
+ enabled?: boolean;
5
+ windowSize?: number;
6
+ rangingThresholdPct?: number;
7
+ trendingThresholdPct?: number;
8
+ ticker?: UseEthPriceTickerOptions;
9
+ };
10
+ export type UseVolatilityRegimeResult = {
11
+ regime: Regime;
12
+ stddevPct: number | null;
13
+ driftPct: number | null;
14
+ sampleCount: number;
15
+ };
16
+ export declare function useVolatilityRegime(options?: UseVolatilityRegimeOptions): UseVolatilityRegimeResult;
17
+ //# sourceMappingURL=useVolatilityRegime.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,48 @@
1
+ import { useEffect, useMemo, useRef, useState } from "react";
2
+ import { useEthPriceTicker } from "./useEthPriceTicker.js";
3
+ export function useVolatilityRegime(options = {}) {
4
+ const { enabled = true, windowSize = 60, rangingThresholdPct = 0.15, trendingThresholdPct = 0.45, ticker } = options;
5
+ const ethTicker = useEthPriceTicker(ticker);
6
+ const samples = useRef([]);
7
+ const [tickCount, setTickCount] = useState(0);
8
+ useEffect(() => {
9
+ if (!enabled)
10
+ return;
11
+ if (ethTicker.price === null)
12
+ return;
13
+ samples.current.push(ethTicker.price);
14
+ if (samples.current.length > windowSize)
15
+ samples.current.shift();
16
+ setTickCount((c) => c + 1);
17
+ }, [enabled, ethTicker.price, windowSize]);
18
+ return useMemo(() => {
19
+ void tickCount;
20
+ const data = samples.current;
21
+ if (data.length < Math.max(8, Math.floor(windowSize / 4))) {
22
+ return { regime: "UNKNOWN", stddevPct: null, driftPct: null, sampleCount: data.length };
23
+ }
24
+ const mean = data.reduce((sum, v) => sum + v, 0) / data.length;
25
+ const variance = data.reduce((sum, v) => sum + (v - mean) ** 2, 0) / data.length;
26
+ const stddev = Math.sqrt(variance);
27
+ const stddevPct = mean > 0 ? (stddev / mean) * 100 : null;
28
+ const drift = data[data.length - 1] - data[0];
29
+ const driftPct = mean > 0 ? (drift / mean) * 100 : null;
30
+ const absDriftPct = driftPct !== null ? Math.abs(driftPct) : null;
31
+ let regime = "MIXED";
32
+ if (stddevPct !== null && absDriftPct !== null) {
33
+ if (absDriftPct >= trendingThresholdPct)
34
+ regime = "TRENDING";
35
+ else if (stddevPct <= rangingThresholdPct && absDriftPct < trendingThresholdPct)
36
+ regime = "RANGING";
37
+ else
38
+ regime = "MIXED";
39
+ }
40
+ return {
41
+ regime,
42
+ stddevPct,
43
+ driftPct,
44
+ sampleCount: data.length
45
+ };
46
+ }, [rangingThresholdPct, tickCount, trendingThresholdPct, windowSize]);
47
+ }
48
+ //# sourceMappingURL=useVolatilityRegime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useVolatilityRegime.js","sourceRoot":"","sources":["../src/useVolatilityRegime.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bandkit",
3
- "version": "1.0.1",
3
+ "version": "1.0.3",
4
4
  "description": "Open-source scaffolding for Ethereum range-bound trading strategies: strategy contract deployment, restricted executor, and React hooks. Strategy logic is not included.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -63,6 +63,7 @@
63
63
  "@tanstack/react-query": "^5.0.0",
64
64
  "@types/node": "^22.0.0",
65
65
  "@types/react": "^19.0.0",
66
+ "@types/ws": "^8.18.1",
66
67
  "chai": "^6.2.2",
67
68
  "dotenv": "^16.4.7",
68
69
  "fp-ts": "^2.16.11",
@@ -73,7 +74,8 @@
73
74
  "ts-node": "^10.9.2",
74
75
  "typescript": "^5.7.0",
75
76
  "viem": "^2.0.0",
76
- "wagmi": "^2.0.0"
77
+ "wagmi": "^2.0.0",
78
+ "ws": "^8.21.0"
77
79
  },
78
80
  "keywords": [
79
81
  "ethereum",