@reyaxyz/common 0.353.1 → 0.354.1

package/README.md

@@ -6,5 +6,5 @@
 
 | Statements                  | Branches                | Functions                 | Lines             |
 | --------------------------- | ----------------------- | ------------------------- | ----------------- |
-| ![Statements](https://img.shields.io/badge/statements-35.67%25-red.svg?style=flat) | ![Branches](https://img.shields.io/badge/branches-32.69%25-red.svg?style=flat) | ![Functions](https://img.shields.io/badge/functions-22.02%25-red.svg?style=flat) | ![Lines](https://img.shields.io/badge/lines-37.06%25-red.svg?style=flat) |
+| ![Statements](https://img.shields.io/badge/statements-35.28%25-red.svg?style=flat) | ![Branches](https://img.shields.io/badge/branches-30.98%25-red.svg?style=flat) | ![Functions](https://img.shields.io/badge/functions-21.92%25-red.svg?style=flat) | ![Lines](https://img.shields.io/badge/lines-36.61%25-red.svg?style=flat) |
 

package/dist/incentives-api-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"incentives-api-types.js","sourceRoot":"/","sources":["incentives-api-types.ts"],"names":[],"mappings":"","sourcesContent":["import {\n  AddressParam,\n  ApiEndpoint,\n  ApiInfiniteListEndpoint,\n  ApiListEndpoint,\n  PaginatedQueryParams,\n  FailableResult,\n  Stringified,\n} from './api-types';\nimport { Rank, RankTrading } from './types';\n\nexport type PointsBreakdown = {\n  totalPoints: number;\n  tradingPoints: number;\n  stakingPoints: number;\n  signalPoints: number;\n  rank: number;\n};\n\nexport type IncentivesUserPointsData = {\n  weekly: PointsBreakdown;\n  total: PointsBreakdown;\n};\n\nexport type IncentivesUserRanks = {\n  walletAddress: string;\n  tradingRank: RankTrading;\n  stakingRank: Rank;\n};\n\nexport type IncentivesUserBoosts = {\n  walletAddress: string;\n  tradingBoost: number;\n  stakingBoost: number;\n  loyaltyBoost: number;\n};\n\nexport type IncentivesUserSummaryData = {\n  walletAddress: string;\n  points: IncentivesUserPointsData;\n  ranks: Omit<IncentivesUserRanks, 'walletAddress'>;\n  boosts: Omit<IncentivesUserBoosts, 'walletAddress'>;\n};\n\nexport type IncentivesLeaderBoardEntry = {\n  rank: number;\n  walletAddress: string;\n  totalPoints: number;\n  tradingPoints: number;\n  stakingPoints: number;\n  signalPoints: number;\n  isCurrentUser?: boolean;\n};\n\nexport type IncentivesRankingHistoryEntry = {\n  week: number;\n  createdAt: Date;\n  tradingRank: RankTrading;\n  stakingRank: Rank;\n  tradingPoints: number;\n  stakingPoints: number;\n};\n\nexport type IncentivesPointsHistoryEntry = {\n  walletAddress: string;\n  totalXpOG: number;\n  totalXpOGRanked: number;\n  liquidityReferralXpOG: number;\n  liquidityXpOG: number;\n  rankMultiplierOG: number;\n  rankOG: Rank;\n  stakingPointsOG: number;\n  liquidityReferralXpSeason1: number;\n  liquidityXpSeason1: number;\n  liquidityXpSeason1Ranked: number;\n  rankMultiplierSeason1: number;\n  rankSeason1: Rank;\n  stakingPointsSeason1: number;\n  tradingReferralXpSeason1: number;\n  tradingXpSeason1: number;\n  tradingXpSeason1Ranked: number;\n  tradingRankMultiplierSeason1: number;\n  tradingRankSeason1: RankTrading;\n  tradingPointsSeason1: number;\n  liquidityReferralXpSeason2: number;\n  liquidityXpSeason2: number;\n  rankSeason2: Rank;\n  stakingPointsSeason2: number;\n  tradingReferralXpSeason2: number;\n  tradingXpSeason2: number;\n  tradingRankSeason2: RankTrading;\n  tradingPointsSeason2: number;\n  totalLiquidityXp: number;\n  totalLiquidityReferralXp: number;\n  totalTradingXp: number;\n  totalTradingReferralXp: number;\n  totalXp: number;\n  totalPoints: number;\n};\n\nexport type LeaderBoardParams = { type: 'weekly' | 'total' };\n\nexport type TradingCompetitionRoundParams = { round: number };\n\nexport type TradingCompetitionUserSummaryData =\n  | {\n      status: 'out';\n    }\n  | {\n      status: 'in';\n      realizedPnl: number;\n      position: number;\n      volume: number;\n      volumePosition: number;\n    };\n\nexport type TradingCompetitionLeaderboardEntry = {\n  walletAddress: string;\n  realizedPnl: number;\n  position: number;\n};\n\nexport type IncentivesApiSource = {\n  'incentives/points': ApiEndpoint<\n    {\n      total: number;\n      weekly: number;\n    },\n    never\n  >;\n\n  'incentives/leaderBoard/:type': ApiInfiniteListEndpoint<\n    IncentivesLeaderBoardEntry,\n    LeaderBoardParams,\n    PaginatedQueryParams\n  >;\n\n  'incentives/wallet/:address': ApiEndpoint<\n    IncentivesUserSummaryData,\n    AddressParam\n  >;\n\n  'incentives/wallet/:address/referralsLeaderBoard/:type': ApiListEndpoint<\n    IncentivesLeaderBoardEntry,\n    AddressParam & LeaderBoardParams\n  >;\n\n  'incentives/wallet/:address/leaderBoard/:type': ApiEndpoint<\n    IncentivesLeaderBoardEntry,\n    AddressParam & LeaderBoardParams\n  >;\n\n  'incentives/wallet/:address/ranksHistory': ApiListEndpoint<\n    IncentivesRankingHistoryEntry,\n    AddressParam\n  >;\n\n  'incentives/wallet/:address/signalPoints': ApiListEndpoint<\n    {\n      createdAt: Date;\n      points: number;\n      reason: string;\n    },\n    AddressParam\n  >;\n\n  'incentives/wallet/:address/pointsHistory': ApiEndpoint<\n    IncentivesPointsHistoryEntry,\n    AddressParam\n  >;\n\n  'incentives/tradingCompetition/:round': ApiEndpoint<\n    {\n      entries: TradingCompetitionLeaderboardEntry[];\n      status: 'live' | 'ended';\n      refreshedAt: number;\n    },\n    TradingCompetitionRoundParams\n  >;\n\n  'incentives/wallet/:address/tradingCompetition/:round': ApiEndpoint<\n    TradingCompetitionUserSummaryData,\n    AddressParam & TradingCompetitionRoundParams\n  >;\n\n  'incentives/wallet/:address/tradingCompetition/:round/registration': ApiEndpoint<\n    { registered: boolean },\n    AddressParam & TradingCompetitionRoundParams\n  >;\n\n  'incentives/wallet/:address/tradingCompetition/:round/claim': ApiEndpoint<\n    FailableResult,\n    AddressParam & TradingCompetitionRoundParams,\n    { code: string }\n  >;\n};\n\nexport type IncentivesApi = {\n  [K in keyof IncentivesApiSource]: {\n    params: IncentivesApiSource[K]['params'];\n    query: IncentivesApiSource[K]['query'];\n    response: Stringified<IncentivesApiSource[K]['response']>;\n  };\n};\n"]}
+{"version":3,"file":"incentives-api-types.js","sourceRoot":"/","sources":["incentives-api-types.ts"],"names":[],"mappings":"","sourcesContent":["import {\n  AddressParam,\n  ApiEndpoint,\n  ApiInfiniteListEndpoint,\n  ApiListEndpoint,\n  PaginatedQueryParams,\n  FailableResult,\n  Stringified,\n} from './api-types';\nimport { Rank, RankTrading } from './types';\n\nexport type PointsBreakdown = {\n  totalPoints: number;\n  tradingPoints: number;\n  stakingPoints: number;\n  signalPoints: number;\n  rank: number;\n};\n\nexport type IncentivesUserPointsData = {\n  weekly: PointsBreakdown;\n  total: PointsBreakdown;\n};\n\nexport type IncentivesUserRanks = {\n  walletAddress: string;\n  tradingRank: RankTrading;\n  stakingRank: Rank;\n};\n\nexport type IncentivesUserBoosts = {\n  walletAddress: string;\n  tradingBoost: number;\n  stakingBoost: number;\n  loyaltyBoost: number;\n};\n\nexport type IncentivesUserSummaryData = {\n  walletAddress: string;\n  points: IncentivesUserPointsData;\n  ranks: Omit<IncentivesUserRanks, 'walletAddress'>;\n  boosts: Omit<IncentivesUserBoosts, 'walletAddress'>;\n};\n\nexport type IncentivesLeaderBoardEntry = {\n  rank: number;\n  walletAddress: string;\n  totalPoints: number;\n  tradingPoints: number;\n  stakingPoints: number;\n  signalPoints: number;\n  isCurrentUser?: boolean;\n};\n\nexport type IncentivesRankingHistoryEntry = {\n  week: number;\n  createdAt: Date;\n  tradingRank: RankTrading;\n  stakingRank: Rank;\n  tradingPoints: number;\n  stakingPoints: number;\n};\n\nexport type IncentivesPointsHistoryEntry = {\n  walletAddress: string;\n  totalXpOG: number;\n  totalXpOGRanked: number;\n  liquidityReferralXpOG: number;\n  liquidityXpOG: number;\n  rankMultiplierOG: number;\n  rankOG: Rank;\n  stakingPointsOG: number;\n  liquidityReferralXpSeason1: number;\n  liquidityXpSeason1: number;\n  liquidityXpSeason1Ranked: number;\n  rankMultiplierSeason1: number;\n  rankSeason1: Rank;\n  stakingPointsSeason1: number;\n  tradingReferralXpSeason1: number;\n  tradingXpSeason1: number;\n  tradingXpSeason1Ranked: number;\n  tradingRankMultiplierSeason1: number;\n  tradingRankSeason1: RankTrading;\n  tradingPointsSeason1: number;\n  liquidityReferralXpSeason2: number;\n  liquidityXpSeason2: number;\n  rankSeason2: Rank;\n  stakingPointsSeason2: number;\n  tradingReferralXpSeason2: number;\n  tradingXpSeason2: number;\n  tradingRankSeason2: RankTrading;\n  tradingPointsSeason2: number;\n  totalLiquidityXp: number;\n  totalLiquidityReferralXp: number;\n  totalTradingXp: number;\n  totalTradingReferralXp: number;\n  totalXp: number;\n  totalPoints: number;\n};\n\nexport type LeaderBoardParams = { type: 'weekly' | 'total' };\n\nexport type TradingCompetitionRoundParams = { round: number };\n\nexport type TradingCompetitionUserSummaryData =\n  | {\n      status: 'out';\n    }\n  | {\n      status: 'in';\n      realizedPnl: number;\n      position: number;\n      volume: number;\n      volumePosition: number;\n    };\n\nexport type TradingCompetitionLeaderboardEntry = {\n  walletAddress: string;\n  realizedPnl: number;\n  position: number;\n};\n\nexport type IncentivesApiSource = {\n  'incentives/points': ApiEndpoint<\n    {\n      total: number;\n      weekly: number;\n    },\n    never\n  >;\n\n  'incentives/leaderBoard/:type': ApiInfiniteListEndpoint<\n    IncentivesLeaderBoardEntry,\n    LeaderBoardParams,\n    PaginatedQueryParams\n  >;\n\n  'incentives/wallet/:address': ApiEndpoint<\n    IncentivesUserSummaryData,\n    AddressParam\n  >;\n\n  'incentives/wallet/:address/referralsLeaderBoard/:type': ApiListEndpoint<\n    IncentivesLeaderBoardEntry,\n    AddressParam & LeaderBoardParams\n  >;\n\n  'incentives/wallet/:address/leaderBoard/:type': ApiEndpoint<\n    IncentivesLeaderBoardEntry,\n    AddressParam & LeaderBoardParams\n  >;\n\n  'incentives/wallet/:address/ranksHistory': ApiListEndpoint<\n    IncentivesRankingHistoryEntry,\n    AddressParam\n  >;\n\n  'incentives/wallet/:address/signalPoints': ApiListEndpoint<\n    {\n      createdAt: Date;\n      points: number;\n      reason: string;\n    },\n    AddressParam\n  >;\n\n  'incentives/wallet/:address/pointsHistory': ApiEndpoint<\n    IncentivesPointsHistoryEntry,\n    AddressParam\n  >;\n\n  'incentives/tradingCompetition/:round': ApiEndpoint<\n    {\n      entries: TradingCompetitionLeaderboardEntry[];\n      status: 'live' | 'ended';\n      refreshedAt: number;\n    },\n    TradingCompetitionRoundParams\n  >;\n\n  'incentives/wallet/:address/tradingCompetition/:round': ApiEndpoint<\n    TradingCompetitionUserSummaryData,\n    AddressParam & TradingCompetitionRoundParams\n  >;\n\n  'incentives/wallet/:address/tradingCompetition/:round/registration': ApiEndpoint<\n    { registered: boolean },\n    AddressParam & TradingCompetitionRoundParams\n  >;\n\n  'incentives/wallet/:address/tradingCompetition/:round/claim': ApiEndpoint<\n    FailableResult,\n    AddressParam & TradingCompetitionRoundParams,\n    { code: string }\n  >;\n\n  'incentives/vip/wallet/:address': ApiEndpoint<\n    {\n      walletAddress: string;\n      isVip: boolean;\n      registered: boolean;\n      hasInviteLink: boolean;\n      registeredAt: number | null;\n    },\n    AddressParam\n  >;\n\n  'incentives/vip/wallet/:address/nonce': ApiEndpoint<\n    FailableResult<{\n      nonce: string;\n      message: string;\n      expiresAt: number;\n    }>,\n    AddressParam\n  >;\n\n  'incentives/vip/wallet/:address/register': ApiEndpoint<\n    FailableResult<{\n      inviteLink: string;\n      alreadyRegistered: boolean;\n    }>,\n    AddressParam\n  >;\n};\n\nexport type IncentivesApi = {\n  [K in keyof IncentivesApiSource]: {\n    params: IncentivesApiSource[K]['params'];\n    query: IncentivesApiSource[K]['query'];\n    response: Stringified<IncentivesApiSource[K]['response']>;\n  };\n};\n"]}

package/dist/types/incentives-api-types.d.ts

@@ -129,6 +129,22 @@ export type IncentivesApiSource = {
     'incentives/wallet/:address/tradingCompetition/:round/claim': ApiEndpoint<FailableResult, AddressParam & TradingCompetitionRoundParams, {
         code: string;
     }>;
+    'incentives/vip/wallet/:address': ApiEndpoint<{
+        walletAddress: string;
+        isVip: boolean;
+        registered: boolean;
+        hasInviteLink: boolean;
+        registeredAt: number | null;
+    }, AddressParam>;
+    'incentives/vip/wallet/:address/nonce': ApiEndpoint<FailableResult<{
+        nonce: string;
+        message: string;
+        expiresAt: number;
+    }>, AddressParam>;
+    'incentives/vip/wallet/:address/register': ApiEndpoint<FailableResult<{
+        inviteLink: string;
+        alreadyRegistered: boolean;
+    }>, AddressParam>;
 };
 export type IncentivesApi = {
     [K in keyof IncentivesApiSource]: {

package/dist/types/incentives-api-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"incentives-api-types.d.ts","sourceRoot":"/","sources":["incentives-api-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"incentives-api-types.d.ts","sourceRoot":"/","sources":["incentives-api-types.ts"],"names":[],"mappings":"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"}

package/dist/types/utils/compute-trade-pnl.d.ts

@@ -0,0 +1,39 @@
+export type TradePnlInput = {
+    /** Position average entry price (position_last_price) — used for openingFee */
+    avgEntryPrice: number;
+    /** Executed base amount (signed — positive = buy, negative = sell) */
+    executedBase: number;
+    /** Execution price of this trade */
+    executionPrice: number;
+    /** Total fee for this execution (rUSD) */
+    fee: number;
+    /** Position base AFTER this execution */
+    postOrderBase: number;
+    /** Previous position base multiplier */
+    previousBaseMultiplier: number | undefined;
+    /** Previous position average entry funding value */
+    previousEntryFundingValue: number | undefined;
+    /** Previous position entry price (position_previous_last_price) */
+    previousEntryPrice: number | undefined;
+    /** Previous position funding value (market funding value at time of previous trade) */
+    previousFundingValue: number | undefined;
+};
+export type TradePnlResult = {
+    fundingPnl: string;
+    openingFee: string;
+    priceVariationPnl: string;
+    realizedPnl: string;
+} | null;
+/**
+ * Compute execution-level PnL for a perpetual trade.
+ *
+ * Returns null when PnL is not applicable (position-extending executions,
+ * missing previous state). Returns computed values only when a position is
+ * being unwound or flipped.
+ *
+ * All inputs should be pre-normalized to numbers (from Prisma Decimal, string, etc.).
+ * This function is the single source of truth for this computation — used by both
+ * the REST transformer (packages/api) and the WS transformer (packages/bun-socket).
+ */
+export declare function computeTradePnl(input: TradePnlInput): TradePnlResult;
+//# sourceMappingURL=compute-trade-pnl.d.ts.map

package/dist/types/utils/compute-trade-pnl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-trade-pnl.d.ts","sourceRoot":"/","sources":["utils/compute-trade-pnl.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG;IAC1B,+EAA+E;IAC/E,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,sBAAsB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,oDAAoD;IACpD,yBAAyB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,mEAAmE;IACnE,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,uFAAuF;IACvF,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,IAAI,CAAC;AAET;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAoEpE"}

package/dist/types/utils/index.d.ts

@@ -1,6 +1,7 @@
 export * from './consts';
 export * from './points';
 export * from './calculate';
+export * from './compute-trade-pnl';
 export * from './struct';
 export * from './cooldown-interval';
 export * from './network';

package/dist/types/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"/","sources":["utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"/","sources":["utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC"}

package/dist/utils/compute-trade-pnl.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeTradePnl = void 0;
+var calculate_1 = require("./calculate");
+/**
+ * Compute execution-level PnL for a perpetual trade.
+ *
+ * Returns null when PnL is not applicable (position-extending executions,
+ * missing previous state). Returns computed values only when a position is
+ * being unwound or flipped.
+ *
+ * All inputs should be pre-normalized to numbers (from Prisma Decimal, string, etc.).
+ * This function is the single source of truth for this computation — used by both
+ * the REST transformer (packages/api) and the WS transformer (packages/bun-socket).
+ */
+function computeTradePnl(input) {
+    var avgEntryPrice = input.avgEntryPrice, executedBase = input.executedBase, executionPrice = input.executionPrice, fee = input.fee, postOrderBase = input.postOrderBase, previousBaseMultiplier = input.previousBaseMultiplier, previousEntryFundingValue = input.previousEntryFundingValue, previousEntryPrice = input.previousEntryPrice, previousFundingValue = input.previousFundingValue;
+    if (executedBase === 0) {
+        return null;
+    }
+    var preOrderBase = postOrderBase - executedBase;
+    // Position-extending: PnL not applicable
+    if (preOrderBase === 0 ||
+        (preOrderBase > 0 && executedBase > 0) ||
+        (preOrderBase < 0 && executedBase < 0)) {
+        return null;
+    }
+    // Missing previous state: can't compute PnL
+    if (previousEntryPrice == null ||
+        previousEntryFundingValue == null ||
+        previousFundingValue == null ||
+        previousBaseMultiplier == null) {
+        return null;
+    }
+    // For unwinding: adjustedBase = -executedBase; for flipping: adjustedBase = preOrderBase
+    var isUnwinding = (preOrderBase >= 0 && postOrderBase >= 0) ||
+        (preOrderBase <= 0 && postOrderBase <= 0);
+    var adjustedBase = isUnwinding ? -executedBase : preOrderBase;
+    var openingFee = executionPrice !== 0 ? fee * (avgEntryPrice / executionPrice) : 0;
+    var priceVariationPnl = (0, calculate_1.calculatePricePnl)({
+        positionAdjustedBase: adjustedBase,
+        positionAvgEntryPrice: previousEntryPrice,
+        price: executionPrice,
+    });
+    var fundingPnl = (0, calculate_1.calculateFundingPnl)({
+        marketBaseMultiplier: previousBaseMultiplier,
+        marketFundingValue: previousFundingValue,
+        positionAdjustedBase: adjustedBase,
+        positionAvgEntryFundingValue: previousEntryFundingValue,
+    });
+    var realizedPnl = priceVariationPnl + fundingPnl;
+    return {
+        fundingPnl: fundingPnl.toString(),
+        openingFee: openingFee.toString(),
+        priceVariationPnl: priceVariationPnl.toString(),
+        realizedPnl: realizedPnl.toString(),
+    };
+}
+exports.computeTradePnl = computeTradePnl;
+//# sourceMappingURL=compute-trade-pnl.js.map

package/dist/utils/compute-trade-pnl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-trade-pnl.js","sourceRoot":"/","sources":["utils/compute-trade-pnl.ts"],"names":[],"mappings":";;;AAAA,yCAAqE;AA8BrE;;;;;;;;;;GAUG;AACH,SAAgB,eAAe,CAAC,KAAoB;IAEhD,IAAA,aAAa,GASX,KAAK,cATM,EACb,YAAY,GAQV,KAAK,aARK,EACZ,cAAc,GAOZ,KAAK,eAPO,EACd,GAAG,GAMD,KAAK,IANJ,EACH,aAAa,GAKX,KAAK,cALM,EACb,sBAAsB,GAIpB,KAAK,uBAJe,EACtB,yBAAyB,GAGvB,KAAK,0BAHkB,EACzB,kBAAkB,GAEhB,KAAK,mBAFW,EAClB,oBAAoB,GAClB,KAAK,qBADa,CACZ;IAEV,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAM,YAAY,GAAG,aAAa,GAAG,YAAY,CAAC;IAElD,yCAAyC;IACzC,IACE,YAAY,KAAK,CAAC;QAClB,CAAC,YAAY,GAAG,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;QACtC,CAAC,YAAY,GAAG,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC,EACtC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4CAA4C;IAC5C,IACE,kBAAkB,IAAI,IAAI;QAC1B,yBAAyB,IAAI,IAAI;QACjC,oBAAoB,IAAI,IAAI;QAC5B,sBAAsB,IAAI,IAAI,EAC9B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yFAAyF;IACzF,IAAM,WAAW,GACf,CAAC,YAAY,IAAI,CAAC,IAAI,aAAa,IAAI,CAAC,CAAC;QACzC,CAAC,YAAY,IAAI,CAAC,IAAI,aAAa,IAAI,CAAC,CAAC,CAAC;IAC5C,IAAM,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;IAEhE,IAAM,UAAU,GACd,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpE,IAAM,iBAAiB,GAAG,IAAA,6BAAiB,EAAC;QAC1C,oBAAoB,EAAE,YAAY;QAClC,qBAAqB,EAAE,kBAAkB;QACzC,KAAK,EAAE,cAAc;KACtB,CAAC,CAAC;IAEH,IAAM,UAAU,GAAG,IAAA,+BAAmB,EAAC;QACrC,oBAAoB,EAAE,sBAAsB;QAC5C,kBAAkB,EAAE,oBAAoB;QACxC,oBAAoB,EAAE,YAAY;QAClC,4BAA4B,EAAE,yBAAyB;KACxD,CAAC,CAAC;IAEH,IAAM,WAAW,GAAG,iBAAiB,GAAG,UAAU,CAAC;IAEnD,OAAO;QACL,UAAU,EAAE,UAAU,CAAC,QAAQ,EAAE;QACjC,UAAU,EAAE,UAAU,CAAC,QAAQ,EAAE;QACjC,iBAAiB,EAAE,iBAAiB,CAAC,QAAQ,EAAE;QAC/C,WAAW,EAAE,WAAW,CAAC,QAAQ,EAAE;KACpC,CAAC;AACJ,CAAC;AApED,0CAoEC","sourcesContent":["import { calculateFundingPnl, calculatePricePnl } from './calculate';\n\nexport type TradePnlInput = {\n  /** Position average entry price (position_last_price) — used for openingFee */\n  avgEntryPrice: number;\n  /** Executed base amount (signed — positive = buy, negative = sell) */\n  executedBase: number;\n  /** Execution price of this trade */\n  executionPrice: number;\n  /** Total fee for this execution (rUSD) */\n  fee: number;\n  /** Position base AFTER this execution */\n  postOrderBase: number;\n  /** Previous position base multiplier */\n  previousBaseMultiplier: number | undefined;\n  /** Previous position average entry funding value */\n  previousEntryFundingValue: number | undefined;\n  /** Previous position entry price (position_previous_last_price) */\n  previousEntryPrice: number | undefined;\n  /** Previous position funding value (market funding value at time of previous trade) */\n  previousFundingValue: number | undefined;\n};\n\nexport type TradePnlResult = {\n  fundingPnl: string;\n  openingFee: string;\n  priceVariationPnl: string;\n  realizedPnl: string;\n} | null;\n\n/**\n * Compute execution-level PnL for a perpetual trade.\n *\n * Returns null when PnL is not applicable (position-extending executions,\n * missing previous state). Returns computed values only when a position is\n * being unwound or flipped.\n *\n * All inputs should be pre-normalized to numbers (from Prisma Decimal, string, etc.).\n * This function is the single source of truth for this computation — used by both\n * the REST transformer (packages/api) and the WS transformer (packages/bun-socket).\n */\nexport function computeTradePnl(input: TradePnlInput): TradePnlResult {\n  const {\n    avgEntryPrice,\n    executedBase,\n    executionPrice,\n    fee,\n    postOrderBase,\n    previousBaseMultiplier,\n    previousEntryFundingValue,\n    previousEntryPrice,\n    previousFundingValue,\n  } = input;\n\n  if (executedBase === 0) {\n    return null;\n  }\n\n  const preOrderBase = postOrderBase - executedBase;\n\n  // Position-extending: PnL not applicable\n  if (\n    preOrderBase === 0 ||\n    (preOrderBase > 0 && executedBase > 0) ||\n    (preOrderBase < 0 && executedBase < 0)\n  ) {\n    return null;\n  }\n\n  // Missing previous state: can't compute PnL\n  if (\n    previousEntryPrice == null ||\n    previousEntryFundingValue == null ||\n    previousFundingValue == null ||\n    previousBaseMultiplier == null\n  ) {\n    return null;\n  }\n\n  // For unwinding: adjustedBase = -executedBase; for flipping: adjustedBase = preOrderBase\n  const isUnwinding =\n    (preOrderBase >= 0 && postOrderBase >= 0) ||\n    (preOrderBase <= 0 && postOrderBase <= 0);\n  const adjustedBase = isUnwinding ? -executedBase : preOrderBase;\n\n  const openingFee =\n    executionPrice !== 0 ? fee * (avgEntryPrice / executionPrice) : 0;\n\n  const priceVariationPnl = calculatePricePnl({\n    positionAdjustedBase: adjustedBase,\n    positionAvgEntryPrice: previousEntryPrice,\n    price: executionPrice,\n  });\n\n  const fundingPnl = calculateFundingPnl({\n    marketBaseMultiplier: previousBaseMultiplier,\n    marketFundingValue: previousFundingValue,\n    positionAdjustedBase: adjustedBase,\n    positionAvgEntryFundingValue: previousEntryFundingValue,\n  });\n\n  const realizedPnl = priceVariationPnl + fundingPnl;\n\n  return {\n    fundingPnl: fundingPnl.toString(),\n    openingFee: openingFee.toString(),\n    priceVariationPnl: priceVariationPnl.toString(),\n    realizedPnl: realizedPnl.toString(),\n  };\n}\n"]}

package/dist/utils/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./consts"), exports);
 __exportStar(require("./points"), exports);
 __exportStar(require("./calculate"), exports);
+__exportStar(require("./compute-trade-pnl"), exports);
 __exportStar(require("./struct"), exports);
 __exportStar(require("./cooldown-interval"), exports);
 __exportStar(require("./network"), exports);

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"/","sources":["utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,2CAAyB;AACzB,8CAA4B;AAC5B,2CAAyB;AACzB,sDAAoC;AACpC,4CAA0B;AAC1B,2CAAyB;AACzB,0CAAwB;AACxB,8CAA4B;AAC5B,0CAAwB;AACxB,iDAA+B;AAC/B,wDAAsC;AACtC,8CAA4B;AAC5B,0CAAwB;AACxB,wDAAsC;AACtC,8CAA4B","sourcesContent":["export * from './consts';\nexport * from './points';\nexport * from './calculate';\nexport * from './struct';\nexport * from './cooldown-interval';\nexport * from './network';\nexport * from './number';\nexport * from './retry';\nexport * from './timestamp';\nexport * from './token';\nexport * from './task-wrapper';\nexport * from './whitelisted-wallets';\nexport * from './stringify';\nexport * from './delay';\nexport * from './transaction-receipt';\nexport * from './layerzero';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"/","sources":["utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,2CAAyB;AACzB,8CAA4B;AAC5B,sDAAoC;AACpC,2CAAyB;AACzB,sDAAoC;AACpC,4CAA0B;AAC1B,2CAAyB;AACzB,0CAAwB;AACxB,8CAA4B;AAC5B,0CAAwB;AACxB,iDAA+B;AAC/B,wDAAsC;AACtC,8CAA4B;AAC5B,0CAAwB;AACxB,wDAAsC;AACtC,8CAA4B","sourcesContent":["export * from './consts';\nexport * from './points';\nexport * from './calculate';\nexport * from './compute-trade-pnl';\nexport * from './struct';\nexport * from './cooldown-interval';\nexport * from './network';\nexport * from './number';\nexport * from './retry';\nexport * from './timestamp';\nexport * from './token';\nexport * from './task-wrapper';\nexport * from './whitelisted-wallets';\nexport * from './stringify';\nexport * from './delay';\nexport * from './transaction-receipt';\nexport * from './layerzero';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reyaxyz/common",
-  "version": "0.353.1",
+  "version": "0.354.1",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -45,5 +45,5 @@
     "generate:coverage-badges": "npx istanbul-badges-readme --silent"
   },
   "packageManager": "pnpm@8.3.1",
-  "gitHead": "f131d61348806e744f9aad9a7b0e58ec48a54833"
+  "gitHead": "84b500f29d92c10bd2015338ceebae1a2a24515b"
 }

package/src/incentives-api-types.ts

@@ -193,6 +193,34 @@ export type IncentivesApiSource = {
     AddressParam & TradingCompetitionRoundParams,
     { code: string }
   >;
+
+  'incentives/vip/wallet/:address': ApiEndpoint<
+    {
+      walletAddress: string;
+      isVip: boolean;
+      registered: boolean;
+      hasInviteLink: boolean;
+      registeredAt: number | null;
+    },
+    AddressParam
+  >;
+
+  'incentives/vip/wallet/:address/nonce': ApiEndpoint<
+    FailableResult<{
+      nonce: string;
+      message: string;
+      expiresAt: number;
+    }>,
+    AddressParam
+  >;
+
+  'incentives/vip/wallet/:address/register': ApiEndpoint<
+    FailableResult<{
+      inviteLink: string;
+      alreadyRegistered: boolean;
+    }>,
+    AddressParam
+  >;
 };
 
 export type IncentivesApi = {

package/src/utils/compute-trade-pnl.ts

@@ -0,0 +1,110 @@
+import { calculateFundingPnl, calculatePricePnl } from './calculate';
+
+export type TradePnlInput = {
+  /** Position average entry price (position_last_price) — used for openingFee */
+  avgEntryPrice: number;
+  /** Executed base amount (signed — positive = buy, negative = sell) */
+  executedBase: number;
+  /** Execution price of this trade */
+  executionPrice: number;
+  /** Total fee for this execution (rUSD) */
+  fee: number;
+  /** Position base AFTER this execution */
+  postOrderBase: number;
+  /** Previous position base multiplier */
+  previousBaseMultiplier: number | undefined;
+  /** Previous position average entry funding value */
+  previousEntryFundingValue: number | undefined;
+  /** Previous position entry price (position_previous_last_price) */
+  previousEntryPrice: number | undefined;
+  /** Previous position funding value (market funding value at time of previous trade) */
+  previousFundingValue: number | undefined;
+};
+
+export type TradePnlResult = {
+  fundingPnl: string;
+  openingFee: string;
+  priceVariationPnl: string;
+  realizedPnl: string;
+} | null;
+
+/**
+ * Compute execution-level PnL for a perpetual trade.
+ *
+ * Returns null when PnL is not applicable (position-extending executions,
+ * missing previous state). Returns computed values only when a position is
+ * being unwound or flipped.
+ *
+ * All inputs should be pre-normalized to numbers (from Prisma Decimal, string, etc.).
+ * This function is the single source of truth for this computation — used by both
+ * the REST transformer (packages/api) and the WS transformer (packages/bun-socket).
+ */
+export function computeTradePnl(input: TradePnlInput): TradePnlResult {
+  const {
+    avgEntryPrice,
+    executedBase,
+    executionPrice,
+    fee,
+    postOrderBase,
+    previousBaseMultiplier,
+    previousEntryFundingValue,
+    previousEntryPrice,
+    previousFundingValue,
+  } = input;
+
+  if (executedBase === 0) {
+    return null;
+  }
+
+  const preOrderBase = postOrderBase - executedBase;
+
+  // Position-extending: PnL not applicable
+  if (
+    preOrderBase === 0 ||
+    (preOrderBase > 0 && executedBase > 0) ||
+    (preOrderBase < 0 && executedBase < 0)
+  ) {
+    return null;
+  }
+
+  // Missing previous state: can't compute PnL
+  if (
+    previousEntryPrice == null ||
+    previousEntryFundingValue == null ||
+    previousFundingValue == null ||
+    previousBaseMultiplier == null
+  ) {
+    return null;
+  }
+
+  // For unwinding: adjustedBase = -executedBase; for flipping: adjustedBase = preOrderBase
+  const isUnwinding =
+    (preOrderBase >= 0 && postOrderBase >= 0) ||
+    (preOrderBase <= 0 && postOrderBase <= 0);
+  const adjustedBase = isUnwinding ? -executedBase : preOrderBase;
+
+  const openingFee =
+    executionPrice !== 0 ? fee * (avgEntryPrice / executionPrice) : 0;
+
+  const priceVariationPnl = calculatePricePnl({
+    positionAdjustedBase: adjustedBase,
+    positionAvgEntryPrice: previousEntryPrice,
+    price: executionPrice,
+  });
+
+  const fundingPnl = calculateFundingPnl({
+    marketBaseMultiplier: previousBaseMultiplier,
+    marketFundingValue: previousFundingValue,
+    positionAdjustedBase: adjustedBase,
+    positionAvgEntryFundingValue: previousEntryFundingValue,
+  });
+
+  const realizedPnl = priceVariationPnl + fundingPnl;
+
+  return {
+    fundingPnl: fundingPnl.toString(),
+    openingFee: openingFee.toString(),
+    priceVariationPnl: priceVariationPnl.toString(),
+    realizedPnl: realizedPnl.toString(),
+  };
+}

package/src/utils/index.ts

@@ -1,6 +1,7 @@
 export * from './consts';
 export * from './points';
 export * from './calculate';
+export * from './compute-trade-pnl';
 export * from './struct';
 export * from './cooldown-interval';
 export * from './network';