@gainsnetwork/sdk 0.0.0-v10.rc2 → 0.0.0-v10.rc4

package/lib/trade/fees/converter.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * @dev Converters for fee data between contract and SDK formats
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeUiRealizedPnlData = exports.encodeTradeFeesData = exports.convertUiRealizedPnlDataArray = exports.convertUiRealizedPnlData = exports.convertTradeFeesDataArray = exports.convertTradeFeesData = void 0;
+/**
+ * @dev Converts contract TradeFeesData to SDK format
+ * @param data Trade fees data from contract
+ * @param collateralConfig Config for the collateral (contains decimals)
+ * @returns Normalized trade fees data
+ */
+const convertTradeFeesData = (data, collateralConfig) => {
+    const decimals = collateralConfig.decimals || 18;
+    return {
+        realizedTradingFeesCollateral: parseFloat(data.realizedTradingFeesCollateral.toString()) /
+            Math.pow(10, decimals),
+        realizedPnlCollateral: parseFloat(data.realizedPnlCollateral.toString()) / Math.pow(10, decimals),
+        manuallyRealizedNegativePnlCollateral: parseFloat(data.manuallyRealizedNegativePnlCollateral.toString()) /
+            Math.pow(10, decimals),
+        alreadyTransferredNegativePnlCollateral: parseFloat(data.alreadyTransferredNegativePnlCollateral.toString()) /
+            Math.pow(10, decimals),
+        virtualAvailableCollateralInDiamond: parseFloat(data.virtualAvailableCollateralInDiamond.toString()) /
+            Math.pow(10, decimals),
+        initialAccFundingFeeP: parseFloat(data.initialAccFundingFeeP.toString()) / 1e10,
+        initialAccBorrowingFeeP: parseFloat(data.initialAccBorrowingFeeP.toString()) / 1e10,
+    };
+};
+exports.convertTradeFeesData = convertTradeFeesData;
+/**
+ * @dev Converts array of TradeFeesData from contract
+ * @param dataArray Array of trade fees data
+ * @param collateralConfig Config for the collateral
+ * @returns Array of normalized trade fees data
+ */
+const convertTradeFeesDataArray = (dataArray, collateralConfig) => {
+    return dataArray.map(data => (0, exports.convertTradeFeesData)(data, collateralConfig));
+};
+exports.convertTradeFeesDataArray = convertTradeFeesDataArray;
+/**
+ * @dev Converts contract UiRealizedPnlData to SDK format
+ * @param data UI realized PnL data from contract
+ * @param collateralConfig Config for the collateral (contains decimals)
+ * @returns Normalized UI realized PnL data
+ */
+const convertUiRealizedPnlData = (data, collateralConfig) => {
+    const decimals = collateralConfig.decimals || 18;
+    return {
+        realizedTradingFeesCollateral: parseFloat(data.realizedTradingFeesCollateral.toString()) /
+            Math.pow(10, decimals),
+        realizedOldBorrowingFeesCollateral: parseFloat(data.realizedOldBorrowingFeesCollateral.toString()) /
+            Math.pow(10, decimals),
+        realizedNewBorrowingFeesCollateral: parseFloat(data.realizedNewBorrowingFeesCollateral.toString()) /
+            Math.pow(10, decimals),
+        realizedFundingFeesCollateral: parseFloat(data.realizedFundingFeesCollateral.toString()) /
+            Math.pow(10, decimals),
+        realizedPnlPartialCloseCollateral: parseFloat(data.realizedPnlPartialCloseCollateral.toString()) /
+            Math.pow(10, decimals),
+        pnlWithdrawnCollateral: parseFloat(data.pnlWithdrawnCollateral.toString()) / Math.pow(10, decimals),
+    };
+};
+exports.convertUiRealizedPnlData = convertUiRealizedPnlData;
+/**
+ * @dev Converts array of UiRealizedPnlData from contract
+ * @param dataArray Array of UI realized PnL data
+ * @param collateralConfig Config for the collateral
+ * @returns Array of normalized UI realized PnL data
+ */
+const convertUiRealizedPnlDataArray = (dataArray, collateralConfig) => {
+    return dataArray.map(data => (0, exports.convertUiRealizedPnlData)(data, collateralConfig));
+};
+exports.convertUiRealizedPnlDataArray = convertUiRealizedPnlDataArray;
+/**
+ * @dev Converts TradeFeesData to contract format (for encoding)
+ * @param data SDK trade fees data
+ * @param collateralConfig Config for the collateral
+ * @returns Contract-formatted trade fees data
+ */
+const encodeTradeFeesData = (data, collateralConfig) => {
+    const decimals = collateralConfig.decimals || 18;
+    return {
+        realizedTradingFeesCollateral: Math.round(data.realizedTradingFeesCollateral * Math.pow(10, decimals)),
+        realizedPnlCollateral: Math.round(data.realizedPnlCollateral * Math.pow(10, decimals)),
+        manuallyRealizedNegativePnlCollateral: Math.round(data.manuallyRealizedNegativePnlCollateral * Math.pow(10, decimals)),
+        alreadyTransferredNegativePnlCollateral: Math.round(data.alreadyTransferredNegativePnlCollateral * Math.pow(10, decimals)),
+        virtualAvailableCollateralInDiamond: Math.round(data.virtualAvailableCollateralInDiamond * Math.pow(10, decimals)),
+        __placeholder: 0,
+        initialAccFundingFeeP: Math.round(data.initialAccFundingFeeP * 1e10),
+        initialAccBorrowingFeeP: Math.round(data.initialAccBorrowingFeeP * 1e10),
+    };
+};
+exports.encodeTradeFeesData = encodeTradeFeesData;
+/**
+ * @dev Converts UiRealizedPnlData to contract format (for encoding)
+ * @param data SDK UI realized PnL data
+ * @param collateralConfig Config for the collateral
+ * @returns Contract-formatted UI realized PnL data
+ */
+const encodeUiRealizedPnlData = (data, collateralConfig) => {
+    const decimals = collateralConfig.decimals || 18;
+    return {
+        realizedTradingFeesCollateral: Math.round(data.realizedTradingFeesCollateral * Math.pow(10, decimals)),
+        realizedOldBorrowingFeesCollateral: Math.round(data.realizedOldBorrowingFeesCollateral * Math.pow(10, decimals)),
+        realizedNewBorrowingFeesCollateral: Math.round(data.realizedNewBorrowingFeesCollateral * Math.pow(10, decimals)),
+        realizedFundingFeesCollateral: Math.round(data.realizedFundingFeesCollateral * Math.pow(10, decimals)),
+        realizedPnlPartialCloseCollateral: Math.round(data.realizedPnlPartialCloseCollateral * Math.pow(10, decimals)),
+        pnlWithdrawnCollateral: Math.round(data.pnlWithdrawnCollateral * Math.pow(10, decimals)),
+    };
+};
+exports.encodeUiRealizedPnlData = encodeUiRealizedPnlData;

package/lib/trade/fees/fundingFees/builder.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @dev Builder functions for funding fees context
+ */
+import { GlobalTradingVariablesType } from "../../../backend/tradingVariables/types";
+import { GetPairFundingFeeContext } from "./pairContext";
+/**
+ * @dev Builds funding fees sub-context for a specific pair
+ */
+export declare const buildFundingContext: (globalTradingVariables: GlobalTradingVariablesType, collateralIndex: number, pairIndex: number, currentTimestamp: number) => GetPairFundingFeeContext | undefined;

package/lib/trade/fees/fundingFees/builder.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * @dev Builder functions for funding fees context
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildFundingContext = void 0;
+/**
+ * @dev Builds funding fees sub-context for a specific pair
+ */
+const buildFundingContext = (globalTradingVariables, collateralIndex, pairIndex, currentTimestamp) => {
+    var _a, _b, _c, _d, _e;
+    const collateral = globalTradingVariables.collaterals[collateralIndex - 1];
+    if (!(collateral === null || collateral === void 0 ? void 0 : collateral.pairFundingFees)) {
+        return undefined;
+    }
+    const params = (_a = collateral.pairFundingFees.params) === null || _a === void 0 ? void 0 : _a[pairIndex];
+    const data = (_b = collateral.pairFundingFees.data) === null || _b === void 0 ? void 0 : _b[pairIndex];
+    const pairOi = (_c = collateral.pairOis) === null || _c === void 0 ? void 0 : _c[pairIndex];
+    if (!params || !data) {
+        return undefined;
+    }
+    return {
+        params,
+        data,
+        pairOi: pairOi
+            ? {
+                oiLongToken: ((_d = pairOi.token) === null || _d === void 0 ? void 0 : _d.long) || 0,
+                oiShortToken: ((_e = pairOi.token) === null || _e === void 0 ? void 0 : _e.short) || 0,
+            }
+            : undefined,
+        currentTimestamp,
+        // TODO: Add net exposure when available
+    };
+};
+exports.buildFundingContext = buildFundingContext;

package/lib/{contracts/fetch/fees/fundingFees.d.ts → trade/fees/fundingFees/fetcher.d.ts}

@@ -1,5 +1,5 @@
-import type { GNSMultiCollatDiamond } from "../../types/generated";
-import type { TradeInitialAccFees } from "../../../trade/fees/fundingFees";
+import type { GNSMultiCollatDiamond } from "../../../contracts/types/generated";
+import type { TradeInitialAccFees } from ".";
 /**
  * @dev Fetches pending accumulated funding fees for a specific pair
  * @param contract GNSMultiCollatDiamond contract instance

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

@@ -62,7 +62,7 @@ export declare const getPairPendingAccFundingFees: (params: FundingFeeParams, da
  * @param tradeInfo Trade info (contracts version)
  * @param tradeFeesData Trade fees data containing initial acc funding fee
  * @param currentPairPrice Current pair price
- * @param context Optional context with funding fee data (if not provided, uses simple calculation)
+ * @param context Optional context with funding fee data (full or pair-specific)
  * @returns Funding fee in collateral tokens
  */
 export declare const getTradeFundingFeesCollateral: (trade: {
@@ -92,7 +92,14 @@ export declare const getTradeFundingFeesCollateral: (trade: {
             [pairIndex: number]: number;
         };
     } | undefined;
-}) | undefined) => number;
+}) | {
+    currentTimestamp: number;
+    params: FundingFeeParams;
+    data: PairFundingFeeData;
+    pairOi?: PairOiAfterV10 | undefined;
+    netExposureToken?: number | undefined;
+    netExposureUsd?: number | undefined;
+} | undefined) => number;
 /**
  * @dev Main function to calculate funding fees for a trade within context
  * @param context Funding fee context with params and data
@@ -133,3 +140,7 @@ export declare const getTradeFundingFeesCollateralSimple: (trade: {
 }, initialAccFundingFeeP: number, currentAccFundingFeeP: number) => number;
 export * as FundingFees from "./types";
 export type { FundingFeeParams, PairFundingFeeData, PairGlobalParams, TradeInitialAccFundingFees, PairOiAfterV10, FundingRateCalculation, GetFundingFeeContext, TradeFundingFeeResult, PairPendingAccFundingFeesResult, PairAccumulatedFees, TradeInitialAccFees, } from "./types";
+export type { GetPairFundingFeeContext } from "./pairContext";
+export * from "./fetcher";
+export * from "./pairContext";
+export * from "./builder";

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

@@ -26,6 +26,9 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
+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.FundingFees = exports.getTradeFundingFeesCollateralSimple = exports.getTradeFundingFees = exports.getTradeFundingFeesCollateral = exports.getPairPendingAccFundingFees = exports.getLongShortAprMultiplier = exports.getAvgFundingRatePerSecondP = exports.getSecondsToReachZeroRate = exports.getCurrentFundingVelocityPerYear = void 0;
 // Constants from contract
@@ -227,7 +230,7 @@ exports.getPairPendingAccFundingFees = getPairPendingAccFundingFees;
  * @param tradeInfo Trade info (contracts version)
  * @param tradeFeesData Trade fees data containing initial acc funding fee
  * @param currentPairPrice Current pair price
- * @param context Optional context with funding fee data (if not provided, uses simple calculation)
+ * @param context Optional context with funding fee data (full or pair-specific)
  * @returns Funding fee in collateral tokens
  */
 const getTradeFundingFeesCollateral = (trade, tradeInfo, tradeFeesData, currentPairPrice, context) => {
@@ -237,8 +240,26 @@ const getTradeFundingFeesCollateral = (trade, tradeInfo, tradeFeesData, currentP
         return 0;
     }
     const positionSizeCollateral = trade.collateralAmount * trade.leverage;
-    // If we have full context, calculate current accumulated funding fee
-    if (context &&
+    if (!context) {
+        return 0; // Cannot calculate without context
+    }
+    // Check if we have a pair-specific context
+    if ("params" in context && "data" in context) {
+        // Pair-specific context
+        const { params, data, pairOi, netExposureToken, netExposureUsd } = context;
+        if (!params.fundingFeesEnabled) {
+            return 0;
+        }
+        // Calculate pending accumulated fees
+        const { accFundingFeeLongP, accFundingFeeShortP } = (0, exports.getPairPendingAccFundingFees)(params, data, currentPairPrice, pairOi || { oiLongToken: 0, oiShortToken: 0 }, netExposureToken || 0, netExposureUsd || 0, context.currentTimestamp);
+        const currentAccFundingFeeP = trade.long
+            ? accFundingFeeLongP
+            : accFundingFeeShortP;
+        const fundingFeeDelta = currentAccFundingFeeP - tradeFeesData.initialAccFundingFeeP;
+        return (positionSizeCollateral * fundingFeeDelta) / trade.openPrice;
+    }
+    // Full context - original logic
+    if ("fundingParams" in context &&
         trade.collateralIndex !== undefined &&
         trade.pairIndex !== undefined) {
         const params = (_a = context.fundingParams[trade.collateralIndex]) === null || _a === void 0 ? void 0 : _a[trade.pairIndex];
@@ -320,3 +341,6 @@ const getTradeFundingFeesCollateralSimple = (trade, tradeInfo, initialAccFunding
 exports.getTradeFundingFeesCollateralSimple = getTradeFundingFeesCollateralSimple;
 // Export namespace for types
 exports.FundingFees = __importStar(require("./types"));
+__exportStar(require("./fetcher"), exports);
+__exportStar(require("./pairContext"), exports);
+__exportStar(require("./builder"), exports);

package/lib/trade/fees/fundingFees/pairContext.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @dev Pair-specific funding fee types and utilities
+ */
+import { FundingFeeParams, PairFundingFeeData, PairGlobalParams, PairOiAfterV10, PairPendingAccFundingFeesResult } from "./types";
+/**
+ * @dev Context for pair-specific funding fee calculations
+ */
+export type GetPairFundingFeeContext = {
+    currentTimestamp: number;
+    params: FundingFeeParams;
+    data: PairFundingFeeData;
+    globalParams?: PairGlobalParams;
+    pairOi?: PairOiAfterV10;
+    netExposureToken?: number;
+    netExposureUsd?: number;
+};
+/**
+ * @dev Input for pair-specific trade funding fee calculation
+ */
+export type PairTradeFundingFeeInput = {
+    positionSizeCollateral: number;
+    openPrice: number;
+    long: boolean;
+    currentPairPrice: number;
+    initialAccFundingFeeP: number;
+};
+/**
+ * @dev Calculate pending accumulated funding fees for a pair using pair-specific context
+ * @param currentPairPrice Current price of the pair
+ * @param context Pair-specific funding context
+ * @returns Pending accumulated funding fees
+ */
+export declare const getPairPendingAccFundingFees: (currentPairPrice: number, context: GetPairFundingFeeContext) => PairPendingAccFundingFeesResult;

package/lib/trade/fees/fundingFees/pairContext.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * @dev Pair-specific funding fee types and utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPairPendingAccFundingFees = void 0;
+const index_1 = require("./index");
+/**
+ * @dev Calculate pending accumulated funding fees for a pair using pair-specific context
+ * @param currentPairPrice Current price of the pair
+ * @param context Pair-specific funding context
+ * @returns Pending accumulated funding fees
+ */
+const getPairPendingAccFundingFees = (currentPairPrice, context) => {
+    return (0, index_1.getPairPendingAccFundingFees)(context.params, context.data, currentPairPrice, context.pairOi || { oiLongToken: 0, oiShortToken: 0 }, context.netExposureToken || 0, context.netExposureUsd || 0, context.currentTimestamp);
+};
+exports.getPairPendingAccFundingFees = getPairPendingAccFundingFees;

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

@@ -1,8 +1,9 @@
 export * from "./borrowing";
 export * from "./tiers";
 export * from "./trading";
-export { BorrowingFeeV2, borrowingFeeV2Utils, getPairPendingAccBorrowingFees as getPairPendingAccBorrowingFeesV2, getTradeBorrowingFeesCollateral as getTradeBorrowingFeesCollateralV2, getBorrowingFee as getBorrowingFeeV2, getPairBorrowingFees as getPairBorrowingFeesV2, MAX_BORROWING_RATE_PER_SECOND as MAX_BORROWING_RATE_PER_SECOND_V2, BORROWING_V2_PRECISION, } from "./borrowingV2";
+export { convertTradeFeesData, convertTradeFeesDataArray, convertUiRealizedPnlData, convertUiRealizedPnlDataArray, encodeTradeFeesData, encodeUiRealizedPnlData, } from "./converter";
+export { BorrowingFeeV2, borrowingFeeV2Utils, getPairPendingAccBorrowingFees as getPairPendingAccBorrowingFeesV2, getTradeBorrowingFeesCollateral as getTradeBorrowingFeesCollateralV2, getPairBorrowingFees as getPairBorrowingFeesV2, MAX_BORROWING_RATE_PER_SECOND as MAX_BORROWING_RATE_PER_SECOND_V2, BORROWING_V2_PRECISION, } from "./borrowingV2";
 export { convertBorrowingFeeParams as convertBorrowingFeeParamsV2, convertBorrowingFeeParamsArray as convertBorrowingFeeParamsArrayV2, convertPairBorrowingFeeData as convertPairBorrowingFeeDataV2, convertPairBorrowingFeeDataArray as convertPairBorrowingFeeDataArrayV2, convertTradeInitialAccFees as convertTradeInitialAccFeesV2, convertTradeInitialAccFeesArray as convertTradeInitialAccFeesArrayV2, createBorrowingV2Context, isValidBorrowingRate as isValidBorrowingRateV2, borrowingRateToAPR as borrowingRateToAPRV2, aprToBorrowingRate as aprToBorrowingRateV2, } from "./borrowingV2/converter";
-export { fetchBorrowingFeeParamsV2, fetchPairBorrowingFeeDataV2, fetchTradeBorrowingFeesCollateralV2, fetchPairPendingAccBorrowingFeesV2, fetchAllBorrowingV2Data, createBorrowingV2ContextFromContract, createBorrowingV2ContextFromArrays, fetchBorrowingV2DataForPairs, } from "../../contracts/fetch/fees/borrowingFeesV2";
+export { fetchBorrowingFeeParamsV2, fetchPairBorrowingFeeDataV2, fetchTradeBorrowingFeesCollateralV2, fetchPairPendingAccBorrowingFeesV2, fetchAllBorrowingV2Data, createBorrowingV2ContextFromContract, createBorrowingV2ContextFromArrays, fetchBorrowingV2DataForPairs, } from "./borrowingV2/fetcher";
 export { FundingFees, getCurrentFundingVelocityPerYear, getSecondsToReachZeroRate, getAvgFundingRatePerSecondP, getLongShortAprMultiplier, getPairPendingAccFundingFees, getTradeFundingFeesCollateral, getTradeFundingFeesCollateralSimple, getTradeFundingFees, } from "./fundingFees";
 export { convertFundingFeeParams, convertFundingFeeParamsArray, convertPairFundingFeeData, convertPairFundingFeeDataArray, convertPairGlobalParams, convertPairGlobalParamsArray, convertTradeInitialAccFundingFees, createFundingFeeContext, isValidFundingRate, fundingRateToAPR, aprToFundingRate, calculateVelocityFromSkew, FUNDING_FEES_PRECISION, } from "./fundingFees/converter";

package/lib/trade/fees/index.js

@@ -14,41 +14,49 @@ 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.FUNDING_FEES_PRECISION = exports.calculateVelocityFromSkew = exports.aprToFundingRate = exports.fundingRateToAPR = exports.isValidFundingRate = exports.createFundingFeeContext = exports.convertTradeInitialAccFundingFees = exports.convertPairGlobalParamsArray = exports.convertPairGlobalParams = exports.convertPairFundingFeeDataArray = exports.convertPairFundingFeeData = exports.convertFundingFeeParamsArray = exports.convertFundingFeeParams = exports.getTradeFundingFees = exports.getTradeFundingFeesCollateralSimple = exports.getTradeFundingFeesCollateral = exports.getPairPendingAccFundingFees = exports.getLongShortAprMultiplier = exports.getAvgFundingRatePerSecondP = exports.getSecondsToReachZeroRate = exports.getCurrentFundingVelocityPerYear = exports.FundingFees = exports.fetchBorrowingV2DataForPairs = exports.createBorrowingV2ContextFromArrays = exports.createBorrowingV2ContextFromContract = exports.fetchAllBorrowingV2Data = exports.fetchPairPendingAccBorrowingFeesV2 = exports.fetchTradeBorrowingFeesCollateralV2 = exports.fetchPairBorrowingFeeDataV2 = exports.fetchBorrowingFeeParamsV2 = exports.aprToBorrowingRateV2 = exports.borrowingRateToAPRV2 = exports.isValidBorrowingRateV2 = exports.createBorrowingV2Context = exports.convertTradeInitialAccFeesArrayV2 = exports.convertTradeInitialAccFeesV2 = exports.convertPairBorrowingFeeDataArrayV2 = exports.convertPairBorrowingFeeDataV2 = exports.convertBorrowingFeeParamsArrayV2 = exports.convertBorrowingFeeParamsV2 = exports.BORROWING_V2_PRECISION = exports.MAX_BORROWING_RATE_PER_SECOND_V2 = exports.getPairBorrowingFeesV2 = exports.getBorrowingFeeV2 = exports.getTradeBorrowingFeesCollateralV2 = exports.getPairPendingAccBorrowingFeesV2 = exports.borrowingFeeV2Utils = exports.BorrowingFeeV2 = void 0;
+exports.fundingRateToAPR = exports.isValidFundingRate = exports.createFundingFeeContext = exports.convertTradeInitialAccFundingFees = exports.convertPairGlobalParamsArray = exports.convertPairGlobalParams = exports.convertPairFundingFeeDataArray = exports.convertPairFundingFeeData = exports.convertFundingFeeParamsArray = exports.convertFundingFeeParams = exports.getTradeFundingFees = exports.getTradeFundingFeesCollateralSimple = exports.getTradeFundingFeesCollateral = exports.getPairPendingAccFundingFees = exports.getLongShortAprMultiplier = exports.getAvgFundingRatePerSecondP = exports.getSecondsToReachZeroRate = exports.getCurrentFundingVelocityPerYear = exports.FundingFees = exports.fetchBorrowingV2DataForPairs = exports.createBorrowingV2ContextFromArrays = exports.createBorrowingV2ContextFromContract = exports.fetchAllBorrowingV2Data = exports.fetchPairPendingAccBorrowingFeesV2 = exports.fetchTradeBorrowingFeesCollateralV2 = exports.fetchPairBorrowingFeeDataV2 = exports.fetchBorrowingFeeParamsV2 = exports.aprToBorrowingRateV2 = exports.borrowingRateToAPRV2 = exports.isValidBorrowingRateV2 = exports.createBorrowingV2Context = exports.convertTradeInitialAccFeesArrayV2 = exports.convertTradeInitialAccFeesV2 = exports.convertPairBorrowingFeeDataArrayV2 = exports.convertPairBorrowingFeeDataV2 = exports.convertBorrowingFeeParamsArrayV2 = exports.convertBorrowingFeeParamsV2 = exports.BORROWING_V2_PRECISION = exports.MAX_BORROWING_RATE_PER_SECOND_V2 = exports.getPairBorrowingFeesV2 = exports.getTradeBorrowingFeesCollateralV2 = exports.getPairPendingAccBorrowingFeesV2 = exports.borrowingFeeV2Utils = exports.BorrowingFeeV2 = exports.encodeUiRealizedPnlData = exports.encodeTradeFeesData = exports.convertUiRealizedPnlDataArray = exports.convertUiRealizedPnlData = exports.convertTradeFeesDataArray = exports.convertTradeFeesData = void 0;
+exports.FUNDING_FEES_PRECISION = exports.calculateVelocityFromSkew = exports.aprToFundingRate = void 0;
 __exportStar(require("./borrowing"), exports);
 __exportStar(require("./tiers"), exports);
 __exportStar(require("./trading"), exports);
+// TradeFeesData and UiRealizedPnlData converters
+var converter_1 = require("./converter");
+Object.defineProperty(exports, "convertTradeFeesData", { enumerable: true, get: function () { return converter_1.convertTradeFeesData; } });
+Object.defineProperty(exports, "convertTradeFeesDataArray", { enumerable: true, get: function () { return converter_1.convertTradeFeesDataArray; } });
+Object.defineProperty(exports, "convertUiRealizedPnlData", { enumerable: true, get: function () { return converter_1.convertUiRealizedPnlData; } });
+Object.defineProperty(exports, "convertUiRealizedPnlDataArray", { enumerable: true, get: function () { return converter_1.convertUiRealizedPnlDataArray; } });
+Object.defineProperty(exports, "encodeTradeFeesData", { enumerable: true, get: function () { return converter_1.encodeTradeFeesData; } });
+Object.defineProperty(exports, "encodeUiRealizedPnlData", { enumerable: true, get: function () { return converter_1.encodeUiRealizedPnlData; } });
 // Borrowing V2 exports with explicit naming to avoid conflicts
 var borrowingV2_1 = require("./borrowingV2");
 Object.defineProperty(exports, "BorrowingFeeV2", { enumerable: true, get: function () { return borrowingV2_1.BorrowingFeeV2; } });
 Object.defineProperty(exports, "borrowingFeeV2Utils", { enumerable: true, get: function () { return borrowingV2_1.borrowingFeeV2Utils; } });
 Object.defineProperty(exports, "getPairPendingAccBorrowingFeesV2", { enumerable: true, get: function () { return borrowingV2_1.getPairPendingAccBorrowingFees; } });
 Object.defineProperty(exports, "getTradeBorrowingFeesCollateralV2", { enumerable: true, get: function () { return borrowingV2_1.getTradeBorrowingFeesCollateral; } });
-Object.defineProperty(exports, "getBorrowingFeeV2", { enumerable: true, get: function () { return borrowingV2_1.getBorrowingFee; } });
 Object.defineProperty(exports, "getPairBorrowingFeesV2", { enumerable: true, get: function () { return borrowingV2_1.getPairBorrowingFees; } });
 Object.defineProperty(exports, "MAX_BORROWING_RATE_PER_SECOND_V2", { enumerable: true, get: function () { return borrowingV2_1.MAX_BORROWING_RATE_PER_SECOND; } });
 Object.defineProperty(exports, "BORROWING_V2_PRECISION", { enumerable: true, get: function () { return borrowingV2_1.BORROWING_V2_PRECISION; } });
-var converter_1 = require("./borrowingV2/converter");
-Object.defineProperty(exports, "convertBorrowingFeeParamsV2", { enumerable: true, get: function () { return converter_1.convertBorrowingFeeParams; } });
-Object.defineProperty(exports, "convertBorrowingFeeParamsArrayV2", { enumerable: true, get: function () { return converter_1.convertBorrowingFeeParamsArray; } });
-Object.defineProperty(exports, "convertPairBorrowingFeeDataV2", { enumerable: true, get: function () { return converter_1.convertPairBorrowingFeeData; } });
-Object.defineProperty(exports, "convertPairBorrowingFeeDataArrayV2", { enumerable: true, get: function () { return converter_1.convertPairBorrowingFeeDataArray; } });
-Object.defineProperty(exports, "convertTradeInitialAccFeesV2", { enumerable: true, get: function () { return converter_1.convertTradeInitialAccFees; } });
-Object.defineProperty(exports, "convertTradeInitialAccFeesArrayV2", { enumerable: true, get: function () { return converter_1.convertTradeInitialAccFeesArray; } });
-Object.defineProperty(exports, "createBorrowingV2Context", { enumerable: true, get: function () { return converter_1.createBorrowingV2Context; } });
-Object.defineProperty(exports, "isValidBorrowingRateV2", { enumerable: true, get: function () { return converter_1.isValidBorrowingRate; } });
-Object.defineProperty(exports, "borrowingRateToAPRV2", { enumerable: true, get: function () { return converter_1.borrowingRateToAPR; } });
-Object.defineProperty(exports, "aprToBorrowingRateV2", { enumerable: true, get: function () { return converter_1.aprToBorrowingRate; } });
+var converter_2 = require("./borrowingV2/converter");
+Object.defineProperty(exports, "convertBorrowingFeeParamsV2", { enumerable: true, get: function () { return converter_2.convertBorrowingFeeParams; } });
+Object.defineProperty(exports, "convertBorrowingFeeParamsArrayV2", { enumerable: true, get: function () { return converter_2.convertBorrowingFeeParamsArray; } });
+Object.defineProperty(exports, "convertPairBorrowingFeeDataV2", { enumerable: true, get: function () { return converter_2.convertPairBorrowingFeeData; } });
+Object.defineProperty(exports, "convertPairBorrowingFeeDataArrayV2", { enumerable: true, get: function () { return converter_2.convertPairBorrowingFeeDataArray; } });
+Object.defineProperty(exports, "convertTradeInitialAccFeesV2", { enumerable: true, get: function () { return converter_2.convertTradeInitialAccFees; } });
+Object.defineProperty(exports, "convertTradeInitialAccFeesArrayV2", { enumerable: true, get: function () { return converter_2.convertTradeInitialAccFeesArray; } });
+Object.defineProperty(exports, "createBorrowingV2Context", { enumerable: true, get: function () { return converter_2.createBorrowingV2Context; } });
+Object.defineProperty(exports, "isValidBorrowingRateV2", { enumerable: true, get: function () { return converter_2.isValidBorrowingRate; } });
+Object.defineProperty(exports, "borrowingRateToAPRV2", { enumerable: true, get: function () { return converter_2.borrowingRateToAPR; } });
+Object.defineProperty(exports, "aprToBorrowingRateV2", { enumerable: true, get: function () { return converter_2.aprToBorrowingRate; } });
 // Contract utilities re-exported for convenience
-var borrowingFeesV2_1 = require("../../contracts/fetch/fees/borrowingFeesV2");
-Object.defineProperty(exports, "fetchBorrowingFeeParamsV2", { enumerable: true, get: function () { return borrowingFeesV2_1.fetchBorrowingFeeParamsV2; } });
-Object.defineProperty(exports, "fetchPairBorrowingFeeDataV2", { enumerable: true, get: function () { return borrowingFeesV2_1.fetchPairBorrowingFeeDataV2; } });
-Object.defineProperty(exports, "fetchTradeBorrowingFeesCollateralV2", { enumerable: true, get: function () { return borrowingFeesV2_1.fetchTradeBorrowingFeesCollateralV2; } });
-Object.defineProperty(exports, "fetchPairPendingAccBorrowingFeesV2", { enumerable: true, get: function () { return borrowingFeesV2_1.fetchPairPendingAccBorrowingFeesV2; } });
-Object.defineProperty(exports, "fetchAllBorrowingV2Data", { enumerable: true, get: function () { return borrowingFeesV2_1.fetchAllBorrowingV2Data; } });
-Object.defineProperty(exports, "createBorrowingV2ContextFromContract", { enumerable: true, get: function () { return borrowingFeesV2_1.createBorrowingV2ContextFromContract; } });
-Object.defineProperty(exports, "createBorrowingV2ContextFromArrays", { enumerable: true, get: function () { return borrowingFeesV2_1.createBorrowingV2ContextFromArrays; } });
-Object.defineProperty(exports, "fetchBorrowingV2DataForPairs", { enumerable: true, get: function () { return borrowingFeesV2_1.fetchBorrowingV2DataForPairs; } });
+var fetcher_1 = require("./borrowingV2/fetcher");
+Object.defineProperty(exports, "fetchBorrowingFeeParamsV2", { enumerable: true, get: function () { return fetcher_1.fetchBorrowingFeeParamsV2; } });
+Object.defineProperty(exports, "fetchPairBorrowingFeeDataV2", { enumerable: true, get: function () { return fetcher_1.fetchPairBorrowingFeeDataV2; } });
+Object.defineProperty(exports, "fetchTradeBorrowingFeesCollateralV2", { enumerable: true, get: function () { return fetcher_1.fetchTradeBorrowingFeesCollateralV2; } });
+Object.defineProperty(exports, "fetchPairPendingAccBorrowingFeesV2", { enumerable: true, get: function () { return fetcher_1.fetchPairPendingAccBorrowingFeesV2; } });
+Object.defineProperty(exports, "fetchAllBorrowingV2Data", { enumerable: true, get: function () { return fetcher_1.fetchAllBorrowingV2Data; } });
+Object.defineProperty(exports, "createBorrowingV2ContextFromContract", { enumerable: true, get: function () { return fetcher_1.createBorrowingV2ContextFromContract; } });
+Object.defineProperty(exports, "createBorrowingV2ContextFromArrays", { enumerable: true, get: function () { return fetcher_1.createBorrowingV2ContextFromArrays; } });
+Object.defineProperty(exports, "fetchBorrowingV2DataForPairs", { enumerable: true, get: function () { return fetcher_1.fetchBorrowingV2DataForPairs; } });
 // Funding Fees exports
 var fundingFees_1 = require("./fundingFees");
 Object.defineProperty(exports, "FundingFees", { enumerable: true, get: function () { return fundingFees_1.FundingFees; } });
@@ -60,17 +68,17 @@ Object.defineProperty(exports, "getPairPendingAccFundingFees", { enumerable: tru
 Object.defineProperty(exports, "getTradeFundingFeesCollateral", { enumerable: true, get: function () { return fundingFees_1.getTradeFundingFeesCollateral; } });
 Object.defineProperty(exports, "getTradeFundingFeesCollateralSimple", { enumerable: true, get: function () { return fundingFees_1.getTradeFundingFeesCollateralSimple; } });
 Object.defineProperty(exports, "getTradeFundingFees", { enumerable: true, get: function () { return fundingFees_1.getTradeFundingFees; } });
-var converter_2 = require("./fundingFees/converter");
-Object.defineProperty(exports, "convertFundingFeeParams", { enumerable: true, get: function () { return converter_2.convertFundingFeeParams; } });
-Object.defineProperty(exports, "convertFundingFeeParamsArray", { enumerable: true, get: function () { return converter_2.convertFundingFeeParamsArray; } });
-Object.defineProperty(exports, "convertPairFundingFeeData", { enumerable: true, get: function () { return converter_2.convertPairFundingFeeData; } });
-Object.defineProperty(exports, "convertPairFundingFeeDataArray", { enumerable: true, get: function () { return converter_2.convertPairFundingFeeDataArray; } });
-Object.defineProperty(exports, "convertPairGlobalParams", { enumerable: true, get: function () { return converter_2.convertPairGlobalParams; } });
-Object.defineProperty(exports, "convertPairGlobalParamsArray", { enumerable: true, get: function () { return converter_2.convertPairGlobalParamsArray; } });
-Object.defineProperty(exports, "convertTradeInitialAccFundingFees", { enumerable: true, get: function () { return converter_2.convertTradeInitialAccFundingFees; } });
-Object.defineProperty(exports, "createFundingFeeContext", { enumerable: true, get: function () { return converter_2.createFundingFeeContext; } });
-Object.defineProperty(exports, "isValidFundingRate", { enumerable: true, get: function () { return converter_2.isValidFundingRate; } });
-Object.defineProperty(exports, "fundingRateToAPR", { enumerable: true, get: function () { return converter_2.fundingRateToAPR; } });
-Object.defineProperty(exports, "aprToFundingRate", { enumerable: true, get: function () { return converter_2.aprToFundingRate; } });
-Object.defineProperty(exports, "calculateVelocityFromSkew", { enumerable: true, get: function () { return converter_2.calculateVelocityFromSkew; } });
-Object.defineProperty(exports, "FUNDING_FEES_PRECISION", { enumerable: true, get: function () { return converter_2.FUNDING_FEES_PRECISION; } });
+var converter_3 = require("./fundingFees/converter");
+Object.defineProperty(exports, "convertFundingFeeParams", { enumerable: true, get: function () { return converter_3.convertFundingFeeParams; } });
+Object.defineProperty(exports, "convertFundingFeeParamsArray", { enumerable: true, get: function () { return converter_3.convertFundingFeeParamsArray; } });
+Object.defineProperty(exports, "convertPairFundingFeeData", { enumerable: true, get: function () { return converter_3.convertPairFundingFeeData; } });
+Object.defineProperty(exports, "convertPairFundingFeeDataArray", { enumerable: true, get: function () { return converter_3.convertPairFundingFeeDataArray; } });
+Object.defineProperty(exports, "convertPairGlobalParams", { enumerable: true, get: function () { return converter_3.convertPairGlobalParams; } });
+Object.defineProperty(exports, "convertPairGlobalParamsArray", { enumerable: true, get: function () { return converter_3.convertPairGlobalParamsArray; } });
+Object.defineProperty(exports, "convertTradeInitialAccFundingFees", { enumerable: true, get: function () { return converter_3.convertTradeInitialAccFundingFees; } });
+Object.defineProperty(exports, "createFundingFeeContext", { enumerable: true, get: function () { return converter_3.createFundingFeeContext; } });
+Object.defineProperty(exports, "isValidFundingRate", { enumerable: true, get: function () { return converter_3.isValidFundingRate; } });
+Object.defineProperty(exports, "fundingRateToAPR", { enumerable: true, get: function () { return converter_3.fundingRateToAPR; } });
+Object.defineProperty(exports, "aprToFundingRate", { enumerable: true, get: function () { return converter_3.aprToFundingRate; } });
+Object.defineProperty(exports, "calculateVelocityFromSkew", { enumerable: true, get: function () { return converter_3.calculateVelocityFromSkew; } });
+Object.defineProperty(exports, "FUNDING_FEES_PRECISION", { enumerable: true, get: function () { return converter_3.FUNDING_FEES_PRECISION; } });

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

@@ -0,0 +1,54 @@
+/**
+ * @dev Converters for fee tier data between contract and SDK formats
+ * @dev All BigNumber values are normalized to floats with appropriate precision
+ */
+import { IFeeTiers } from "../../../contracts/types/generated/GNSMultiCollatDiamond";
+import { FeeTier, TraderInfo, TraderEnrollment } from "./types";
+/**
+ * @dev Converts contract fee tier data to SDK format
+ * @param contractData Contract FeeTier struct
+ * @returns Normalized fee tier data
+ */
+export declare const convertFeeTier: (contractData: IFeeTiers.FeeTierStructOutput) => FeeTier;
+/**
+ * @dev Converts array of fee tiers from contract format
+ * @param contractDataArray Array of contract FeeTier structs
+ * @returns Array of normalized fee tiers
+ */
+export declare const convertFeeTierArray: (contractDataArray: IFeeTiers.FeeTierStructOutput[]) => FeeTier[];
+/**
+ * @dev Converts contract trader info to SDK format
+ * @param contractData Contract TraderInfo struct
+ * @returns Normalized trader info
+ */
+export declare const convertTraderInfo: (contractData: IFeeTiers.TraderInfoStructOutput) => TraderInfo;
+/**
+ * @dev Converts contract trader enrollment to SDK format
+ * @param contractData Contract TraderEnrollment struct
+ * @returns Normalized trader enrollment
+ */
+export declare const convertTraderEnrollment: (contractData: IFeeTiers.TraderEnrollmentStructOutput) => TraderEnrollment;
+/**
+ * @dev Converts the complete fee tiers configuration from contract format
+ * @param tiers Array of fee tiers from contract
+ * @param groupVolumeMultipliers Array of group volume multipliers
+ * @param currentDay Current day from contract
+ * @returns Complete fee tiers configuration
+ */
+export declare const convertFeeTiersConfig: (tiers: IFeeTiers.FeeTierStructOutput[], groupVolumeMultipliers: readonly bigint[], currentDay: bigint) => {
+    tiers: FeeTier[];
+    groupVolumeMultipliers: number[];
+    currentDay: number;
+};
+/**
+ * @dev Converts trader's fee tier data from contract format
+ * @param traderInfo Trader info from contract
+ * @param traderDailyInfo Array of daily points info
+ * @param traderEnrollment Enrollment status from contract
+ * @returns Complete trader fee tier data
+ */
+export declare const convertTraderFeeTiersData: (traderInfo: IFeeTiers.TraderInfoStructOutput, traderDailyInfo: readonly bigint[], traderEnrollment: IFeeTiers.TraderEnrollmentStructOutput) => {
+    traderInfo: TraderInfo;
+    dailyPoints: number[];
+    traderEnrollment: TraderEnrollment;
+};

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

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * @dev Converters for fee tier data between contract and SDK formats
+ * @dev All BigNumber values are normalized to floats with appropriate precision
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertTraderFeeTiersData = exports.convertFeeTiersConfig = exports.convertTraderEnrollment = exports.convertTraderInfo = exports.convertFeeTierArray = exports.convertFeeTier = void 0;
+/**
+ * @dev Converts contract fee tier data to SDK format
+ * @param contractData Contract FeeTier struct
+ * @returns Normalized fee tier data
+ */
+const convertFeeTier = (contractData) => {
+    return {
+        feeMultiplier: Number(contractData.feeMultiplier) / 1e3,
+        pointsThreshold: Number(contractData.pointsThreshold) / 1e18, // Points in 1e18 precision
+    };
+};
+exports.convertFeeTier = convertFeeTier;
+/**
+ * @dev Converts array of fee tiers from contract format
+ * @param contractDataArray Array of contract FeeTier structs
+ * @returns Array of normalized fee tiers
+ */
+const convertFeeTierArray = (contractDataArray) => {
+    return contractDataArray.map(exports.convertFeeTier);
+};
+exports.convertFeeTierArray = convertFeeTierArray;
+/**
+ * @dev Converts contract trader info to SDK format
+ * @param contractData Contract TraderInfo struct
+ * @returns Normalized trader info
+ */
+const convertTraderInfo = (contractData) => {
+    return {
+        lastDayUpdated: Number(contractData.lastDayUpdated),
+        trailingPoints: Number(contractData.trailingPoints) / 1e18, // Points in 1e18 precision
+    };
+};
+exports.convertTraderInfo = convertTraderInfo;
+/**
+ * @dev Converts contract trader enrollment to SDK format
+ * @param contractData Contract TraderEnrollment struct
+ * @returns Normalized trader enrollment
+ */
+const convertTraderEnrollment = (contractData) => {
+    return {
+        status: Number(contractData.status),
+    };
+};
+exports.convertTraderEnrollment = convertTraderEnrollment;
+/**
+ * @dev Converts the complete fee tiers configuration from contract format
+ * @param tiers Array of fee tiers from contract
+ * @param groupVolumeMultipliers Array of group volume multipliers
+ * @param currentDay Current day from contract
+ * @returns Complete fee tiers configuration
+ */
+const convertFeeTiersConfig = (tiers, groupVolumeMultipliers, currentDay) => {
+    return {
+        tiers: (0, exports.convertFeeTierArray)(tiers),
+        groupVolumeMultipliers: groupVolumeMultipliers.map(m => Number(m) / 1e3),
+        currentDay: Number(currentDay),
+    };
+};
+exports.convertFeeTiersConfig = convertFeeTiersConfig;
+/**
+ * @dev Converts trader's fee tier data from contract format
+ * @param traderInfo Trader info from contract
+ * @param traderDailyInfo Array of daily points info
+ * @param traderEnrollment Enrollment status from contract
+ * @returns Complete trader fee tier data
+ */
+const convertTraderFeeTiersData = (traderInfo, traderDailyInfo, traderEnrollment) => {
+    return {
+        traderInfo: (0, exports.convertTraderInfo)(traderInfo),
+        dailyPoints: traderDailyInfo.map(points => Number(points) / 1e18),
+        traderEnrollment: (0, exports.convertTraderEnrollment)(traderEnrollment),
+    };
+};
+exports.convertTraderFeeTiersData = convertTraderFeeTiersData;

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

@@ -1,6 +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;

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

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 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;

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

@@ -0,0 +1,18 @@
+/**
+ * @dev Trading fees context builder module
+ * @dev Provides builder functions for creating trading fee contexts
+ */
+import { Fee, GlobalTradeFeeParams } from "../../types";
+import { GlobalTradingVariablesType } from "src/backend/tradingVariables/types";
+/**
+ * @dev Sub-context for trading fees
+ */
+export type TradingFeesSubContext = {
+    fee: Fee;
+    globalTradeFeeParams: GlobalTradeFeeParams;
+    traderFeeMultiplier?: number;
+};
+/**
+ * @dev Builds trading fees sub-context
+ */
+export declare const buildTradingFeesContext: (globalTradingVariables: GlobalTradingVariablesType, pairIndex: number, traderFeeMultiplier?: number) => TradingFeesSubContext;