@metamask-previews/perps-controller 0.0.0-preview-ce3ee897a → 0.0.0-preview-e4aa1532

package/dist/utils/positionCalculations.mjs

@@ -0,0 +1,165 @@
+/**
+ * Position calculation utilities for closing positions
+ */
+import { CLOSE_POSITION_CONFIG } from "../constants/perpsConfig.mjs";
+/**
+ * Calculate close amounts from percentage for both USD and token modes
+ * Uses USD as source of truth with precision validation (matches order placement logic)
+ *
+ * @param params - Percentage, position size, current price, and asset-specific decimal precision
+ * @returns Object with token amount and USD value
+ */
+export function calculateCloseAmountFromPercentage(params) {
+    const { percentage, positionSize, currentPrice, szDecimals } = params;
+    // Validate required parameters
+    if (szDecimals === undefined || szDecimals === null) {
+        throw new Error('szDecimals is required for close position calculation');
+    }
+    if (szDecimals < 0) {
+        throw new Error(`szDecimals must be >= 0, got: ${szDecimals}`);
+    }
+    if (isNaN(percentage) ||
+        isNaN(positionSize) ||
+        isNaN(currentPrice) ||
+        percentage < 0 ||
+        percentage > 100) {
+        return { tokenAmount: 0, usdValue: 0 };
+    }
+    // Calculate initial token amount and USD value
+    let tokenAmount = (percentage / 100) * Math.abs(positionSize);
+    const usdValue = tokenAmount * currentPrice;
+    // Apply asset-specific decimal precision rounding
+    const multiplier = Math.pow(10, szDecimals);
+    tokenAmount = Math.round(tokenAmount * multiplier) / multiplier;
+    // Ensure rounded size meets requested USD value (fix validation gap)
+    // This matches the logic in calculatePositionSize for consistency
+    const actualUsd = tokenAmount * currentPrice;
+    if (actualUsd < usdValue) {
+        // Add 1 minimum increment to meet requested USD
+        tokenAmount += 1 / multiplier;
+    }
+    return {
+        tokenAmount: Number(tokenAmount.toFixed(szDecimals)),
+        usdValue: Number(usdValue.toFixed(CLOSE_POSITION_CONFIG.UsdDecimalPlaces)),
+    };
+}
+/**
+ * Validate and clamp close amount within limits
+ *
+ * @param params - Amount to validate, maximum allowed, and optional minimum
+ * @returns Clamped amount within valid range
+ */
+export function validateCloseAmountLimits(params) {
+    const { amount, maxAmount, minAmount = 0 } = params;
+    if (isNaN(amount) || amount < 0) {
+        return 0;
+    }
+    return Math.max(minAmount, Math.min(amount, maxAmount));
+}
+/**
+ * Format close amount for display based on mode and decimals
+ *
+ * @param params - Value string, display mode, and decimal places
+ * @returns Formatted string with appropriate decimal precision
+ */
+export function formatCloseAmountDisplay(params) {
+    const { value, displayMode, decimals } = params;
+    if (!value || value === '') {
+        return '0';
+    }
+    const numericValue = parseFloat(value);
+    if (isNaN(numericValue)) {
+        return '0';
+    }
+    const decimalPlaces = decimals ??
+        (displayMode === 'usd'
+            ? CLOSE_POSITION_CONFIG.UsdDecimalPlaces
+            : CLOSE_POSITION_CONFIG.AmountCalculationPrecision);
+    // For USD mode, limit input to specified decimal places
+    if (displayMode === 'usd' && value.includes('.')) {
+        const parts = value.split('.');
+        const integerPart = parts[0] || '0';
+        const decimalPart = (parts[1] || '').slice(0, CLOSE_POSITION_CONFIG.UsdDecimalPlaces);
+        return `${integerPart}${decimalPart ? `.${decimalPart}` : ''}`;
+    }
+    return numericValue.toFixed(decimalPlaces);
+}
+/**
+ * Calculate USD value for a given token amount
+ *
+ * @param params - Token amount and current price
+ * @returns USD value formatted to 2 decimal places
+ */
+export function calculateCloseValue(params) {
+    const { amount, price } = params;
+    if (isNaN(amount) || isNaN(price) || amount < 0 || price <= 0) {
+        return 0;
+    }
+    const value = amount * price;
+    return Number(value.toFixed(CLOSE_POSITION_CONFIG.UsdDecimalPlaces));
+}
+/**
+ * Formats a USD value for close amount display with proper decimal places
+ * Uses the centralized USD_DECIMAL_PLACES configuration
+ *
+ * @param value - Raw USD value to format
+ * @returns Formatted string with configured decimal places
+ */
+export function formatCloseAmountUSD(value) {
+    if (isNaN(value) || value < 0) {
+        return '0';
+    }
+    return value.toFixed(CLOSE_POSITION_CONFIG.UsdDecimalPlaces);
+}
+/**
+ * Calculate percentage from token amount
+ *
+ * @param tokenAmount - Amount in token units
+ * @param totalPositionSize - Total position size in token units
+ * @returns Percentage (0-100)
+ */
+export function calculatePercentageFromTokenAmount(tokenAmount, totalPositionSize) {
+    if (isNaN(tokenAmount) ||
+        isNaN(totalPositionSize) ||
+        totalPositionSize === 0) {
+        return 0;
+    }
+    const percentage = (Math.abs(tokenAmount) / Math.abs(totalPositionSize)) * 100;
+    return Math.max(0, Math.min(100, percentage));
+}
+/**
+ * Calculate percentage from USD amount
+ *
+ * @param usdAmount - Amount in USD
+ * @param totalPositionValue - Total position value in USD
+ * @returns Percentage (0-100)
+ */
+export function calculatePercentageFromUSDAmount(usdAmount, totalPositionValue) {
+    if (isNaN(usdAmount) ||
+        isNaN(totalPositionValue) ||
+        totalPositionValue === 0) {
+        return 0;
+    }
+    const percentage = (usdAmount / totalPositionValue) * 100;
+    return Math.max(0, Math.min(100, percentage));
+}
+/**
+ * Helper function to determine position direction based on size value
+ *
+ * @param sizeString - The position size as a string
+ * @returns 'long', 'short', or 'unknown'
+ */
+export function getPositionDirection(sizeString) {
+    const sizeValue = parseFloat(sizeString);
+    if (!Number.isFinite(sizeValue)) {
+        return 'unknown';
+    }
+    if (sizeValue > 0) {
+        return 'long';
+    }
+    if (sizeValue < 0) {
+        return 'short';
+    }
+    return 'unknown';
+}
+//# sourceMappingURL=positionCalculations.mjs.map

package/dist/utils/positionCalculations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"positionCalculations.mjs","sourceRoot":"","sources":["../../src/utils/positionCalculations.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Position calculation utilities for closing positions\n */\nimport { CLOSE_POSITION_CONFIG } from '../constants/perpsConfig';\n\ntype CloseAmountFromPercentageParams = {\n  percentage: number;\n  positionSize: number;\n  currentPrice: number;\n  szDecimals: number;\n};\n\ntype CloseAmountLimitsParams = {\n  amount: number;\n  maxAmount: number;\n  minAmount?: number;\n};\n\ntype CloseAmountDisplayParams = {\n  value: string;\n  displayMode: 'usd' | 'token';\n  decimals?: number;\n};\n\ntype CloseValueParams = {\n  amount: number;\n  price: number;\n};\n\n/**\n * Calculate close amounts from percentage for both USD and token modes\n * Uses USD as source of truth with precision validation (matches order placement logic)\n *\n * @param params - Percentage, position size, current price, and asset-specific decimal precision\n * @returns Object with token amount and USD value\n */\nexport function calculateCloseAmountFromPercentage(\n  params: CloseAmountFromPercentageParams,\n): { tokenAmount: number; usdValue: number } {\n  const { percentage, positionSize, currentPrice, szDecimals } = params;\n\n  // Validate required parameters\n  if (szDecimals === undefined || szDecimals === null) {\n    throw new Error('szDecimals is required for close position calculation');\n  }\n  if (szDecimals < 0) {\n    throw new Error(`szDecimals must be >= 0, got: ${szDecimals}`);\n  }\n\n  if (\n    isNaN(percentage) ||\n    isNaN(positionSize) ||\n    isNaN(currentPrice) ||\n    percentage < 0 ||\n    percentage > 100\n  ) {\n    return { tokenAmount: 0, usdValue: 0 };\n  }\n\n  // Calculate initial token amount and USD value\n  let tokenAmount = (percentage / 100) * Math.abs(positionSize);\n  const usdValue = tokenAmount * currentPrice;\n\n  // Apply asset-specific decimal precision rounding\n  const multiplier = Math.pow(10, szDecimals);\n  tokenAmount = Math.round(tokenAmount * multiplier) / multiplier;\n\n  // Ensure rounded size meets requested USD value (fix validation gap)\n  // This matches the logic in calculatePositionSize for consistency\n  const actualUsd = tokenAmount * currentPrice;\n  if (actualUsd < usdValue) {\n    // Add 1 minimum increment to meet requested USD\n    tokenAmount += 1 / multiplier;\n  }\n\n  return {\n    tokenAmount: Number(tokenAmount.toFixed(szDecimals)),\n    usdValue: Number(usdValue.toFixed(CLOSE_POSITION_CONFIG.UsdDecimalPlaces)),\n  };\n}\n\n/**\n * Validate and clamp close amount within limits\n *\n * @param params - Amount to validate, maximum allowed, and optional minimum\n * @returns Clamped amount within valid range\n */\nexport function validateCloseAmountLimits(\n  params: CloseAmountLimitsParams,\n): number {\n  const { amount, maxAmount, minAmount = 0 } = params;\n\n  if (isNaN(amount) || amount < 0) {\n    return 0;\n  }\n\n  return Math.max(minAmount, Math.min(amount, maxAmount));\n}\n\n/**\n * Format close amount for display based on mode and decimals\n *\n * @param params - Value string, display mode, and decimal places\n * @returns Formatted string with appropriate decimal precision\n */\nexport function formatCloseAmountDisplay(\n  params: CloseAmountDisplayParams,\n): string {\n  const { value, displayMode, decimals } = params;\n\n  if (!value || value === '') {\n    return '0';\n  }\n\n  const numericValue = parseFloat(value);\n  if (isNaN(numericValue)) {\n    return '0';\n  }\n\n  const decimalPlaces =\n    decimals ??\n    (displayMode === 'usd'\n      ? CLOSE_POSITION_CONFIG.UsdDecimalPlaces\n      : CLOSE_POSITION_CONFIG.AmountCalculationPrecision);\n\n  // For USD mode, limit input to specified decimal places\n  if (displayMode === 'usd' && value.includes('.')) {\n    const parts = value.split('.');\n    const integerPart = parts[0] || '0';\n    const decimalPart = (parts[1] || '').slice(\n      0,\n      CLOSE_POSITION_CONFIG.UsdDecimalPlaces,\n    );\n    return `${integerPart}${decimalPart ? `.${decimalPart}` : ''}`;\n  }\n\n  return numericValue.toFixed(decimalPlaces);\n}\n\n/**\n * Calculate USD value for a given token amount\n *\n * @param params - Token amount and current price\n * @returns USD value formatted to 2 decimal places\n */\nexport function calculateCloseValue(params: CloseValueParams): number {\n  const { amount, price } = params;\n\n  if (isNaN(amount) || isNaN(price) || amount < 0 || price <= 0) {\n    return 0;\n  }\n\n  const value = amount * price;\n  return Number(value.toFixed(CLOSE_POSITION_CONFIG.UsdDecimalPlaces));\n}\n\n/**\n * Formats a USD value for close amount display with proper decimal places\n * Uses the centralized USD_DECIMAL_PLACES configuration\n *\n * @param value - Raw USD value to format\n * @returns Formatted string with configured decimal places\n */\nexport function formatCloseAmountUSD(value: number): string {\n  if (isNaN(value) || value < 0) {\n    return '0';\n  }\n  return value.toFixed(CLOSE_POSITION_CONFIG.UsdDecimalPlaces);\n}\n\n/**\n * Calculate percentage from token amount\n *\n * @param tokenAmount - Amount in token units\n * @param totalPositionSize - Total position size in token units\n * @returns Percentage (0-100)\n */\nexport function calculatePercentageFromTokenAmount(\n  tokenAmount: number,\n  totalPositionSize: number,\n): number {\n  if (\n    isNaN(tokenAmount) ||\n    isNaN(totalPositionSize) ||\n    totalPositionSize === 0\n  ) {\n    return 0;\n  }\n\n  const percentage =\n    (Math.abs(tokenAmount) / Math.abs(totalPositionSize)) * 100;\n  return Math.max(0, Math.min(100, percentage));\n}\n\n/**\n * Calculate percentage from USD amount\n *\n * @param usdAmount - Amount in USD\n * @param totalPositionValue - Total position value in USD\n * @returns Percentage (0-100)\n */\nexport function calculatePercentageFromUSDAmount(\n  usdAmount: number,\n  totalPositionValue: number,\n): number {\n  if (\n    isNaN(usdAmount) ||\n    isNaN(totalPositionValue) ||\n    totalPositionValue === 0\n  ) {\n    return 0;\n  }\n\n  const percentage = (usdAmount / totalPositionValue) * 100;\n  return Math.max(0, Math.min(100, percentage));\n}\n\n/**\n * Helper function to determine position direction based on size value\n *\n * @param sizeString - The position size as a string\n * @returns 'long', 'short', or 'unknown'\n */\nexport function getPositionDirection(\n  sizeString: string,\n): 'long' | 'short' | 'unknown' {\n  const sizeValue = parseFloat(sizeString);\n\n  if (!Number.isFinite(sizeValue)) {\n    return 'unknown';\n  }\n\n  if (sizeValue > 0) {\n    return 'long';\n  }\n\n  if (sizeValue < 0) {\n    return 'short';\n  }\n\n  return 'unknown';\n}\n"]}

package/dist/utils/sortMarkets.cjs

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sortMarkets = void 0;
+const perpsConfig_1 = require("../constants/perpsConfig.cjs");
+/**
+ * Parse volume string with magnitude suffixes (e.g., '$1.2B', '$850M')
+ *
+ * @param volume - Volume string with optional magnitude suffix
+ * @returns Parsed numeric value
+ */
+function parseVolume(volume) {
+    if (!volume) {
+        return 0;
+    }
+    // Remove $ and any whitespace
+    const cleanedVolume = volume.replace(/[$,\s]/gu, '');
+    // Match number with optional suffix (K, M, B, T)
+    const match = cleanedVolume.match(/^([\d.]+)([KMBT])?$/iu);
+    if (!match) {
+        return 0;
+    }
+    const parsedValue = parseFloat(match[1]);
+    const suffix = match[2]?.toUpperCase();
+    const multipliers = {
+        K: 1000,
+        M: 1000000,
+        B: 1000000000,
+        T: 1000000000000,
+    };
+    return suffix ? parsedValue * (multipliers[suffix] ?? 1) : parsedValue;
+}
+/**
+ * Sorts markets based on the specified criteria.
+ * Uses object parameters pattern for maintainability.
+ *
+ * @param options - Sort options object
+ * @param options.markets - Array of market data to sort
+ * @param options.sortBy - Field to sort by (volume, priceChange, fundingRate, openInterest)
+ * @param options.direction - Sort direction (asc or desc, defaults to desc)
+ * @returns Sorted array of market data
+ */
+const sortMarkets = ({ markets, sortBy, direction = perpsConfig_1.MARKET_SORTING_CONFIG.DefaultDirection, }) => {
+    const sortedMarkets = [...markets];
+    sortedMarkets.sort((marketA, marketB) => {
+        let compareValue = 0;
+        switch (sortBy) {
+            case perpsConfig_1.MARKET_SORTING_CONFIG.SortFields.Volume: {
+                // Parse volume strings with magnitude suffixes (e.g., '$1.2B', '$850M')
+                const volumeA = parseVolume(marketA.volume);
+                const volumeB = parseVolume(marketB.volume);
+                compareValue = volumeA - volumeB;
+                break;
+            }
+            case perpsConfig_1.MARKET_SORTING_CONFIG.SortFields.PriceChange: {
+                // Use 24h price change percentage (e.g., '+2.5%', '-1.8%')
+                // Parse and remove % sign
+                const changeA = parseFloat(marketA.change24hPercent?.replace(/[%+]/gu, '') || '0');
+                const changeB = parseFloat(marketB.change24hPercent?.replace(/[%+]/gu, '') || '0');
+                compareValue = changeA - changeB;
+                break;
+            }
+            case perpsConfig_1.MARKET_SORTING_CONFIG.SortFields.FundingRate: {
+                // Funding rate is a number (not string)
+                const fundingA = marketA.fundingRate ?? 0;
+                const fundingB = marketB.fundingRate ?? 0;
+                compareValue = fundingA - fundingB;
+                break;
+            }
+            case perpsConfig_1.MARKET_SORTING_CONFIG.SortFields.OpenInterest: {
+                // Parse open interest strings (similar to volume)
+                const openInterestA = parseVolume(marketA.openInterest);
+                const openInterestB = parseVolume(marketB.openInterest);
+                compareValue = openInterestA - openInterestB;
+                break;
+            }
+            default:
+                // Unsupported sort field - maintain current order (compareValue remains 0)
+                break;
+        }
+        // Apply sort direction
+        return direction === perpsConfig_1.MARKET_SORTING_CONFIG.DefaultDirection
+            ? compareValue * -1 // desc (larger first)
+            : compareValue; // asc (smaller first)
+    });
+    return sortedMarkets;
+};
+exports.sortMarkets = sortMarkets;
+//# sourceMappingURL=sortMarkets.cjs.map

package/dist/utils/sortMarkets.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortMarkets.cjs","sourceRoot":"","sources":["../../src/utils/sortMarkets.ts"],"names":[],"mappings":"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","sourcesContent":["import { MARKET_SORTING_CONFIG } from '../constants/perpsConfig';\nimport type { PerpsMarketData } from '../types';\n\nexport type SortField =\n  | 'volume'\n  | 'priceChange'\n  | 'fundingRate'\n  | 'openInterest';\nexport type SortDirection = 'asc' | 'desc';\n\ntype SortMarketsParams = {\n  markets: PerpsMarketData[];\n  sortBy: SortField;\n  direction?: SortDirection;\n};\n\n/**\n * Parse volume string with magnitude suffixes (e.g., '$1.2B', '$850M')\n *\n * @param volume - Volume string with optional magnitude suffix\n * @returns Parsed numeric value\n */\nfunction parseVolume(volume: string | undefined): number {\n  if (!volume) {\n    return 0;\n  }\n\n  // Remove $ and any whitespace\n  const cleanedVolume = volume.replace(/[$,\\s]/gu, '');\n\n  // Match number with optional suffix (K, M, B, T)\n  const match = cleanedVolume.match(/^([\\d.]+)([KMBT])?$/iu);\n  if (!match) {\n    return 0;\n  }\n\n  const parsedValue = parseFloat(match[1]);\n  const suffix = match[2]?.toUpperCase();\n\n  const multipliers: Record<string, number> = {\n    K: 1_000,\n    M: 1_000_000,\n    B: 1_000_000_000,\n    T: 1_000_000_000_000,\n  };\n\n  return suffix ? parsedValue * (multipliers[suffix] ?? 1) : parsedValue;\n}\n\n/**\n * Sorts markets based on the specified criteria.\n * Uses object parameters pattern for maintainability.\n *\n * @param options - Sort options object\n * @param options.markets - Array of market data to sort\n * @param options.sortBy - Field to sort by (volume, priceChange, fundingRate, openInterest)\n * @param options.direction - Sort direction (asc or desc, defaults to desc)\n * @returns Sorted array of market data\n */\nexport const sortMarkets = ({\n  markets,\n  sortBy,\n  direction = MARKET_SORTING_CONFIG.DefaultDirection,\n}: SortMarketsParams): PerpsMarketData[] => {\n  const sortedMarkets = [...markets];\n\n  sortedMarkets.sort((marketA, marketB) => {\n    let compareValue = 0;\n\n    switch (sortBy) {\n      case MARKET_SORTING_CONFIG.SortFields.Volume: {\n        // Parse volume strings with magnitude suffixes (e.g., '$1.2B', '$850M')\n        const volumeA = parseVolume(marketA.volume);\n        const volumeB = parseVolume(marketB.volume);\n        compareValue = volumeA - volumeB;\n        break;\n      }\n\n      case MARKET_SORTING_CONFIG.SortFields.PriceChange: {\n        // Use 24h price change percentage (e.g., '+2.5%', '-1.8%')\n        // Parse and remove % sign\n        const changeA = parseFloat(\n          marketA.change24hPercent?.replace(/[%+]/gu, '') || '0',\n        );\n        const changeB = parseFloat(\n          marketB.change24hPercent?.replace(/[%+]/gu, '') || '0',\n        );\n        compareValue = changeA - changeB;\n        break;\n      }\n\n      case MARKET_SORTING_CONFIG.SortFields.FundingRate: {\n        // Funding rate is a number (not string)\n        const fundingA = marketA.fundingRate ?? 0;\n        const fundingB = marketB.fundingRate ?? 0;\n        compareValue = fundingA - fundingB;\n        break;\n      }\n\n      case MARKET_SORTING_CONFIG.SortFields.OpenInterest: {\n        // Parse open interest strings (similar to volume)\n        const openInterestA = parseVolume(marketA.openInterest);\n        const openInterestB = parseVolume(marketB.openInterest);\n        compareValue = openInterestA - openInterestB;\n        break;\n      }\n\n      default:\n        // Unsupported sort field - maintain current order (compareValue remains 0)\n        break;\n    }\n\n    // Apply sort direction\n    return direction === MARKET_SORTING_CONFIG.DefaultDirection\n      ? compareValue * -1 // desc (larger first)\n      : compareValue; // asc (smaller first)\n  });\n\n  return sortedMarkets;\n};\n"]}

package/dist/utils/sortMarkets.d.cts

@@ -0,0 +1,21 @@
+import type { PerpsMarketData } from "../types/index.cjs";
+export type SortField = 'volume' | 'priceChange' | 'fundingRate' | 'openInterest';
+export type SortDirection = 'asc' | 'desc';
+type SortMarketsParams = {
+    markets: PerpsMarketData[];
+    sortBy: SortField;
+    direction?: SortDirection;
+};
+/**
+ * Sorts markets based on the specified criteria.
+ * Uses object parameters pattern for maintainability.
+ *
+ * @param options - Sort options object
+ * @param options.markets - Array of market data to sort
+ * @param options.sortBy - Field to sort by (volume, priceChange, fundingRate, openInterest)
+ * @param options.direction - Sort direction (asc or desc, defaults to desc)
+ * @returns Sorted array of market data
+ */
+export declare const sortMarkets: ({ markets, sortBy, direction, }: SortMarketsParams) => PerpsMarketData[];
+export {};
+//# sourceMappingURL=sortMarkets.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sortMarkets.d.cts","sourceRoot":"","sources":["../../src/utils/sortMarkets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,2BAAiB;AAEhD,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,aAAa,GACb,aAAa,GACb,cAAc,CAAC;AACnB,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;AAE3C,KAAK,iBAAiB,GAAG;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B,CAAC;AAmCF;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,oCAIrB,iBAAiB,KAAG,eAAe,EAwDrC,CAAC"}

package/dist/utils/sortMarkets.d.mts

@@ -0,0 +1,21 @@
+import type { PerpsMarketData } from "../types/index.mjs";
+export type SortField = 'volume' | 'priceChange' | 'fundingRate' | 'openInterest';
+export type SortDirection = 'asc' | 'desc';
+type SortMarketsParams = {
+    markets: PerpsMarketData[];
+    sortBy: SortField;
+    direction?: SortDirection;
+};
+/**
+ * Sorts markets based on the specified criteria.
+ * Uses object parameters pattern for maintainability.
+ *
+ * @param options - Sort options object
+ * @param options.markets - Array of market data to sort
+ * @param options.sortBy - Field to sort by (volume, priceChange, fundingRate, openInterest)
+ * @param options.direction - Sort direction (asc or desc, defaults to desc)
+ * @returns Sorted array of market data
+ */
+export declare const sortMarkets: ({ markets, sortBy, direction, }: SortMarketsParams) => PerpsMarketData[];
+export {};
+//# sourceMappingURL=sortMarkets.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sortMarkets.d.mts","sourceRoot":"","sources":["../../src/utils/sortMarkets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,2BAAiB;AAEhD,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,aAAa,GACb,aAAa,GACb,cAAc,CAAC;AACnB,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;AAE3C,KAAK,iBAAiB,GAAG;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B,CAAC;AAmCF;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,oCAIrB,iBAAiB,KAAG,eAAe,EAwDrC,CAAC"}

package/dist/utils/sortMarkets.mjs

@@ -0,0 +1,84 @@
+import { MARKET_SORTING_CONFIG } from "../constants/perpsConfig.mjs";
+/**
+ * Parse volume string with magnitude suffixes (e.g., '$1.2B', '$850M')
+ *
+ * @param volume - Volume string with optional magnitude suffix
+ * @returns Parsed numeric value
+ */
+function parseVolume(volume) {
+    if (!volume) {
+        return 0;
+    }
+    // Remove $ and any whitespace
+    const cleanedVolume = volume.replace(/[$,\s]/gu, '');
+    // Match number with optional suffix (K, M, B, T)
+    const match = cleanedVolume.match(/^([\d.]+)([KMBT])?$/iu);
+    if (!match) {
+        return 0;
+    }
+    const parsedValue = parseFloat(match[1]);
+    const suffix = match[2]?.toUpperCase();
+    const multipliers = {
+        K: 1000,
+        M: 1000000,
+        B: 1000000000,
+        T: 1000000000000,
+    };
+    return suffix ? parsedValue * (multipliers[suffix] ?? 1) : parsedValue;
+}
+/**
+ * Sorts markets based on the specified criteria.
+ * Uses object parameters pattern for maintainability.
+ *
+ * @param options - Sort options object
+ * @param options.markets - Array of market data to sort
+ * @param options.sortBy - Field to sort by (volume, priceChange, fundingRate, openInterest)
+ * @param options.direction - Sort direction (asc or desc, defaults to desc)
+ * @returns Sorted array of market data
+ */
+export const sortMarkets = ({ markets, sortBy, direction = MARKET_SORTING_CONFIG.DefaultDirection, }) => {
+    const sortedMarkets = [...markets];
+    sortedMarkets.sort((marketA, marketB) => {
+        let compareValue = 0;
+        switch (sortBy) {
+            case MARKET_SORTING_CONFIG.SortFields.Volume: {
+                // Parse volume strings with magnitude suffixes (e.g., '$1.2B', '$850M')
+                const volumeA = parseVolume(marketA.volume);
+                const volumeB = parseVolume(marketB.volume);
+                compareValue = volumeA - volumeB;
+                break;
+            }
+            case MARKET_SORTING_CONFIG.SortFields.PriceChange: {
+                // Use 24h price change percentage (e.g., '+2.5%', '-1.8%')
+                // Parse and remove % sign
+                const changeA = parseFloat(marketA.change24hPercent?.replace(/[%+]/gu, '') || '0');
+                const changeB = parseFloat(marketB.change24hPercent?.replace(/[%+]/gu, '') || '0');
+                compareValue = changeA - changeB;
+                break;
+            }
+            case MARKET_SORTING_CONFIG.SortFields.FundingRate: {
+                // Funding rate is a number (not string)
+                const fundingA = marketA.fundingRate ?? 0;
+                const fundingB = marketB.fundingRate ?? 0;
+                compareValue = fundingA - fundingB;
+                break;
+            }
+            case MARKET_SORTING_CONFIG.SortFields.OpenInterest: {
+                // Parse open interest strings (similar to volume)
+                const openInterestA = parseVolume(marketA.openInterest);
+                const openInterestB = parseVolume(marketB.openInterest);
+                compareValue = openInterestA - openInterestB;
+                break;
+            }
+            default:
+                // Unsupported sort field - maintain current order (compareValue remains 0)
+                break;
+        }
+        // Apply sort direction
+        return direction === MARKET_SORTING_CONFIG.DefaultDirection
+            ? compareValue * -1 // desc (larger first)
+            : compareValue; // asc (smaller first)
+    });
+    return sortedMarkets;
+};
+//# sourceMappingURL=sortMarkets.mjs.map

package/dist/utils/sortMarkets.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortMarkets.mjs","sourceRoot":"","sources":["../../src/utils/sortMarkets.ts"],"names":[],"mappings":"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","sourcesContent":["import { MARKET_SORTING_CONFIG } from '../constants/perpsConfig';\nimport type { PerpsMarketData } from '../types';\n\nexport type SortField =\n  | 'volume'\n  | 'priceChange'\n  | 'fundingRate'\n  | 'openInterest';\nexport type SortDirection = 'asc' | 'desc';\n\ntype SortMarketsParams = {\n  markets: PerpsMarketData[];\n  sortBy: SortField;\n  direction?: SortDirection;\n};\n\n/**\n * Parse volume string with magnitude suffixes (e.g., '$1.2B', '$850M')\n *\n * @param volume - Volume string with optional magnitude suffix\n * @returns Parsed numeric value\n */\nfunction parseVolume(volume: string | undefined): number {\n  if (!volume) {\n    return 0;\n  }\n\n  // Remove $ and any whitespace\n  const cleanedVolume = volume.replace(/[$,\\s]/gu, '');\n\n  // Match number with optional suffix (K, M, B, T)\n  const match = cleanedVolume.match(/^([\\d.]+)([KMBT])?$/iu);\n  if (!match) {\n    return 0;\n  }\n\n  const parsedValue = parseFloat(match[1]);\n  const suffix = match[2]?.toUpperCase();\n\n  const multipliers: Record<string, number> = {\n    K: 1_000,\n    M: 1_000_000,\n    B: 1_000_000_000,\n    T: 1_000_000_000_000,\n  };\n\n  return suffix ? parsedValue * (multipliers[suffix] ?? 1) : parsedValue;\n}\n\n/**\n * Sorts markets based on the specified criteria.\n * Uses object parameters pattern for maintainability.\n *\n * @param options - Sort options object\n * @param options.markets - Array of market data to sort\n * @param options.sortBy - Field to sort by (volume, priceChange, fundingRate, openInterest)\n * @param options.direction - Sort direction (asc or desc, defaults to desc)\n * @returns Sorted array of market data\n */\nexport const sortMarkets = ({\n  markets,\n  sortBy,\n  direction = MARKET_SORTING_CONFIG.DefaultDirection,\n}: SortMarketsParams): PerpsMarketData[] => {\n  const sortedMarkets = [...markets];\n\n  sortedMarkets.sort((marketA, marketB) => {\n    let compareValue = 0;\n\n    switch (sortBy) {\n      case MARKET_SORTING_CONFIG.SortFields.Volume: {\n        // Parse volume strings with magnitude suffixes (e.g., '$1.2B', '$850M')\n        const volumeA = parseVolume(marketA.volume);\n        const volumeB = parseVolume(marketB.volume);\n        compareValue = volumeA - volumeB;\n        break;\n      }\n\n      case MARKET_SORTING_CONFIG.SortFields.PriceChange: {\n        // Use 24h price change percentage (e.g., '+2.5%', '-1.8%')\n        // Parse and remove % sign\n        const changeA = parseFloat(\n          marketA.change24hPercent?.replace(/[%+]/gu, '') || '0',\n        );\n        const changeB = parseFloat(\n          marketB.change24hPercent?.replace(/[%+]/gu, '') || '0',\n        );\n        compareValue = changeA - changeB;\n        break;\n      }\n\n      case MARKET_SORTING_CONFIG.SortFields.FundingRate: {\n        // Funding rate is a number (not string)\n        const fundingA = marketA.fundingRate ?? 0;\n        const fundingB = marketB.fundingRate ?? 0;\n        compareValue = fundingA - fundingB;\n        break;\n      }\n\n      case MARKET_SORTING_CONFIG.SortFields.OpenInterest: {\n        // Parse open interest strings (similar to volume)\n        const openInterestA = parseVolume(marketA.openInterest);\n        const openInterestB = parseVolume(marketB.openInterest);\n        compareValue = openInterestA - openInterestB;\n        break;\n      }\n\n      default:\n        // Unsupported sort field - maintain current order (compareValue remains 0)\n        break;\n    }\n\n    // Apply sort direction\n    return direction === MARKET_SORTING_CONFIG.DefaultDirection\n      ? compareValue * -1 // desc (larger first)\n      : compareValue; // asc (smaller first)\n  });\n\n  return sortedMarkets;\n};\n"]}

package/dist/utils/standaloneInfoClient.cjs

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStandaloneInfoClient = void 0;
+const hyperliquid_1 = require("@nktkas/hyperliquid");
+const perpsConfig_1 = require("../constants/perpsConfig.cjs");
+/**
+ * Creates a standalone InfoClient for lightweight read-only queries.
+ * Does not require full perps initialization (no wallet, WebSocket, etc.)
+ *
+ * Use cases:
+ * - Discovery queries (checking if perps market exists)
+ * - Portfolio analytics outside perps context
+ * - Price feeds without full initialization
+ *
+ * @param options - Configuration options
+ * @param options.isTestnet - Whether to use testnet API endpoint
+ * @param options.timeout - Request timeout in ms (default: CONNECTION_TIMEOUT_MS)
+ * @returns InfoClient instance
+ * @example
+ * ```typescript
+ * const infoClient = createStandaloneInfoClient({ isTestnet: false });
+ * const meta = await infoClient.meta();
+ * ```
+ */
+const createStandaloneInfoClient = (options) => {
+    const { isTestnet, timeout = perpsConfig_1.PERPS_CONSTANTS.ConnectionTimeoutMs } = options;
+    const httpTransport = new hyperliquid_1.HttpTransport({
+        isTestnet,
+        timeout,
+    });
+    return new hyperliquid_1.InfoClient({ transport: httpTransport });
+};
+exports.createStandaloneInfoClient = createStandaloneInfoClient;
+//# sourceMappingURL=standaloneInfoClient.cjs.map

package/dist/utils/standaloneInfoClient.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"standaloneInfoClient.cjs","sourceRoot":"","sources":["../../src/utils/standaloneInfoClient.ts"],"names":[],"mappings":";;;AAAA,qDAAgE;AAEhE,8DAA2D;AAY3D;;;;;;;;;;;;;;;;;;GAkBG;AACI,MAAM,0BAA0B,GAAG,CACxC,OAAoC,EACxB,EAAE;IACd,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,6BAAe,CAAC,mBAAmB,EAAE,GAAG,OAAO,CAAC;IAE7E,MAAM,aAAa,GAAG,IAAI,2BAAa,CAAC;QACtC,SAAS;QACT,OAAO;KACR,CAAC,CAAC;IAEH,OAAO,IAAI,wBAAU,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;AACtD,CAAC,CAAC;AAXW,QAAA,0BAA0B,8BAWrC","sourcesContent":["import { HttpTransport, InfoClient } from '@nktkas/hyperliquid';\n\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig';\n\n/**\n * Options for creating a standalone info client.\n */\nexport type StandaloneInfoClientOptions = {\n  /** Whether to use testnet API endpoint */\n  isTestnet: boolean;\n  /** Request timeout in ms (default: CONNECTION_TIMEOUT_MS) */\n  timeout?: number;\n};\n\n/**\n * Creates a standalone InfoClient for lightweight read-only queries.\n * Does not require full perps initialization (no wallet, WebSocket, etc.)\n *\n * Use cases:\n * - Discovery queries (checking if perps market exists)\n * - Portfolio analytics outside perps context\n * - Price feeds without full initialization\n *\n * @param options - Configuration options\n * @param options.isTestnet - Whether to use testnet API endpoint\n * @param options.timeout - Request timeout in ms (default: CONNECTION_TIMEOUT_MS)\n * @returns InfoClient instance\n * @example\n * ```typescript\n * const infoClient = createStandaloneInfoClient({ isTestnet: false });\n * const meta = await infoClient.meta();\n * ```\n */\nexport const createStandaloneInfoClient = (\n  options: StandaloneInfoClientOptions,\n): InfoClient => {\n  const { isTestnet, timeout = PERPS_CONSTANTS.ConnectionTimeoutMs } = options;\n\n  const httpTransport = new HttpTransport({\n    isTestnet,\n    timeout,\n  });\n\n  return new InfoClient({ transport: httpTransport });\n};\n"]}

package/dist/utils/standaloneInfoClient.d.cts

@@ -0,0 +1,31 @@
+import { InfoClient } from "@nktkas/hyperliquid";
+/**
+ * Options for creating a standalone info client.
+ */
+export type StandaloneInfoClientOptions = {
+    /** Whether to use testnet API endpoint */
+    isTestnet: boolean;
+    /** Request timeout in ms (default: CONNECTION_TIMEOUT_MS) */
+    timeout?: number;
+};
+/**
+ * Creates a standalone InfoClient for lightweight read-only queries.
+ * Does not require full perps initialization (no wallet, WebSocket, etc.)
+ *
+ * Use cases:
+ * - Discovery queries (checking if perps market exists)
+ * - Portfolio analytics outside perps context
+ * - Price feeds without full initialization
+ *
+ * @param options - Configuration options
+ * @param options.isTestnet - Whether to use testnet API endpoint
+ * @param options.timeout - Request timeout in ms (default: CONNECTION_TIMEOUT_MS)
+ * @returns InfoClient instance
+ * @example
+ * ```typescript
+ * const infoClient = createStandaloneInfoClient({ isTestnet: false });
+ * const meta = await infoClient.meta();
+ * ```
+ */
+export declare const createStandaloneInfoClient: (options: StandaloneInfoClientOptions) => InfoClient;
+//# sourceMappingURL=standaloneInfoClient.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"standaloneInfoClient.d.cts","sourceRoot":"","sources":["../../src/utils/standaloneInfoClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,UAAU,EAAE,4BAA4B;AAIhE;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,0BAA0B,YAC5B,2BAA2B,KACnC,UASF,CAAC"}

package/dist/utils/standaloneInfoClient.d.mts

@@ -0,0 +1,31 @@
+import { InfoClient } from "@nktkas/hyperliquid";
+/**
+ * Options for creating a standalone info client.
+ */
+export type StandaloneInfoClientOptions = {
+    /** Whether to use testnet API endpoint */
+    isTestnet: boolean;
+    /** Request timeout in ms (default: CONNECTION_TIMEOUT_MS) */
+    timeout?: number;
+};
+/**
+ * Creates a standalone InfoClient for lightweight read-only queries.
+ * Does not require full perps initialization (no wallet, WebSocket, etc.)
+ *
+ * Use cases:
+ * - Discovery queries (checking if perps market exists)
+ * - Portfolio analytics outside perps context
+ * - Price feeds without full initialization
+ *
+ * @param options - Configuration options
+ * @param options.isTestnet - Whether to use testnet API endpoint
+ * @param options.timeout - Request timeout in ms (default: CONNECTION_TIMEOUT_MS)
+ * @returns InfoClient instance
+ * @example
+ * ```typescript
+ * const infoClient = createStandaloneInfoClient({ isTestnet: false });
+ * const meta = await infoClient.meta();
+ * ```
+ */
+export declare const createStandaloneInfoClient: (options: StandaloneInfoClientOptions) => InfoClient;
+//# sourceMappingURL=standaloneInfoClient.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"standaloneInfoClient.d.mts","sourceRoot":"","sources":["../../src/utils/standaloneInfoClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,UAAU,EAAE,4BAA4B;AAIhE;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,0BAA0B,YAC5B,2BAA2B,KACnC,UASF,CAAC"}

package/dist/utils/standaloneInfoClient.mjs

@@ -0,0 +1,30 @@
+import { HttpTransport, InfoClient } from "@nktkas/hyperliquid";
+import { PERPS_CONSTANTS } from "../constants/perpsConfig.mjs";
+/**
+ * Creates a standalone InfoClient for lightweight read-only queries.
+ * Does not require full perps initialization (no wallet, WebSocket, etc.)
+ *
+ * Use cases:
+ * - Discovery queries (checking if perps market exists)
+ * - Portfolio analytics outside perps context
+ * - Price feeds without full initialization
+ *
+ * @param options - Configuration options
+ * @param options.isTestnet - Whether to use testnet API endpoint
+ * @param options.timeout - Request timeout in ms (default: CONNECTION_TIMEOUT_MS)
+ * @returns InfoClient instance
+ * @example
+ * ```typescript
+ * const infoClient = createStandaloneInfoClient({ isTestnet: false });
+ * const meta = await infoClient.meta();
+ * ```
+ */
+export const createStandaloneInfoClient = (options) => {
+    const { isTestnet, timeout = PERPS_CONSTANTS.ConnectionTimeoutMs } = options;
+    const httpTransport = new HttpTransport({
+        isTestnet,
+        timeout,
+    });
+    return new InfoClient({ transport: httpTransport });
+};
+//# sourceMappingURL=standaloneInfoClient.mjs.map

package/dist/utils/standaloneInfoClient.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"standaloneInfoClient.mjs","sourceRoot":"","sources":["../../src/utils/standaloneInfoClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,4BAA4B;AAEhE,OAAO,EAAE,eAAe,EAAE,qCAAiC;AAY3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,OAAoC,EACxB,EAAE;IACd,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,eAAe,CAAC,mBAAmB,EAAE,GAAG,OAAO,CAAC;IAE7E,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC;QACtC,SAAS;QACT,OAAO;KACR,CAAC,CAAC;IAEH,OAAO,IAAI,UAAU,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;AACtD,CAAC,CAAC","sourcesContent":["import { HttpTransport, InfoClient } from '@nktkas/hyperliquid';\n\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig';\n\n/**\n * Options for creating a standalone info client.\n */\nexport type StandaloneInfoClientOptions = {\n  /** Whether to use testnet API endpoint */\n  isTestnet: boolean;\n  /** Request timeout in ms (default: CONNECTION_TIMEOUT_MS) */\n  timeout?: number;\n};\n\n/**\n * Creates a standalone InfoClient for lightweight read-only queries.\n * Does not require full perps initialization (no wallet, WebSocket, etc.)\n *\n * Use cases:\n * - Discovery queries (checking if perps market exists)\n * - Portfolio analytics outside perps context\n * - Price feeds without full initialization\n *\n * @param options - Configuration options\n * @param options.isTestnet - Whether to use testnet API endpoint\n * @param options.timeout - Request timeout in ms (default: CONNECTION_TIMEOUT_MS)\n * @returns InfoClient instance\n * @example\n * ```typescript\n * const infoClient = createStandaloneInfoClient({ isTestnet: false });\n * const meta = await infoClient.meta();\n * ```\n */\nexport const createStandaloneInfoClient = (\n  options: StandaloneInfoClientOptions,\n): InfoClient => {\n  const { isTestnet, timeout = PERPS_CONSTANTS.ConnectionTimeoutMs } = options;\n\n  const httpTransport = new HttpTransport({\n    isTestnet,\n    timeout,\n  });\n\n  return new InfoClient({ transport: httpTransport });\n};\n"]}

package/dist/utils/stringParseUtils.cjs

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCommaSeparatedString = exports.stripQuotes = void 0;
+/**
+ * Strip surrounding quotes from a string (handles both single and double quotes)
+ * Use this to clean up values that may have been JSON-encoded with extra quotes
+ *
+ * @param str - String to strip quotes from
+ * @returns String with surrounding quotes removed, or unchanged if no matching quotes
+ *
+ * @example
+ * stripQuotes('"xyz"') // returns "xyz"
+ * stripQuotes("'abc'") // returns "abc"
+ * stripQuotes('xyz')   // returns "xyz" (unchanged)
+ */
+const stripQuotes = (str) => {
+    if ((str.startsWith('"') && str.endsWith('"')) ||
+        (str.startsWith("'") && str.endsWith("'"))) {
+        return str.slice(1, -1);
+    }
+    return str;
+};
+exports.stripQuotes = stripQuotes;
+/**
+ * Parse comma-separated string into array of trimmed non-empty values
+ * Commonly used for LaunchDarkly feature flag list values
+ *
+ * Note: This function only handles parsing and trimming. If your values may
+ * contain surrounding quotes (e.g., from LaunchDarkly JSON encoding), apply
+ * stripQuotes separately: `parseCommaSeparatedString(value).map(stripQuotes)`
+ *
+ * @param value - Comma-separated string
+ * @returns Array of trimmed non-empty strings
+ *
+ * @example Basic usage
+ * parseCommaSeparatedString("xyz:*, abc:TSLA") // returns ["xyz:*", "abc:TSLA"]
+ *
+ * @example Empty string
+ * parseCommaSeparatedString("") // returns []
+ *
+ * @example Whitespace handling
+ * parseCommaSeparatedString("  ,  , xyz  ") // returns ["xyz"]
+ */
+const parseCommaSeparatedString = (value) => value
+    .split(',')
+    .map((item) => item.trim())
+    .filter((item) => item.length > 0);
+exports.parseCommaSeparatedString = parseCommaSeparatedString;
+//# sourceMappingURL=stringParseUtils.cjs.map