@gainsnetwork/sdk 0.0.0-me-rc1

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

@@ -0,0 +1,75 @@
+import type { IFundingFees } from "../../../contracts/types/generated/GNSMultiCollatDiamond";
+import { BorrowingFeeV2 } from ".";
+/**
+ * @dev Converts contract BorrowingFeeParams to SDK type
+ * @param contractParams Contract borrowing fee params from IFundingFees.BorrowingFeeParams
+ * @returns SDK BorrowingFeeParams
+ */
+export declare const convertBorrowingFeeParams: (contractParams: IFundingFees.BorrowingFeeParamsStructOutput) => BorrowingFeeV2.BorrowingFeeParams;
+/**
+ * @dev Converts array of contract BorrowingFeeParams to SDK types
+ * @param contractParamsArray Array of contract borrowing fee params
+ * @returns Array of SDK BorrowingFeeParams
+ */
+export declare const convertBorrowingFeeParamsArray: (contractParamsArray: IFundingFees.BorrowingFeeParamsStructOutput[]) => BorrowingFeeV2.BorrowingFeeParams[];
+/**
+ * @dev Converts contract PairBorrowingFeeData to SDK type
+ * @param contractData Contract pair borrowing fee data from IFundingFees.PairBorrowingFeeData
+ * @returns SDK PairBorrowingFeeData
+ */
+export declare const convertPairBorrowingFeeData: (contractData: IFundingFees.PairBorrowingFeeDataStructOutput) => BorrowingFeeV2.PairBorrowingFeeData;
+/**
+ * @dev Converts array of contract PairBorrowingFeeData to SDK types
+ * @param contractDataArray Array of contract pair borrowing fee data
+ * @returns Array of SDK PairBorrowingFeeData
+ */
+export declare const convertPairBorrowingFeeDataArray: (contractDataArray: IFundingFees.PairBorrowingFeeDataStructOutput[]) => BorrowingFeeV2.PairBorrowingFeeData[];
+/**
+ * @dev Converts contract TradeFeesData to SDK TradeInitialAccFees
+ * @param contractTradeData Contract trade fees data from IFundingFees.TradeFeesData
+ * @returns SDK TradeInitialAccFees
+ */
+export declare const convertTradeInitialAccFees: (contractTradeData: IFundingFees.TradeFeesDataStructOutput) => BorrowingFeeV2.TradeInitialAccFees;
+/**
+ * @dev Converts array of contract TradeFeesData to SDK TradeInitialAccFees
+ * @param contractTradeDataArray Array of contract trade fees data
+ * @returns Array of SDK TradeInitialAccFees
+ */
+export declare const convertTradeInitialAccFeesArray: (contractTradeDataArray: IFundingFees.TradeFeesDataStructOutput[]) => BorrowingFeeV2.TradeInitialAccFees[];
+/**
+ * @dev Creates a context object from contract data arrays
+ * @param pairIndices Array of pair indices
+ * @param borrowingParams Array of borrowing fee params from contract
+ * @param borrowingData Array of pair borrowing fee data from contract
+ * @param currentTimestamp Optional current timestamp
+ * @returns Complete SDK context for borrowing v2 calculations (collateral-scoped)
+ */
+export declare const createBorrowingV2Context: (pairIndices: number[], borrowingParams: IFundingFees.BorrowingFeeParamsStructOutput[], borrowingData: IFundingFees.PairBorrowingFeeDataStructOutput[], currentTimestamp?: number) => BorrowingFeeV2.GetBorrowingFeeV2Context;
+/**
+ * @dev Helper function to validate borrowing rate per second
+ * @param borrowingRatePerSecondP Borrowing rate per second (normalized float)
+ * @returns True if rate is within valid bounds
+ */
+export declare const isValidBorrowingRate: (borrowingRatePerSecondP: number) => boolean;
+/**
+ * @dev Helper function to convert borrowing rate to APR percentage
+ * @param borrowingRatePerSecondP Borrowing rate per second (normalized float)
+ * @returns APR as percentage (e.g., 10.5 for 10.5% APR)
+ */
+export declare const borrowingRateToAPR: (borrowingRatePerSecondP: number) => number;
+/**
+ * @dev Helper function to convert APR percentage to borrowing rate per second
+ * @param aprPercentage APR as percentage (e.g., 10.5 for 10.5% APR)
+ * @returns Borrowing rate per second (normalized float)
+ */
+export declare const aprToBorrowingRate: (aprPercentage: number) => number;
+/**
+ * @dev Creates a collateral-scoped context from frontend data structure
+ * @param collateralBorrowingData Data structure from frontend (params and data arrays)
+ * @param currentTimestamp Optional current timestamp
+ * @returns Collateral-scoped borrowing fee v2 context
+ */
+export declare const createCollateralScopedBorrowingContext: (collateralBorrowingData: {
+    params: BorrowingFeeV2.BorrowingFeeParams[];
+    data: BorrowingFeeV2.PairBorrowingFeeData[];
+}, currentTimestamp?: number) => BorrowingFeeV2.GetBorrowingFeeV2Context;

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

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCollateralScopedBorrowingContext = exports.aprToBorrowingRate = exports.borrowingRateToAPR = exports.isValidBorrowingRate = exports.createBorrowingV2Context = exports.convertTradeInitialAccFeesArray = exports.convertTradeInitialAccFees = exports.convertPairBorrowingFeeDataArray = exports.convertPairBorrowingFeeData = exports.convertBorrowingFeeParamsArray = exports.convertBorrowingFeeParams = void 0;
+const index_1 = require("./index");
+/**
+ * @dev Converts contract BorrowingFeeParams to SDK type
+ * @param contractParams Contract borrowing fee params from IFundingFees.BorrowingFeeParams
+ * @returns SDK BorrowingFeeParams
+ */
+const convertBorrowingFeeParams = (contractParams) => ({
+    borrowingRatePerSecondP: contractParams.borrowingRatePerSecondP /
+        index_1.BORROWING_V2_PRECISION.RATE_PER_SECOND,
+});
+exports.convertBorrowingFeeParams = convertBorrowingFeeParams;
+/**
+ * @dev Converts array of contract BorrowingFeeParams to SDK types
+ * @param contractParamsArray Array of contract borrowing fee params
+ * @returns Array of SDK BorrowingFeeParams
+ */
+const convertBorrowingFeeParamsArray = (contractParamsArray) => contractParamsArray.map(params => (0, exports.convertBorrowingFeeParams)(params));
+exports.convertBorrowingFeeParamsArray = convertBorrowingFeeParamsArray;
+/**
+ * @dev Converts contract PairBorrowingFeeData to SDK type
+ * @param contractData Contract pair borrowing fee data from IFundingFees.PairBorrowingFeeData
+ * @returns SDK PairBorrowingFeeData
+ */
+const convertPairBorrowingFeeData = (contractData) => ({
+    accBorrowingFeeP: parseFloat(contractData.accBorrowingFeeP.toString()) /
+        index_1.BORROWING_V2_PRECISION.ACC_FEE,
+    lastBorrowingUpdateTs: contractData.lastBorrowingUpdateTs,
+});
+exports.convertPairBorrowingFeeData = convertPairBorrowingFeeData;
+/**
+ * @dev Converts array of contract PairBorrowingFeeData to SDK types
+ * @param contractDataArray Array of contract pair borrowing fee data
+ * @returns Array of SDK PairBorrowingFeeData
+ */
+const convertPairBorrowingFeeDataArray = (contractDataArray) => contractDataArray.map(data => (0, exports.convertPairBorrowingFeeData)(data));
+exports.convertPairBorrowingFeeDataArray = convertPairBorrowingFeeDataArray;
+/**
+ * @dev Converts contract TradeFeesData to SDK TradeInitialAccFees
+ * @param contractTradeData Contract trade fees data from IFundingFees.TradeFeesData
+ * @returns SDK TradeInitialAccFees
+ */
+const convertTradeInitialAccFees = (contractTradeData) => ({
+    initialAccBorrowingFeeP: parseFloat(contractTradeData.initialAccBorrowingFeeP.toString()) /
+        index_1.BORROWING_V2_PRECISION.ACC_FEE,
+});
+exports.convertTradeInitialAccFees = convertTradeInitialAccFees;
+/**
+ * @dev Converts array of contract TradeFeesData to SDK TradeInitialAccFees
+ * @param contractTradeDataArray Array of contract trade fees data
+ * @returns Array of SDK TradeInitialAccFees
+ */
+const convertTradeInitialAccFeesArray = (contractTradeDataArray) => contractTradeDataArray.map(data => (0, exports.convertTradeInitialAccFees)(data));
+exports.convertTradeInitialAccFeesArray = convertTradeInitialAccFeesArray;
+/**
+ * @dev Creates a context object from contract data arrays
+ * @param pairIndices Array of pair indices
+ * @param borrowingParams Array of borrowing fee params from contract
+ * @param borrowingData Array of pair borrowing fee data from contract
+ * @param currentTimestamp Optional current timestamp
+ * @returns Complete SDK context for borrowing v2 calculations (collateral-scoped)
+ */
+const createBorrowingV2Context = (pairIndices, borrowingParams, borrowingData, currentTimestamp) => {
+    const context = {
+        currentTimestamp,
+        borrowingParams: {},
+        borrowingData: {},
+    };
+    // Build objects indexed by pairIndex
+    for (let i = 0; i < pairIndices.length; i++) {
+        const pairIndex = pairIndices[i];
+        // Store converted data
+        context.borrowingParams[pairIndex] = (0, exports.convertBorrowingFeeParams)(borrowingParams[i]);
+        context.borrowingData[pairIndex] = (0, exports.convertPairBorrowingFeeData)(borrowingData[i]);
+    }
+    return context;
+};
+exports.createBorrowingV2Context = createBorrowingV2Context;
+/**
+ * @dev Helper function to validate borrowing rate per second
+ * @param borrowingRatePerSecondP Borrowing rate per second (normalized float)
+ * @returns True if rate is within valid bounds
+ */
+const isValidBorrowingRate = (borrowingRatePerSecondP) => {
+    return (borrowingRatePerSecondP >= 0 &&
+        borrowingRatePerSecondP <= 317097 / index_1.BORROWING_V2_PRECISION.RATE_PER_SECOND); // Max 1,000% APR
+};
+exports.isValidBorrowingRate = isValidBorrowingRate;
+/**
+ * @dev Helper function to convert borrowing rate to APR percentage
+ * @param borrowingRatePerSecondP Borrowing rate per second (normalized float)
+ * @returns APR as percentage (e.g., 10.5 for 10.5% APR)
+ */
+const borrowingRateToAPR = (borrowingRatePerSecondP) => {
+    const SECONDS_PER_YEAR = 365 * 24 * 60 * 60; // 31,536,000
+    return borrowingRatePerSecondP * SECONDS_PER_YEAR;
+};
+exports.borrowingRateToAPR = borrowingRateToAPR;
+/**
+ * @dev Helper function to convert APR percentage to borrowing rate per second
+ * @param aprPercentage APR as percentage (e.g., 10.5 for 10.5% APR)
+ * @returns Borrowing rate per second (normalized float)
+ */
+const aprToBorrowingRate = (aprPercentage) => {
+    const SECONDS_PER_YEAR = 365 * 24 * 60 * 60; // 31,536,000
+    return aprPercentage / SECONDS_PER_YEAR;
+};
+exports.aprToBorrowingRate = aprToBorrowingRate;
+/**
+ * @dev Creates a collateral-scoped context from frontend data structure
+ * @param collateralBorrowingData Data structure from frontend (params and data arrays)
+ * @param currentTimestamp Optional current timestamp
+ * @returns Collateral-scoped borrowing fee v2 context
+ */
+const createCollateralScopedBorrowingContext = (collateralBorrowingData, currentTimestamp) => {
+    const context = {
+        currentTimestamp: currentTimestamp ?? Math.floor(Date.now() / 1000),
+        borrowingParams: {},
+        borrowingData: {},
+    };
+    // Map arrays to objects indexed by array position (pairIndex)
+    collateralBorrowingData.params.forEach((param, index) => {
+        context.borrowingParams[index] = param;
+    });
+    collateralBorrowingData.data.forEach((data, index) => {
+        context.borrowingData[index] = data;
+    });
+    return context;
+};
+exports.createCollateralScopedBorrowingContext = createCollateralScopedBorrowingContext;

package/lib/trade/fees/borrowingV2/fetcher.d.ts

@@ -0,0 +1,76 @@
+/// <reference types="mocha" />
+import type { GNSMultiCollatDiamond } from "../../../contracts/types/generated";
+import { BorrowingFeeV2 } from ".";
+/**
+ * @dev Fetches borrowing fee parameters v2 for specific pairs
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndices Array of collateral indices
+ * @param pairIndices Array of pair indices
+ * @returns Promise resolving to array of borrowing fee parameters
+ */
+export declare const fetchBorrowingFeeParamsV2: (contract: GNSMultiCollatDiamond, collateralIndices: number[], pairIndices: number[]) => Promise<BorrowingFeeV2.BorrowingFeeParams[]>;
+/**
+ * @dev Fetches pair borrowing fee data v2 for specific pairs
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndices Array of collateral indices
+ * @param pairIndices Array of pair indices
+ * @returns Promise resolving to array of pair borrowing fee data
+ */
+export declare const fetchPairBorrowingFeeDataV2: (contract: GNSMultiCollatDiamond, collateralIndices: number[], pairIndices: number[]) => Promise<BorrowingFeeV2.PairBorrowingFeeData[]>;
+/**
+ * @dev Fetches borrowing fees in collateral tokens for a specific trade
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param trader Address of the trader
+ * @param index Trade index
+ * @param currentPairPrice Current price of the trading pair (1e6 precision)
+ * @returns Promise resolving to borrowing fees in collateral tokens
+ */
+export declare const fetchTradeBorrowingFeesCollateralV2: (contract: GNSMultiCollatDiamond, trader: string, index: number, currentPairPrice: number) => Promise<number>;
+/**
+ * @dev Fetches pending accumulated borrowing fees for a specific pair
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndex Index of the collateral
+ * @param pairIndex Index of the trading pair
+ * @param currentPairPrice Current price of the trading pair (1e6 precision)
+ * @returns Promise resolving to pending accumulated borrowing fee
+ */
+export declare const fetchPairPendingAccBorrowingFeesV2: (contract: GNSMultiCollatDiamond, collateralIndex: number, pairIndex: number, currentPairPrice: number) => Promise<number>;
+/**
+ * @dev Convenience function to fetch all borrowing v2 data for specific pairs
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndex Index of the collateral
+ * @param pairIndices Array of pair indices
+ * @returns Promise resolving to complete borrowing v2 data set
+ */
+export declare const fetchAllBorrowingV2Data: (contract: GNSMultiCollatDiamond, collateralIndex: number, pairIndices: number[]) => Promise<{
+    params: BorrowingFeeV2.BorrowingFeeParams[];
+    data: BorrowingFeeV2.PairBorrowingFeeData[];
+    context: BorrowingFeeV2.GetBorrowingFeeV2Context;
+}>;
+/**
+ * @dev Creates a complete borrowing v2 context from contract data
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndex Index of the collateral
+ * @param pairIndices Array of pair indices
+ * @param currentTimestamp Optional current timestamp for calculations
+ * @returns Promise resolving to complete borrowing v2 context
+ */
+export declare const createBorrowingV2ContextFromContract: (contract: GNSMultiCollatDiamond, collateralIndex: number, pairIndices: number[], currentTimestamp?: number) => Promise<BorrowingFeeV2.GetBorrowingFeeV2Context>;
+/**
+ * @dev Helper function to create context from already fetched arrays
+ * @param collateralIndices Array of collateral indices
+ * @param pairIndices Array of pair indices
+ * @param params Array of borrowing fee parameters
+ * @param data Array of pair borrowing fee data
+ * @param currentTimestamp Optional current timestamp
+ * @returns Complete borrowing v2 context
+ */
+export declare const createBorrowingV2ContextFromArrays: (collateralIndices: number[], pairIndices: number[], params: BorrowingFeeV2.BorrowingFeeParams[], data: BorrowingFeeV2.PairBorrowingFeeData[], currentTimestamp?: number) => BorrowingFeeV2.GetBorrowingFeeV2Context;
+/**
+ * @dev Fetches borrowing v2 data for multiple collateral/pair combinations
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndices Array of collateral indices
+ * @param pairIndices Array of pair indices (must match collateralIndices length)
+ * @returns Promise resolving to complete borrowing v2 context
+ */
+export declare const fetchBorrowingV2DataForPairs: (contract: GNSMultiCollatDiamond, collateralIndices: number[], pairIndices: number[]) => Promise<BorrowingFeeV2.GetBorrowingFeeV2Context>;

package/lib/trade/fees/borrowingV2/fetcher.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchBorrowingV2DataForPairs = exports.createBorrowingV2ContextFromArrays = exports.createBorrowingV2ContextFromContract = exports.fetchAllBorrowingV2Data = exports.fetchPairPendingAccBorrowingFeesV2 = exports.fetchTradeBorrowingFeesCollateralV2 = exports.fetchPairBorrowingFeeDataV2 = exports.fetchBorrowingFeeParamsV2 = void 0;
+const converter_1 = require("./converter");
+/**
+ * @dev Fetches borrowing fee parameters v2 for specific pairs
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndices Array of collateral indices
+ * @param pairIndices Array of pair indices
+ * @returns Promise resolving to array of borrowing fee parameters
+ */
+const fetchBorrowingFeeParamsV2 = async (contract, collateralIndices, pairIndices) => {
+    if (collateralIndices.length !== pairIndices.length) {
+        throw new Error("Collateral indices and pair indices arrays must have the same length");
+    }
+    try {
+        const contractParams = await contract.getPairBorrowingFeeParams(collateralIndices, pairIndices);
+        return (0, converter_1.convertBorrowingFeeParamsArray)(contractParams);
+    }
+    catch (error) {
+        console.error("Error fetching borrowing fee params v2:", error);
+        throw error;
+    }
+};
+exports.fetchBorrowingFeeParamsV2 = fetchBorrowingFeeParamsV2;
+/**
+ * @dev Fetches pair borrowing fee data v2 for specific pairs
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndices Array of collateral indices
+ * @param pairIndices Array of pair indices
+ * @returns Promise resolving to array of pair borrowing fee data
+ */
+const fetchPairBorrowingFeeDataV2 = async (contract, collateralIndices, pairIndices) => {
+    if (collateralIndices.length !== pairIndices.length) {
+        throw new Error("Collateral indices and pair indices arrays must have the same length");
+    }
+    try {
+        const contractData = await contract.getPairBorrowingFeeData(collateralIndices, pairIndices);
+        return (0, converter_1.convertPairBorrowingFeeDataArray)(contractData);
+    }
+    catch (error) {
+        console.error("Error fetching pair borrowing fee data v2:", error);
+        throw error;
+    }
+};
+exports.fetchPairBorrowingFeeDataV2 = fetchPairBorrowingFeeDataV2;
+/**
+ * @dev Fetches borrowing fees in collateral tokens for a specific trade
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param trader Address of the trader
+ * @param index Trade index
+ * @param currentPairPrice Current price of the trading pair (1e6 precision)
+ * @returns Promise resolving to borrowing fees in collateral tokens
+ */
+const fetchTradeBorrowingFeesCollateralV2 = async (contract, trader, index, currentPairPrice) => {
+    try {
+        const feesCollateral = await contract.getTradeBorrowingFeesCollateral(trader, index, currentPairPrice);
+        // Convert BigNumber to normalized float
+        // Note: Collateral precision varies by chain, but contract returns proper precision
+        return parseFloat(feesCollateral.toString());
+    }
+    catch (error) {
+        console.error("Error fetching trade borrowing fees collateral v2:", error);
+        throw error;
+    }
+};
+exports.fetchTradeBorrowingFeesCollateralV2 = fetchTradeBorrowingFeesCollateralV2;
+/**
+ * @dev Fetches pending accumulated borrowing fees for a specific pair
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndex Index of the collateral
+ * @param pairIndex Index of the trading pair
+ * @param currentPairPrice Current price of the trading pair (1e6 precision)
+ * @returns Promise resolving to pending accumulated borrowing fee
+ */
+const fetchPairPendingAccBorrowingFeesV2 = async (contract, collateralIndex, pairIndex, currentPairPrice) => {
+    try {
+        const accBorrowingFeeP = await contract.getPairPendingAccBorrowingFees(collateralIndex, pairIndex, currentPairPrice);
+        // Convert BigNumber to normalized float
+        return parseFloat(accBorrowingFeeP.toString()) / 1e20;
+    }
+    catch (error) {
+        console.error("Error fetching pair pending acc borrowing fees v2:", error);
+        throw error;
+    }
+};
+exports.fetchPairPendingAccBorrowingFeesV2 = fetchPairPendingAccBorrowingFeesV2;
+/**
+ * @dev Convenience function to fetch all borrowing v2 data for specific pairs
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndex Index of the collateral
+ * @param pairIndices Array of pair indices
+ * @returns Promise resolving to complete borrowing v2 data set
+ */
+const fetchAllBorrowingV2Data = async (contract, collateralIndex, pairIndices) => {
+    const collateralIndices = new Array(pairIndices.length).fill(collateralIndex);
+    try {
+        // Fetch both parameters and data in parallel
+        const [params, data] = await Promise.all([
+            (0, exports.fetchBorrowingFeeParamsV2)(contract, collateralIndices, pairIndices),
+            (0, exports.fetchPairBorrowingFeeDataV2)(contract, collateralIndices, pairIndices),
+        ]);
+        // Create context from fetched data
+        const context = (0, exports.createBorrowingV2ContextFromArrays)(collateralIndices, pairIndices, params, data);
+        return { params, data, context };
+    }
+    catch (error) {
+        console.error("Error fetching all borrowing v2 data:", error);
+        throw error;
+    }
+};
+exports.fetchAllBorrowingV2Data = fetchAllBorrowingV2Data;
+/**
+ * @dev Creates a complete borrowing v2 context from contract data
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndex Index of the collateral
+ * @param pairIndices Array of pair indices
+ * @param currentTimestamp Optional current timestamp for calculations
+ * @returns Promise resolving to complete borrowing v2 context
+ */
+const createBorrowingV2ContextFromContract = async (contract, collateralIndex, pairIndices, currentTimestamp) => {
+    const { context } = await (0, exports.fetchAllBorrowingV2Data)(contract, collateralIndex, pairIndices);
+    return {
+        ...context,
+        currentTimestamp: currentTimestamp ?? Math.floor(Date.now() / 1000),
+    };
+};
+exports.createBorrowingV2ContextFromContract = createBorrowingV2ContextFromContract;
+/**
+ * @dev Helper function to create context from already fetched arrays
+ * @param collateralIndices Array of collateral indices
+ * @param pairIndices Array of pair indices
+ * @param params Array of borrowing fee parameters
+ * @param data Array of pair borrowing fee data
+ * @param currentTimestamp Optional current timestamp
+ * @returns Complete borrowing v2 context
+ */
+const createBorrowingV2ContextFromArrays = (collateralIndices, pairIndices, params, data, currentTimestamp) => {
+    const context = {
+        currentTimestamp: currentTimestamp ?? Math.floor(Date.now() / 1000),
+        borrowingParams: {},
+        borrowingData: {},
+    };
+    // Build objects indexed by pairIndex (collateral-scoped)
+    for (let i = 0; i < pairIndices.length; i++) {
+        const pairIndex = pairIndices[i];
+        // Store data indexed by pairIndex
+        context.borrowingParams[pairIndex] = params[i];
+        context.borrowingData[pairIndex] = data[i];
+    }
+    return context;
+};
+exports.createBorrowingV2ContextFromArrays = createBorrowingV2ContextFromArrays;
+/**
+ * @dev Fetches borrowing v2 data for multiple collateral/pair combinations
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndices Array of collateral indices
+ * @param pairIndices Array of pair indices (must match collateralIndices length)
+ * @returns Promise resolving to complete borrowing v2 context
+ */
+const fetchBorrowingV2DataForPairs = async (contract, collateralIndices, pairIndices) => {
+    if (collateralIndices.length !== pairIndices.length) {
+        throw new Error("Collateral indices and pair indices arrays must have the same length");
+    }
+    try {
+        // Fetch both parameters and data in parallel
+        const [params, data] = await Promise.all([
+            (0, exports.fetchBorrowingFeeParamsV2)(contract, collateralIndices, pairIndices),
+            (0, exports.fetchPairBorrowingFeeDataV2)(contract, collateralIndices, pairIndices),
+        ]);
+        // Create and return context
+        return (0, exports.createBorrowingV2ContextFromArrays)(collateralIndices, pairIndices, params, data);
+    }
+    catch (error) {
+        console.error("Error fetching borrowing v2 data for pairs:", error);
+        throw error;
+    }
+};
+exports.fetchBorrowingV2DataForPairs = fetchBorrowingV2DataForPairs;

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

@@ -0,0 +1,48 @@
+import * as BorrowingFeeV2 from "./types";
+/**
+ * @dev Maximum borrowing rate per second (1,000% APR)
+ */
+export declare const MAX_BORROWING_RATE_PER_SECOND = 0.0317097;
+/**
+ * @dev Precision constants for borrowing v2 calculations
+ */
+export declare const BORROWING_V2_PRECISION: {
+    readonly RATE_PER_SECOND: 10000000000;
+    readonly ACC_FEE: 100000000000000000000;
+    readonly PERCENTAGE: 100;
+};
+/**
+ * @dev Calculates pending accumulated borrowing fees for a pair
+ * @param params Borrowing fee parameters for the pair
+ * @param data Current borrowing fee data for the pair
+ * @param currentPairPrice Current price of the trading pair
+ * @param currentTimestamp Current timestamp (defaults to now)
+ * @returns Updated accumulated borrowing fee (1e20 precision)
+ */
+export declare const getPairPendingAccBorrowingFees: (params: BorrowingFeeV2.BorrowingFeeParams, data: BorrowingFeeV2.PairBorrowingFeeData, currentPairPrice: number, currentTimestamp?: number) => number;
+/**
+ * @dev Calculates borrowing fees owed by a specific trade
+ * @param input Trade borrowing fee calculation input (without pairIndex)
+ * @param context Pair-specific borrowing context
+ * @returns Borrowing fees in collateral tokens
+ */
+export declare const getTradeBorrowingFeesCollateral: (input: Omit<BorrowingFeeV2.TradeBorrowingFeeInput, "pairIndex">, context: BorrowingFeeV2.GetPairBorrowingFeeV2Context) => number;
+/**
+ * @dev Utility function to get pending accumulated borrowing fees for a pair using context
+ * @param input Pair borrowing fee calculation input
+ * @param context Context containing borrowing parameters and data
+ * @returns Updated accumulated borrowing fee (1e20 precision)
+ */
+export declare const getPairBorrowingFees: (input: BorrowingFeeV2.PairBorrowingFeeInput, context: BorrowingFeeV2.GetBorrowingFeeV2Context) => number;
+/**
+ * @dev Utility functions for working with borrowing v2 fees
+ */
+export declare const borrowingFeeV2Utils: {
+    getPairPendingAccBorrowingFees: (params: BorrowingFeeV2.BorrowingFeeParams, data: BorrowingFeeV2.PairBorrowingFeeData, currentPairPrice: number, currentTimestamp?: number) => number;
+    getTradeBorrowingFeesCollateral: (input: Omit<BorrowingFeeV2.TradeBorrowingFeeInput, "pairIndex">, context: BorrowingFeeV2.GetPairBorrowingFeeV2Context) => number;
+    getPairBorrowingFees: (input: BorrowingFeeV2.PairBorrowingFeeInput, context: BorrowingFeeV2.GetBorrowingFeeV2Context) => number;
+};
+export * as BorrowingFeeV2 from "./types";
+export { GetPairBorrowingFeeV2Context } from "./types";
+export * from "./converter";
+export * from "./fetcher";

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

@@ -0,0 +1,112 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __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.BorrowingFeeV2 = exports.borrowingFeeV2Utils = exports.getPairBorrowingFees = exports.getTradeBorrowingFeesCollateral = exports.getPairPendingAccBorrowingFees = exports.BORROWING_V2_PRECISION = exports.MAX_BORROWING_RATE_PER_SECOND = void 0;
+/**
+ * @dev Maximum borrowing rate per second (1,000% APR)
+ */
+exports.MAX_BORROWING_RATE_PER_SECOND = 0.0317097; // 317097 / 1e10
+/**
+ * @dev Precision constants for borrowing v2 calculations
+ */
+exports.BORROWING_V2_PRECISION = {
+    RATE_PER_SECOND: 1e10,
+    ACC_FEE: 1e20,
+    PERCENTAGE: 100,
+};
+/**
+ * @dev Calculates pending accumulated borrowing fees for a pair
+ * @param params Borrowing fee parameters for the pair
+ * @param data Current borrowing fee data for the pair
+ * @param currentPairPrice Current price of the trading pair
+ * @param currentTimestamp Current timestamp (defaults to now)
+ * @returns Updated accumulated borrowing fee (1e20 precision)
+ */
+const getPairPendingAccBorrowingFees = (params, data, currentPairPrice, currentTimestamp) => {
+    const timestamp = currentTimestamp ?? Math.floor(Date.now() / 1000);
+    // Calculate time elapsed since last update
+    const timeElapsed = Math.max(0, timestamp - data.lastBorrowingUpdateTs);
+    // If no time elapsed, return current accumulated fee
+    if (timeElapsed === 0) {
+        return data.accBorrowingFeeP;
+    }
+    // Calculate accumulated borrowing fee delta
+    // Formula: borrowingRatePerSecondP * timeElapsed * currentPairPrice
+    const accBorrowingFeeDeltaP = params.borrowingRatePerSecondP * timeElapsed * currentPairPrice;
+    return data.accBorrowingFeeP + accBorrowingFeeDeltaP;
+};
+exports.getPairPendingAccBorrowingFees = getPairPendingAccBorrowingFees;
+/**
+ * @dev Calculates borrowing fees owed by a specific trade
+ * @param input Trade borrowing fee calculation input (without pairIndex)
+ * @param context Pair-specific borrowing context
+ * @returns Borrowing fees in collateral tokens
+ */
+const getTradeBorrowingFeesCollateral = (input, context) => {
+    const { positionSizeCollateral, openPrice, currentPairPrice, initialAccBorrowingFeeP, currentTimestamp, } = input;
+    const { params, data } = context;
+    if (!params || !data) {
+        return 0;
+    }
+    // Calculate current accumulated borrowing fees
+    const currentAccBorrowingFeeP = (0, exports.getPairPendingAccBorrowingFees)(params, data, currentPairPrice, currentTimestamp ?? context.currentTimestamp);
+    // Calculate borrowing fees for this trade
+    // Formula: (positionSizeCollateral * (currentAccFee - initialAccFee)) / openPrice / 100
+    const feeDeltaP = currentAccBorrowingFeeP - initialAccBorrowingFeeP;
+    return ((positionSizeCollateral * feeDeltaP) /
+        openPrice /
+        exports.BORROWING_V2_PRECISION.PERCENTAGE);
+};
+exports.getTradeBorrowingFeesCollateral = getTradeBorrowingFeesCollateral;
+/**
+ * @dev Utility function to get pending accumulated borrowing fees for a pair using context
+ * @param input Pair borrowing fee calculation input
+ * @param context Context containing borrowing parameters and data
+ * @returns Updated accumulated borrowing fee (1e20 precision)
+ */
+const getPairBorrowingFees = (input, context) => {
+    const { pairIndex, currentPairPrice, currentTimestamp } = input;
+    const params = context.borrowingParams[pairIndex];
+    const data = context.borrowingData[pairIndex];
+    if (!params || !data) {
+        return 0;
+    }
+    return (0, exports.getPairPendingAccBorrowingFees)(params, data, currentPairPrice, currentTimestamp ?? context.currentTimestamp);
+};
+exports.getPairBorrowingFees = getPairBorrowingFees;
+/**
+ * @dev Utility functions for working with borrowing v2 fees
+ */
+exports.borrowingFeeV2Utils = {
+    getPairPendingAccBorrowingFees: exports.getPairPendingAccBorrowingFees,
+    getTradeBorrowingFeesCollateral: exports.getTradeBorrowingFeesCollateral,
+    getPairBorrowingFees: exports.getPairBorrowingFees,
+};
+exports.BorrowingFeeV2 = __importStar(require("./types"));
+__exportStar(require("./converter"), exports);
+__exportStar(require("./fetcher"), exports);