@pulsepairs/sdk 0.5.1 → 0.5.2

package/dist/index.d.ts

@@ -7,4 +7,4 @@ export { readOnChainHolderShares, reconcileFills, reportedFromPositions, type On
 export { UpDownAccountKitSigner, bareErc1271Signer, stripErc6492Wrapper, isErc6492Signature, type UpDownAccountKitConfig, type Eip1193Provider, type GrantSessionResult, type RawTypedDataSigner, } from "./accountKit.js";
 export { buildApproveSettlementTx, buildInstallOrderSessionTx, signWithOrderSession, type RawTransaction, type OrderSessionRecord, } from "./accountKit.js";
 export { PRICE_BPS_SCALE, WIN_MARK_BPS, LOSE_MARK_BPS, DEFAULT_USDT_DECIMALS, atomicToUsdt, markValueAtomic, midBps, markForOption, isResolvedWinner, positionPnl, feesPaidByWallet, portfolioPnl, computePortfolioPnl, type MarkSource, type PositionPnl, type PortfolioPnl, type PositionPnlOptions, } from "./pnl.js";
-export { OrderType, OrderSide, Option, type ApiConfig, type Balance, type CancelOrderBody, type Eip712Domain, type MarketDetail, type MarketListItem, type OptionValue, type OrderBookFull, type OrderBookLevel, type OrderBookSide, type OrderRow, type OrderSideKey, type OrderSideValue, type OrderStatus, type OrderTypeKey, type OrderTypeValue, type OrdersResponse, type PairConfig, type PairSymbol, type PostOrderBody, type Position, type Stats, type Trade, type Version, } from "./types.js";
+export { OrderType, OrderSide, Option, takerPriceBps, type ApiConfig, type Balance, type CancelOrderBody, type Eip712Domain, type MarketDetail, type MarketListItem, type OptionValue, type OrderBookFull, type OrderBookLevel, type OrderBookSide, type OrderRow, type OrderSideKey, type OrderSideValue, type OrderStatus, type OrderTypeKey, type OrderTypeValue, type OrdersResponse, type PairConfig, type PairSymbol, type PostOrderBody, type Position, type Stats, type Trade, type Version, } from "./types.js";

package/dist/index.js

@@ -25,4 +25,4 @@ export { buildApproveSettlementTx, buildInstallOrderSessionTx, signWithOrderSess
 // contract). `UpDownHttpClient.getPnl` is the batteries-included wrapper.
 export { PRICE_BPS_SCALE, WIN_MARK_BPS, LOSE_MARK_BPS, DEFAULT_USDT_DECIMALS, atomicToUsdt, markValueAtomic, midBps, markForOption, isResolvedWinner, positionPnl, feesPaidByWallet, portfolioPnl, computePortfolioPnl, } from "./pnl.js";
 // Types
-export { OrderType, OrderSide, Option, } from "./types.js";
+export { OrderType, OrderSide, Option, takerPriceBps, } from "./types.js";

package/dist/types.d.ts

@@ -140,18 +140,40 @@ export type Position = {
 export type Trade = {
     tradeId: string;
     market: string;
+    /** The TAKER leg's option (1=UP, 2=DOWN). On a MINT/MERGE the maker leg is
+     *  the opposite option. */
     option: number;
     buyOrderId: string;
     sellOrderId: string;
+    /** NORMAL: the buyer. MINT/MERGE: the aggressor (taker) — a buyer on MINT,
+     *  a seller on MERGE. */
     buyer: string;
+    /** NORMAL: the seller. MINT/MERGE: the resting maker, on the OPPOSITE option
+     *  to `option`. */
     seller: string;
+    /** Basis points — the resting MAKER's pegged execution price. On a
+     *  complementary fill the taker executed at the complement; render taker
+     *  fills with `takerPrice`, not this. */
     price: number;
     amount: string;
     platformFee: string;
     makerFee: string;
     settlementStatus: string;
     createdAt: string;
+    /** Match geometry. NORMAL = same-option fill. MINT/MERGE = complementary
+     *  cross (opposite-option legs). Optional so a pre-2026-07-17 backend
+     *  (field absent) degrades rather than breaking a consumer. */
+    matchType?: "NORMAL" | "MINT" | "MERGE";
+    /** Basis points the taker actually executed at: `price` on NORMAL,
+     *  `10000 − price` on MINT/MERGE. Prefer this over `price` when rendering a
+     *  wallet's own fills. Optional for the same back-compat reason. */
+    takerPrice?: number;
 };
+/** The price the AGGRESSOR paid/received per share, in bps. Mirrors the
+ *  backend's `takerPriceBps`: the complement on a complementary fill, else the
+ *  row price. Falls back to computing the complement if a row predates the
+ *  `takerPrice` field. */
+export declare function takerPriceBps(trade: Pick<Trade, "price" | "matchType" | "takerPrice">): number;
 export type OrderStatus = "OPEN" | "PARTIALLY_FILLED" | "FILLED" | "CANCEL_PENDING" | "CANCELLED" | string;
 export type OrderRow = {
     orderId: string;

package/dist/types.js

@@ -18,3 +18,14 @@ export const Option = {
     UP: 1,
     DOWN: 2,
 };
+/** The price the AGGRESSOR paid/received per share, in bps. Mirrors the
+ *  backend's `takerPriceBps`: the complement on a complementary fill, else the
+ *  row price. Falls back to computing the complement if a row predates the
+ *  `takerPrice` field. */
+export function takerPriceBps(trade) {
+    if (typeof trade.takerPrice === "number")
+        return trade.takerPrice;
+    return trade.matchType === "MINT" || trade.matchType === "MERGE"
+        ? 10000 - trade.price
+        : trade.price;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pulsepairs/sdk",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Standalone SDK for the UpDown (PulsePairs) up/down prediction markets — matcher REST/WS client, EIP-712 order signing, trade-math, and Alchemy Account Kit (smart-account) order signing for rain.trade integration.",
   "license": "UNLICENSED",
   "type": "module",