@metamask-previews/perps-controller 0.0.0-preview-685dbf46b → 1.0.0-preview-bc00f2c

package/dist/utils/hyperLiquidOrderBookProcessor.d.cts

@@ -0,0 +1,55 @@
+import type { BboWsEvent, L2BookResponse } from "@nktkas/hyperliquid";
+import type { PriceUpdate } from "../types/index.cjs";
+/**
+ * HyperLiquid Order Book Processor
+ *
+ * Utility functions for processing Level 2 order book data from HyperLiquid WebSocket.
+ * Extracts best bid/ask prices, calculates spreads, and updates caches.
+ */
+/**
+ * Order book cache entry structure
+ */
+export type OrderBookCacheEntry = {
+    bestBid?: string;
+    bestAsk?: string;
+    spread?: string;
+    lastUpdated: number;
+};
+/**
+ * Parameters for processing L2 book data
+ */
+export type ProcessL2BookDataParams = {
+    symbol: string;
+    data: L2BookResponse;
+    orderBookCache: Map<string, OrderBookCacheEntry>;
+    cachedPriceData: Map<string, PriceUpdate> | null;
+    createPriceUpdate: (symbol: string, price: string) => PriceUpdate;
+    notifySubscribers: () => void;
+};
+export type ProcessBboDataParams = {
+    symbol: string;
+    data: BboWsEvent;
+    orderBookCache: Map<string, OrderBookCacheEntry>;
+    cachedPriceData: Map<string, PriceUpdate> | null;
+    createPriceUpdate: (symbol: string, price: string) => PriceUpdate;
+    notifySubscribers: () => void;
+};
+/**
+ * Process Level 2 order book data and update caches
+ *
+ * Extracts best bid/ask prices from order book levels, calculates spread,
+ * and updates the order book cache and price data cache.
+ *
+ * @param params - Processing parameters
+ */
+export declare function processL2BookData(params: ProcessL2BookDataParams): void;
+/**
+ * Process BBO (best bid/offer) data and update caches
+ *
+ * BBO is lightweight and independent from L2Book aggregation parameters,
+ * making it ideal for spread / top-of-book display.
+ *
+ * @param params - The BBO processing parameters including symbol, data, and caches.
+ */
+export declare function processBboData(params: ProcessBboDataParams): void;
+//# sourceMappingURL=hyperLiquidOrderBookProcessor.d.cts.map

package/dist/utils/hyperLiquidOrderBookProcessor.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperLiquidOrderBookProcessor.d.cts","sourceRoot":"","sources":["../../src/utils/hyperLiquidOrderBookProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,4BAA4B;AAEtE,OAAO,KAAK,EAAE,WAAW,EAAE,2BAAiB;AAE5C;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACjD,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC;IACjD,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,WAAW,CAAC;IAClE,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACjD,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC;IACjD,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,WAAW,CAAC;IAClE,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAgDvE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAyCjE"}

package/dist/utils/hyperLiquidOrderBookProcessor.d.mts

@@ -0,0 +1,55 @@
+import type { BboWsEvent, L2BookResponse } from "@nktkas/hyperliquid";
+import type { PriceUpdate } from "../types/index.mjs";
+/**
+ * HyperLiquid Order Book Processor
+ *
+ * Utility functions for processing Level 2 order book data from HyperLiquid WebSocket.
+ * Extracts best bid/ask prices, calculates spreads, and updates caches.
+ */
+/**
+ * Order book cache entry structure
+ */
+export type OrderBookCacheEntry = {
+    bestBid?: string;
+    bestAsk?: string;
+    spread?: string;
+    lastUpdated: number;
+};
+/**
+ * Parameters for processing L2 book data
+ */
+export type ProcessL2BookDataParams = {
+    symbol: string;
+    data: L2BookResponse;
+    orderBookCache: Map<string, OrderBookCacheEntry>;
+    cachedPriceData: Map<string, PriceUpdate> | null;
+    createPriceUpdate: (symbol: string, price: string) => PriceUpdate;
+    notifySubscribers: () => void;
+};
+export type ProcessBboDataParams = {
+    symbol: string;
+    data: BboWsEvent;
+    orderBookCache: Map<string, OrderBookCacheEntry>;
+    cachedPriceData: Map<string, PriceUpdate> | null;
+    createPriceUpdate: (symbol: string, price: string) => PriceUpdate;
+    notifySubscribers: () => void;
+};
+/**
+ * Process Level 2 order book data and update caches
+ *
+ * Extracts best bid/ask prices from order book levels, calculates spread,
+ * and updates the order book cache and price data cache.
+ *
+ * @param params - Processing parameters
+ */
+export declare function processL2BookData(params: ProcessL2BookDataParams): void;
+/**
+ * Process BBO (best bid/offer) data and update caches
+ *
+ * BBO is lightweight and independent from L2Book aggregation parameters,
+ * making it ideal for spread / top-of-book display.
+ *
+ * @param params - The BBO processing parameters including symbol, data, and caches.
+ */
+export declare function processBboData(params: ProcessBboDataParams): void;
+//# sourceMappingURL=hyperLiquidOrderBookProcessor.d.mts.map

package/dist/utils/hyperLiquidOrderBookProcessor.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperLiquidOrderBookProcessor.d.mts","sourceRoot":"","sources":["../../src/utils/hyperLiquidOrderBookProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,4BAA4B;AAEtE,OAAO,KAAK,EAAE,WAAW,EAAE,2BAAiB;AAE5C;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACjD,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC;IACjD,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,WAAW,CAAC;IAClE,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACjD,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC;IACjD,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,WAAW,CAAC;IAClE,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAgDvE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAyCjE"}

package/dist/utils/hyperLiquidOrderBookProcessor.mjs

@@ -0,0 +1,78 @@
+/**
+ * Process Level 2 order book data and update caches
+ *
+ * Extracts best bid/ask prices from order book levels, calculates spread,
+ * and updates the order book cache and price data cache.
+ *
+ * @param params - Processing parameters
+ */
+export function processL2BookData(params) {
+    const { symbol, data, orderBookCache, cachedPriceData, createPriceUpdate, notifySubscribers, } = params;
+    if (data?.coin !== symbol || !data?.levels) {
+        return;
+    }
+    // Extract best bid and ask from order book
+    const bestBid = data.levels[0]?.[0]; // First bid level
+    const bestAsk = data.levels[1]?.[0]; // First ask level
+    if (!bestBid && !bestAsk) {
+        return;
+    }
+    const bidPrice = bestBid ? parseFloat(bestBid.px) : 0;
+    const askPrice = bestAsk ? parseFloat(bestAsk.px) : 0;
+    const spread = bidPrice > 0 && askPrice > 0 ? (askPrice - bidPrice).toFixed(5) : undefined;
+    // Update order book cache
+    orderBookCache.set(symbol, {
+        bestBid: bestBid?.px,
+        bestAsk: bestAsk?.px,
+        spread,
+        lastUpdated: Date.now(),
+    });
+    // Update cached price data with new order book data
+    const currentCachedPrice = cachedPriceData?.get(symbol);
+    if (!currentCachedPrice) {
+        return;
+    }
+    const updatedPrice = createPriceUpdate(symbol, currentCachedPrice.price);
+    // Ensure cache exists before setting
+    if (cachedPriceData) {
+        cachedPriceData.set(symbol, updatedPrice);
+        notifySubscribers();
+    }
+}
+/**
+ * Process BBO (best bid/offer) data and update caches
+ *
+ * BBO is lightweight and independent from L2Book aggregation parameters,
+ * making it ideal for spread / top-of-book display.
+ *
+ * @param params - The BBO processing parameters including symbol, data, and caches.
+ */
+export function processBboData(params) {
+    const { symbol, data, orderBookCache, cachedPriceData, createPriceUpdate, notifySubscribers, } = params;
+    if (data?.coin !== symbol || !Array.isArray(data?.bbo)) {
+        return;
+    }
+    const [bestBid, bestAsk] = data.bbo;
+    if (!bestBid && !bestAsk) {
+        return;
+    }
+    const bidPrice = bestBid ? parseFloat(bestBid.px) : 0;
+    const askPrice = bestAsk ? parseFloat(bestAsk.px) : 0;
+    const spread = bidPrice > 0 && askPrice > 0 ? (askPrice - bidPrice).toFixed(5) : undefined;
+    orderBookCache.set(symbol, {
+        bestBid: bestBid?.px,
+        bestAsk: bestAsk?.px,
+        spread,
+        lastUpdated: Date.now(),
+    });
+    const currentCachedPrice = cachedPriceData?.get(symbol);
+    if (!currentCachedPrice) {
+        return;
+    }
+    const updatedPrice = createPriceUpdate(symbol, currentCachedPrice.price);
+    if (cachedPriceData) {
+        cachedPriceData.set(symbol, updatedPrice);
+        notifySubscribers();
+    }
+}
+//# sourceMappingURL=hyperLiquidOrderBookProcessor.mjs.map

package/dist/utils/hyperLiquidOrderBookProcessor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperLiquidOrderBookProcessor.mjs","sourceRoot":"","sources":["../../src/utils/hyperLiquidOrderBookProcessor.ts"],"names":[],"mappings":"AA0CA;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA+B;IAC/D,MAAM,EACJ,MAAM,EACN,IAAI,EACJ,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAClB,GAAG,MAAM,CAAC;IAEX,IAAI,IAAI,EAAE,IAAI,KAAK,MAAM,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAC3C,OAAO;IACT,CAAC;IAED,2CAA2C;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB;IAEvD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,MAAM,GACV,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9E,0BAA0B;IAC1B,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE;QACzB,OAAO,EAAE,OAAO,EAAE,EAAE;QACpB,OAAO,EAAE,OAAO,EAAE,EAAE;QACpB,MAAM;QACN,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;KACxB,CAAC,CAAC;IAEH,oDAAoD;IACpD,MAAM,kBAAkB,GAAG,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAEzE,qCAAqC;IACrC,IAAI,eAAe,EAAE,CAAC;QACpB,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC1C,iBAAiB,EAAE,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,MAA4B;IACzD,MAAM,EACJ,MAAM,EACN,IAAI,EACJ,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAClB,GAAG,MAAM,CAAC;IAEX,IAAI,IAAI,EAAE,IAAI,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO;IACT,CAAC;IAED,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;IACpC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,MAAM,GACV,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9E,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE;QACzB,OAAO,EAAE,OAAO,EAAE,EAAE;QACpB,OAAO,EAAE,OAAO,EAAE,EAAE;QACpB,MAAM;QACN,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;KACxB,CAAC,CAAC;IAEH,MAAM,kBAAkB,GAAG,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACzE,IAAI,eAAe,EAAE,CAAC;QACpB,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC1C,iBAAiB,EAAE,CAAC;IACtB,CAAC;AACH,CAAC","sourcesContent":["import type { BboWsEvent, L2BookResponse } from '@nktkas/hyperliquid';\n\nimport type { PriceUpdate } from '../types';\n\n/**\n * HyperLiquid Order Book Processor\n *\n * Utility functions for processing Level 2 order book data from HyperLiquid WebSocket.\n * Extracts best bid/ask prices, calculates spreads, and updates caches.\n */\n\n/**\n * Order book cache entry structure\n */\nexport type OrderBookCacheEntry = {\n  bestBid?: string;\n  bestAsk?: string;\n  spread?: string;\n  lastUpdated: number;\n};\n\n/**\n * Parameters for processing L2 book data\n */\nexport type ProcessL2BookDataParams = {\n  symbol: string;\n  data: L2BookResponse;\n  orderBookCache: Map<string, OrderBookCacheEntry>;\n  cachedPriceData: Map<string, PriceUpdate> | null;\n  createPriceUpdate: (symbol: string, price: string) => PriceUpdate;\n  notifySubscribers: () => void;\n};\n\nexport type ProcessBboDataParams = {\n  symbol: string;\n  data: BboWsEvent;\n  orderBookCache: Map<string, OrderBookCacheEntry>;\n  cachedPriceData: Map<string, PriceUpdate> | null;\n  createPriceUpdate: (symbol: string, price: string) => PriceUpdate;\n  notifySubscribers: () => void;\n};\n\n/**\n * Process Level 2 order book data and update caches\n *\n * Extracts best bid/ask prices from order book levels, calculates spread,\n * and updates the order book cache and price data cache.\n *\n * @param params - Processing parameters\n */\nexport function processL2BookData(params: ProcessL2BookDataParams): void {\n  const {\n    symbol,\n    data,\n    orderBookCache,\n    cachedPriceData,\n    createPriceUpdate,\n    notifySubscribers,\n  } = params;\n\n  if (data?.coin !== symbol || !data?.levels) {\n    return;\n  }\n\n  // Extract best bid and ask from order book\n  const bestBid = data.levels[0]?.[0]; // First bid level\n  const bestAsk = data.levels[1]?.[0]; // First ask level\n\n  if (!bestBid && !bestAsk) {\n    return;\n  }\n\n  const bidPrice = bestBid ? parseFloat(bestBid.px) : 0;\n  const askPrice = bestAsk ? parseFloat(bestAsk.px) : 0;\n  const spread =\n    bidPrice > 0 && askPrice > 0 ? (askPrice - bidPrice).toFixed(5) : undefined;\n\n  // Update order book cache\n  orderBookCache.set(symbol, {\n    bestBid: bestBid?.px,\n    bestAsk: bestAsk?.px,\n    spread,\n    lastUpdated: Date.now(),\n  });\n\n  // Update cached price data with new order book data\n  const currentCachedPrice = cachedPriceData?.get(symbol);\n  if (!currentCachedPrice) {\n    return;\n  }\n\n  const updatedPrice = createPriceUpdate(symbol, currentCachedPrice.price);\n\n  // Ensure cache exists before setting\n  if (cachedPriceData) {\n    cachedPriceData.set(symbol, updatedPrice);\n    notifySubscribers();\n  }\n}\n\n/**\n * Process BBO (best bid/offer) data and update caches\n *\n * BBO is lightweight and independent from L2Book aggregation parameters,\n * making it ideal for spread / top-of-book display.\n *\n * @param params - The BBO processing parameters including symbol, data, and caches.\n */\nexport function processBboData(params: ProcessBboDataParams): void {\n  const {\n    symbol,\n    data,\n    orderBookCache,\n    cachedPriceData,\n    createPriceUpdate,\n    notifySubscribers,\n  } = params;\n\n  if (data?.coin !== symbol || !Array.isArray(data?.bbo)) {\n    return;\n  }\n\n  const [bestBid, bestAsk] = data.bbo;\n  if (!bestBid && !bestAsk) {\n    return;\n  }\n\n  const bidPrice = bestBid ? parseFloat(bestBid.px) : 0;\n  const askPrice = bestAsk ? parseFloat(bestAsk.px) : 0;\n  const spread =\n    bidPrice > 0 && askPrice > 0 ? (askPrice - bidPrice).toFixed(5) : undefined;\n\n  orderBookCache.set(symbol, {\n    bestBid: bestBid?.px,\n    bestAsk: bestAsk?.px,\n    spread,\n    lastUpdated: Date.now(),\n  });\n\n  const currentCachedPrice = cachedPriceData?.get(symbol);\n  if (!currentCachedPrice) {\n    return;\n  }\n\n  const updatedPrice = createPriceUpdate(symbol, currentCachedPrice.price);\n  if (cachedPriceData) {\n    cachedPriceData.set(symbol, updatedPrice);\n    notifySubscribers();\n  }\n}\n"]}

package/dist/utils/hyperLiquidValidation.cjs

@@ -0,0 +1,426 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateCoinExists = exports.validateOrderParams = exports.getMaxOrderValue = exports.getSupportedPaths = exports.applyPathFilters = exports.validateBalance = exports.validateAssetSupport = exports.validateDepositParams = exports.validateWithdrawalParams = exports.createErrorResult = void 0;
+const utils_1 = require("@metamask/utils");
+const hyperLiquidConfig_1 = require("../constants/hyperLiquidConfig.cjs");
+const perpsConfig_1 = require("../constants/perpsConfig.cjs");
+const perpsErrorCodes_1 = require("../perpsErrorCodes.cjs");
+/**
+ * Validation utilities for HyperLiquid operations
+ */
+/**
+ * Create standardized error response.
+ *
+ * @param error - The error that occurred
+ * @param defaultResponse - The default response object to use as template
+ * @returns The error response with success=false and error message
+ */
+function createErrorResult(error, defaultResponse) {
+    return {
+        ...defaultResponse,
+        success: false,
+        error: error instanceof Error ? error.message : perpsErrorCodes_1.PERPS_ERROR_CODES.UNKNOWN_ERROR,
+    };
+}
+exports.createErrorResult = createErrorResult;
+/**
+ * Validate withdrawal parameters.
+ *
+ * @param params - Withdrawal parameters to validate
+ * @param params.assetId - The CAIP asset ID to withdraw
+ * @param params.amount - Amount to withdraw as string
+ * @param params.destination - Optional destination hex address
+ * @param debugLogger - Optional debug logger for detailed logging
+ * @returns Validation result with isValid flag and optional error message
+ */
+function validateWithdrawalParams(params, debugLogger) {
+    debugLogger?.log('validateWithdrawalParams: Starting validation', {
+        params,
+        hasAssetId: Boolean(params.assetId),
+        hasAmount: Boolean(params.amount),
+        hasDestination: Boolean(params.destination),
+    });
+    // Validate required parameters
+    if (!params.assetId) {
+        debugLogger?.log('validateWithdrawalParams: Missing assetId', {
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.WITHDRAW_ASSET_ID_REQUIRED,
+            params,
+        });
+        return {
+            isValid: false,
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.WITHDRAW_ASSET_ID_REQUIRED,
+        };
+    }
+    // Validate amount
+    if (!params.amount) {
+        debugLogger?.log('validateWithdrawalParams: Missing amount', {
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.WITHDRAW_AMOUNT_REQUIRED,
+            params,
+        });
+        return {
+            isValid: false,
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.WITHDRAW_AMOUNT_REQUIRED,
+        };
+    }
+    const amount = parseFloat(params.amount);
+    if (isNaN(amount) || amount <= 0) {
+        debugLogger?.log('validateWithdrawalParams: Invalid amount', {
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.WITHDRAW_AMOUNT_POSITIVE,
+            amount: params.amount,
+            parsedAmount: amount,
+            isNaN: isNaN(amount),
+        });
+        return {
+            isValid: false,
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.WITHDRAW_AMOUNT_POSITIVE,
+        };
+    }
+    // Validate destination address if provided
+    if (params.destination && !(0, utils_1.isValidHexAddress)(params.destination)) {
+        debugLogger?.log('validateWithdrawalParams: Invalid destination address', {
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.WITHDRAW_INVALID_DESTINATION,
+            destination: params.destination,
+            isValidHex: (0, utils_1.isValidHexAddress)(params.destination),
+        });
+        return {
+            isValid: false,
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.WITHDRAW_INVALID_DESTINATION,
+        };
+    }
+    debugLogger?.log('validateWithdrawalParams: All validations passed', {
+        assetId: params.assetId,
+        amount: params.amount,
+        destination: params.destination ?? 'will use user wallet',
+    });
+    return { isValid: true };
+}
+exports.validateWithdrawalParams = validateWithdrawalParams;
+/**
+ * Validate deposit parameters.
+ *
+ * @param params - Deposit parameters to validate
+ * @param params.assetId - The CAIP asset ID to deposit
+ * @param params.amount - Amount to deposit as string
+ * @param params.isTestnet - Whether this is a testnet deposit
+ * @param debugLogger - Optional debug logger for detailed logging
+ * @returns Validation result with isValid flag and optional error message
+ */
+function validateDepositParams(params, debugLogger) {
+    debugLogger?.log('validateDepositParams: Starting validation', {
+        params,
+        hasAssetId: Boolean(params.assetId),
+        hasAmount: Boolean(params.amount),
+        isTestnet: params.isTestnet,
+    });
+    // Validate required parameters
+    if (!params.assetId) {
+        debugLogger?.log('validateDepositParams: Missing assetId', {
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.DEPOSIT_ASSET_ID_REQUIRED,
+            params,
+        });
+        return {
+            isValid: false,
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.DEPOSIT_ASSET_ID_REQUIRED,
+        };
+    }
+    // Validate amount
+    if (!params.amount) {
+        debugLogger?.log('validateDepositParams: Missing amount', {
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.DEPOSIT_AMOUNT_REQUIRED,
+            params,
+        });
+        return {
+            isValid: false,
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.DEPOSIT_AMOUNT_REQUIRED,
+        };
+    }
+    const amount = parseFloat(params.amount);
+    if (isNaN(amount) || amount <= 0) {
+        debugLogger?.log('validateDepositParams: Invalid amount', {
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.DEPOSIT_AMOUNT_POSITIVE,
+            amount: params.amount,
+            parsedAmount: amount,
+            isNaN: isNaN(amount),
+        });
+        return {
+            isValid: false,
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.DEPOSIT_AMOUNT_POSITIVE,
+        };
+    }
+    // Check minimum deposit amount
+    const minimumAmount = params.isTestnet
+        ? hyperLiquidConfig_1.TRADING_DEFAULTS.amount.testnet
+        : hyperLiquidConfig_1.TRADING_DEFAULTS.amount.mainnet;
+    debugLogger?.log('validateDepositParams: Checking minimum amount', {
+        amount,
+        minimumAmount,
+        isTestnet: params.isTestnet,
+        network: params.isTestnet ? 'testnet' : 'mainnet',
+    });
+    if (amount < minimumAmount) {
+        debugLogger?.log('validateDepositParams: Below minimum deposit', {
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.DEPOSIT_MINIMUM_AMOUNT,
+            amount,
+            minimumAmount,
+            difference: minimumAmount - amount,
+        });
+        return {
+            isValid: false,
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.DEPOSIT_MINIMUM_AMOUNT,
+        };
+    }
+    debugLogger?.log('validateDepositParams: All validations passed', {
+        assetId: params.assetId,
+        amount: params.amount,
+        parsedAmount: amount,
+        minimumAmount,
+        isTestnet: params.isTestnet,
+    });
+    return { isValid: true };
+}
+exports.validateDepositParams = validateDepositParams;
+/**
+ * Validate asset support for withdrawals using AssetRoute arrays.
+ *
+ * @param assetId - The CAIP asset ID to validate
+ * @param supportedRoutes - Array of supported asset routes
+ * @param debugLogger - Optional debug logger for detailed logging
+ * @returns Validation result with isValid flag and optional error message
+ */
+function validateAssetSupport(assetId, supportedRoutes, debugLogger) {
+    debugLogger?.log('validateAssetSupport: Checking asset support', {
+        assetId,
+        supportedRoutesCount: supportedRoutes.length,
+    });
+    const supportedAssetIds = supportedRoutes.map((route) => route.assetId);
+    // Check if asset is supported
+    const isSupported = supportedAssetIds.includes(assetId);
+    if (!isSupported) {
+        // Also check case-insensitive match for contract addresses
+        const isSupportedCaseInsensitive = supportedAssetIds.some((supportedId) => supportedId.toLowerCase() === assetId.toLowerCase());
+        if (!isSupportedCaseInsensitive) {
+            debugLogger?.log('validateAssetSupport: Asset not supported', {
+                error: perpsErrorCodes_1.PERPS_ERROR_CODES.WITHDRAW_ASSET_NOT_SUPPORTED,
+                assetId,
+                supportedAssetIds,
+                checkedCaseInsensitive: true,
+            });
+            return {
+                isValid: false,
+                error: perpsErrorCodes_1.PERPS_ERROR_CODES.WITHDRAW_ASSET_NOT_SUPPORTED,
+            };
+        }
+        debugLogger?.log('⚠️ validateAssetSupport: Asset supported with case mismatch', {
+            providedAssetId: assetId,
+            matchedAssetId: supportedAssetIds.find((id) => id.toLowerCase() === assetId.toLowerCase()),
+        });
+    }
+    debugLogger?.log('validateAssetSupport: Asset is supported', {
+        assetId,
+    });
+    return { isValid: true };
+}
+exports.validateAssetSupport = validateAssetSupport;
+/**
+ * Validate balance against withdrawal amount.
+ *
+ * @param withdrawAmount - The amount to withdraw
+ * @param availableBalance - The available balance
+ * @param debugLogger - Optional debug logger for detailed logging
+ * @returns Validation result with isValid flag and optional error message
+ */
+function validateBalance(withdrawAmount, availableBalance, debugLogger) {
+    debugLogger?.log('validateBalance: Checking balance sufficiency', {
+        withdrawAmount,
+        availableBalance,
+        difference: availableBalance - withdrawAmount,
+    });
+    if (withdrawAmount > availableBalance) {
+        const shortfall = withdrawAmount - availableBalance;
+        debugLogger?.log('validateBalance: Insufficient balance', {
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.WITHDRAW_INSUFFICIENT_BALANCE,
+            withdrawAmount,
+            availableBalance,
+            shortfall,
+            percentageOfAvailable: `${((withdrawAmount / availableBalance) * 100).toFixed(2)}%`,
+        });
+        return {
+            isValid: false,
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.WITHDRAW_INSUFFICIENT_BALANCE,
+        };
+    }
+    const remainingBalance = availableBalance - withdrawAmount;
+    debugLogger?.log('validateBalance: Balance is sufficient', {
+        withdrawAmount,
+        availableBalance,
+        remainingBalance,
+        percentageUsed: `${((withdrawAmount / availableBalance) * 100).toFixed(2)}%`,
+    });
+    return { isValid: true };
+}
+exports.validateBalance = validateBalance;
+/**
+ * Apply filters to asset paths with comprehensive logging.
+ *
+ * @param assets - Array of CAIP asset IDs to filter
+ * @param params - Filter parameters including chainId, symbol, and assetId
+ * @param debugLogger - Optional debug logger for detailed logging
+ * @returns Filtered array of CAIP asset IDs
+ */
+function applyPathFilters(assets, params, debugLogger) {
+    if (!params) {
+        debugLogger?.log('HyperLiquid: applyPathFilters - no params, returning all assets', { assets });
+        return assets;
+    }
+    let filtered = assets;
+    debugLogger?.log('HyperLiquid: applyPathFilters - starting filter', {
+        initialAssets: assets,
+        filterParams: params,
+    });
+    if (params.chainId) {
+        const before = filtered;
+        filtered = filtered.filter((asset) => asset.startsWith(params.chainId));
+        debugLogger?.log('HyperLiquid: applyPathFilters - chainId filter', {
+            chainId: params.chainId,
+            before,
+            after: filtered,
+        });
+    }
+    if (params.symbol && params.symbol in hyperLiquidConfig_1.HYPERLIQUID_ASSET_CONFIGS) {
+        const config = hyperLiquidConfig_1.HYPERLIQUID_ASSET_CONFIGS[params.symbol];
+        const isTestnet = params.isTestnet ?? false;
+        const selectedAsset = isTestnet ? config.testnet : config.mainnet;
+        const before = filtered;
+        filtered = [selectedAsset];
+        debugLogger?.log('HyperLiquid: applyPathFilters - symbol filter', {
+            symbol: params.symbol,
+            isTestnet,
+            config,
+            selectedAsset,
+            before,
+            after: filtered,
+        });
+    }
+    if (params.assetId) {
+        const before = filtered;
+        // Use case-insensitive comparison for asset ID matching to handle address case differences
+        filtered = filtered.filter((asset) => asset.toLowerCase() === params.assetId?.toLowerCase());
+        debugLogger?.log('HyperLiquid: applyPathFilters - assetId filter', {
+            assetId: params.assetId,
+            before,
+            after: filtered,
+            exactMatch: before.includes(params.assetId),
+            caseInsensitiveMatch: before.some((asset) => asset.toLowerCase() === params.assetId?.toLowerCase()),
+        });
+    }
+    debugLogger?.log('HyperLiquid: applyPathFilters - final result', {
+        initialAssets: assets,
+        finalFiltered: filtered,
+        filterParams: params,
+    });
+    return filtered;
+}
+exports.applyPathFilters = applyPathFilters;
+/**
+ * Get supported deposit/withdrawal paths with filtering.
+ *
+ * @param params - Filter parameters including isTestnet, chainId, symbol
+ * @param debugLogger - Optional debug logger for detailed logging
+ * @returns Array of supported CAIP asset IDs
+ */
+function getSupportedPaths(params, debugLogger) {
+    const isTestnet = params?.isTestnet ?? false;
+    const assets = (0, hyperLiquidConfig_1.getSupportedAssets)(isTestnet);
+    const filteredAssets = applyPathFilters(assets, params, debugLogger);
+    debugLogger?.log('HyperLiquid: getSupportedPaths', {
+        isTestnet,
+        requestedParams: params,
+        allAssets: assets,
+        filteredAssets,
+        returnType: 'CaipAssetId[]',
+        example: filteredAssets[0],
+    });
+    return filteredAssets;
+}
+exports.getSupportedPaths = getSupportedPaths;
+/**
+ * Get maximum order value based on leverage and order type.
+ * Based on HyperLiquid contract specifications.
+ *
+ * @param maxLeverage - The maximum leverage for the market
+ * @param orderType - The order type (market or limit)
+ * @returns Maximum order value in USD
+ */
+function getMaxOrderValue(maxLeverage, orderType) {
+    let marketLimit;
+    if (maxLeverage >= 25) {
+        marketLimit = perpsConfig_1.HYPERLIQUID_ORDER_LIMITS.MarketOrderLimits.HighLeverage;
+    }
+    else if (maxLeverage >= 20) {
+        marketLimit = perpsConfig_1.HYPERLIQUID_ORDER_LIMITS.MarketOrderLimits.MediumHighLeverage;
+    }
+    else if (maxLeverage >= 10) {
+        marketLimit = perpsConfig_1.HYPERLIQUID_ORDER_LIMITS.MarketOrderLimits.MediumLeverage;
+    }
+    else {
+        marketLimit = perpsConfig_1.HYPERLIQUID_ORDER_LIMITS.MarketOrderLimits.LowLeverage;
+    }
+    return orderType === 'limit'
+        ? marketLimit * perpsConfig_1.HYPERLIQUID_ORDER_LIMITS.LimitOrderMultiplier
+        : marketLimit;
+}
+exports.getMaxOrderValue = getMaxOrderValue;
+/**
+ * Validate order parameters.
+ * Basic validation - checks required fields are present.
+ * Amount validation (size/USD) is handled by validateOrder.
+ *
+ * @param params - Order parameters to validate
+ * @param params.coin - The trading pair coin symbol
+ * @param params.size - The order size as string
+ * @param params.price - The order price as string
+ * @param params.orderType - The order type (market or limit)
+ * @returns Validation result with isValid flag and optional error message
+ */
+function validateOrderParams(params) {
+    if (!params.coin) {
+        return {
+            isValid: false,
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.ORDER_COIN_REQUIRED,
+        };
+    }
+    // Note: Size validation removed - validateOrder handles amount validation using USD as source of truth
+    // Require price for limit orders
+    if (params.orderType === 'limit' && !params.price) {
+        return {
+            isValid: false,
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.ORDER_LIMIT_PRICE_REQUIRED,
+        };
+    }
+    if (params.price && parseFloat(params.price) <= 0) {
+        return {
+            isValid: false,
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.ORDER_PRICE_POSITIVE,
+        };
+    }
+    return { isValid: true };
+}
+exports.validateOrderParams = validateOrderParams;
+/**
+ * Validate coin exists in asset mapping.
+ *
+ * @param coin - The coin symbol to validate
+ * @param coinToAssetId - Map of coin symbols to asset IDs
+ * @returns Validation result with isValid flag and optional error message
+ */
+function validateCoinExists(coin, coinToAssetId) {
+    if (!coinToAssetId.has(coin)) {
+        return {
+            isValid: false,
+            error: perpsErrorCodes_1.PERPS_ERROR_CODES.ORDER_UNKNOWN_COIN,
+        };
+    }
+    return { isValid: true };
+}
+exports.validateCoinExists = validateCoinExists;
+//# sourceMappingURL=hyperLiquidValidation.cjs.map