@gainsnetwork/sdk 0.0.0-v10.rc1 → 0.0.0-v10.rc3

package/lib/trade/fees/tiers/index.d.ts

@@ -1,5 +1,7 @@
 import { FeeTiers, TraderFeeTiers } from "../../types";
 import { FeeTier } from "./types";
+export * from "./types";
+export * from "./converter";
 export declare const TRAILING_PERIOD_DAYS = 30;
 export declare const FEE_MULTIPLIER_SCALE = 1;
 export declare const MAX_FEE_TIERS = 8;
@@ -10,3 +12,19 @@ export declare const computeFeeMultiplier: (feeTiers: FeeTiers, traderFeeTiers:
     feeMultiplier: number;
     trailingPoints: number;
 };
+/**
+ * @dev Calculates the final fee amount after applying the trader's fee tier discount
+ * @dev Mirrors the contract's calculateFeeAmount function
+ * @param trader The address of the trader (not used in SDK, for consistency)
+ * @param normalFeeAmountCollateral The base fee amount before any discounts
+ * @param feeMultiplier The trader's fee multiplier (e.g., 0.8 = 80% of normal fee)
+ * @returns The final fee amount after applying discount
+ */
+export declare const calculateFeeAmount: (trader: string, normalFeeAmountCollateral: number, feeMultiplier?: number) => number;
+/**
+ * @dev Helper function to get trader's fee multiplier from fee tiers data
+ * @param feeTiers System fee tiers configuration
+ * @param traderFeeTiers Trader's fee tier data
+ * @returns Fee multiplier (1e3 precision)
+ */
+export declare const getTraderFeeMultiplier: (feeTiers: FeeTiers, traderFeeTiers: TraderFeeTiers) => number;

package/lib/trade/fees/tiers/index.js

@@ -1,7 +1,23 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.computeFeeMultiplier = exports.getFeeMultiplier = exports.getFeeTiersCount = exports.getCurrentDay = exports.MAX_FEE_TIERS = exports.FEE_MULTIPLIER_SCALE = exports.TRAILING_PERIOD_DAYS = void 0;
+exports.getTraderFeeMultiplier = exports.calculateFeeAmount = exports.computeFeeMultiplier = exports.getFeeMultiplier = exports.getFeeTiersCount = exports.getCurrentDay = exports.MAX_FEE_TIERS = exports.FEE_MULTIPLIER_SCALE = exports.TRAILING_PERIOD_DAYS = void 0;
 const types_1 = require("./types");
+__exportStar(require("./types"), exports);
+__exportStar(require("./converter"), exports);
 exports.TRAILING_PERIOD_DAYS = 30;
 exports.FEE_MULTIPLIER_SCALE = 1;
 exports.MAX_FEE_TIERS = 8;
@@ -52,3 +68,31 @@ const computeFeeMultiplier = (feeTiers, traderFeeTiers) => {
     };
 };
 exports.computeFeeMultiplier = computeFeeMultiplier;
+/**
+ * @dev Calculates the final fee amount after applying the trader's fee tier discount
+ * @dev Mirrors the contract's calculateFeeAmount function
+ * @param trader The address of the trader (not used in SDK, for consistency)
+ * @param normalFeeAmountCollateral The base fee amount before any discounts
+ * @param feeMultiplier The trader's fee multiplier (e.g., 0.8 = 80% of normal fee)
+ * @returns The final fee amount after applying discount
+ */
+const calculateFeeAmount = (trader, normalFeeAmountCollateral, feeMultiplier) => {
+    // If no fee multiplier provided or it's 0, return normal fee
+    if (!feeMultiplier || feeMultiplier === 0) {
+        return normalFeeAmountCollateral;
+    }
+    // Apply fee multiplier discount
+    return (feeMultiplier * normalFeeAmountCollateral) / exports.FEE_MULTIPLIER_SCALE;
+};
+exports.calculateFeeAmount = calculateFeeAmount;
+/**
+ * @dev Helper function to get trader's fee multiplier from fee tiers data
+ * @param feeTiers System fee tiers configuration
+ * @param traderFeeTiers Trader's fee tier data
+ * @returns Fee multiplier (1e3 precision)
+ */
+const getTraderFeeMultiplier = (feeTiers, traderFeeTiers) => {
+    const { feeMultiplier } = (0, exports.computeFeeMultiplier)(feeTiers, traderFeeTiers);
+    return feeMultiplier;
+};
+exports.getTraderFeeMultiplier = getTraderFeeMultiplier;

package/lib/trade/fees/trading/converter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @dev Converters for trading fee data between contract and SDK formats
+ */
+import { CounterTradeSettings } from "../../types";
+import { GlobalTradeFeeParams } from "./types";
+/**
+ * @dev Converts contract counter trade settings to SDK format
+ * @param feeRateMultiplier Fee rate multiplier from contract (1e3 precision)
+ * @param maxLeverage Max leverage from contract (1e3 precision)
+ * @returns Normalized counter trade settings
+ */
+export declare const convertCounterTradeSettings: (feeRateMultiplier: number, maxLeverage: number) => CounterTradeSettings;
+/**
+ * @dev Converts array of counter trade fee rate multipliers from contract
+ * @param multipliers Array of fee rate multipliers (1e3 precision)
+ * @returns Array of normalized multipliers
+ */
+export declare const convertCounterTradeFeeRateMultipliers: (multipliers: number[]) => number[];
+/**
+ * @dev Converts global trade fee params from contract to SDK format
+ * @param contractParams Global trade fee params from contract
+ * @returns Normalized global trade fee params
+ */
+export declare const convertGlobalTradeFeeParams: (contractParams: {
+    referralFeeP: number;
+    govFeeP: number;
+    triggerOrderFeeP: number;
+    gnsOtcFeeP: number;
+    gTokenFeeP: number;
+}) => GlobalTradeFeeParams;

package/lib/trade/fees/trading/converter.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * @dev Converters for trading fee data between contract and SDK formats
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertGlobalTradeFeeParams = exports.convertCounterTradeFeeRateMultipliers = exports.convertCounterTradeSettings = void 0;
+/**
+ * @dev Converts contract counter trade settings to SDK format
+ * @param feeRateMultiplier Fee rate multiplier from contract (1e3 precision)
+ * @param maxLeverage Max leverage from contract (1e3 precision)
+ * @returns Normalized counter trade settings
+ */
+const convertCounterTradeSettings = (feeRateMultiplier, maxLeverage) => {
+    return {
+        feeRateMultiplier: feeRateMultiplier / 1000,
+        maxLeverage: maxLeverage / 1000, // 1e3 → float
+    };
+};
+exports.convertCounterTradeSettings = convertCounterTradeSettings;
+/**
+ * @dev Converts array of counter trade fee rate multipliers from contract
+ * @param multipliers Array of fee rate multipliers (1e3 precision)
+ * @returns Array of normalized multipliers
+ */
+const convertCounterTradeFeeRateMultipliers = (multipliers) => {
+    return multipliers.map(m => m / 1000);
+};
+exports.convertCounterTradeFeeRateMultipliers = convertCounterTradeFeeRateMultipliers;
+/**
+ * @dev Converts global trade fee params from contract to SDK format
+ * @param contractParams Global trade fee params from contract
+ * @returns Normalized global trade fee params
+ */
+const convertGlobalTradeFeeParams = (contractParams) => {
+    return {
+        referralFeeP: contractParams.referralFeeP / 1e10 / 100,
+        govFeeP: contractParams.govFeeP / 1e10 / 100,
+        triggerOrderFeeP: contractParams.triggerOrderFeeP / 1e10 / 100,
+        gnsOtcFeeP: contractParams.gnsOtcFeeP / 1e10 / 100,
+        gTokenFeeP: contractParams.gTokenFeeP / 1e10 / 100,
+    };
+};
+exports.convertGlobalTradeFeeParams = convertGlobalTradeFeeParams;

package/lib/trade/fees/trading/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @dev Trading fee calculations for opening and closing positions
+ */
+import { Fee, PairIndex, Trade, TradeInfo, TradeFeesData } from "../../types";
+import { GetTradeFeesContext, GetLiquidationFeesContext, GetClosingFeeContext, TradeFeesBreakdown, TradeHoldingFees } from "./types";
+import { ContractsVersion } from "../../../contracts/types";
+import * as BorrowingFee from "../borrowing/types";
+/**
+ * @dev Returns the total fee for a trade in collateral tokens
+ * @dev Mirrors the contract's getTotalTradeFeesCollateral function
+ * @param collateralIndex Collateral index (not used in calculation, for consistency)
+ * @param trader Trader address (for fee tier lookup)
+ * @param pairIndex Index of the trading pair
+ * @param positionSizeCollateral Position size in collateral tokens
+ * @param isCounterTrade Whether the trade is a counter trade
+ * @param context Context containing fee parameters and settings
+ * @returns Total fee in collateral tokens
+ */
+export declare const getTotalTradeFeesCollateral: (collateralIndex: number, trader: string, pairIndex: PairIndex, positionSizeCollateral: number, isCounterTrade: boolean, context: GetTradeFeesContext) => number;
+/**
+ * @dev Returns the fee breakdown for a trade
+ * @dev Mirrors the contract's getTradeFeesCollateral function
+ */
+export declare const getTradeFeesCollateral: (collateralIndex: number, trader: string, pairIndex: PairIndex, positionSizeCollateral: number, isCounterTrade: boolean, context: GetTradeFeesContext) => TradeFeesBreakdown;
+/**
+ * @dev Returns total liquidation fee for a trade in collateral tokens
+ * @dev Mirrors the contract's getTotalTradeLiqFeesCollateral function
+ */
+export declare const getTotalTradeLiqFeesCollateral: (collateralIndex: number, trader: string, pairIndex: PairIndex, collateralAmount: number, context: GetLiquidationFeesContext) => number;
+/**
+ * @dev Legacy function for backward compatibility
+ * @deprecated Use getTotalTradeFeesCollateral instead
+ */
+export declare const getClosingFee: (collateralAmount: number, leverage: number, pairIndex: PairIndex, pairFee: Fee | undefined, _collateralPriceUsd?: number | undefined, isCounterTrade?: boolean, trader?: string, context?: GetClosingFeeContext) => number;
+/**
+ * @dev Calculates total holding fees for a trade (funding + borrowing fees)
+ * @param trade The trade to calculate fees for
+ * @param tradeInfo Trade info containing contracts version
+ * @param tradeFeesData Trade fees data containing initial acc fees
+ * @param currentPairPrice Current pair price
+ * @param context Context with fee parameters
+ * @returns Object containing all holding fee components
+ */
+export declare const getTradePendingHoldingFeesCollateral: (trade: Trade, tradeInfo: TradeInfo, tradeFeesData: TradeFeesData, currentPairPrice: number, context: {
+    [key: string]: any;
+    contractsVersion?: ContractsVersion | undefined;
+    currentBlock?: number | undefined;
+    groups?: BorrowingFee.Group[] | undefined;
+    pairs?: BorrowingFee.Pair[] | undefined;
+    collateralPriceUsd?: number | undefined;
+    initialAccFees?: BorrowingFee.InitialAccFees | undefined;
+}) => TradeHoldingFees;
+export * from "./types";
+export * from "./converter";

package/lib/trade/fees/trading/index.js

@@ -0,0 +1,147 @@
+"use strict";
+/**
+ * @dev Trading fee calculations for opening and closing positions
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTradePendingHoldingFeesCollateral = exports.getClosingFee = exports.getTotalTradeLiqFeesCollateral = exports.getTradeFeesCollateral = exports.getTotalTradeFeesCollateral = void 0;
+const tiers_1 = require("../tiers");
+const fundingFees_1 = require("../fundingFees");
+const borrowingV2_1 = require("../borrowingV2");
+const borrowing_1 = require("../borrowing");
+const types_1 = require("../../../contracts/types");
+/**
+ * @dev Returns the total fee for a trade in collateral tokens
+ * @dev Mirrors the contract's getTotalTradeFeesCollateral function
+ * @param collateralIndex Collateral index (not used in calculation, for consistency)
+ * @param trader Trader address (for fee tier lookup)
+ * @param pairIndex Index of the trading pair
+ * @param positionSizeCollateral Position size in collateral tokens
+ * @param isCounterTrade Whether the trade is a counter trade
+ * @param context Context containing fee parameters and settings
+ * @returns Total fee in collateral tokens
+ */
+const getTotalTradeFeesCollateral = (collateralIndex, trader, pairIndex, positionSizeCollateral, isCounterTrade, context) => {
+    var _a;
+    const { fee, collateralPriceUsd } = context;
+    const { totalPositionSizeFeeP, minPositionSizeUsd } = fee;
+    // Get counter trade fee rate multiplier (default 1 = 1x)
+    const counterTradeFeeRateMultiplier = isCounterTrade && ((_a = context.counterTradeSettings) === null || _a === void 0 ? void 0 : _a[pairIndex])
+        ? context.counterTradeSettings[pairIndex].feeRateMultiplier
+        : 1;
+    // Apply counter trade multiplier to position size
+    const adjustedPositionSizeCollateral = positionSizeCollateral * counterTradeFeeRateMultiplier;
+    // Calculate minimum position size in collateral
+    const minPositionSizeCollateral = minPositionSizeUsd / collateralPriceUsd;
+    // Use max of adjusted position size and minimum position size
+    const positionSizeBasis = Math.max(adjustedPositionSizeCollateral, minPositionSizeCollateral);
+    // Calculate raw fee
+    const rawFee = totalPositionSizeFeeP * positionSizeBasis;
+    // Apply trader fee tier if available
+    return (0, tiers_1.calculateFeeAmount)(trader, rawFee, context.traderFeeMultiplier);
+};
+exports.getTotalTradeFeesCollateral = getTotalTradeFeesCollateral;
+/**
+ * @dev Returns the fee breakdown for a trade
+ * @dev Mirrors the contract's getTradeFeesCollateral function
+ */
+const getTradeFeesCollateral = (collateralIndex, trader, pairIndex, positionSizeCollateral, isCounterTrade, context) => {
+    const totalFees = (0, exports.getTotalTradeFeesCollateral)(collateralIndex, trader, pairIndex, positionSizeCollateral, isCounterTrade, context);
+    const { globalTradeFeeParams } = context;
+    const totalP = globalTradeFeeParams.referralFeeP +
+        globalTradeFeeParams.govFeeP +
+        globalTradeFeeParams.triggerOrderFeeP +
+        globalTradeFeeParams.gnsOtcFeeP +
+        globalTradeFeeParams.gTokenFeeP;
+    // Distribute fees proportionally
+    return {
+        referralFeeCollateral: (totalFees * globalTradeFeeParams.referralFeeP) / totalP,
+        govFeeCollateral: (totalFees * globalTradeFeeParams.govFeeP) / totalP,
+        triggerFeeCollateral: (totalFees * globalTradeFeeParams.triggerOrderFeeP) / totalP,
+        gnsOtcFeeCollateral: (totalFees * globalTradeFeeParams.gnsOtcFeeP) / totalP,
+        gTokenFeeCollateral: (totalFees * globalTradeFeeParams.gTokenFeeP) / totalP,
+    };
+};
+exports.getTradeFeesCollateral = getTradeFeesCollateral;
+/**
+ * @dev Returns total liquidation fee for a trade in collateral tokens
+ * @dev Mirrors the contract's getTotalTradeLiqFeesCollateral function
+ */
+const getTotalTradeLiqFeesCollateral = (collateralIndex, trader, pairIndex, collateralAmount, context) => {
+    const { totalLiqCollateralFeeP } = context;
+    // Calculate raw liquidation fee
+    const rawFee = collateralAmount * totalLiqCollateralFeeP;
+    // Apply trader fee tier if available
+    return (0, tiers_1.calculateFeeAmount)(trader, rawFee, context.traderFeeMultiplier);
+};
+exports.getTotalTradeLiqFeesCollateral = getTotalTradeLiqFeesCollateral;
+/**
+ * @dev Legacy function for backward compatibility
+ * @deprecated Use getTotalTradeFeesCollateral instead
+ */
+const getClosingFee = (collateralAmount, leverage, pairIndex, pairFee, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+_collateralPriceUsd = 0, // Kept for backward compatibility
+isCounterTrade = false, trader, context) => {
+    if (!pairFee || !context)
+        return 0;
+    const positionSizeCollateral = collateralAmount * leverage;
+    return (0, exports.getTotalTradeFeesCollateral)(0, // collateralIndex not used
+    trader || "", pairIndex, positionSizeCollateral, isCounterTrade, context);
+};
+exports.getClosingFee = getClosingFee;
+/**
+ * @dev Calculates total holding fees for a trade (funding + borrowing fees)
+ * @param trade The trade to calculate fees for
+ * @param tradeInfo Trade info containing contracts version
+ * @param tradeFeesData Trade fees data containing initial acc fees
+ * @param currentPairPrice Current pair price
+ * @param context Context with fee parameters
+ * @returns Object containing all holding fee components
+ */
+const getTradePendingHoldingFeesCollateral = (trade, tradeInfo, tradeFeesData, currentPairPrice, context) => {
+    var _a;
+    // Calculate funding fees (v10+ only)
+    const fundingFeeCollateral = ((_a = context.contractsVersion) !== null && _a !== void 0 ? _a : tradeInfo.contractsVersion) >=
+        types_1.ContractsVersion.V10
+        ? (0, fundingFees_1.getTradeFundingFeesCollateral)(trade, tradeInfo, tradeFeesData, currentPairPrice, context)
+        : 0;
+    // Calculate borrowing fees v2
+    const borrowingFeeCollateral = (0, borrowingV2_1.getTradeBorrowingFeesCollateral)({
+        positionSizeCollateral: trade.collateralAmount * trade.leverage,
+        openPrice: trade.openPrice,
+        collateralIndex: trade.collateralIndex,
+        pairIndex: trade.pairIndex,
+        currentPairPrice,
+        initialAccBorrowingFeeP: tradeFeesData.initialAccBorrowingFeeP,
+        currentTimestamp: context.currentTimestamp,
+    }, context);
+    // Calculate v1 borrowing fees (some markets use v1 indefinitely)
+    const borrowingFeeCollateral_old = (0, borrowing_1.getBorrowingFee)(trade.collateralAmount * trade.leverage, trade.pairIndex, trade.long, context.initialAccFees || { accPairFee: 0, accGroupFee: 0, block: 0 }, // Use context initial fees or empty
+    context);
+    return {
+        fundingFeeCollateral,
+        borrowingFeeCollateral,
+        borrowingFeeCollateral_old,
+        totalFeeCollateral: fundingFeeCollateral +
+            borrowingFeeCollateral +
+            borrowingFeeCollateral_old,
+    };
+};
+exports.getTradePendingHoldingFeesCollateral = getTradePendingHoldingFeesCollateral;
+// Export types
+__exportStar(require("./types"), exports);
+__exportStar(require("./converter"), exports);

package/lib/trade/fees/trading/types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @dev Types for trading fee calculations (open/close position fees)
+ */
+import { Fee, CounterTradeSettings, GlobalTradeFeeParams } from "../../types";
+/**
+ * @dev Breakdown of trading fees into components
+ */
+export type TradeFeesBreakdown = {
+    referralFeeCollateral: number;
+    govFeeCollateral: number;
+    triggerFeeCollateral: number;
+    gnsOtcFeeCollateral: number;
+    gTokenFeeCollateral: number;
+};
+/**
+ * @dev Context for calculating trading fees
+ */
+export type GetTradeFeesContext = {
+    fee: Fee;
+    collateralPriceUsd: number;
+    globalTradeFeeParams: GlobalTradeFeeParams;
+    counterTradeSettings?: {
+        [pairIndex: number]: CounterTradeSettings;
+    };
+    traderFeeMultiplier?: number;
+};
+/**
+ * @dev Context for calculating liquidation fees
+ */
+export type GetLiquidationFeesContext = {
+    totalLiqCollateralFeeP: number;
+    globalTradeFeeParams: GlobalTradeFeeParams;
+    traderFeeMultiplier?: number;
+};
+/**
+ * @dev Legacy support
+ */
+export type GetClosingFeeContext = GetTradeFeesContext;
+/**
+ * @dev Holding fees breakdown (funding + borrowing)
+ */
+export type TradeHoldingFees = {
+    fundingFeeCollateral: number;
+    borrowingFeeCollateral: number;
+    borrowingFeeCollateral_old: number;
+    totalFeeCollateral: number;
+};
+export type { GlobalTradeFeeParams };

package/lib/trade/fees/trading/types.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * @dev Types for trading fee calculations (open/close position fees)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/trade/index.d.ts

@@ -1,7 +1,8 @@
 export * from "./fees";
-export * from "./pnl";
+export * from "./pnl/index";
 export * from "./spread";
 export * from "./liquidation";
-export * from "./fees";
 export * from "./types";
 export * from "./oiWindows";
+export * from "./priceImpact";
+export * from "./utils";

package/lib/trade/index.js

@@ -15,9 +15,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./fees"), exports);
-__exportStar(require("./pnl"), exports);
+__exportStar(require("./pnl/index"), exports);
 __exportStar(require("./spread"), exports);
 __exportStar(require("./liquidation"), exports);
-__exportStar(require("./fees"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./oiWindows"), exports);
+__exportStar(require("./priceImpact"), exports);
+__exportStar(require("./utils"), exports);

package/lib/trade/liquidation/converter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @dev Converters for liquidation data between contract and SDK formats
+ */
+import { IPairsStorage } from "../../contracts/types/generated/GNSMultiCollatDiamond";
+import { LiquidationParams } from "../types";
+/**
+ * @dev Converts contract liquidation params to SDK format
+ * @param params Group liquidation params from contract
+ * @returns Normalized liquidation params
+ */
+export declare const convertLiquidationParams: (params: IPairsStorage.GroupLiquidationParamsStructOutput) => LiquidationParams;
+/**
+ * @dev Converts array of liquidation params from contract
+ * @param paramsArray Array of group liquidation params
+ * @returns Array of normalized liquidation params
+ */
+export declare const convertLiquidationParamsArray: (paramsArray: IPairsStorage.GroupLiquidationParamsStructOutput[]) => LiquidationParams[];
+/**
+ * @dev Converts liquidation params to contract format (for encoding)
+ * @param params SDK liquidation params
+ * @returns Contract-formatted liquidation params
+ */
+export declare const encodeLiquidationParams: (params: LiquidationParams) => IPairsStorage.GroupLiquidationParamsStruct;

package/lib/trade/liquidation/converter.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * @dev Converters for liquidation data between contract and SDK formats
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeLiquidationParams = exports.convertLiquidationParamsArray = exports.convertLiquidationParams = void 0;
+/**
+ * @dev Converts contract liquidation params to SDK format
+ * @param params Group liquidation params from contract
+ * @returns Normalized liquidation params
+ */
+const convertLiquidationParams = (params) => {
+    const ONCHAIN_LIQ_THRESHOLD = 0.9;
+    return {
+        maxLiqSpreadP: Number(params.maxLiqSpreadP) / 1e10 / 100,
+        startLiqThresholdP: Number(params.startLiqThresholdP) / 1e10 / 100 || ONCHAIN_LIQ_THRESHOLD,
+        endLiqThresholdP: Number(params.endLiqThresholdP) / 1e10 / 100 || ONCHAIN_LIQ_THRESHOLD,
+        startLeverage: Number(params.startLeverage) / 1e3,
+        endLeverage: Number(params.endLeverage) / 1e3, // 1e3 → float
+    };
+};
+exports.convertLiquidationParams = convertLiquidationParams;
+/**
+ * @dev Converts array of liquidation params from contract
+ * @param paramsArray Array of group liquidation params
+ * @returns Array of normalized liquidation params
+ */
+const convertLiquidationParamsArray = (paramsArray) => {
+    return paramsArray.map(exports.convertLiquidationParams);
+};
+exports.convertLiquidationParamsArray = convertLiquidationParamsArray;
+/**
+ * @dev Converts liquidation params to contract format (for encoding)
+ * @param params SDK liquidation params
+ * @returns Contract-formatted liquidation params
+ */
+const encodeLiquidationParams = (params) => {
+    return {
+        maxLiqSpreadP: Math.round(params.maxLiqSpreadP * 100 * 1e10),
+        startLiqThresholdP: Math.round(params.startLiqThresholdP * 100 * 1e10),
+        endLiqThresholdP: Math.round(params.endLiqThresholdP * 100 * 1e10),
+        startLeverage: Math.round(params.startLeverage * 1e3),
+        endLeverage: Math.round(params.endLeverage * 1e3), // float → 1e3
+    };
+};
+exports.encodeLiquidationParams = encodeLiquidationParams;

package/lib/trade/liquidation/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @dev Main export file for liquidation module
+ */
+import { Trade, Fee, BorrowingFee, LiquidationParams } from "..";
+import { GetLiquidationPriceContext, LiqPriceInput } from "./types";
+/**
+ * @dev Wrapper function that mirrors the contract's getTradeLiquidationPrice signature
+ * @dev This is the main entry point matching the contract interface
+ * @param input Liquidation price input parameters
+ * @param context Additional context for SDK calculations
+ * @returns Liquidation price
+ */
+export declare const getTradeLiquidationPrice: (input: LiqPriceInput, context: Omit<GetLiquidationPriceContext, "currentPairPrice" | "isCounterTrade" | "partialCloseMultiplier" | "additionalFeeCollateral" | "beforeOpened" | "liquidationParams"> & {
+    fee: Fee;
+}) => number;
+export declare const getLiquidationPrice: (trade: Trade, fee: Fee, initialAccFees: BorrowingFee.InitialAccFees, context: GetLiquidationPriceContext) => number;
+export declare const getLiqPnlThresholdP: (liquidationParams: LiquidationParams | undefined, leverage: number | undefined) => number;
+/**
+ * @dev Simplified wrapper for getTradeLiquidationPrice
+ * @dev Mirrors the contract's simplified overload
+ * @param trade The trade to calculate liquidation price for
+ * @param additionalFeeCollateral Additional fees to consider
+ * @param currentPairPrice Current pair price
+ * @param context Context with all required data
+ * @returns Liquidation price
+ */
+export declare const getTradeLiquidationPriceSimple: (trade: Trade, additionalFeeCollateral: number, currentPairPrice: number, context: Omit<GetLiquidationPriceContext, "currentPairPrice" | "additionalFeeCollateral"> & {
+    fee: Fee;
+}) => number;
+export { convertLiquidationParams, convertLiquidationParamsArray, encodeLiquidationParams, } from "./converter";
+export * from "./types";