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

package/dist/utils/marginUtils.cjs

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateNewLiquidationPrice = exports.calculateMaxRemovableMargin = exports.assessMarginRemovalRisk = void 0;
+/**
+ * Margin adjustment calculation utilities
+ * Provides risk assessment and margin calculation functions for position management
+ */
+const perpsConfig_1 = require("../constants/perpsConfig.cjs");
+/**
+ * Assess liquidation risk after margin removal
+ * Compares new liquidation price against current market price to determine risk level
+ *
+ * @param params - New liquidation price, current market price, and position direction
+ * @returns Risk assessment with level (safe/warning/danger), price difference, and risk ratio
+ */
+function assessMarginRemovalRisk(params) {
+    const { newLiquidationPrice, currentPrice, isLong } = params;
+    if (!newLiquidationPrice ||
+        !currentPrice ||
+        isNaN(newLiquidationPrice) ||
+        isNaN(currentPrice)) {
+        return { riskLevel: 'safe', priceDiff: 0, riskRatio: 0 };
+    }
+    // Calculate price difference based on position direction
+    // For long: current price should be above liquidation price
+    // For short: liquidation price should be above current price
+    const priceDiff = isLong
+        ? currentPrice - newLiquidationPrice
+        : newLiquidationPrice - currentPrice;
+    // Risk ratio: how far away is price from liquidation, relative to liquidation price
+    // Higher ratio = safer (price is far from liquidation)
+    // Lower ratio = riskier (price is close to liquidation)
+    const riskRatio = priceDiff / newLiquidationPrice;
+    let riskLevel;
+    if (riskRatio < perpsConfig_1.MARGIN_ADJUSTMENT_CONFIG.LiquidationRiskThreshold - 1) {
+        riskLevel = 'danger'; // <20% buffer - critical risk
+    }
+    else if (riskRatio <
+        perpsConfig_1.MARGIN_ADJUSTMENT_CONFIG.LiquidationWarningThreshold - 1) {
+        riskLevel = 'warning'; // <50% buffer - moderate risk
+    }
+    else {
+        riskLevel = 'safe'; // >=50% buffer - safe
+    }
+    return { riskLevel, priceDiff, riskRatio };
+}
+exports.assessMarginRemovalRisk = assessMarginRemovalRisk;
+/**
+ * Calculate maximum margin that can be safely removed from a position
+ *
+ * HyperLiquid enforces: transfer_margin_required = max(initial_margin_required, 0.1 * total_position_value)
+ * See: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/margin-and-pnl
+ * See also: docs/perps/hyperliquid/margining.md
+ *
+ * Key insight from Hyperliquid support (Xulian, Dec 6, 2025):
+ * "you need to account for initial margin for withdrawal, maintenance is what is needed to not be liquidated"
+ *
+ * The initial margin is calculated using the POSITION'S leverage (not the asset's max leverage).
+ * For example, a position opened at 10x leverage requires 10% initial margin,
+ * not 2% (which would be for 50x max leverage).
+ *
+ * @param params - Current margin, position size, prices, and position leverage
+ * @returns Maximum removable margin amount in USD
+ */
+function calculateMaxRemovableMargin(params) {
+    const { currentMargin, positionSize, currentPrice, positionLeverage, notionalValue: providedNotionalValue, } = params;
+    // Validate inputs
+    if (isNaN(currentMargin) ||
+        isNaN(positionLeverage) ||
+        currentMargin <= 0 ||
+        positionLeverage <= 0) {
+        return 0;
+    }
+    // Use provided notional value (e.g., from position.positionValue) or calculate from price
+    // This allows immediate display before live prices load
+    let notionalValue = providedNotionalValue;
+    if (notionalValue === undefined ||
+        isNaN(notionalValue) ||
+        notionalValue <= 0) {
+        // Fall back to calculating from price if not provided or invalid
+        if (isNaN(positionSize) ||
+            isNaN(currentPrice) ||
+            positionSize <= 0 ||
+            currentPrice <= 0) {
+            return 0;
+        }
+        notionalValue = positionSize * currentPrice;
+    }
+    // Hyperliquid's transfer margin requirement formula:
+    // transfer_margin_required = max(initial_margin_required, 0.1 * total_position_value)
+    //
+    // IMPORTANT: Use the position's actual leverage, not the asset's max leverage
+    // A position at 10x leverage needs 10% initial margin ($100 for $1000 notional)
+    // NOT the 2% that 50x max leverage would imply
+    const initialMarginRequired = notionalValue / positionLeverage;
+    const tenPercentMargin = notionalValue * perpsConfig_1.MARGIN_ADJUSTMENT_CONFIG.MarginRemovalSafetyBuffer;
+    // Transfer margin required is the MAX of these two constraints
+    const transferMarginRequired = Math.max(initialMarginRequired, tenPercentMargin);
+    // Note: Unrealized PnL is NOT counted as part of "remaining margin" for withdrawals
+    // Per Hyperliquid docs, unrealized PnL helps prevent liquidation but doesn't
+    // increase your available withdrawal limit for margin transfers
+    // Maximum removable = current margin - required (must be non-negative)
+    return Math.max(0, currentMargin - transferMarginRequired);
+}
+exports.calculateMaxRemovableMargin = calculateMaxRemovableMargin;
+/**
+ * Calculate new liquidation price after margin adjustment
+ * Estimates where the liquidation price will move based on margin change
+ * Note: This is a simplified calculation; actual liquidation price may vary based on protocol
+ *
+ * @param params - New margin amount, position size, entry price, direction, and current liquidation price
+ * @returns Estimated new liquidation price
+ */
+function calculateNewLiquidationPrice(params) {
+    const { newMargin, positionSize, entryPrice, isLong, currentLiquidationPrice, } = params;
+    // Validate inputs
+    if (isNaN(newMargin) ||
+        isNaN(positionSize) ||
+        isNaN(entryPrice) ||
+        newMargin <= 0 ||
+        positionSize <= 0 ||
+        entryPrice <= 0) {
+        return currentLiquidationPrice; // Return current if invalid inputs
+    }
+    // Calculate margin per unit of position
+    const marginPerUnit = newMargin / positionSize;
+    // For long positions: liquidation price is below entry price
+    // liquidationPrice = entryPrice - marginPerUnit
+    // For short positions: liquidation price is above entry price
+    // liquidationPrice = entryPrice + marginPerUnit
+    if (isLong) {
+        return Math.max(0, entryPrice - marginPerUnit);
+    }
+    return entryPrice + marginPerUnit;
+}
+exports.calculateNewLiquidationPrice = calculateNewLiquidationPrice;
+//# sourceMappingURL=marginUtils.cjs.map

package/dist/utils/marginUtils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"marginUtils.cjs","sourceRoot":"","sources":["../../src/utils/marginUtils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Margin adjustment calculation utilities\n * Provides risk assessment and margin calculation functions for position management\n */\nimport { MARGIN_ADJUSTMENT_CONFIG } from '../constants/perpsConfig';\n\nexport type RiskLevel = 'safe' | 'warning' | 'danger';\n\nexport type MarginRiskAssessment = {\n  riskLevel: RiskLevel;\n  priceDiff: number;\n  riskRatio: number;\n};\n\nexport type AssessMarginRemovalRiskParams = {\n  newLiquidationPrice: number;\n  currentPrice: number;\n  isLong: boolean;\n};\n\nexport type CalculateMaxRemovableMarginParams = {\n  currentMargin: number;\n  positionSize: number;\n  entryPrice: number;\n  currentPrice: number;\n  /** The actual leverage of the position (not the asset's max leverage) */\n  positionLeverage: number;\n  /** Optional pre-calculated notional value (e.g., from position.positionValue) for immediate display before live prices load */\n  notionalValue?: number;\n};\n\nexport type CalculateNewLiquidationPriceParams = {\n  newMargin: number;\n  positionSize: number;\n  entryPrice: number;\n  isLong: boolean;\n  currentLiquidationPrice: number;\n};\n\n/**\n * Assess liquidation risk after margin removal\n * Compares new liquidation price against current market price to determine risk level\n *\n * @param params - New liquidation price, current market price, and position direction\n * @returns Risk assessment with level (safe/warning/danger), price difference, and risk ratio\n */\nexport function assessMarginRemovalRisk(\n  params: AssessMarginRemovalRiskParams,\n): MarginRiskAssessment {\n  const { newLiquidationPrice, currentPrice, isLong } = params;\n\n  if (\n    !newLiquidationPrice ||\n    !currentPrice ||\n    isNaN(newLiquidationPrice) ||\n    isNaN(currentPrice)\n  ) {\n    return { riskLevel: 'safe', priceDiff: 0, riskRatio: 0 };\n  }\n\n  // Calculate price difference based on position direction\n  // For long: current price should be above liquidation price\n  // For short: liquidation price should be above current price\n  const priceDiff = isLong\n    ? currentPrice - newLiquidationPrice\n    : newLiquidationPrice - currentPrice;\n\n  // Risk ratio: how far away is price from liquidation, relative to liquidation price\n  // Higher ratio = safer (price is far from liquidation)\n  // Lower ratio = riskier (price is close to liquidation)\n  const riskRatio = priceDiff / newLiquidationPrice;\n\n  let riskLevel: RiskLevel;\n  if (riskRatio < MARGIN_ADJUSTMENT_CONFIG.LiquidationRiskThreshold - 1) {\n    riskLevel = 'danger'; // <20% buffer - critical risk\n  } else if (\n    riskRatio <\n    MARGIN_ADJUSTMENT_CONFIG.LiquidationWarningThreshold - 1\n  ) {\n    riskLevel = 'warning'; // <50% buffer - moderate risk\n  } else {\n    riskLevel = 'safe'; // >=50% buffer - safe\n  }\n\n  return { riskLevel, priceDiff, riskRatio };\n}\n\n/**\n * Calculate maximum margin that can be safely removed from a position\n *\n * HyperLiquid enforces: transfer_margin_required = max(initial_margin_required, 0.1 * total_position_value)\n * See: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/margin-and-pnl\n * See also: docs/perps/hyperliquid/margining.md\n *\n * Key insight from Hyperliquid support (Xulian, Dec 6, 2025):\n * \"you need to account for initial margin for withdrawal, maintenance is what is needed to not be liquidated\"\n *\n * The initial margin is calculated using the POSITION'S leverage (not the asset's max leverage).\n * For example, a position opened at 10x leverage requires 10% initial margin,\n * not 2% (which would be for 50x max leverage).\n *\n * @param params - Current margin, position size, prices, and position leverage\n * @returns Maximum removable margin amount in USD\n */\nexport function calculateMaxRemovableMargin(\n  params: CalculateMaxRemovableMarginParams,\n): number {\n  const {\n    currentMargin,\n    positionSize,\n    currentPrice,\n    positionLeverage,\n    notionalValue: providedNotionalValue,\n  } = params;\n\n  // Validate inputs\n  if (\n    isNaN(currentMargin) ||\n    isNaN(positionLeverage) ||\n    currentMargin <= 0 ||\n    positionLeverage <= 0\n  ) {\n    return 0;\n  }\n\n  // Use provided notional value (e.g., from position.positionValue) or calculate from price\n  // This allows immediate display before live prices load\n  let notionalValue = providedNotionalValue;\n  if (\n    notionalValue === undefined ||\n    isNaN(notionalValue) ||\n    notionalValue <= 0\n  ) {\n    // Fall back to calculating from price if not provided or invalid\n    if (\n      isNaN(positionSize) ||\n      isNaN(currentPrice) ||\n      positionSize <= 0 ||\n      currentPrice <= 0\n    ) {\n      return 0;\n    }\n    notionalValue = positionSize * currentPrice;\n  }\n\n  // Hyperliquid's transfer margin requirement formula:\n  // transfer_margin_required = max(initial_margin_required, 0.1 * total_position_value)\n  //\n  // IMPORTANT: Use the position's actual leverage, not the asset's max leverage\n  // A position at 10x leverage needs 10% initial margin ($100 for $1000 notional)\n  // NOT the 2% that 50x max leverage would imply\n  const initialMarginRequired = notionalValue / positionLeverage;\n  const tenPercentMargin =\n    notionalValue * MARGIN_ADJUSTMENT_CONFIG.MarginRemovalSafetyBuffer;\n\n  // Transfer margin required is the MAX of these two constraints\n  const transferMarginRequired = Math.max(\n    initialMarginRequired,\n    tenPercentMargin,\n  );\n\n  // Note: Unrealized PnL is NOT counted as part of \"remaining margin\" for withdrawals\n  // Per Hyperliquid docs, unrealized PnL helps prevent liquidation but doesn't\n  // increase your available withdrawal limit for margin transfers\n  // Maximum removable = current margin - required (must be non-negative)\n  return Math.max(0, currentMargin - transferMarginRequired);\n}\n\n/**\n * Calculate new liquidation price after margin adjustment\n * Estimates where the liquidation price will move based on margin change\n * Note: This is a simplified calculation; actual liquidation price may vary based on protocol\n *\n * @param params - New margin amount, position size, entry price, direction, and current liquidation price\n * @returns Estimated new liquidation price\n */\nexport function calculateNewLiquidationPrice(\n  params: CalculateNewLiquidationPriceParams,\n): number {\n  const {\n    newMargin,\n    positionSize,\n    entryPrice,\n    isLong,\n    currentLiquidationPrice,\n  } = params;\n\n  // Validate inputs\n  if (\n    isNaN(newMargin) ||\n    isNaN(positionSize) ||\n    isNaN(entryPrice) ||\n    newMargin <= 0 ||\n    positionSize <= 0 ||\n    entryPrice <= 0\n  ) {\n    return currentLiquidationPrice; // Return current if invalid inputs\n  }\n\n  // Calculate margin per unit of position\n  const marginPerUnit = newMargin / positionSize;\n\n  // For long positions: liquidation price is below entry price\n  // liquidationPrice = entryPrice - marginPerUnit\n  // For short positions: liquidation price is above entry price\n  // liquidationPrice = entryPrice + marginPerUnit\n  if (isLong) {\n    return Math.max(0, entryPrice - marginPerUnit);\n  }\n  return entryPrice + marginPerUnit;\n}\n"]}

package/dist/utils/marginUtils.d.cts

@@ -0,0 +1,64 @@
+export type RiskLevel = 'safe' | 'warning' | 'danger';
+export type MarginRiskAssessment = {
+    riskLevel: RiskLevel;
+    priceDiff: number;
+    riskRatio: number;
+};
+export type AssessMarginRemovalRiskParams = {
+    newLiquidationPrice: number;
+    currentPrice: number;
+    isLong: boolean;
+};
+export type CalculateMaxRemovableMarginParams = {
+    currentMargin: number;
+    positionSize: number;
+    entryPrice: number;
+    currentPrice: number;
+    /** The actual leverage of the position (not the asset's max leverage) */
+    positionLeverage: number;
+    /** Optional pre-calculated notional value (e.g., from position.positionValue) for immediate display before live prices load */
+    notionalValue?: number;
+};
+export type CalculateNewLiquidationPriceParams = {
+    newMargin: number;
+    positionSize: number;
+    entryPrice: number;
+    isLong: boolean;
+    currentLiquidationPrice: number;
+};
+/**
+ * Assess liquidation risk after margin removal
+ * Compares new liquidation price against current market price to determine risk level
+ *
+ * @param params - New liquidation price, current market price, and position direction
+ * @returns Risk assessment with level (safe/warning/danger), price difference, and risk ratio
+ */
+export declare function assessMarginRemovalRisk(params: AssessMarginRemovalRiskParams): MarginRiskAssessment;
+/**
+ * Calculate maximum margin that can be safely removed from a position
+ *
+ * HyperLiquid enforces: transfer_margin_required = max(initial_margin_required, 0.1 * total_position_value)
+ * See: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/margin-and-pnl
+ * See also: docs/perps/hyperliquid/margining.md
+ *
+ * Key insight from Hyperliquid support (Xulian, Dec 6, 2025):
+ * "you need to account for initial margin for withdrawal, maintenance is what is needed to not be liquidated"
+ *
+ * The initial margin is calculated using the POSITION'S leverage (not the asset's max leverage).
+ * For example, a position opened at 10x leverage requires 10% initial margin,
+ * not 2% (which would be for 50x max leverage).
+ *
+ * @param params - Current margin, position size, prices, and position leverage
+ * @returns Maximum removable margin amount in USD
+ */
+export declare function calculateMaxRemovableMargin(params: CalculateMaxRemovableMarginParams): number;
+/**
+ * Calculate new liquidation price after margin adjustment
+ * Estimates where the liquidation price will move based on margin change
+ * Note: This is a simplified calculation; actual liquidation price may vary based on protocol
+ *
+ * @param params - New margin amount, position size, entry price, direction, and current liquidation price
+ * @returns Estimated new liquidation price
+ */
+export declare function calculateNewLiquidationPrice(params: CalculateNewLiquidationPriceParams): number;
+//# sourceMappingURL=marginUtils.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"marginUtils.d.cts","sourceRoot":"","sources":["../../src/utils/marginUtils.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEtD,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,CAAC;IACzB,+HAA+H;IAC/H,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,uBAAuB,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,6BAA6B,GACpC,oBAAoB,CAqCtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,iCAAiC,GACxC,MAAM,CA4DR;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,kCAAkC,GACzC,MAAM,CAgCR"}

package/dist/utils/marginUtils.d.mts

@@ -0,0 +1,64 @@
+export type RiskLevel = 'safe' | 'warning' | 'danger';
+export type MarginRiskAssessment = {
+    riskLevel: RiskLevel;
+    priceDiff: number;
+    riskRatio: number;
+};
+export type AssessMarginRemovalRiskParams = {
+    newLiquidationPrice: number;
+    currentPrice: number;
+    isLong: boolean;
+};
+export type CalculateMaxRemovableMarginParams = {
+    currentMargin: number;
+    positionSize: number;
+    entryPrice: number;
+    currentPrice: number;
+    /** The actual leverage of the position (not the asset's max leverage) */
+    positionLeverage: number;
+    /** Optional pre-calculated notional value (e.g., from position.positionValue) for immediate display before live prices load */
+    notionalValue?: number;
+};
+export type CalculateNewLiquidationPriceParams = {
+    newMargin: number;
+    positionSize: number;
+    entryPrice: number;
+    isLong: boolean;
+    currentLiquidationPrice: number;
+};
+/**
+ * Assess liquidation risk after margin removal
+ * Compares new liquidation price against current market price to determine risk level
+ *
+ * @param params - New liquidation price, current market price, and position direction
+ * @returns Risk assessment with level (safe/warning/danger), price difference, and risk ratio
+ */
+export declare function assessMarginRemovalRisk(params: AssessMarginRemovalRiskParams): MarginRiskAssessment;
+/**
+ * Calculate maximum margin that can be safely removed from a position
+ *
+ * HyperLiquid enforces: transfer_margin_required = max(initial_margin_required, 0.1 * total_position_value)
+ * See: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/margin-and-pnl
+ * See also: docs/perps/hyperliquid/margining.md
+ *
+ * Key insight from Hyperliquid support (Xulian, Dec 6, 2025):
+ * "you need to account for initial margin for withdrawal, maintenance is what is needed to not be liquidated"
+ *
+ * The initial margin is calculated using the POSITION'S leverage (not the asset's max leverage).
+ * For example, a position opened at 10x leverage requires 10% initial margin,
+ * not 2% (which would be for 50x max leverage).
+ *
+ * @param params - Current margin, position size, prices, and position leverage
+ * @returns Maximum removable margin amount in USD
+ */
+export declare function calculateMaxRemovableMargin(params: CalculateMaxRemovableMarginParams): number;
+/**
+ * Calculate new liquidation price after margin adjustment
+ * Estimates where the liquidation price will move based on margin change
+ * Note: This is a simplified calculation; actual liquidation price may vary based on protocol
+ *
+ * @param params - New margin amount, position size, entry price, direction, and current liquidation price
+ * @returns Estimated new liquidation price
+ */
+export declare function calculateNewLiquidationPrice(params: CalculateNewLiquidationPriceParams): number;
+//# sourceMappingURL=marginUtils.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"marginUtils.d.mts","sourceRoot":"","sources":["../../src/utils/marginUtils.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEtD,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,CAAC;IACzB,+HAA+H;IAC/H,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,uBAAuB,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,6BAA6B,GACpC,oBAAoB,CAqCtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,iCAAiC,GACxC,MAAM,CA4DR;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,kCAAkC,GACzC,MAAM,CAgCR"}

package/dist/utils/marginUtils.mjs

@@ -0,0 +1,131 @@
+/**
+ * Margin adjustment calculation utilities
+ * Provides risk assessment and margin calculation functions for position management
+ */
+import { MARGIN_ADJUSTMENT_CONFIG } from "../constants/perpsConfig.mjs";
+/**
+ * Assess liquidation risk after margin removal
+ * Compares new liquidation price against current market price to determine risk level
+ *
+ * @param params - New liquidation price, current market price, and position direction
+ * @returns Risk assessment with level (safe/warning/danger), price difference, and risk ratio
+ */
+export function assessMarginRemovalRisk(params) {
+    const { newLiquidationPrice, currentPrice, isLong } = params;
+    if (!newLiquidationPrice ||
+        !currentPrice ||
+        isNaN(newLiquidationPrice) ||
+        isNaN(currentPrice)) {
+        return { riskLevel: 'safe', priceDiff: 0, riskRatio: 0 };
+    }
+    // Calculate price difference based on position direction
+    // For long: current price should be above liquidation price
+    // For short: liquidation price should be above current price
+    const priceDiff = isLong
+        ? currentPrice - newLiquidationPrice
+        : newLiquidationPrice - currentPrice;
+    // Risk ratio: how far away is price from liquidation, relative to liquidation price
+    // Higher ratio = safer (price is far from liquidation)
+    // Lower ratio = riskier (price is close to liquidation)
+    const riskRatio = priceDiff / newLiquidationPrice;
+    let riskLevel;
+    if (riskRatio < MARGIN_ADJUSTMENT_CONFIG.LiquidationRiskThreshold - 1) {
+        riskLevel = 'danger'; // <20% buffer - critical risk
+    }
+    else if (riskRatio <
+        MARGIN_ADJUSTMENT_CONFIG.LiquidationWarningThreshold - 1) {
+        riskLevel = 'warning'; // <50% buffer - moderate risk
+    }
+    else {
+        riskLevel = 'safe'; // >=50% buffer - safe
+    }
+    return { riskLevel, priceDiff, riskRatio };
+}
+/**
+ * Calculate maximum margin that can be safely removed from a position
+ *
+ * HyperLiquid enforces: transfer_margin_required = max(initial_margin_required, 0.1 * total_position_value)
+ * See: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/margin-and-pnl
+ * See also: docs/perps/hyperliquid/margining.md
+ *
+ * Key insight from Hyperliquid support (Xulian, Dec 6, 2025):
+ * "you need to account for initial margin for withdrawal, maintenance is what is needed to not be liquidated"
+ *
+ * The initial margin is calculated using the POSITION'S leverage (not the asset's max leverage).
+ * For example, a position opened at 10x leverage requires 10% initial margin,
+ * not 2% (which would be for 50x max leverage).
+ *
+ * @param params - Current margin, position size, prices, and position leverage
+ * @returns Maximum removable margin amount in USD
+ */
+export function calculateMaxRemovableMargin(params) {
+    const { currentMargin, positionSize, currentPrice, positionLeverage, notionalValue: providedNotionalValue, } = params;
+    // Validate inputs
+    if (isNaN(currentMargin) ||
+        isNaN(positionLeverage) ||
+        currentMargin <= 0 ||
+        positionLeverage <= 0) {
+        return 0;
+    }
+    // Use provided notional value (e.g., from position.positionValue) or calculate from price
+    // This allows immediate display before live prices load
+    let notionalValue = providedNotionalValue;
+    if (notionalValue === undefined ||
+        isNaN(notionalValue) ||
+        notionalValue <= 0) {
+        // Fall back to calculating from price if not provided or invalid
+        if (isNaN(positionSize) ||
+            isNaN(currentPrice) ||
+            positionSize <= 0 ||
+            currentPrice <= 0) {
+            return 0;
+        }
+        notionalValue = positionSize * currentPrice;
+    }
+    // Hyperliquid's transfer margin requirement formula:
+    // transfer_margin_required = max(initial_margin_required, 0.1 * total_position_value)
+    //
+    // IMPORTANT: Use the position's actual leverage, not the asset's max leverage
+    // A position at 10x leverage needs 10% initial margin ($100 for $1000 notional)
+    // NOT the 2% that 50x max leverage would imply
+    const initialMarginRequired = notionalValue / positionLeverage;
+    const tenPercentMargin = notionalValue * MARGIN_ADJUSTMENT_CONFIG.MarginRemovalSafetyBuffer;
+    // Transfer margin required is the MAX of these two constraints
+    const transferMarginRequired = Math.max(initialMarginRequired, tenPercentMargin);
+    // Note: Unrealized PnL is NOT counted as part of "remaining margin" for withdrawals
+    // Per Hyperliquid docs, unrealized PnL helps prevent liquidation but doesn't
+    // increase your available withdrawal limit for margin transfers
+    // Maximum removable = current margin - required (must be non-negative)
+    return Math.max(0, currentMargin - transferMarginRequired);
+}
+/**
+ * Calculate new liquidation price after margin adjustment
+ * Estimates where the liquidation price will move based on margin change
+ * Note: This is a simplified calculation; actual liquidation price may vary based on protocol
+ *
+ * @param params - New margin amount, position size, entry price, direction, and current liquidation price
+ * @returns Estimated new liquidation price
+ */
+export function calculateNewLiquidationPrice(params) {
+    const { newMargin, positionSize, entryPrice, isLong, currentLiquidationPrice, } = params;
+    // Validate inputs
+    if (isNaN(newMargin) ||
+        isNaN(positionSize) ||
+        isNaN(entryPrice) ||
+        newMargin <= 0 ||
+        positionSize <= 0 ||
+        entryPrice <= 0) {
+        return currentLiquidationPrice; // Return current if invalid inputs
+    }
+    // Calculate margin per unit of position
+    const marginPerUnit = newMargin / positionSize;
+    // For long positions: liquidation price is below entry price
+    // liquidationPrice = entryPrice - marginPerUnit
+    // For short positions: liquidation price is above entry price
+    // liquidationPrice = entryPrice + marginPerUnit
+    if (isLong) {
+        return Math.max(0, entryPrice - marginPerUnit);
+    }
+    return entryPrice + marginPerUnit;
+}
+//# sourceMappingURL=marginUtils.mjs.map

package/dist/utils/marginUtils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"marginUtils.mjs","sourceRoot":"","sources":["../../src/utils/marginUtils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Margin adjustment calculation utilities\n * Provides risk assessment and margin calculation functions for position management\n */\nimport { MARGIN_ADJUSTMENT_CONFIG } from '../constants/perpsConfig';\n\nexport type RiskLevel = 'safe' | 'warning' | 'danger';\n\nexport type MarginRiskAssessment = {\n  riskLevel: RiskLevel;\n  priceDiff: number;\n  riskRatio: number;\n};\n\nexport type AssessMarginRemovalRiskParams = {\n  newLiquidationPrice: number;\n  currentPrice: number;\n  isLong: boolean;\n};\n\nexport type CalculateMaxRemovableMarginParams = {\n  currentMargin: number;\n  positionSize: number;\n  entryPrice: number;\n  currentPrice: number;\n  /** The actual leverage of the position (not the asset's max leverage) */\n  positionLeverage: number;\n  /** Optional pre-calculated notional value (e.g., from position.positionValue) for immediate display before live prices load */\n  notionalValue?: number;\n};\n\nexport type CalculateNewLiquidationPriceParams = {\n  newMargin: number;\n  positionSize: number;\n  entryPrice: number;\n  isLong: boolean;\n  currentLiquidationPrice: number;\n};\n\n/**\n * Assess liquidation risk after margin removal\n * Compares new liquidation price against current market price to determine risk level\n *\n * @param params - New liquidation price, current market price, and position direction\n * @returns Risk assessment with level (safe/warning/danger), price difference, and risk ratio\n */\nexport function assessMarginRemovalRisk(\n  params: AssessMarginRemovalRiskParams,\n): MarginRiskAssessment {\n  const { newLiquidationPrice, currentPrice, isLong } = params;\n\n  if (\n    !newLiquidationPrice ||\n    !currentPrice ||\n    isNaN(newLiquidationPrice) ||\n    isNaN(currentPrice)\n  ) {\n    return { riskLevel: 'safe', priceDiff: 0, riskRatio: 0 };\n  }\n\n  // Calculate price difference based on position direction\n  // For long: current price should be above liquidation price\n  // For short: liquidation price should be above current price\n  const priceDiff = isLong\n    ? currentPrice - newLiquidationPrice\n    : newLiquidationPrice - currentPrice;\n\n  // Risk ratio: how far away is price from liquidation, relative to liquidation price\n  // Higher ratio = safer (price is far from liquidation)\n  // Lower ratio = riskier (price is close to liquidation)\n  const riskRatio = priceDiff / newLiquidationPrice;\n\n  let riskLevel: RiskLevel;\n  if (riskRatio < MARGIN_ADJUSTMENT_CONFIG.LiquidationRiskThreshold - 1) {\n    riskLevel = 'danger'; // <20% buffer - critical risk\n  } else if (\n    riskRatio <\n    MARGIN_ADJUSTMENT_CONFIG.LiquidationWarningThreshold - 1\n  ) {\n    riskLevel = 'warning'; // <50% buffer - moderate risk\n  } else {\n    riskLevel = 'safe'; // >=50% buffer - safe\n  }\n\n  return { riskLevel, priceDiff, riskRatio };\n}\n\n/**\n * Calculate maximum margin that can be safely removed from a position\n *\n * HyperLiquid enforces: transfer_margin_required = max(initial_margin_required, 0.1 * total_position_value)\n * See: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/margin-and-pnl\n * See also: docs/perps/hyperliquid/margining.md\n *\n * Key insight from Hyperliquid support (Xulian, Dec 6, 2025):\n * \"you need to account for initial margin for withdrawal, maintenance is what is needed to not be liquidated\"\n *\n * The initial margin is calculated using the POSITION'S leverage (not the asset's max leverage).\n * For example, a position opened at 10x leverage requires 10% initial margin,\n * not 2% (which would be for 50x max leverage).\n *\n * @param params - Current margin, position size, prices, and position leverage\n * @returns Maximum removable margin amount in USD\n */\nexport function calculateMaxRemovableMargin(\n  params: CalculateMaxRemovableMarginParams,\n): number {\n  const {\n    currentMargin,\n    positionSize,\n    currentPrice,\n    positionLeverage,\n    notionalValue: providedNotionalValue,\n  } = params;\n\n  // Validate inputs\n  if (\n    isNaN(currentMargin) ||\n    isNaN(positionLeverage) ||\n    currentMargin <= 0 ||\n    positionLeverage <= 0\n  ) {\n    return 0;\n  }\n\n  // Use provided notional value (e.g., from position.positionValue) or calculate from price\n  // This allows immediate display before live prices load\n  let notionalValue = providedNotionalValue;\n  if (\n    notionalValue === undefined ||\n    isNaN(notionalValue) ||\n    notionalValue <= 0\n  ) {\n    // Fall back to calculating from price if not provided or invalid\n    if (\n      isNaN(positionSize) ||\n      isNaN(currentPrice) ||\n      positionSize <= 0 ||\n      currentPrice <= 0\n    ) {\n      return 0;\n    }\n    notionalValue = positionSize * currentPrice;\n  }\n\n  // Hyperliquid's transfer margin requirement formula:\n  // transfer_margin_required = max(initial_margin_required, 0.1 * total_position_value)\n  //\n  // IMPORTANT: Use the position's actual leverage, not the asset's max leverage\n  // A position at 10x leverage needs 10% initial margin ($100 for $1000 notional)\n  // NOT the 2% that 50x max leverage would imply\n  const initialMarginRequired = notionalValue / positionLeverage;\n  const tenPercentMargin =\n    notionalValue * MARGIN_ADJUSTMENT_CONFIG.MarginRemovalSafetyBuffer;\n\n  // Transfer margin required is the MAX of these two constraints\n  const transferMarginRequired = Math.max(\n    initialMarginRequired,\n    tenPercentMargin,\n  );\n\n  // Note: Unrealized PnL is NOT counted as part of \"remaining margin\" for withdrawals\n  // Per Hyperliquid docs, unrealized PnL helps prevent liquidation but doesn't\n  // increase your available withdrawal limit for margin transfers\n  // Maximum removable = current margin - required (must be non-negative)\n  return Math.max(0, currentMargin - transferMarginRequired);\n}\n\n/**\n * Calculate new liquidation price after margin adjustment\n * Estimates where the liquidation price will move based on margin change\n * Note: This is a simplified calculation; actual liquidation price may vary based on protocol\n *\n * @param params - New margin amount, position size, entry price, direction, and current liquidation price\n * @returns Estimated new liquidation price\n */\nexport function calculateNewLiquidationPrice(\n  params: CalculateNewLiquidationPriceParams,\n): number {\n  const {\n    newMargin,\n    positionSize,\n    entryPrice,\n    isLong,\n    currentLiquidationPrice,\n  } = params;\n\n  // Validate inputs\n  if (\n    isNaN(newMargin) ||\n    isNaN(positionSize) ||\n    isNaN(entryPrice) ||\n    newMargin <= 0 ||\n    positionSize <= 0 ||\n    entryPrice <= 0\n  ) {\n    return currentLiquidationPrice; // Return current if invalid inputs\n  }\n\n  // Calculate margin per unit of position\n  const marginPerUnit = newMargin / positionSize;\n\n  // For long positions: liquidation price is below entry price\n  // liquidationPrice = entryPrice - marginPerUnit\n  // For short positions: liquidation price is above entry price\n  // liquidationPrice = entryPrice + marginPerUnit\n  if (isLong) {\n    return Math.max(0, entryPrice - marginPerUnit);\n  }\n  return entryPrice + marginPerUnit;\n}\n"]}