@metamask-previews/perps-controller 0.0.0-preview-e4aa1532 → 0.0.0-preview-6dfa4aeba

package/dist/utils/orderBookGrouping.d.cts

@@ -1,76 +0,0 @@
-/**
- * Order book level structure for grouping
- */
-export type OrderBookLevel = {
-    price: string;
-    size: string;
-    total: string;
-    notional: string;
-    totalNotional: string;
-};
-/**
- * Maximum API levels to request from Hyperliquid L2Book API.
- * The API returns at most ~20 levels per side when using nSigFigs aggregation.
- */
-export declare const MAX_ORDER_BOOK_LEVELS = 20;
-/**
- * Parameters for Hyperliquid L2Book API aggregation.
- */
-export type AggregationParams = {
-    nSigFigs: 2 | 3 | 4 | 5;
-    mantissa?: 2 | 5;
-};
-/**
- * Calculate nSigFigs and mantissa based on grouping and price.
- * These parameters match Hyperliquid's L2Book API aggregation:
- * - nSigFigs: 5, mantissa: 2 → finest granularity (~$1-2 for BTC)
- * - nSigFigs: 5, mantissa: 5 → ~$5 increments for BTC
- * - nSigFigs: 4 → ~$10 increments for BTC
- * - nSigFigs: 3 → ~$100 increments for BTC
- * - nSigFigs: 2 → ~$1000 increments for BTC (widest range)
- *
- * mantissa is only applicable when nSigFigs is 5.
- *
- * @param grouping - The price grouping increment
- * @param price - The current mid price
- * @returns Aggregation parameters for the API
- */
-export declare function calculateAggregationParams(grouping: number, price: number): AggregationParams;
-/**
- * Calculate dynamic grouping options based on asset's mid price.
- * Uses "1-2-5 per decade" scale anchored to price magnitude.
- *
- * @param midPrice - The current mid price of the asset
- * @returns Array of grouping options suitable for the price magnitude
- * @example
- * calculateGroupingOptions(87000) → [1, 2, 5, 10, 100, 1000]           // BTC
- * calculateGroupingOptions(33)    → [0.001, 0.002, 0.005, 0.01, 0.1, 1] // HYPE
- * calculateGroupingOptions(0.002) → [0.000001, 0.00001, 0.0001]        // PUMP
- */
-export declare function calculateGroupingOptions(midPrice: number): number[];
-/**
- * Format grouping value for display (e.g., "0.001", "1", "100").
- *
- * @param value - The grouping value to format
- * @returns Formatted string representation
- */
-export declare function formatGroupingLabel(value: number): string;
-/**
- * Select a sensible default grouping option.
- * Picks a middle option that gives reasonable granularity.
- *
- * @param options - Array of available grouping options
- * @returns The recommended default grouping value
- */
-export declare function selectDefaultGrouping(options: number[]): number;
-/**
- * Aggregate order book levels by price grouping.
- * Groups prices into buckets, sums sizes, and recalculates cumulative totals.
- *
- * @param levels - Raw order book levels from API
- * @param groupingSize - Price bucket size (e.g., 10 means group by $10 increments)
- * @param side - 'bid' rounds down to bucket, 'ask' rounds up to bucket
- * @returns Aggregated order book levels
- */
-export declare function aggregateOrderBookLevels(levels: OrderBookLevel[], groupingSize: number, side: 'bid' | 'ask'): OrderBookLevel[];
-//# sourceMappingURL=orderBookGrouping.d.cts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"orderBookGrouping.d.cts","sourceRoot":"","sources":["../../src/utils/orderBookGrouping.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,iBAAiB,CAyBnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAUnE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAI/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,cAAc,EAAE,EACxB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,KAAK,GAAG,KAAK,GAClB,cAAc,EAAE,CA0DlB"}

package/dist/utils/orderBookGrouping.d.mts

@@ -1,76 +0,0 @@
-/**
- * Order book level structure for grouping
- */
-export type OrderBookLevel = {
-    price: string;
-    size: string;
-    total: string;
-    notional: string;
-    totalNotional: string;
-};
-/**
- * Maximum API levels to request from Hyperliquid L2Book API.
- * The API returns at most ~20 levels per side when using nSigFigs aggregation.
- */
-export declare const MAX_ORDER_BOOK_LEVELS = 20;
-/**
- * Parameters for Hyperliquid L2Book API aggregation.
- */
-export type AggregationParams = {
-    nSigFigs: 2 | 3 | 4 | 5;
-    mantissa?: 2 | 5;
-};
-/**
- * Calculate nSigFigs and mantissa based on grouping and price.
- * These parameters match Hyperliquid's L2Book API aggregation:
- * - nSigFigs: 5, mantissa: 2 → finest granularity (~$1-2 for BTC)
- * - nSigFigs: 5, mantissa: 5 → ~$5 increments for BTC
- * - nSigFigs: 4 → ~$10 increments for BTC
- * - nSigFigs: 3 → ~$100 increments for BTC
- * - nSigFigs: 2 → ~$1000 increments for BTC (widest range)
- *
- * mantissa is only applicable when nSigFigs is 5.
- *
- * @param grouping - The price grouping increment
- * @param price - The current mid price
- * @returns Aggregation parameters for the API
- */
-export declare function calculateAggregationParams(grouping: number, price: number): AggregationParams;
-/**
- * Calculate dynamic grouping options based on asset's mid price.
- * Uses "1-2-5 per decade" scale anchored to price magnitude.
- *
- * @param midPrice - The current mid price of the asset
- * @returns Array of grouping options suitable for the price magnitude
- * @example
- * calculateGroupingOptions(87000) → [1, 2, 5, 10, 100, 1000]           // BTC
- * calculateGroupingOptions(33)    → [0.001, 0.002, 0.005, 0.01, 0.1, 1] // HYPE
- * calculateGroupingOptions(0.002) → [0.000001, 0.00001, 0.0001]        // PUMP
- */
-export declare function calculateGroupingOptions(midPrice: number): number[];
-/**
- * Format grouping value for display (e.g., "0.001", "1", "100").
- *
- * @param value - The grouping value to format
- * @returns Formatted string representation
- */
-export declare function formatGroupingLabel(value: number): string;
-/**
- * Select a sensible default grouping option.
- * Picks a middle option that gives reasonable granularity.
- *
- * @param options - Array of available grouping options
- * @returns The recommended default grouping value
- */
-export declare function selectDefaultGrouping(options: number[]): number;
-/**
- * Aggregate order book levels by price grouping.
- * Groups prices into buckets, sums sizes, and recalculates cumulative totals.
- *
- * @param levels - Raw order book levels from API
- * @param groupingSize - Price bucket size (e.g., 10 means group by $10 increments)
- * @param side - 'bid' rounds down to bucket, 'ask' rounds up to bucket
- * @returns Aggregated order book levels
- */
-export declare function aggregateOrderBookLevels(levels: OrderBookLevel[], groupingSize: number, side: 'bid' | 'ask'): OrderBookLevel[];
-//# sourceMappingURL=orderBookGrouping.d.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"orderBookGrouping.d.mts","sourceRoot":"","sources":["../../src/utils/orderBookGrouping.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,iBAAiB,CAyBnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAUnE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAI/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,cAAc,EAAE,EACxB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,KAAK,GAAG,KAAK,GAClB,cAAc,EAAE,CA0DlB"}

package/dist/utils/orderBookGrouping.mjs

@@ -1,143 +0,0 @@
-/**
- * Maximum API levels to request from Hyperliquid L2Book API.
- * The API returns at most ~20 levels per side when using nSigFigs aggregation.
- */
-export const MAX_ORDER_BOOK_LEVELS = 20;
-/**
- * Calculate nSigFigs and mantissa based on grouping and price.
- * These parameters match Hyperliquid's L2Book API aggregation:
- * - nSigFigs: 5, mantissa: 2 → finest granularity (~$1-2 for BTC)
- * - nSigFigs: 5, mantissa: 5 → ~$5 increments for BTC
- * - nSigFigs: 4 → ~$10 increments for BTC
- * - nSigFigs: 3 → ~$100 increments for BTC
- * - nSigFigs: 2 → ~$1000 increments for BTC (widest range)
- *
- * mantissa is only applicable when nSigFigs is 5.
- *
- * @param grouping - The price grouping increment
- * @param price - The current mid price
- * @returns Aggregation parameters for the API
- */
-export function calculateAggregationParams(grouping, price) {
-    // Guard against invalid inputs that would cause Math.log10 to return -Infinity or NaN
-    if (price <= 0 || grouping <= 0) {
-        return { nSigFigs: 5 };
-    }
-    const magnitude = Math.floor(Math.log10(price));
-    const groupingMagnitude = Math.floor(Math.log10(grouping));
-    const baseNSigFigs = magnitude - groupingMagnitude + 1;
-    if (baseNSigFigs >= 5) {
-        // Finest granularity needs mantissa
-        // Derive mantissa from the first digit of grouping
-        const firstDigit = Math.floor(grouping / Math.pow(10, groupingMagnitude));
-        const mantissa = firstDigit <= 2 ? 2 : 5;
-        return { nSigFigs: 5, mantissa };
-    }
-    // Clamp nSigFigs between 2 and 5 (API only supports these values)
-    const clampedNSigFigs = Math.max(2, Math.min(5, baseNSigFigs));
-    return { nSigFigs: clampedNSigFigs };
-}
-/**
- * Calculate dynamic grouping options based on asset's mid price.
- * Uses "1-2-5 per decade" scale anchored to price magnitude.
- *
- * @param midPrice - The current mid price of the asset
- * @returns Array of grouping options suitable for the price magnitude
- * @example
- * calculateGroupingOptions(87000) → [1, 2, 5, 10, 100, 1000]           // BTC
- * calculateGroupingOptions(33)    → [0.001, 0.002, 0.005, 0.01, 0.1, 1] // HYPE
- * calculateGroupingOptions(0.002) → [0.000001, 0.00001, 0.0001]        // PUMP
- */
-export function calculateGroupingOptions(midPrice) {
-    if (midPrice <= 0) {
-        return [0.01, 0.1, 1]; // Fallback for invalid prices
-    }
-    const priceExponent = Math.floor(Math.log10(midPrice));
-    const base = Math.pow(10, priceExponent - 4);
-    const multipliers = [1, 2, 5, 10, 100, 1000];
-    return multipliers.map((multiplier) => base * multiplier);
-}
-/**
- * Format grouping value for display (e.g., "0.001", "1", "100").
- *
- * @param value - The grouping value to format
- * @returns Formatted string representation
- */
-export function formatGroupingLabel(value) {
-    if (value >= 1) {
-        return value.toString();
-    }
-    // Calculate decimal places needed
-    const decimals = Math.max(0, Math.ceil(-Math.log10(value)));
-    return value.toFixed(decimals);
-}
-/**
- * Select a sensible default grouping option.
- * Picks a middle option that gives reasonable granularity.
- *
- * @param options - Array of available grouping options
- * @returns The recommended default grouping value
- */
-export function selectDefaultGrouping(options) {
-    // Pick the 4th option (index 3) which is typically a good balance
-    // For BTC: 10, for HYPE: 0.01, etc.
-    return options[3] ?? options[Math.floor(options.length / 2)] ?? options[0];
-}
-/**
- * Aggregate order book levels by price grouping.
- * Groups prices into buckets, sums sizes, and recalculates cumulative totals.
- *
- * @param levels - Raw order book levels from API
- * @param groupingSize - Price bucket size (e.g., 10 means group by $10 increments)
- * @param side - 'bid' rounds down to bucket, 'ask' rounds up to bucket
- * @returns Aggregated order book levels
- */
-export function aggregateOrderBookLevels(levels, groupingSize, side) {
-    if (!levels.length || groupingSize <= 0) {
-        return levels;
-    }
-    // Group levels by price bucket
-    const buckets = new Map();
-    for (const level of levels) {
-        const price = parseFloat(level.price);
-        const size = parseFloat(level.size);
-        const notional = parseFloat(level.notional);
-        // Round price to bucket
-        // Bids: round down (floor) to include in lower bucket
-        // Asks: round up (ceil) to include in higher bucket
-        let bucketPrice;
-        if (side === 'bid') {
-            bucketPrice = Math.floor(price / groupingSize) * groupingSize;
-        }
-        else {
-            bucketPrice = Math.ceil(price / groupingSize) * groupingSize;
-        }
-        const existing = buckets.get(bucketPrice);
-        if (existing) {
-            existing.size += size;
-            existing.notional += notional;
-        }
-        else {
-            buckets.set(bucketPrice, { size, notional, price: bucketPrice });
-        }
-    }
-    // Convert buckets to array and sort
-    const sortedBuckets = Array.from(buckets.values()).sort((bucketA, bucketB) => side === 'bid'
-        ? bucketB.price - bucketA.price
-        : bucketA.price - bucketB.price);
-    // Calculate cumulative totals
-    let cumulativeSize = 0;
-    let cumulativeNotional = 0;
-    return sortedBuckets.map((bucket) => {
-        cumulativeSize += bucket.size;
-        cumulativeNotional += bucket.notional;
-        return {
-            price: bucket.price.toString(),
-            size: bucket.size.toString(),
-            total: cumulativeSize.toString(),
-            notional: bucket.notional.toFixed(2),
-            totalNotional: cumulativeNotional.toFixed(2),
-        };
-    });
-}
-//# sourceMappingURL=orderBookGrouping.mjs.map

package/dist/utils/orderBookGrouping.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"orderBookGrouping.mjs","sourceRoot":"","sources":["../../src/utils/orderBookGrouping.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Order book level structure for grouping\n */\nexport type OrderBookLevel = {\n  price: string;\n  size: string;\n  total: string;\n  notional: string;\n  totalNotional: string;\n};\n\n/**\n * Maximum API levels to request from Hyperliquid L2Book API.\n * The API returns at most ~20 levels per side when using nSigFigs aggregation.\n */\nexport const MAX_ORDER_BOOK_LEVELS = 20;\n\n/**\n * Parameters for Hyperliquid L2Book API aggregation.\n */\nexport type AggregationParams = {\n  nSigFigs: 2 | 3 | 4 | 5;\n  mantissa?: 2 | 5;\n};\n\n/**\n * Calculate nSigFigs and mantissa based on grouping and price.\n * These parameters match Hyperliquid's L2Book API aggregation:\n * - nSigFigs: 5, mantissa: 2 → finest granularity (~$1-2 for BTC)\n * - nSigFigs: 5, mantissa: 5 → ~$5 increments for BTC\n * - nSigFigs: 4 → ~$10 increments for BTC\n * - nSigFigs: 3 → ~$100 increments for BTC\n * - nSigFigs: 2 → ~$1000 increments for BTC (widest range)\n *\n * mantissa is only applicable when nSigFigs is 5.\n *\n * @param grouping - The price grouping increment\n * @param price - The current mid price\n * @returns Aggregation parameters for the API\n */\nexport function calculateAggregationParams(\n  grouping: number,\n  price: number,\n): AggregationParams {\n  // Guard against invalid inputs that would cause Math.log10 to return -Infinity or NaN\n  if (price <= 0 || grouping <= 0) {\n    return { nSigFigs: 5 };\n  }\n\n  const magnitude = Math.floor(Math.log10(price));\n  const groupingMagnitude = Math.floor(Math.log10(grouping));\n  const baseNSigFigs = magnitude - groupingMagnitude + 1;\n\n  if (baseNSigFigs >= 5) {\n    // Finest granularity needs mantissa\n    // Derive mantissa from the first digit of grouping\n    const firstDigit = Math.floor(grouping / Math.pow(10, groupingMagnitude));\n    const mantissa = firstDigit <= 2 ? 2 : 5;\n    return { nSigFigs: 5, mantissa };\n  }\n\n  // Clamp nSigFigs between 2 and 5 (API only supports these values)\n  const clampedNSigFigs = Math.max(2, Math.min(5, baseNSigFigs)) as\n    | 2\n    | 3\n    | 4\n    | 5;\n  return { nSigFigs: clampedNSigFigs };\n}\n\n/**\n * Calculate dynamic grouping options based on asset's mid price.\n * Uses \"1-2-5 per decade\" scale anchored to price magnitude.\n *\n * @param midPrice - The current mid price of the asset\n * @returns Array of grouping options suitable for the price magnitude\n * @example\n * calculateGroupingOptions(87000) → [1, 2, 5, 10, 100, 1000]           // BTC\n * calculateGroupingOptions(33)    → [0.001, 0.002, 0.005, 0.01, 0.1, 1] // HYPE\n * calculateGroupingOptions(0.002) → [0.000001, 0.00001, 0.0001]        // PUMP\n */\nexport function calculateGroupingOptions(midPrice: number): number[] {\n  if (midPrice <= 0) {\n    return [0.01, 0.1, 1]; // Fallback for invalid prices\n  }\n\n  const priceExponent = Math.floor(Math.log10(midPrice));\n  const base = Math.pow(10, priceExponent - 4);\n  const multipliers = [1, 2, 5, 10, 100, 1000];\n\n  return multipliers.map((multiplier) => base * multiplier);\n}\n\n/**\n * Format grouping value for display (e.g., \"0.001\", \"1\", \"100\").\n *\n * @param value - The grouping value to format\n * @returns Formatted string representation\n */\nexport function formatGroupingLabel(value: number): string {\n  if (value >= 1) {\n    return value.toString();\n  }\n  // Calculate decimal places needed\n  const decimals = Math.max(0, Math.ceil(-Math.log10(value)));\n  return value.toFixed(decimals);\n}\n\n/**\n * Select a sensible default grouping option.\n * Picks a middle option that gives reasonable granularity.\n *\n * @param options - Array of available grouping options\n * @returns The recommended default grouping value\n */\nexport function selectDefaultGrouping(options: number[]): number {\n  // Pick the 4th option (index 3) which is typically a good balance\n  // For BTC: 10, for HYPE: 0.01, etc.\n  return options[3] ?? options[Math.floor(options.length / 2)] ?? options[0];\n}\n\n/**\n * Aggregate order book levels by price grouping.\n * Groups prices into buckets, sums sizes, and recalculates cumulative totals.\n *\n * @param levels - Raw order book levels from API\n * @param groupingSize - Price bucket size (e.g., 10 means group by $10 increments)\n * @param side - 'bid' rounds down to bucket, 'ask' rounds up to bucket\n * @returns Aggregated order book levels\n */\nexport function aggregateOrderBookLevels(\n  levels: OrderBookLevel[],\n  groupingSize: number,\n  side: 'bid' | 'ask',\n): OrderBookLevel[] {\n  if (!levels.length || groupingSize <= 0) {\n    return levels;\n  }\n\n  // Group levels by price bucket\n  const buckets = new Map<\n    number,\n    { size: number; notional: number; price: number }\n  >();\n\n  for (const level of levels) {\n    const price = parseFloat(level.price);\n    const size = parseFloat(level.size);\n    const notional = parseFloat(level.notional);\n\n    // Round price to bucket\n    // Bids: round down (floor) to include in lower bucket\n    // Asks: round up (ceil) to include in higher bucket\n    let bucketPrice: number;\n    if (side === 'bid') {\n      bucketPrice = Math.floor(price / groupingSize) * groupingSize;\n    } else {\n      bucketPrice = Math.ceil(price / groupingSize) * groupingSize;\n    }\n\n    const existing = buckets.get(bucketPrice);\n    if (existing) {\n      existing.size += size;\n      existing.notional += notional;\n    } else {\n      buckets.set(bucketPrice, { size, notional, price: bucketPrice });\n    }\n  }\n\n  // Convert buckets to array and sort\n  const sortedBuckets = Array.from(buckets.values()).sort((bucketA, bucketB) =>\n    side === 'bid'\n      ? bucketB.price - bucketA.price\n      : bucketA.price - bucketB.price,\n  );\n\n  // Calculate cumulative totals\n  let cumulativeSize = 0;\n  let cumulativeNotional = 0;\n\n  return sortedBuckets.map((bucket) => {\n    cumulativeSize += bucket.size;\n    cumulativeNotional += bucket.notional;\n\n    return {\n      price: bucket.price.toString(),\n      size: bucket.size.toString(),\n      total: cumulativeSize.toString(),\n      notional: bucket.notional.toFixed(2),\n      totalNotional: cumulativeNotional.toFixed(2),\n    };\n  });\n}\n"]}

package/dist/utils/orderCalculations.cjs

@@ -1,283 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildOrdersArray = exports.calculateOrderPriceAndSize = exports.calculateFinalPositionSize = exports.getMaxAllowedAmount = exports.calculateMarginRequired = exports.calculatePositionSize = void 0;
-const hyperLiquidAdapter_1 = require("./hyperLiquidAdapter.cjs");
-const perpsConfig_1 = require("../constants/perpsConfig.cjs");
-const perpsErrorCodes_1 = require("../constants/perpsErrorCodes.cjs");
-/**
- * Calculate position size based on USD amount and asset price
- *
- * @param params - Amount in USD, current asset price, and required decimal precision
- * @returns Position size formatted to the asset's decimal precision
- */
-function calculatePositionSize(params) {
-    const { amount, price, szDecimals } = params;
-    // Validate required parameters
-    if (szDecimals === undefined || szDecimals === null) {
-        throw new Error('szDecimals is required for position size calculation');
-    }
-    if (szDecimals < 0) {
-        throw new Error(`szDecimals must be >= 0, got: ${szDecimals}`);
-    }
-    const amountNum = parseFloat(amount || '0');
-    if (isNaN(amountNum) || isNaN(price) || amountNum === 0 || price === 0) {
-        return (0).toFixed(szDecimals);
-    }
-    const positionSize = amountNum / price;
-    const multiplier = Math.pow(10, szDecimals);
-    let rounded = Math.round(positionSize * multiplier) / multiplier;
-    // Ensure rounded size meets requested USD (fix validation gap)
-    const actualUsd = rounded * price;
-    if (actualUsd < amountNum) {
-        rounded += 1 / multiplier;
-    }
-    return rounded.toFixed(szDecimals);
-}
-exports.calculatePositionSize = calculatePositionSize;
-/**
- * Calculate margin required for a position
- *
- * @param params - Position amount and leverage
- * @returns Margin required formatted to 2 decimal places
- */
-function calculateMarginRequired(params) {
-    const { amount, leverage } = params;
-    const amountNum = parseFloat(amount || '0');
-    if (isNaN(amountNum) ||
-        isNaN(leverage) ||
-        amountNum === 0 ||
-        leverage === 0) {
-        return '0.00';
-    }
-    return (amountNum / leverage).toFixed(2);
-}
-exports.calculateMarginRequired = calculateMarginRequired;
-function getMaxAllowedAmount(params) {
-    const { availableBalance, assetPrice, assetSzDecimals, leverage } = params;
-    if (availableBalance === 0 || !assetPrice || assetSzDecimals === undefined) {
-        return 0;
-    }
-    // The theoretical maximum is simply availableBalance * leverage
-    const theoreticalMax = availableBalance * leverage;
-    // But we need to account for position size rounding
-    // Find the largest whole dollar amount that fits within this limit
-    let maxAmount = Math.floor(theoreticalMax);
-    // Verify this amount doesn't exceed available balance after rounding
-    const testPositionSize = calculatePositionSize({
-        amount: maxAmount.toString(),
-        price: assetPrice,
-        szDecimals: assetSzDecimals,
-    });
-    const actualNotionalValue = parseFloat(testPositionSize) * assetPrice;
-    const requiredMargin = actualNotionalValue / leverage;
-    // If rounding caused us to exceed available balance, step down by one position increment
-    if (requiredMargin > availableBalance) {
-        const minPositionSizeIncrement = 1 / Math.pow(10, assetSzDecimals);
-        const positionSizeIncrementUsd = Math.ceil(minPositionSizeIncrement * assetPrice);
-        maxAmount -= positionSizeIncrementUsd;
-    }
-    return Math.max(0, maxAmount);
-}
-exports.getMaxAllowedAmount = getMaxAllowedAmount;
-/**
- * Calculates final position size using USD as source of truth with price validation
- *
- * This function implements the hybrid approach where USD is the source of truth,
- * but includes price staleness validation and proper rounding to prevent precision loss.
- *
- * @param params - USD amount, size, prices, and configuration
- * @returns Final position size as a number
- */
-function calculateFinalPositionSize(params) {
-    const { usdAmount, size, currentPrice, priceAtCalculation, maxSlippageBps, szDecimals, leverage, debugLogger, } = params;
-    let finalPositionSize;
-    if (usdAmount && parseFloat(usdAmount) > 0) {
-        // USD amount provided - use it as source of truth
-        const usdValue = parseFloat(usdAmount);
-        // 1. Validate price staleness if priceAtCalculation provided
-        if (priceAtCalculation) {
-            const priceDeltaBps = Math.abs(((currentPrice - priceAtCalculation) / priceAtCalculation) * 10000);
-            const maxSlippageBpsValue = maxSlippageBps ?? perpsConfig_1.ORDER_SLIPPAGE_CONFIG.DefaultMarketSlippageBps;
-            if (priceDeltaBps > maxSlippageBpsValue) {
-                throw new Error(`Price moved too much: ${priceDeltaBps.toFixed(0)} bps (max: ${maxSlippageBpsValue} bps). ` +
-                    `Expected: ${priceAtCalculation.toFixed(2)}, Current: ${currentPrice.toFixed(2)}`);
-            }
-            debugLogger?.log('Price validation passed:', {
-                priceAtCalculation,
-                currentPrice,
-                deltaBps: priceDeltaBps.toFixed(2),
-                maxSlippageBps: maxSlippageBpsValue,
-            });
-        }
-        // 2. Recalculate position size with fresh price
-        finalPositionSize = usdValue / currentPrice;
-        // 3. Apply size decimals rounding
-        const multiplier = Math.pow(10, szDecimals);
-        finalPositionSize = Math.round(finalPositionSize * multiplier) / multiplier;
-        // 4. Ensure rounded size meets requested USD (fix validation gap)
-        let actualNotionalValue = finalPositionSize * currentPrice;
-        if (actualNotionalValue < usdValue) {
-            // Add 1 minimum increment to meet requested USD
-            finalPositionSize += 1 / multiplier;
-            actualNotionalValue = finalPositionSize * currentPrice;
-            debugLogger?.log('Position size adjusted to meet USD minimum:', {
-                requestedUsd: usdValue,
-                beforeAdjustment: finalPositionSize - 1 / multiplier,
-                afterAdjustment: finalPositionSize,
-                actualUsd: actualNotionalValue,
-            });
-        }
-        const requiredMargin = actualNotionalValue / (leverage ?? 1);
-        // Log if rounding caused significant difference
-        const usdDifference = Math.abs(actualNotionalValue - usdValue);
-        if (usdDifference > 0.01) {
-            debugLogger?.log('Position size rounding caused USD difference (acceptable):', {
-                requestedUsd: usdValue,
-                actualUsd: actualNotionalValue,
-                difference: usdDifference,
-                positionSize: finalPositionSize,
-            });
-        }
-        debugLogger?.log('Recalculated position size with fresh price:', {
-            usdAmount: usdValue,
-            priceAtCalculation,
-            currentPrice,
-            originalSize: size,
-            recalculatedSize: finalPositionSize,
-            requiredMargin,
-            minIncrement: 1 / multiplier,
-        });
-    }
-    else {
-        // Legacy: Use provided size (backward compatibility)
-        finalPositionSize = parseFloat(size ?? '0');
-        debugLogger?.log('Using legacy size calculation (no USD amount provided):', {
-            providedSize: size,
-            finalSize: finalPositionSize,
-        });
-    }
-    return { finalPositionSize };
-}
-exports.calculateFinalPositionSize = calculateFinalPositionSize;
-/**
- * Calculates order price and formatted size based on order type
- *
- * @param params - Order parameters including type, direction, size, and prices
- * @returns Formatted order price, size, and price string
- */
-function calculateOrderPriceAndSize(params) {
-    const { orderType, isBuy, finalPositionSize, currentPrice, limitPrice, slippage, szDecimals, } = params;
-    let orderPrice;
-    let formattedSize;
-    if (orderType === 'market') {
-        // Market orders: add slippage (3% conservative default)
-        const slippageValue = slippage ?? perpsConfig_1.ORDER_SLIPPAGE_CONFIG.DefaultMarketSlippageBps / 10000;
-        orderPrice = isBuy
-            ? currentPrice * (1 + slippageValue)
-            : currentPrice * (1 - slippageValue);
-        formattedSize = (0, hyperLiquidAdapter_1.formatHyperLiquidSize)({
-            size: finalPositionSize,
-            szDecimals,
-        });
-    }
-    else {
-        // Limit orders: use provided price (no slippage applied)
-        if (!limitPrice) {
-            throw new Error(perpsErrorCodes_1.PERPS_ERROR_CODES.ORDER_LIMIT_PRICE_REQUIRED);
-        }
-        orderPrice = parseFloat(limitPrice);
-        formattedSize = (0, hyperLiquidAdapter_1.formatHyperLiquidSize)({
-            size: finalPositionSize,
-            szDecimals,
-        });
-    }
-    const formattedPrice = (0, hyperLiquidAdapter_1.formatHyperLiquidPrice)({
-        price: orderPrice,
-        szDecimals,
-    });
-    return { orderPrice, formattedSize, formattedPrice };
-}
-exports.calculateOrderPriceAndSize = calculateOrderPriceAndSize;
-/**
- * Builds orders array including main order and optional TP/SL orders
- *
- * @param params - Order construction parameters
- * @returns Array of SDK order params and grouping type
- */
-function buildOrdersArray(params) {
-    const { assetId, isBuy, formattedPrice, formattedSize, reduceOnly, orderType, clientOrderId, takeProfitPrice, stopLossPrice, szDecimals, grouping, } = params;
-    const orders = [];
-    // 1. Main order
-    const mainOrder = {
-        a: assetId,
-        b: isBuy,
-        p: formattedPrice,
-        s: formattedSize,
-        r: reduceOnly || false,
-        t: orderType === 'limit'
-            ? { limit: { tif: 'Gtc' } }
-            : { limit: { tif: 'FrontendMarket' } },
-        c: clientOrderId ? clientOrderId : undefined,
-    };
-    orders.push(mainOrder);
-    // 2. Take Profit order
-    if (takeProfitPrice) {
-        const tpOrder = {
-            a: assetId,
-            b: !isBuy,
-            p: (0, hyperLiquidAdapter_1.formatHyperLiquidPrice)({
-                price: parseFloat(takeProfitPrice),
-                szDecimals,
-            }),
-            s: formattedSize,
-            r: true,
-            t: {
-                trigger: {
-                    isMarket: false,
-                    triggerPx: (0, hyperLiquidAdapter_1.formatHyperLiquidPrice)({
-                        price: parseFloat(takeProfitPrice),
-                        szDecimals,
-                    }),
-                    tpsl: 'tp',
-                },
-            },
-        };
-        orders.push(tpOrder);
-    }
-    // 3. Stop Loss order
-    if (stopLossPrice) {
-        // Apply 10% slippage to SL limit price (executes as market order when triggered)
-        // HyperLiquid recommended: 10% for TP/SL orders
-        const stopLossPriceNum = parseFloat(stopLossPrice);
-        const slippageValue = perpsConfig_1.ORDER_SLIPPAGE_CONFIG.DefaultTpslSlippageBps / 10000;
-        const limitPriceWithSlippage = isBuy
-            ? stopLossPriceNum * (1 - slippageValue) // Selling to close long: willing to accept LESS (slippage protection)
-            : stopLossPriceNum * (1 + slippageValue); // Buying to close short: willing to pay MORE (slippage protection)
-        const slOrder = {
-            a: assetId,
-            b: !isBuy,
-            p: (0, hyperLiquidAdapter_1.formatHyperLiquidPrice)({
-                price: limitPriceWithSlippage,
-                szDecimals,
-            }),
-            s: formattedSize,
-            r: true,
-            t: {
-                trigger: {
-                    isMarket: true,
-                    triggerPx: (0, hyperLiquidAdapter_1.formatHyperLiquidPrice)({
-                        price: stopLossPriceNum,
-                        szDecimals,
-                    }),
-                    tpsl: 'sl',
-                },
-            },
-        };
-        orders.push(slOrder);
-    }
-    // Determine grouping
-    const finalGrouping = grouping ?? ((takeProfitPrice ?? stopLossPrice) ? 'normalTpsl' : 'na');
-    return { orders, grouping: finalGrouping };
-}
-exports.buildOrdersArray = buildOrdersArray;
-//# sourceMappingURL=orderCalculations.cjs.map

package/dist/utils/orderCalculations.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"orderCalculations.cjs","sourceRoot":"","sources":["../../src/utils/orderCalculations.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Hex } from '@metamask/utils';\n\nimport {\n  formatHyperLiquidPrice,\n  formatHyperLiquidSize,\n} from './hyperLiquidAdapter';\nimport { ORDER_SLIPPAGE_CONFIG } from '../constants/perpsConfig';\nimport { PERPS_ERROR_CODES } from '../constants/perpsErrorCodes';\nimport type { PerpsDebugLogger } from '../types';\nimport type { SDKOrderParams } from '../types/hyperliquid-types';\n\n/**\n * Optional debug logger for order calculation functions.\n * When provided, enables detailed logging for debugging.\n */\nexport type OrderCalculationsDebugLogger = PerpsDebugLogger | undefined;\n\ntype PositionSizeParams = {\n  amount: string;\n  price: number;\n  szDecimals: number;\n};\n\ntype MarginRequiredParams = {\n  amount: string;\n  leverage: number;\n};\n\ntype MaxAllowedAmountParams = {\n  availableBalance: number;\n  assetPrice: number;\n  assetSzDecimals: number;\n  leverage: number;\n};\n\n// Advanced order calculation interfaces\nexport type CalculateFinalPositionSizeParams = {\n  usdAmount?: string;\n  size?: string;\n  currentPrice: number;\n  priceAtCalculation?: number;\n  maxSlippageBps?: number;\n  szDecimals: number;\n  leverage?: number;\n  debugLogger?: OrderCalculationsDebugLogger;\n};\n\nexport type CalculateFinalPositionSizeResult = {\n  finalPositionSize: number;\n};\n\nexport type CalculateOrderPriceAndSizeParams = {\n  orderType: 'market' | 'limit';\n  isBuy: boolean;\n  finalPositionSize: number;\n  currentPrice: number;\n  limitPrice?: string;\n  slippage?: number;\n  szDecimals: number;\n};\n\nexport type CalculateOrderPriceAndSizeResult = {\n  orderPrice: number;\n  formattedSize: string;\n  formattedPrice: string;\n};\n\nexport type BuildOrdersArrayParams = {\n  assetId: number;\n  isBuy: boolean;\n  formattedPrice: string;\n  formattedSize: string;\n  reduceOnly: boolean;\n  orderType: 'market' | 'limit';\n  clientOrderId?: string;\n  takeProfitPrice?: string;\n  stopLossPrice?: string;\n  szDecimals: number;\n  grouping?: 'na' | 'normalTpsl' | 'positionTpsl';\n};\n\nexport type BuildOrdersArrayResult = {\n  orders: SDKOrderParams[];\n  grouping: 'na' | 'normalTpsl' | 'positionTpsl';\n};\n\n/**\n * Calculate position size based on USD amount and asset price\n *\n * @param params - Amount in USD, current asset price, and required decimal precision\n * @returns Position size formatted to the asset's decimal precision\n */\nexport function calculatePositionSize(params: PositionSizeParams): string {\n  const { amount, price, szDecimals } = params;\n\n  // Validate required parameters\n  if (szDecimals === undefined || szDecimals === null) {\n    throw new Error('szDecimals is required for position size calculation');\n  }\n  if (szDecimals < 0) {\n    throw new Error(`szDecimals must be >= 0, got: ${szDecimals}`);\n  }\n\n  const amountNum = parseFloat(amount || '0');\n\n  if (isNaN(amountNum) || isNaN(price) || amountNum === 0 || price === 0) {\n    return (0).toFixed(szDecimals);\n  }\n\n  const positionSize = amountNum / price;\n  const multiplier = Math.pow(10, szDecimals);\n  let rounded = Math.round(positionSize * multiplier) / multiplier;\n\n  // Ensure rounded size meets requested USD (fix validation gap)\n  const actualUsd = rounded * price;\n  if (actualUsd < amountNum) {\n    rounded += 1 / multiplier;\n  }\n\n  return rounded.toFixed(szDecimals);\n}\n\n/**\n * Calculate margin required for a position\n *\n * @param params - Position amount and leverage\n * @returns Margin required formatted to 2 decimal places\n */\nexport function calculateMarginRequired(params: MarginRequiredParams): string {\n  const { amount, leverage } = params;\n  const amountNum = parseFloat(amount || '0');\n\n  if (\n    isNaN(amountNum) ||\n    isNaN(leverage) ||\n    amountNum === 0 ||\n    leverage === 0\n  ) {\n    return '0.00';\n  }\n\n  return (amountNum / leverage).toFixed(2);\n}\n\nexport function getMaxAllowedAmount(params: MaxAllowedAmountParams): number {\n  const { availableBalance, assetPrice, assetSzDecimals, leverage } = params;\n  if (availableBalance === 0 || !assetPrice || assetSzDecimals === undefined) {\n    return 0;\n  }\n\n  // The theoretical maximum is simply availableBalance * leverage\n  const theoreticalMax = availableBalance * leverage;\n\n  // But we need to account for position size rounding\n  // Find the largest whole dollar amount that fits within this limit\n  let maxAmount = Math.floor(theoreticalMax);\n\n  // Verify this amount doesn't exceed available balance after rounding\n  const testPositionSize = calculatePositionSize({\n    amount: maxAmount.toString(),\n    price: assetPrice,\n    szDecimals: assetSzDecimals,\n  });\n\n  const actualNotionalValue = parseFloat(testPositionSize) * assetPrice;\n  const requiredMargin = actualNotionalValue / leverage;\n\n  // If rounding caused us to exceed available balance, step down by one position increment\n  if (requiredMargin > availableBalance) {\n    const minPositionSizeIncrement = 1 / Math.pow(10, assetSzDecimals);\n    const positionSizeIncrementUsd = Math.ceil(\n      minPositionSizeIncrement * assetPrice,\n    );\n    maxAmount -= positionSizeIncrementUsd;\n  }\n\n  return Math.max(0, maxAmount);\n}\n\n/**\n * Calculates final position size using USD as source of truth with price validation\n *\n * This function implements the hybrid approach where USD is the source of truth,\n * but includes price staleness validation and proper rounding to prevent precision loss.\n *\n * @param params - USD amount, size, prices, and configuration\n * @returns Final position size as a number\n */\nexport function calculateFinalPositionSize(\n  params: CalculateFinalPositionSizeParams,\n): CalculateFinalPositionSizeResult {\n  const {\n    usdAmount,\n    size,\n    currentPrice,\n    priceAtCalculation,\n    maxSlippageBps,\n    szDecimals,\n    leverage,\n    debugLogger,\n  } = params;\n\n  let finalPositionSize: number;\n\n  if (usdAmount && parseFloat(usdAmount) > 0) {\n    // USD amount provided - use it as source of truth\n    const usdValue = parseFloat(usdAmount);\n\n    // 1. Validate price staleness if priceAtCalculation provided\n    if (priceAtCalculation) {\n      const priceDeltaBps = Math.abs(\n        ((currentPrice - priceAtCalculation) / priceAtCalculation) * 10000,\n      );\n      const maxSlippageBpsValue =\n        maxSlippageBps ?? ORDER_SLIPPAGE_CONFIG.DefaultMarketSlippageBps;\n\n      if (priceDeltaBps > maxSlippageBpsValue) {\n        throw new Error(\n          `Price moved too much: ${priceDeltaBps.toFixed(0)} bps (max: ${maxSlippageBpsValue} bps). ` +\n            `Expected: ${priceAtCalculation.toFixed(2)}, Current: ${currentPrice.toFixed(2)}`,\n        );\n      }\n\n      debugLogger?.log('Price validation passed:', {\n        priceAtCalculation,\n        currentPrice,\n        deltaBps: priceDeltaBps.toFixed(2),\n        maxSlippageBps: maxSlippageBpsValue,\n      });\n    }\n\n    // 2. Recalculate position size with fresh price\n    finalPositionSize = usdValue / currentPrice;\n\n    // 3. Apply size decimals rounding\n    const multiplier = Math.pow(10, szDecimals);\n    finalPositionSize = Math.round(finalPositionSize * multiplier) / multiplier;\n\n    // 4. Ensure rounded size meets requested USD (fix validation gap)\n    let actualNotionalValue = finalPositionSize * currentPrice;\n    if (actualNotionalValue < usdValue) {\n      // Add 1 minimum increment to meet requested USD\n      finalPositionSize += 1 / multiplier;\n      actualNotionalValue = finalPositionSize * currentPrice;\n\n      debugLogger?.log('Position size adjusted to meet USD minimum:', {\n        requestedUsd: usdValue,\n        beforeAdjustment: finalPositionSize - 1 / multiplier,\n        afterAdjustment: finalPositionSize,\n        actualUsd: actualNotionalValue,\n      });\n    }\n\n    const requiredMargin = actualNotionalValue / (leverage ?? 1);\n\n    // Log if rounding caused significant difference\n    const usdDifference = Math.abs(actualNotionalValue - usdValue);\n    if (usdDifference > 0.01) {\n      debugLogger?.log(\n        'Position size rounding caused USD difference (acceptable):',\n        {\n          requestedUsd: usdValue,\n          actualUsd: actualNotionalValue,\n          difference: usdDifference,\n          positionSize: finalPositionSize,\n        },\n      );\n    }\n\n    debugLogger?.log('Recalculated position size with fresh price:', {\n      usdAmount: usdValue,\n      priceAtCalculation,\n      currentPrice,\n      originalSize: size,\n      recalculatedSize: finalPositionSize,\n      requiredMargin,\n      minIncrement: 1 / multiplier,\n    });\n  } else {\n    // Legacy: Use provided size (backward compatibility)\n    finalPositionSize = parseFloat(size ?? '0');\n\n    debugLogger?.log(\n      'Using legacy size calculation (no USD amount provided):',\n      {\n        providedSize: size,\n        finalSize: finalPositionSize,\n      },\n    );\n  }\n\n  return { finalPositionSize };\n}\n\n/**\n * Calculates order price and formatted size based on order type\n *\n * @param params - Order parameters including type, direction, size, and prices\n * @returns Formatted order price, size, and price string\n */\nexport function calculateOrderPriceAndSize(\n  params: CalculateOrderPriceAndSizeParams,\n): CalculateOrderPriceAndSizeResult {\n  const {\n    orderType,\n    isBuy,\n    finalPositionSize,\n    currentPrice,\n    limitPrice,\n    slippage,\n    szDecimals,\n  } = params;\n\n  let orderPrice: number;\n  let formattedSize: string;\n\n  if (orderType === 'market') {\n    // Market orders: add slippage (3% conservative default)\n    const slippageValue =\n      slippage ?? ORDER_SLIPPAGE_CONFIG.DefaultMarketSlippageBps / 10000;\n    orderPrice = isBuy\n      ? currentPrice * (1 + slippageValue)\n      : currentPrice * (1 - slippageValue);\n    formattedSize = formatHyperLiquidSize({\n      size: finalPositionSize,\n      szDecimals,\n    });\n  } else {\n    // Limit orders: use provided price (no slippage applied)\n    if (!limitPrice) {\n      throw new Error(PERPS_ERROR_CODES.ORDER_LIMIT_PRICE_REQUIRED);\n    }\n    orderPrice = parseFloat(limitPrice);\n    formattedSize = formatHyperLiquidSize({\n      size: finalPositionSize,\n      szDecimals,\n    });\n  }\n\n  const formattedPrice = formatHyperLiquidPrice({\n    price: orderPrice,\n    szDecimals,\n  });\n\n  return { orderPrice, formattedSize, formattedPrice };\n}\n\n/**\n * Builds orders array including main order and optional TP/SL orders\n *\n * @param params - Order construction parameters\n * @returns Array of SDK order params and grouping type\n */\nexport function buildOrdersArray(\n  params: BuildOrdersArrayParams,\n): BuildOrdersArrayResult {\n  const {\n    assetId,\n    isBuy,\n    formattedPrice,\n    formattedSize,\n    reduceOnly,\n    orderType,\n    clientOrderId,\n    takeProfitPrice,\n    stopLossPrice,\n    szDecimals,\n    grouping,\n  } = params;\n\n  const orders: SDKOrderParams[] = [];\n\n  // 1. Main order\n  const mainOrder: SDKOrderParams = {\n    a: assetId,\n    b: isBuy,\n    p: formattedPrice,\n    s: formattedSize,\n    r: reduceOnly || false,\n    t:\n      orderType === 'limit'\n        ? { limit: { tif: 'Gtc' } }\n        : { limit: { tif: 'FrontendMarket' } },\n    c: clientOrderId ? (clientOrderId as Hex) : undefined,\n  };\n  orders.push(mainOrder);\n\n  // 2. Take Profit order\n  if (takeProfitPrice) {\n    const tpOrder: SDKOrderParams = {\n      a: assetId,\n      b: !isBuy,\n      p: formatHyperLiquidPrice({\n        price: parseFloat(takeProfitPrice),\n        szDecimals,\n      }),\n      s: formattedSize,\n      r: true,\n      t: {\n        trigger: {\n          isMarket: false,\n          triggerPx: formatHyperLiquidPrice({\n            price: parseFloat(takeProfitPrice),\n            szDecimals,\n          }),\n          tpsl: 'tp',\n        },\n      },\n    };\n    orders.push(tpOrder);\n  }\n\n  // 3. Stop Loss order\n  if (stopLossPrice) {\n    // Apply 10% slippage to SL limit price (executes as market order when triggered)\n    // HyperLiquid recommended: 10% for TP/SL orders\n    const stopLossPriceNum = parseFloat(stopLossPrice);\n    const slippageValue = ORDER_SLIPPAGE_CONFIG.DefaultTpslSlippageBps / 10000;\n    const limitPriceWithSlippage = isBuy\n      ? stopLossPriceNum * (1 - slippageValue) // Selling to close long: willing to accept LESS (slippage protection)\n      : stopLossPriceNum * (1 + slippageValue); // Buying to close short: willing to pay MORE (slippage protection)\n\n    const slOrder: SDKOrderParams = {\n      a: assetId,\n      b: !isBuy,\n      p: formatHyperLiquidPrice({\n        price: limitPriceWithSlippage,\n        szDecimals,\n      }),\n      s: formattedSize,\n      r: true,\n      t: {\n        trigger: {\n          isMarket: true,\n          triggerPx: formatHyperLiquidPrice({\n            price: stopLossPriceNum,\n            szDecimals,\n          }),\n          tpsl: 'sl',\n        },\n      },\n    };\n    orders.push(slOrder);\n  }\n\n  // Determine grouping\n  const finalGrouping: 'na' | 'normalTpsl' | 'positionTpsl' =\n    grouping ?? ((takeProfitPrice ?? stopLossPrice) ? 'normalTpsl' : 'na');\n\n  return { orders, grouping: finalGrouping };\n}\n"]}