@gainsnetwork/sdk 0.0.0-me-rc1

package/lib/trade/priceImpact/open/types.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * @dev Types for trade opening price impact calculations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/trade/priceImpact/skew/builder.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @dev Builders for skew price impact contexts
+ */
+import { TradingVariablesCollateral } from "../../../backend/tradingVariables/types";
+import { SkewPriceImpactContext } from "./types";
+/**
+ * @dev Builds skew price impact context from trading variables for a specific pair
+ * @param tradingVariables Trading variables containing collateral data
+ * @param pairIndex Index of the pair to build context for
+ * @returns Skew price impact context for the pair
+ */
+export declare const buildSkewPriceImpactContext: (tradingVariables: TradingVariablesCollateral, pairIndex: number) => SkewPriceImpactContext;

package/lib/trade/priceImpact/skew/builder.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * @dev Builders for skew price impact contexts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSkewPriceImpactContext = void 0;
+/**
+ * @dev Builds skew price impact context from trading variables for a specific pair
+ * @param tradingVariables Trading variables containing collateral data
+ * @param pairIndex Index of the pair to build context for
+ * @returns Skew price impact context for the pair
+ */
+const buildSkewPriceImpactContext = (tradingVariables, pairIndex) => {
+    const skewDepth = tradingVariables.pairSkewDepths?.[pairIndex] ?? 0;
+    const pairOi = tradingVariables.pairOis?.[pairIndex];
+    if (!pairOi) {
+        throw new Error(`Pair OI data not found for pair index ${pairIndex}`);
+    }
+    return {
+        skewDepth,
+        pairOiToken: {
+            oiLongToken: pairOi.token.long,
+            oiShortToken: pairOi.token.short,
+        },
+    };
+};
+exports.buildSkewPriceImpactContext = buildSkewPriceImpactContext;

package/lib/trade/priceImpact/skew/converter.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @dev Converters for skew price impact data between contract and SDK formats
+ * @dev All BigNumber values are normalized to floats with appropriate precision
+ */
+import { IPriceImpact } from "../../../contracts/types/generated/GNSMultiCollatDiamond";
+import { PairOiToken, PairOiCollateral } from "./types";
+/**
+ * @dev Converts contract pair OI token data to SDK format
+ * @param contractData Contract pair OI token struct
+ * @returns Normalized pair OI token data
+ */
+export declare const convertPairOiToken: (contractData: IPriceImpact.PairOiTokenStruct) => PairOiToken;
+/**
+ * @dev Converts array of contract pair OI token data to SDK format
+ * @param contractDataArray Array of contract pair OI token data
+ * @returns Array of normalized pair OI token data
+ */
+export declare const convertPairOiTokenArray: (contractDataArray: IPriceImpact.PairOiTokenStruct[]) => PairOiToken[];
+/**
+ * @dev Converts contract pair OI collateral data to SDK format
+ * @param contractData Contract pair OI collateral struct
+ * @param collateralDecimals Number of decimals for the collateral (e.g., 18 for DAI, 6 for USDC)
+ * @returns Normalized pair OI collateral data
+ */
+export declare const convertPairOiCollateral: (contractData: IPriceImpact.PairOiCollateralStruct, collateralDecimals: number) => PairOiCollateral;
+/**
+ * @dev Converts array of contract pair OI collateral data to SDK format
+ * @param contractDataArray Array of contract pair OI collateral data
+ * @param collateralDecimals Array of collateral decimals for each entry
+ * @returns Array of normalized pair OI collateral data
+ */
+export declare const convertPairOiCollateralArray: (contractDataArray: IPriceImpact.PairOiCollateralStruct[], collateralDecimals: number[]) => PairOiCollateral[];
+/**
+ * @dev Converts skew depth from contract format to SDK format
+ * @param depth Skew depth from contract (in token units with 1e18 precision)
+ * @returns Normalized skew depth in tokens
+ */
+export declare const convertSkewDepth: (depth: string) => number;
+/**
+ * @dev Converts array of skew depths from contract format to SDK format
+ * @param depths Array of skew depths from contract (in token units with 1e18 precision)
+ * @returns Object mapping pair index to normalized depth
+ */
+export declare const convertPairSkewDepths: (depths: string[]) => {
+    [pairIndex: number]: number;
+};

package/lib/trade/priceImpact/skew/converter.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * @dev Converters for skew price impact data between contract and SDK formats
+ * @dev All BigNumber values are normalized to floats with appropriate precision
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertPairSkewDepths = exports.convertSkewDepth = exports.convertPairOiCollateralArray = exports.convertPairOiCollateral = exports.convertPairOiTokenArray = exports.convertPairOiToken = void 0;
+/**
+ * @dev Converts contract pair OI token data to SDK format
+ * @param contractData Contract pair OI token struct
+ * @returns Normalized pair OI token data
+ */
+const convertPairOiToken = (contractData) => {
+    // Token amounts are stored as 1e18 in contract
+    return {
+        oiLongToken: Number(contractData.oiLongToken) / 1e18,
+        oiShortToken: Number(contractData.oiShortToken) / 1e18,
+    };
+};
+exports.convertPairOiToken = convertPairOiToken;
+/**
+ * @dev Converts array of contract pair OI token data to SDK format
+ * @param contractDataArray Array of contract pair OI token data
+ * @returns Array of normalized pair OI token data
+ */
+const convertPairOiTokenArray = (contractDataArray) => {
+    return contractDataArray.map(exports.convertPairOiToken);
+};
+exports.convertPairOiTokenArray = convertPairOiTokenArray;
+/**
+ * @dev Converts contract pair OI collateral data to SDK format
+ * @param contractData Contract pair OI collateral struct
+ * @param collateralDecimals Number of decimals for the collateral (e.g., 18 for DAI, 6 for USDC)
+ * @returns Normalized pair OI collateral data
+ */
+const convertPairOiCollateral = (contractData, collateralDecimals) => {
+    const divisor = 10 ** collateralDecimals;
+    return {
+        oiLongCollateral: Number(contractData.oiLongCollateral) / divisor,
+        oiShortCollateral: Number(contractData.oiShortCollateral) / divisor,
+    };
+};
+exports.convertPairOiCollateral = convertPairOiCollateral;
+/**
+ * @dev Converts array of contract pair OI collateral data to SDK format
+ * @param contractDataArray Array of contract pair OI collateral data
+ * @param collateralDecimals Array of collateral decimals for each entry
+ * @returns Array of normalized pair OI collateral data
+ */
+const convertPairOiCollateralArray = (contractDataArray, collateralDecimals) => {
+    if (contractDataArray.length !== collateralDecimals.length) {
+        throw new Error("Contract data array and collateral decimals array must have the same length");
+    }
+    return contractDataArray.map((data, index) => (0, exports.convertPairOiCollateral)(data, collateralDecimals[index]));
+};
+exports.convertPairOiCollateralArray = convertPairOiCollateralArray;
+/**
+ * @dev Converts skew depth from contract format to SDK format
+ * @param depth Skew depth from contract (in token units with 1e18 precision)
+ * @returns Normalized skew depth in tokens
+ */
+const convertSkewDepth = (depth) => {
+    // Token depths are always stored with 1e18 precision in the contract
+    return Number(depth) / 1e18;
+};
+exports.convertSkewDepth = convertSkewDepth;
+/**
+ * @dev Converts array of skew depths from contract format to SDK format
+ * @param depths Array of skew depths from contract (in token units with 1e18 precision)
+ * @returns Object mapping pair index to normalized depth
+ */
+const convertPairSkewDepths = (depths) => {
+    const result = {};
+    depths.forEach((depth, index) => {
+        if (depth && depth !== "0") {
+            result[index] = (0, exports.convertSkewDepth)(depth);
+        }
+    });
+    return result;
+};
+exports.convertPairSkewDepths = convertPairSkewDepths;

package/lib/trade/priceImpact/skew/fetcher.d.ts

@@ -0,0 +1,60 @@
+import type { GNSMultiCollatDiamond } from "../../../contracts/types/generated";
+import type { PairOiToken, SkewPriceImpactContext } from "./types";
+/**
+ * @dev Fetches pair open interest in tokens for a specific pair
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndex Collateral index
+ * @param pairIndex Pair index
+ * @returns Promise resolving to pair OI in tokens
+ */
+export declare const fetchPairOiAfterV10Token: (contract: GNSMultiCollatDiamond, collateralIndex: number, pairIndex: number) => Promise<PairOiToken>;
+/**
+ * @dev Fetches pair open interest in tokens for multiple 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 OI in tokens
+ */
+export declare const fetchPairOisAfterV10Token: (contract: GNSMultiCollatDiamond, collateralIndices: number[], pairIndices: number[]) => Promise<PairOiToken[]>;
+/**
+ * @dev Fetches skew depth for a specific pair
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndex Collateral index
+ * @param pairIndex Pair index
+ * @returns Promise resolving to normalized skew depth
+ */
+export declare const fetchPairSkewDepth: (contract: GNSMultiCollatDiamond, collateralIndex: number, pairIndex: number) => Promise<number>;
+/**
+ * @dev Fetches skew depths for multiple pairs
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndices Array of collateral indices
+ * @param pairIndices Array of pair indices
+ * @returns Promise resolving to array of normalized skew depths
+ */
+export declare const fetchPairSkewDepths: (contract: GNSMultiCollatDiamond, collateralIndices: number[], pairIndices: number[]) => Promise<number[]>;
+/**
+ * @dev Fetches skew price impact context for a single pair
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndex Collateral index
+ * @param pairIndex Pair index
+ * @returns Promise resolving to skew price impact context
+ */
+export declare const fetchSkewPriceImpactContext: (contract: GNSMultiCollatDiamond, collateralIndex: number, pairIndex: number) => Promise<SkewPriceImpactContext>;
+/**
+ * @dev Fetches collateral decimals for given collateral indices
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndices Array of collateral indices
+ * @returns Promise resolving to array of decimals
+ */
+export declare const fetchCollateralDecimals: (contract: GNSMultiCollatDiamond, collateralIndices: number[]) => Promise<number[]>;
+/**
+ * @dev Calculates skew price impact for a trade using contract call
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndex Collateral index
+ * @param pairIndex Pair index
+ * @param long Whether trade is long
+ * @param positionSizeToken Position size in tokens
+ * @param open Whether trade is opening
+ * @returns Promise resolving to price impact percentage (1e10)
+ */
+export declare const calculateTradeSkewPriceImpact: (contract: GNSMultiCollatDiamond, collateralIndex: number, pairIndex: number, long: boolean, positionSizeToken: number, open: boolean) => Promise<number>;

package/lib/trade/priceImpact/skew/fetcher.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateTradeSkewPriceImpact = exports.fetchCollateralDecimals = exports.fetchSkewPriceImpactContext = exports.fetchPairSkewDepths = exports.fetchPairSkewDepth = exports.fetchPairOisAfterV10Token = exports.fetchPairOiAfterV10Token = void 0;
+const converter_1 = require("./converter");
+/**
+ * @dev Fetches pair open interest in tokens for a specific pair
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndex Collateral index
+ * @param pairIndex Pair index
+ * @returns Promise resolving to pair OI in tokens
+ */
+const fetchPairOiAfterV10Token = async (contract, collateralIndex, pairIndex) => {
+    try {
+        const contractData = await contract.getPairOiAfterV10Token(collateralIndex, pairIndex);
+        return (0, converter_1.convertPairOiToken)(contractData);
+    }
+    catch (error) {
+        console.error("Error fetching pair OI token:", error);
+        throw error;
+    }
+};
+exports.fetchPairOiAfterV10Token = fetchPairOiAfterV10Token;
+/**
+ * @dev Fetches pair open interest in tokens for multiple 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 OI in tokens
+ */
+const fetchPairOisAfterV10Token = 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 contractDataArray = await contract.getPairOisAfterV10Token(collateralIndices, pairIndices);
+        return contractDataArray.map(converter_1.convertPairOiToken);
+    }
+    catch (error) {
+        console.error("Error fetching pair OIs token:", error);
+        throw error;
+    }
+};
+exports.fetchPairOisAfterV10Token = fetchPairOisAfterV10Token;
+/**
+ * @dev Fetches skew depth for a specific pair
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndex Collateral index
+ * @param pairIndex Pair index
+ * @returns Promise resolving to normalized skew depth
+ */
+const fetchPairSkewDepth = async (contract, collateralIndex, pairIndex) => {
+    try {
+        const contractDepth = await contract.getPairSkewDepth(collateralIndex, pairIndex);
+        // Token depths are always 1e18 precision
+        return (0, converter_1.convertSkewDepth)(contractDepth.toString());
+    }
+    catch (error) {
+        console.error("Error fetching skew depth:", error);
+        throw error;
+    }
+};
+exports.fetchPairSkewDepth = fetchPairSkewDepth;
+/**
+ * @dev Fetches skew depths for multiple pairs
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndices Array of collateral indices
+ * @param pairIndices Array of pair indices
+ * @returns Promise resolving to array of normalized skew depths
+ */
+const fetchPairSkewDepths = async (contract, collateralIndices, pairIndices) => {
+    if (collateralIndices.length !== pairIndices.length) {
+        throw new Error("All input arrays must have the same length");
+    }
+    try {
+        const contractDepths = await contract.getPairSkewDepths(collateralIndices, pairIndices);
+        // Token depths are always 1e18 precision
+        return contractDepths.map(depth => (0, converter_1.convertSkewDepth)(depth.toString()));
+    }
+    catch (error) {
+        console.error("Error fetching skew depths:", error);
+        throw error;
+    }
+};
+exports.fetchPairSkewDepths = fetchPairSkewDepths;
+/**
+ * @dev Fetches skew price impact context for a single pair
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndex Collateral index
+ * @param pairIndex Pair index
+ * @returns Promise resolving to skew price impact context
+ */
+const fetchSkewPriceImpactContext = async (contract, collateralIndex, pairIndex) => {
+    try {
+        // Fetch OI data and skew depth in parallel
+        const [pairOiToken, skewDepth] = await Promise.all([
+            (0, exports.fetchPairOiAfterV10Token)(contract, collateralIndex, pairIndex),
+            (0, exports.fetchPairSkewDepth)(contract, collateralIndex, pairIndex),
+        ]);
+        return {
+            skewDepth,
+            pairOiToken,
+        };
+    }
+    catch (error) {
+        console.error("Error fetching skew price impact context:", error);
+        throw error;
+    }
+};
+exports.fetchSkewPriceImpactContext = fetchSkewPriceImpactContext;
+/**
+ * @dev Fetches collateral decimals for given collateral indices
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndices Array of collateral indices
+ * @returns Promise resolving to array of decimals
+ */
+const fetchCollateralDecimals = async (contract, collateralIndices) => {
+    try {
+        // Get unique collateral indices to minimize calls
+        const uniqueIndices = [...new Set(collateralIndices)];
+        // Fetch collateral info for unique indices
+        const promises = uniqueIndices.map(async (index) => {
+            const collateral = await contract.getCollateral(index);
+            return { index, decimals: Number(collateral.precision) };
+        });
+        const collateralData = await Promise.all(promises);
+        // Create a map for quick lookup
+        const decimalsMap = new Map(collateralData.map(data => [data.index, data.decimals]));
+        // Return decimals in the same order as input
+        return collateralIndices.map(index => decimalsMap.get(index) || 18 // Default to 18 if not found
+        );
+    }
+    catch (error) {
+        console.error("Error fetching collateral decimals:", error);
+        throw error;
+    }
+};
+exports.fetchCollateralDecimals = fetchCollateralDecimals;
+/**
+ * @dev Calculates skew price impact for a trade using contract call
+ * @param contract GNSMultiCollatDiamond contract instance
+ * @param collateralIndex Collateral index
+ * @param pairIndex Pair index
+ * @param long Whether trade is long
+ * @param positionSizeToken Position size in tokens
+ * @param open Whether trade is opening
+ * @returns Promise resolving to price impact percentage (1e10)
+ */
+const calculateTradeSkewPriceImpact = async (contract, collateralIndex, pairIndex, long, positionSizeToken, open) => {
+    try {
+        const priceImpactP = await contract.getTradeSkewPriceImpactP(collateralIndex, pairIndex, long, BigInt(Math.round(positionSizeToken * 1e18)), // Convert to 1e18 precision
+        open);
+        // Convert from int256 1e10 to percentage
+        return Number(priceImpactP) / 1e10;
+    }
+    catch (error) {
+        console.error("Error calculating trade skew price impact:", error);
+        throw error;
+    }
+};
+exports.calculateTradeSkewPriceImpact = calculateTradeSkewPriceImpact;

package/lib/trade/priceImpact/skew/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @dev Skew price impact calculations for v10+ trades
+ * @dev Based on formula: (existingSkew + tradeSize/2) / skewDepth
+ */
+import { PairOiToken, SkewPriceImpactInput, SkewPriceImpactResult, SkewPriceImpactContext } from "./types";
+/**
+ * @dev Calculates net skew in tokens (long - short)
+ * @param pairOi Pair OI data with long and short token amounts
+ * @returns Net skew in tokens (positive = long heavy, negative = short heavy)
+ */
+export declare const getNetSkewToken: (pairOi: PairOiToken) => number;
+/**
+ * @dev Calculates net skew in collateral
+ * @param netSkewToken Net skew in tokens
+ * @param currentPrice Current pair price
+ * @returns Net skew in collateral
+ */
+export declare const getNetSkewCollateral: (netSkewToken: number, currentPrice: number) => number;
+/**
+ * @dev Determines trade direction impact on skew
+ * @param long Is long position
+ * @param open Is opening (true) or closing (false)
+ * @returns Whether trade increases or decreases skew
+ */
+export declare const getTradeSkewDirection: (long: boolean, open: boolean) => boolean;
+/**
+ * @dev Core skew price impact calculation
+ * @param existingSkewToken Current net skew in tokens (signed)
+ * @param tradeSizeToken Trade size in tokens (always positive)
+ * @param skewDepth Skew depth in tokens
+ * @param tradePositiveSkew Whether trade increases skew in its direction
+ * @returns Price impact percentage (can be positive or negative)
+ */
+export declare const calculateSkewPriceImpactP: (existingSkewToken: number, tradeSizeToken: number, skewDepth: number, tradePositiveSkew: boolean) => number;
+/**
+ * @dev Main function to calculate skew price impact for a trade
+ * @param input Trade parameters
+ * @param context Skew price impact context with depths and OI data
+ * @returns Skew price impact result
+ */
+export declare const getTradeSkewPriceImpact: (input: SkewPriceImpactInput, context: SkewPriceImpactContext) => SkewPriceImpactResult;
+/**
+ * @dev Calculate position sizes for partial operations
+ * @param originalSizeCollateral Original position size in collateral
+ * @param deltaCollateral Position size delta in collateral
+ * @param originalSizeToken Original position size in tokens
+ * @returns Delta in tokens proportional to collateral delta
+ */
+export declare const calculatePartialSizeToken: (originalSizeCollateral: number, deltaCollateral: number, originalSizeToken: number) => number;
+export * as SkewPriceImpact from "./types";
+export * from "./converter";
+export * from "./builder";
+export * from "./fetcher";

package/lib/trade/priceImpact/skew/index.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * @dev Skew price impact calculations for v10+ trades
+ * @dev Based on formula: (existingSkew + tradeSize/2) / skewDepth
+ */
+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.SkewPriceImpact = exports.calculatePartialSizeToken = exports.getTradeSkewPriceImpact = exports.calculateSkewPriceImpactP = exports.getTradeSkewDirection = exports.getNetSkewCollateral = exports.getNetSkewToken = void 0;
+// Constants
+const PRICE_IMPACT_DIVIDER = 2; // Half price impact to match cumulative volume impact scale
+/**
+ * @dev Calculates net skew in tokens (long - short)
+ * @param pairOi Pair OI data with long and short token amounts
+ * @returns Net skew in tokens (positive = long heavy, negative = short heavy)
+ */
+const getNetSkewToken = (pairOi) => {
+    return pairOi.oiLongToken - pairOi.oiShortToken;
+};
+exports.getNetSkewToken = getNetSkewToken;
+/**
+ * @dev Calculates net skew in collateral
+ * @param netSkewToken Net skew in tokens
+ * @param currentPrice Current pair price
+ * @returns Net skew in collateral
+ */
+const getNetSkewCollateral = (netSkewToken, currentPrice) => {
+    return netSkewToken * currentPrice;
+};
+exports.getNetSkewCollateral = getNetSkewCollateral;
+/**
+ * @dev Determines trade direction impact on skew
+ * @param long Is long position
+ * @param open Is opening (true) or closing (false)
+ * @returns Whether trade increases or decreases skew
+ */
+const getTradeSkewDirection = (long, open) => {
+    // Opening long or closing short increases positive skew
+    // Opening short or closing long increases negative skew
+    return (long && open) || (!long && !open);
+};
+exports.getTradeSkewDirection = getTradeSkewDirection;
+/**
+ * @dev Core skew price impact calculation
+ * @param existingSkewToken Current net skew in tokens (signed)
+ * @param tradeSizeToken Trade size in tokens (always positive)
+ * @param skewDepth Skew depth in tokens
+ * @param tradePositiveSkew Whether trade increases skew in its direction
+ * @returns Price impact percentage (can be positive or negative)
+ */
+const calculateSkewPriceImpactP = (existingSkewToken, tradeSizeToken, skewDepth, tradePositiveSkew) => {
+    if (skewDepth === 0) {
+        return 0; // No impact if depth is 0
+    }
+    // Convert signed values based on trade direction
+    const tradeSkewMultiplier = tradePositiveSkew ? 1 : -1;
+    const signedExistingSkew = existingSkewToken;
+    const signedTradeSize = tradeSizeToken * tradeSkewMultiplier;
+    // (existingSkew + tradeSize/2) / skewDepth
+    const numerator = signedExistingSkew + signedTradeSize / 2;
+    const priceImpactP = numerator / skewDepth;
+    // Apply divider to match cumulative volume impact scale
+    return priceImpactP / PRICE_IMPACT_DIVIDER;
+};
+exports.calculateSkewPriceImpactP = calculateSkewPriceImpactP;
+/**
+ * @dev Main function to calculate skew price impact for a trade
+ * @param input Trade parameters
+ * @param context Skew price impact context with depths and OI data
+ * @returns Skew price impact result
+ */
+const getTradeSkewPriceImpact = (input, context) => {
+    // Get skew depth and pair OI from simplified context
+    const { skewDepth, pairOiToken: pairOi } = context;
+    // Calculate net skew
+    const netSkewToken = (0, exports.getNetSkewToken)(pairOi);
+    // Determine trade direction
+    const tradePositiveSkew = (0, exports.getTradeSkewDirection)(input.long, input.open);
+    // Calculate price impact
+    const basePriceImpactP = (0, exports.calculateSkewPriceImpactP)(netSkewToken, 0, skewDepth, tradePositiveSkew);
+    // Calculate price impact
+    const totalPriceImpactP = (0, exports.calculateSkewPriceImpactP)(netSkewToken, input.positionSizeToken, skewDepth, tradePositiveSkew);
+    const tradePriceImpactP = totalPriceImpactP - basePriceImpactP;
+    // Determine trade direction relative to skew
+    let tradeDirection;
+    if (totalPriceImpactP > 0) {
+        tradeDirection = "increase";
+    }
+    else if (totalPriceImpactP < 0) {
+        tradeDirection = "decrease";
+    }
+    else {
+        tradeDirection = "neutral";
+    }
+    return {
+        basePriceImpactP,
+        tradePriceImpactP,
+        totalPriceImpactP,
+        netSkewToken,
+        netSkewCollateral: 0,
+        tradeDirection,
+    };
+};
+exports.getTradeSkewPriceImpact = getTradeSkewPriceImpact;
+/**
+ * @dev Calculate position sizes for partial operations
+ * @param originalSizeCollateral Original position size in collateral
+ * @param deltaCollateral Position size delta in collateral
+ * @param originalSizeToken Original position size in tokens
+ * @returns Delta in tokens proportional to collateral delta
+ */
+const calculatePartialSizeToken = (originalSizeCollateral, deltaCollateral, originalSizeToken) => {
+    if (originalSizeCollateral === 0) {
+        return 0;
+    }
+    // For partial close/add, token delta is proportional to collateral delta
+    return (deltaCollateral * originalSizeToken) / originalSizeCollateral;
+};
+exports.calculatePartialSizeToken = calculatePartialSizeToken;
+// Export namespace for types
+exports.SkewPriceImpact = __importStar(require("./types"));
+__exportStar(require("./converter"), exports);
+__exportStar(require("./builder"), exports);
+__exportStar(require("./fetcher"), exports);

package/lib/trade/priceImpact/skew/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @dev Skew price impact types for v10+ trades
+ */
+export type PairOiToken = {
+    oiLongToken: number;
+    oiShortToken: number;
+};
+export type PairOiCollateral = {
+    oiLongCollateral: number;
+    oiShortCollateral: number;
+};
+export type SkewPriceImpactInput = {
+    collateralIndex: number;
+    pairIndex: number;
+    long: boolean;
+    open: boolean;
+    positionSizeToken: number;
+};
+export type SkewPriceImpactResult = {
+    basePriceImpactP: number;
+    tradePriceImpactP: number;
+    totalPriceImpactP: number;
+    netSkewToken: number;
+    netSkewCollateral: number;
+    tradeDirection: "increase" | "decrease" | "neutral";
+};
+export type SkewPriceImpactContext = {
+    skewDepth: number;
+    pairOiToken: PairOiToken;
+};
+export type TradeSkewParams = {
+    collateralIndex: number;
+    pairIndex: number;
+    long: boolean;
+    open: boolean;
+    positionSizeCollateral: number;
+    currentPrice: number;
+    contractsVersion: number;
+    isCounterTrade?: boolean;
+};
+export type PositionSizeResult = {
+    positionSizeToken: number;
+    positionSizeCollateral: number;
+};

package/lib/trade/priceImpact/skew/types.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * @dev Skew price impact types for v10+ trades
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/trade/spread.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @dev Pure spread calculations without price impact
+ * @dev For price impact calculations, see priceImpact module
+ */
+export { getSpreadWithPriceImpactP, getSpreadWithCumulVolPriceImpactP, getTradeCumulVolPriceImpactP, getCumulVolPriceImpact, getProtectionCloseFactor, isProtectionCloseFactorActive, getCumulativeFactor, getLegacyFactor, getFixedSpreadP, getSpreadP, CumulVolContext as SpreadContext, } from "./priceImpact/cumulVol";