@pulsepairs/sdk 0.5.0 → 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/dist/ws.js

@@ -154,14 +154,42 @@ export class UpDownWsClient {
     openSocket() {
         if (this.closed)
             return;
+        // Close any socket we're superseding before opening a new one. Without
+        // this, a rapid connect→(reconnect|reconnectMode) churn could leave the
+        // previous socket open — especially one still in CONNECTING, whose
+        // `onopen` fires after we've moved on.
+        if (this.ws) {
+            const stale = this.ws;
+            stale.onopen = stale.onmessage = stale.onclose = stale.onerror = null;
+            try {
+                stale.close();
+            }
+            catch {
+                /* ignore */
+            }
+        }
         const ws = new WebSocket(this.url);
         this.ws = ws;
         this.state = "idle";
         ws.onopen = () => {
+            // Guard: if we were disconnected, or a newer socket has superseded this
+            // one, this socket is an orphan (it finished CONNECTING after we moved
+            // on). Close it instead of leaving it open and streaming.
+            if (this.closed || this.ws !== ws) {
+                try {
+                    ws.close();
+                }
+                catch {
+                    /* ignore */
+                }
+                return;
+            }
             this.reconnect = 0;
             void this.startHandshake();
         };
         ws.onmessage = (ev) => {
+            if (this.ws !== ws)
+                return; // ignore frames from a superseded socket
             let parsed;
             try {
                 parsed = JSON.parse(String(ev.data));
@@ -172,7 +200,9 @@ export class UpDownWsClient {
             void this.handleIncoming(parsed);
         };
         ws.onclose = () => {
-            if (this.closed)
+            // A superseded socket's close must not trigger a reconnect — the live
+            // `this.ws` is a different, healthy socket.
+            if (this.closed || this.ws !== ws)
                 return;
             if (this.state === "unauthed-failure") {
                 // signAuth was rejected — don't reconnect into a hot loop.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pulsepairs/sdk",
-  "version": "0.5.0",
-  "description": "Standalone SDK for the UpDown (PulsePairs) up/down prediction markets \u2014 matcher REST/WS client, EIP-712 order signing, trade-math, and Alchemy Account Kit (smart-account) order signing for rain.trade integration.",
+  "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",
   "main": "dist/index.js",