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

package/dist/utils/marginUtils.cjs

@@ -1,137 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,64 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,64 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,131 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"]}