@gainsnetwork/sdk 1.4.0-rc1 → 1.4.2-rc1

package/lib/contracts/utils/borrowingFees.js

@@ -1,13 +1,4 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchAllPairAndGroupBorrowingFees = exports.fetchGroupBorrowingFees = exports.fetchAllPairBorrowingFees = exports.getBorrowingGroupName = void 0;
 const trade_1 = require("../../trade");
@@ -31,24 +22,22 @@ const getBorrowingGroupName = (groupIndex) => {
     return groupNamesByIndex[groupIndex - 1] || "Unknown";
 };
 exports.getBorrowingGroupName = getBorrowingGroupName;
-const fetchAllPairBorrowingFees = (contract, collateralIndex) => __awaiter(void 0, void 0, void 0, function* () {
-    const [pairs, pairOi, pairGroups] = yield contract.getAllBorrowingPairs(collateralIndex);
-    const feeCaps = yield contract.getBorrowingPairFeePerBlockCaps(collateralIndex, [...Array(pairs.length).keys()]);
+const fetchAllPairBorrowingFees = async (contract, collateralIndex) => {
+    const [pairs, pairOi, pairGroups] = await contract.getAllBorrowingPairs(collateralIndex);
+    const feeCaps = await contract.getBorrowingPairFeePerBlockCaps(collateralIndex, [...Array(pairs.length).keys()]);
     return (0, trade_1.convertPairBorrowingFees)([pairs, pairOi, pairGroups, feeCaps]);
-});
+};
 exports.fetchAllPairBorrowingFees = fetchAllPairBorrowingFees;
-const fetchGroupBorrowingFees = (contract, collateralIndex, groupIxs) => __awaiter(void 0, void 0, void 0, function* () {
-    return (0, trade_1.convertGroupBorrowingFees)(yield contract.getBorrowingGroups(collateralIndex, groupIxs));
-});
+const fetchGroupBorrowingFees = async (contract, collateralIndex, groupIxs) => (0, trade_1.convertGroupBorrowingFees)(await contract.getBorrowingGroups(collateralIndex, groupIxs));
 exports.fetchGroupBorrowingFees = fetchGroupBorrowingFees;
-const fetchAllPairAndGroupBorrowingFees = (contract, collateralIndex) => __awaiter(void 0, void 0, void 0, function* () {
-    const pairs = yield (0, exports.fetchAllPairBorrowingFees)(contract, collateralIndex);
+const fetchAllPairAndGroupBorrowingFees = async (contract, collateralIndex) => {
+    const pairs = await (0, exports.fetchAllPairBorrowingFees)(contract, collateralIndex);
     const groupIxs = [
         ...new Set(pairs
             .map(value => value.groups.map(value => value.groupIndex))
             .reduce((acc, value) => acc.concat(value), [])),
     ].sort((a, b) => a - b);
-    const groups = yield (0, exports.fetchGroupBorrowingFees)(contract, collateralIndex, groupIxs);
+    const groups = await (0, exports.fetchGroupBorrowingFees)(contract, collateralIndex, groupIxs);
     return { pairs, groups };
-});
+};
 exports.fetchAllPairAndGroupBorrowingFees = fetchAllPairAndGroupBorrowingFees;

package/lib/contracts/utils/openTrades.js

@@ -1,20 +1,11 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchOpenPairTradesRaw = exports.fetchOpenPairTrades = void 0;
 const ethcall_1 = require("ethcall");
 const trade_1 = require("../../trade");
-const fetchOpenPairTrades = (contracts, overrides = {}) => __awaiter(void 0, void 0, void 0, function* () {
-    const rawTrades = yield (0, exports.fetchOpenPairTradesRaw)(contracts, overrides);
-    const collaterals = yield contracts.gnsMultiCollatDiamond.getCollaterals();
+const fetchOpenPairTrades = async (contracts, overrides = {}) => {
+    const rawTrades = await (0, exports.fetchOpenPairTradesRaw)(contracts, overrides);
+    const collaterals = await contracts.gnsMultiCollatDiamond.getCollaterals();
     const collateralConfigs = collaterals.map(c => ({
         collateral: c.collateral,
         isActive: c.isActive,
@@ -22,10 +13,10 @@ const fetchOpenPairTrades = (contracts, overrides = {}) => __awaiter(void 0, voi
         precisionDelta: parseFloat(c.precisionDelta.toString()),
     }));
     return rawTrades.map(rawTrade => _prepareTradeContainer(rawTrade.trade, rawTrade.tradeInfo, rawTrade.liquidationParams, rawTrade.initialAccFees, rawTrade.tradeFeesData, rawTrade.uiRealizedPnlData, collateralConfigs[parseInt(rawTrade.trade.collateralIndex.toString()) - 1]));
-});
+};
 exports.fetchOpenPairTrades = fetchOpenPairTrades;
 // @todo rename
-const fetchOpenPairTradesRaw = (contracts, overrides = {}) => __awaiter(void 0, void 0, void 0, function* () {
+const fetchOpenPairTradesRaw = async (contracts, overrides = {}) => {
     if (!contracts) {
         return [];
     }
@@ -39,13 +30,13 @@ const fetchOpenPairTradesRaw = (contracts, overrides = {}) => __awaiter(void 0,
             ]),
         };
         if (useMulticall) {
-            yield multicallCtx.provider.init(multiCollatDiamondContract.provider);
+            await multicallCtx.provider.init(multiCollatDiamondContract.provider);
         }
         let allOpenPairTrades = [];
         let running = true;
         let offset = 0;
         while (running) {
-            const [trades, tradeInfos, tradeLiquidationParams] = yield Promise.all([
+            const [trades, tradeInfos, tradeLiquidationParams] = await Promise.all([
                 multiCollatDiamondContract.getAllTrades(offset, offset + batchSize),
                 multiCollatDiamondContract.getAllTradeInfos(offset, offset + batchSize),
                 multiCollatDiamondContract.getAllTradesLiquidationParams(offset, offset + batchSize),
@@ -85,7 +76,7 @@ const fetchOpenPairTradesRaw = (contracts, overrides = {}) => __awaiter(void 0,
                     uiRealizedPnlData: undefined,
                 };
             });
-            const [tradeFeesData, uiRealizedPnlData] = yield Promise.all([
+            const [tradeFeesData, uiRealizedPnlData] = await Promise.all([
                 multiCollatDiamondContract.getTradeFeesDataArray(...fundingFeesCallParams),
                 includeUIRealizedPnlData
                     ? multiCollatDiamondContract.getTradeUiRealizedPnlDataArray(...fundingFeesCallParams)
@@ -100,13 +91,13 @@ const fetchOpenPairTradesRaw = (contracts, overrides = {}) => __awaiter(void 0,
                 .map(({ collateralIndex, user, index }) => (useMulticall
                 ? multicallCtx.diamond
                 : multiCollatDiamondContract).getBorrowingInitialAccFees(collateralIndex, user, index));
-            const initialAccFees = yield (useMulticall
+            const initialAccFees = await (useMulticall
                 ? multicallCtx.provider.all(initialAccFeesPromises)
                 : Promise.all(initialAccFeesPromises));
             initialAccFees.forEach((accFees, ix) => {
                 openTrades[ix].initialAccFees = accFees;
                 openTrades[ix].tradeFeesData = tradeFeesData[ix];
-                openTrades[ix].uiRealizedPnlData = uiRealizedPnlData === null || uiRealizedPnlData === void 0 ? void 0 : uiRealizedPnlData[ix];
+                openTrades[ix].uiRealizedPnlData = uiRealizedPnlData?.[ix];
             });
             allOpenPairTrades = allOpenPairTrades.concat(openTrades);
             offset += batchSize + 1;
@@ -119,7 +110,7 @@ const fetchOpenPairTradesRaw = (contracts, overrides = {}) => __awaiter(void 0,
         console.error(`Unexpected error while fetching open pair trades!`);
         throw error;
     }
-});
+};
 exports.fetchOpenPairTradesRaw = fetchOpenPairTradesRaw;
 const _prepareTradeContainer = (trade, tradeInfo, tradeLiquidationParams, tradeInitialAccFees, tradeFeesData, uiRealizedPnlData, collateralConfig) => {
     const precision = collateralConfig.precision;

package/lib/contracts/utils/pairs.js

@@ -1,26 +1,17 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPairDescription = exports.fetchOpenInterest = exports.fetchFees = exports.fetchPairDepths = exports.fetchPairs = void 0;
 /* eslint-disable @typescript-eslint/no-unsafe-call */
 /* eslint-disable @typescript-eslint/no-unsafe-return */
 /* eslint-disable @typescript-eslint/no-unsafe-member-access */
 const types_1 = require("../../trade/types");
-const fetchPairs = (contracts, pairIxs) => __awaiter(void 0, void 0, void 0, function* () {
+const fetchPairs = async (contracts, pairIxs) => {
     if (!contracts) {
         return [];
     }
     const { gnsMultiCollatDiamond: multiCollatContract } = contracts;
     try {
-        const pairs = yield Promise.all(pairIxs.map(pairIndex => multiCollatContract.pairs(pairIndex)));
+        const pairs = await Promise.all(pairIxs.map(pairIndex => multiCollatContract.pairs(pairIndex)));
         return pairs.map((pair, index) => {
             return {
                 name: pair.from + "/" + pair.to,
@@ -38,15 +29,15 @@ const fetchPairs = (contracts, pairIxs) => __awaiter(void 0, void 0, void 0, fun
         console.error(`Unexpected error while fetching pairs!`);
         throw error;
     }
-});
+};
 exports.fetchPairs = fetchPairs;
-const fetchPairDepths = (contracts, pairIxs) => __awaiter(void 0, void 0, void 0, function* () {
+const fetchPairDepths = async (contracts, pairIxs) => {
     if (!contracts) {
         return [];
     }
     const { gnsMultiCollatDiamond: multiCollatContract } = contracts;
     try {
-        const pairParams = yield multiCollatContract.getPairDepths(pairIxs);
+        const pairParams = await multiCollatContract.getPairDepths(pairIxs);
         return pairParams.map(pair => {
             return {
                 onePercentDepthAboveUsd: parseFloat(pair.onePercentDepthAboveUsd.toString()),
@@ -58,15 +49,15 @@ const fetchPairDepths = (contracts, pairIxs) => __awaiter(void 0, void 0, void 0
         console.error(`Unexpected error while fetching pairs!`);
         throw error;
     }
-});
+};
 exports.fetchPairDepths = fetchPairDepths;
-const fetchFees = (contracts, feeIxs) => __awaiter(void 0, void 0, void 0, function* () {
+const fetchFees = async (contracts, feeIxs) => {
     if (!contracts) {
         return [];
     }
     const { gnsMultiCollatDiamond: multiCollatContract } = contracts;
     try {
-        const fees = yield Promise.all(feeIxs.map(pairIndex => multiCollatContract.fees(pairIndex)));
+        const fees = await Promise.all(feeIxs.map(pairIndex => multiCollatContract.fees(pairIndex)));
         return fees.map(fee => {
             return {
                 totalPositionSizeFeeP: parseFloat(fee.totalPositionSizeFeeP.toString()) / 1e12,
@@ -80,13 +71,13 @@ const fetchFees = (contracts, feeIxs) => __awaiter(void 0, void 0, void 0, funct
         console.error(`Unexpected error while fetching pairs!`);
         throw error;
     }
-});
+};
 exports.fetchFees = fetchFees;
-const fetchOpenInterest = (contracts, collateralIndex, pairIxs) => __awaiter(void 0, void 0, void 0, function* () {
+const fetchOpenInterest = async (contracts, collateralIndex, pairIxs) => {
     if (pairIxs.length === 0) {
         return [];
     }
-    const openInterests = (yield contracts.gnsMultiCollatDiamond.getAllBorrowingPairs(collateralIndex))[1];
+    const openInterests = (await contracts.gnsMultiCollatDiamond.getAllBorrowingPairs(collateralIndex))[1];
     return pairIxs.map(pairIndex => {
         const openInterest = openInterests[pairIndex];
         if (!openInterest) {
@@ -98,7 +89,7 @@ const fetchOpenInterest = (contracts, collateralIndex, pairIxs) => __awaiter(voi
             max: parseFloat(openInterest[2].toString()) / 1e10,
         };
     });
-});
+};
 exports.fetchOpenInterest = fetchOpenInterest;
 const getPairDescription = (pairIndex) => {
     return PAIR_INDEX_TO_DESCRIPTION[pairIndex] || "";

package/lib/markets/forex.js

@@ -33,7 +33,7 @@ const isForexLowLiquidity = (timestampToCheck, pair) => {
     const hour = now.hour;
     const minute = now.minute;
     const isInDST = now.isInDST;
-    const groupIndex = pair === null || pair === void 0 ? void 0 : pair.groupIndex;
+    const groupIndex = pair?.groupIndex;
     if (groupIndex && extendedLowLiqGroupIds.includes(+groupIndex)) {
         return ((isInDST &&
             ((hour == 14 && minute >= 45) || (hour >= 15 && hour < 21))) ||

package/lib/markets/leverage/builder.js

@@ -18,8 +18,8 @@ const buildMarketLeverageRestrictionsContext = (globalTradingVariables, pairInde
     return {
         groupMinLeverage: group.minLeverage,
         groupMaxLeverage: group.maxLeverage,
-        pairMaxLeverage: pairMaxLeverages === null || pairMaxLeverages === void 0 ? void 0 : pairMaxLeverages[pairIndex],
-        counterTradeSettings: counterTradeSettings === null || counterTradeSettings === void 0 ? void 0 : counterTradeSettings[pairIndex],
+        pairMaxLeverage: pairMaxLeverages?.[pairIndex],
+        counterTradeSettings: counterTradeSettings?.[pairIndex],
     };
 };
 exports.buildMarketLeverageRestrictionsContext = buildMarketLeverageRestrictionsContext;

package/lib/markets/oi/fetcher.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @dev Fetchers for retrieving OI data from contracts
+ * @dev Consolidates the three OI storage systems into unified format
+ */
+import { ethers } from "ethers";
+import { ChainId } from "../../contracts/types";
+import { UnifiedPairOi } from "./types";
+/**
+ * @dev Fetches all OI data for a single pair
+ * @param chainId Target chain
+ * @param collateralIndex Collateral type
+ * @param pairIndex Trading pair
+ * @param signer Ethers signer
+ * @returns Unified PairOi structure with all OI data
+ */
+export declare function fetchPairOi(chainId: ChainId, collateralIndex: number, pairIndex: number, signer: ethers.Signer): Promise<UnifiedPairOi>;
+/**
+ * @dev Fetches OI data for multiple pairs efficiently
+ * @param chainId Target chain
+ * @param collateralIndex Collateral type
+ * @param pairIndices Array of trading pairs
+ * @param signer Ethers signer
+ * @returns Array of unified PairOi structures
+ */
+export declare function fetchMultiplePairOi(chainId: ChainId, collateralIndex: number, pairIndices: number[], signer: ethers.Signer): Promise<UnifiedPairOi[]>;
+/**
+ * @dev Creates OI context for fee calculations
+ * @param chainId Target chain
+ * @param collateralIndex Collateral type
+ * @param pairIndex Trading pair
+ * @param signer Ethers signer
+ * @returns OI data formatted for SDK calculations
+ */
+export declare function createOiContext(chainId: ChainId, collateralIndex: number, pairIndex: number, signer: ethers.Signer): Promise<{
+    pairOi: UnifiedPairOi;
+    currentPrice: number;
+    computed: {
+        totalDynamicOi: {
+            long: number;
+            short: number;
+        };
+        totalStaticOi: {
+            long: number;
+            short: number;
+        };
+        skew: number;
+    };
+}>;
+/**
+ * @dev Fetches only the OI data needed for specific use cases
+ * @param chainId Target chain
+ * @param collateralIndex Collateral type
+ * @param pairIndex Trading pair
+ * @param useCase Which OI systems to fetch
+ * @param signer Ethers signer
+ * @returns Partial OI data based on use case
+ */
+export declare function fetchOiForUseCase(chainId: ChainId, collateralIndex: number, pairIndex: number, useCase: "skew" | "funding" | "borrowingV1" | "limits", signer: ethers.Signer): Promise<Partial<UnifiedPairOi>>;

package/lib/markets/oi/fetcher.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * @dev Fetchers for retrieving OI data from contracts
+ * @dev Consolidates the three OI storage systems into unified format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchOiForUseCase = exports.createOiContext = exports.fetchMultiplePairOi = exports.fetchPairOi = void 0;
+const ethers_1 = require("ethers");
+const contracts_1 = require("../../contracts");
+const generated_1 = require("../../contracts/types/generated");
+const converter_1 = require("./converter");
+/**
+ * @dev Fetches all OI data for a single pair
+ * @param chainId Target chain
+ * @param collateralIndex Collateral type
+ * @param pairIndex Trading pair
+ * @param signer Ethers signer
+ * @returns Unified PairOi structure with all OI data
+ */
+function fetchPairOi(chainId, collateralIndex, pairIndex, signer) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const addresses = (0, contracts_1.getContractAddressesForChain)(chainId);
+        const diamond = generated_1.GNSMultiCollatDiamond__factory.connect(addresses.gnsMultiCollatDiamond, signer);
+        // Fetch all three OI types in parallel
+        const [beforeV10Raw, afterV10Collateral, afterV10Token, maxOi, collateral] = yield Promise.all([
+            diamond.getPairOisBeforeV10Collateral(collateralIndex, pairIndex),
+            diamond.getPairOiAfterV10Collateral(collateralIndex, pairIndex),
+            diamond.getPairOiAfterV10Token(collateralIndex, pairIndex),
+            diamond.getPairMaxOi(collateralIndex, pairIndex),
+            diamond.getCollateral(collateralIndex),
+        ]);
+        // Convert the beforeV10 format to match expected structure
+        const beforeV10 = {
+            long: beforeV10Raw.longOi,
+            short: beforeV10Raw.shortOi,
+            max: maxOi,
+            __placeholder: ethers_1.ethers.BigNumber.from(0),
+        };
+        return (0, converter_1.convertPairOi)(beforeV10, afterV10Collateral, afterV10Token, Number(collateral.precision));
+    });
+}
+exports.fetchPairOi = fetchPairOi;
+/**
+ * @dev Fetches OI data for multiple pairs efficiently
+ * @param chainId Target chain
+ * @param collateralIndex Collateral type
+ * @param pairIndices Array of trading pairs
+ * @param signer Ethers signer
+ * @returns Array of unified PairOi structures
+ */
+function fetchMultiplePairOi(chainId, collateralIndex, pairIndices, signer) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const addresses = (0, contracts_1.getContractAddressesForChain)(chainId);
+        const diamond = generated_1.GNSMultiCollatDiamond__factory.connect(addresses.gnsMultiCollatDiamond, signer);
+        // Get collateral precision once
+        const collateral = yield diamond.getCollateral(collateralIndex);
+        const precision = Number(collateral.precision);
+        // Batch fetch all OI data
+        const promises = pairIndices.map((pairIndex) => __awaiter(this, void 0, void 0, function* () {
+            const [beforeV10Raw, afterV10Collateral, afterV10Token, maxOi] = yield Promise.all([
+                diamond.getPairOisBeforeV10Collateral(collateralIndex, pairIndex),
+                diamond.getPairOiAfterV10Collateral(collateralIndex, pairIndex),
+                diamond.getPairOiAfterV10Token(collateralIndex, pairIndex),
+                diamond.getPairMaxOi(collateralIndex, pairIndex),
+            ]);
+            // Convert the beforeV10 format to match expected structure
+            const beforeV10 = {
+                long: beforeV10Raw.longOi,
+                short: beforeV10Raw.shortOi,
+                max: maxOi,
+                __placeholder: ethers_1.ethers.BigNumber.from(0),
+            };
+            return {
+                beforeV10: beforeV10,
+                collateral: afterV10Collateral,
+                token: afterV10Token,
+            };
+        }));
+        const results = yield Promise.all(promises);
+        return (0, converter_1.convertPairOiArray)(results, precision);
+    });
+}
+exports.fetchMultiplePairOi = fetchMultiplePairOi;
+/**
+ * @dev Creates OI context for fee calculations
+ * @param chainId Target chain
+ * @param collateralIndex Collateral type
+ * @param pairIndex Trading pair
+ * @param signer Ethers signer
+ * @returns OI data formatted for SDK calculations
+ */
+function createOiContext(chainId, collateralIndex, pairIndex, signer) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // Fetch OI data
+        const pairOi = yield fetchPairOi(chainId, collateralIndex, pairIndex, signer);
+        // For now, use a placeholder price - in real usage, this would come from price feeds
+        // The actual price should be fetched from the price aggregator or oracle
+        const currentPrice = 1; // Placeholder - replace with actual price fetching
+        // Compute derived values
+        const totalDynamicOi = {
+            long: pairOi.beforeV10Collateral.long + pairOi.token.long * currentPrice,
+            short: pairOi.beforeV10Collateral.short + pairOi.token.short * currentPrice,
+        };
+        const totalStaticOi = {
+            long: pairOi.beforeV10Collateral.long + pairOi.collateral.long,
+            short: pairOi.beforeV10Collateral.short + pairOi.collateral.short,
+        };
+        const skew = pairOi.token.long - pairOi.token.short;
+        return {
+            pairOi,
+            currentPrice,
+            computed: {
+                totalDynamicOi,
+                totalStaticOi,
+                skew,
+            },
+        };
+    });
+}
+exports.createOiContext = createOiContext;
+/**
+ * @dev Fetches only the OI data needed for specific use cases
+ * @param chainId Target chain
+ * @param collateralIndex Collateral type
+ * @param pairIndex Trading pair
+ * @param useCase Which OI systems to fetch
+ * @param signer Ethers signer
+ * @returns Partial OI data based on use case
+ */
+function fetchOiForUseCase(chainId, collateralIndex, pairIndex, useCase, signer) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const addresses = (0, contracts_1.getContractAddressesForChain)(chainId);
+        const diamond = generated_1.GNSMultiCollatDiamond__factory.connect(addresses.gnsMultiCollatDiamond, signer);
+        switch (useCase) {
+            case "skew":
+            case "funding": {
+                // Only need token OI
+                const tokenOi = yield diamond.getPairOiAfterV10Token(collateralIndex, pairIndex);
+                return {
+                    token: (0, converter_1.convertTokenOi)(tokenOi),
+                };
+            }
+            case "borrowingV1": {
+                // Need beforeV10 and token (for dynamic calculation)
+                const [beforeV10Raw, tokenOi, collateral, maxOi] = yield Promise.all([
+                    diamond.getPairOisBeforeV10Collateral(collateralIndex, pairIndex),
+                    diamond.getPairOiAfterV10Token(collateralIndex, pairIndex),
+                    diamond.getCollateral(collateralIndex),
+                    diamond.getPairMaxOi(collateralIndex, pairIndex),
+                ]);
+                // Convert the beforeV10 format to match expected structure
+                const beforeV10 = {
+                    long: beforeV10Raw.longOi,
+                    short: beforeV10Raw.shortOi,
+                    max: maxOi,
+                    __placeholder: ethers_1.ethers.BigNumber.from(0),
+                };
+                return {
+                    beforeV10Collateral: (0, converter_1.convertBeforeV10Collateral)(beforeV10, Number(collateral.precision)),
+                    token: (0, converter_1.convertTokenOi)(tokenOi),
+                };
+            }
+            case "limits": {
+                // Need all OI for limit checks
+                return fetchPairOi(chainId, collateralIndex, pairIndex, signer);
+            }
+            default:
+                throw new Error(`Unknown use case: ${String(useCase)}`);
+        }
+    });
+}
+exports.fetchOiForUseCase = fetchOiForUseCase;

package/lib/markets/oi/validation.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @dev OI Validation module
+ * @dev Provides validation functions for Open Interest limits
+ */
+import { UnifiedPairOi } from "./types";
+import * as BorrowingFee from "../../trade/fees/borrowing/types";
+import { PairIndex } from "../../trade/types";
+/**
+ * @dev Check if a position would exceed per-pair OI limits
+ * @param pairOi Current OI data for the pair
+ * @param long Whether the position is long
+ * @param positionSizeCollateral Position size in collateral
+ * @param currentPrice Current collateral price in USD (required for dynamic OI)
+ * @returns true if within limits, false if would exceed
+ */
+export declare const withinMaxPairOi: (pairOi: UnifiedPairOi, long: boolean, positionSizeCollateral: number, currentPrice: number) => boolean;
+/**
+ * @dev Calculate dynamic OI for a specific side
+ * @param pairOi OI data for the pair
+ * @param currentPrice Current collateral price in USD
+ * @param long Whether to calculate for long side
+ * @returns Dynamic OI in collateral value
+ */
+export declare const calculateDynamicOi: (pairOi: UnifiedPairOi, currentPrice: number, long: boolean) => number;
+/**
+ * @dev Calculate remaining OI capacity for a side
+ * @param pairOi OI data for the pair
+ * @param currentPrice Current collateral price in USD
+ * @param long Whether to calculate for long side
+ * @returns Remaining capacity in collateral (0 if unlimited)
+ */
+export declare const getRemainingOiCapacity: (pairOi: UnifiedPairOi, currentPrice: number, long: boolean) => number;
+/**
+ * @dev Updated group OI validation using dynamic OI
+ * @param pairIndex Index of the trading pair
+ * @param long Whether the position is long
+ * @param positionSizeCollateral Position size in collateral
+ * @param currentPrice Current collateral price in USD
+ * @param context Context with groups, pairs, and OI data
+ * @returns true if within group limits, false if would exceed
+ */
+export declare const withinMaxGroupOiDynamic: (pairIndex: PairIndex, long: boolean, positionSizeCollateral: number, currentPrice: number, context: {
+    groups: BorrowingFee.Group[];
+    pairs: BorrowingFee.Pair[];
+    pairOis: UnifiedPairOi[];
+}) => boolean;
+/**
+ * @dev Calculate total dynamic OI for a group
+ * @param groupIndex Index of the group
+ * @param currentPrice Current collateral price in USD
+ * @param context Context with pairs and OI data
+ * @returns Total dynamic OI for the group
+ */
+export declare const getGroupDynamicOi: (groupIndex: number, currentPrice: number, context: {
+    pairs: BorrowingFee.Pair[];
+    pairOis: UnifiedPairOi[];
+}) => {
+    long: number;
+    short: number;
+    total: number;
+};
+/**
+ * @dev Check both pair and group OI limits
+ * @param pairIndex Index of the trading pair
+ * @param long Whether the position is long
+ * @param positionSizeCollateral Position size in collateral
+ * @param currentPrice Current collateral price in USD
+ * @param context Full context with all required data
+ * @returns Object with validation results
+ */
+export declare const validateOiLimits: (pairIndex: PairIndex, long: boolean, positionSizeCollateral: number, currentPrice: number, context: {
+    groups: BorrowingFee.Group[];
+    pairs: BorrowingFee.Pair[];
+    pairOis: UnifiedPairOi[];
+}) => {
+    withinPairLimit: boolean;
+    withinGroupLimit: boolean;
+    pairRemainingCapacity: number;
+    groupRemainingCapacity: number;
+};