@agg-build/sdk 4.24.0 → 4.26.0

package/dist/index.js

@@ -87,6 +87,7 @@ __export(index_exports, {
   MarketStatus: () => MarketStatus,
   MatchStatus: () => MatchStatus,
   MatchType: () => MatchType,
+  OPTIONAL_SIGNATURE_TIMEOUT_MS: () => OPTIONAL_SIGNATURE_TIMEOUT_MS,
   OrderStatus: () => OrderStatus,
   OrderType: () => OrderType,
   RECURRENCE_CADENCES: () => RECURRENCE_CADENCES,
@@ -1101,6 +1102,7 @@ function toChecksumAddress(address) {
 // src/types.ts
 var SELF_CUSTODY_FILL_TIMEOUT_MS = 5 * 6e4;
 var SELF_CUSTODY_POLL_INTERVAL_MS = 2e3;
+var OPTIONAL_SIGNATURE_TIMEOUT_MS = 15e3;
 var TERMINAL_EXECUTION_STATES = /* @__PURE__ */ new Set(["filled", "partially_filled", "failed", "cancelled", "expired"]);
 var RECURRENCE_CADENCES = [
   "PT5M",
@@ -1543,6 +1545,10 @@ var RECONNECT_BASE_MS = 1e3;
 var RECONNECT_MAX_MS = 3e4;
 var STALE_TIMEOUT_MS = 45e3;
 var ORDERBOOK_DEBUG_TOP_LEVELS = 5;
+var WATCHDOG_SILENCE_MS = 5 * 6e4;
+var WATCHDOG_CHECK_INTERVAL_MS = 6e4;
+var WATCHDOG_BATCH_MAX = 100;
+var WATCHDOG_REQUEST_TIMEOUT_MS = 15e3;
 var AggWebSocket = class {
   constructor(options) {
     this.ws = null;
@@ -1568,6 +1574,18 @@ var AggWebSocket = class {
     this.books = /* @__PURE__ */ new Map();
     /** Markets currently resyncing (awaiting snapshot after seq gap / checksum mismatch). */
     this.resyncing = /* @__PURE__ */ new Set();
+    /**
+     * Per subscribed orderbook outcome: last time it made progress (subscribe,
+     * snapshot, applied delta) or was checked against REST (ms). Tracked from
+     * subscribe, not from the first snapshot, so a book that never arrives or
+     * is stuck resyncing is still found by the watchdog.
+     */
+    this.bookCheckedAt = /* @__PURE__ */ new Map();
+    /** Outcomes the watchdog already resnapshotted; a repeat mismatch resubscribes. */
+    this.watchdogResnapshotted = /* @__PURE__ */ new Set();
+    this.watchdogTimer = null;
+    this.watchdogAbort = null;
+    this.watchdogPausedUntil = 0;
     // ── Connection state ──
     this.connecting = false;
     this._connected = false;
@@ -1583,6 +1601,7 @@ var AggWebSocket = class {
     this.callbacks = (_b = options.callbacks) != null ? _b : {};
     this.initialToken = options.initialToken;
     this.enableLogs = (_c = options.enableLogs) != null ? _c : false;
+    this.bookWatchdog = options.bookWatchdog;
   }
   // ── Public API ──
   get connected() {
@@ -1728,6 +1747,7 @@ var AggWebSocket = class {
       this.subs.set(outcomeId, sub);
     }
     if (sub.refCount === 0) {
+      this.bookCheckedAt.set(outcomeId, Date.now());
       this.pendingSubs.add(outcomeId);
       this.ensureConnected();
       if (this._connected) {
@@ -1752,6 +1772,8 @@ var AggWebSocket = class {
           this.books.delete(outcomeId);
         }
         this.resyncing.delete(outcomeId);
+        this.bookCheckedAt.delete(outcomeId);
+        this.watchdogResnapshotted.delete(outcomeId);
         if (this._connected) {
           if (this.pendingFlushSubs.has(outcomeId)) {
             this.pendingFlushSubs.delete(outcomeId);
@@ -1819,6 +1841,7 @@ var AggWebSocket = class {
   }
   /** Send a JWT to authenticate (or re-authenticate) the connection. */
   authenticate(token) {
+    this.initialToken = token;
     if (this._connected) {
       this.send({ action: "authenticate", token });
     }
@@ -1850,6 +1873,7 @@ var AggWebSocket = class {
   }
   /** Permanently destroy. Cannot reconnect after this. */
   destroy() {
+    var _a;
     this.destroyed = true;
     for (const controller of this.historyControllers)
       controller.abort(new Error("Market-data client disposed"));
@@ -1860,6 +1884,12 @@ var AggWebSocket = class {
     this.subs.clear();
     this.books.clear();
     this.resyncing.clear();
+    if (this.watchdogTimer) clearInterval(this.watchdogTimer);
+    this.watchdogTimer = null;
+    (_a = this.watchdogAbort) == null ? void 0 : _a.abort();
+    this.watchdogAbort = null;
+    this.bookCheckedAt.clear();
+    this.watchdogResnapshotted.clear();
     this.pendingSubs.clear();
     this.pendingTradeSubs.clear();
     this.pendingResnapshots.clear();
@@ -2043,11 +2073,21 @@ var AggWebSocket = class {
    * ready to accept subscriptions. Now flush all pending subs.
    */
   handleConnected(msg) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     this._connected = true;
-    (_b = (_a = this.callbacks).onConnectionStateChange) == null ? void 0 : _b.call(_a, true);
-    (_d = (_c = this.callbacks).onConnected) == null ? void 0 : _d.call(_c, msg);
+    if (this.bookWatchdog && !this.watchdogTimer && !this.destroyed) {
+      this.watchdogTimer = setInterval(
+        () => void this.checkSilentBooks(),
+        (_a = this.bookWatchdog.checkIntervalMs) != null ? _a : WATCHDOG_CHECK_INTERVAL_MS
+      );
+    }
+    (_c = (_b = this.callbacks).onConnectionStateChange) == null ? void 0 : _c.call(_b, true);
+    (_e = (_d = this.callbacks).onConnected) == null ? void 0 : _e.call(_d, msg);
     const orderbookSet = new Set(this.activeOrderbookMarkets());
+    const reconnectedAt = Date.now();
+    for (const id of orderbookSet) {
+      if (this.bookCheckedAt.has(id)) this.bookCheckedAt.set(id, reconnectedAt);
+    }
     this.pendingSubs.forEach((id) => orderbookSet.add(id));
     this.pendingFlushSubs.forEach((id) => orderbookSet.add(id));
     const orderbookIds = Array.from(orderbookSet);
@@ -2090,6 +2130,7 @@ var AggWebSocket = class {
     const msg = __spreadProps(__spreadValues({}, raw), { timestamp: raw.timestamp / 1e3 });
     const book = snapshotToOrderbook(msg);
     this.books.set(msg.outcomeId, new IndexedOrderbook(book));
+    this.bookCheckedAt.set(msg.outcomeId, Date.now());
     this.resyncing.delete(msg.outcomeId);
     this.pendingResnapshots.delete(msg.outcomeId);
     this.debugOrderbook("snapshot_applied", {
@@ -2159,6 +2200,8 @@ var AggWebSocket = class {
       this.requestResnapshot(outcomeId);
       return;
     }
+    this.bookCheckedAt.set(outcomeId, Date.now());
+    this.watchdogResnapshotted.delete(outcomeId);
     (_b = (_a = this.callbacks).onBookTick) == null ? void 0 : _b.call(_a, outcomeId, {
       midpoint: msg.midpoint,
       timestamp: msg.timestamp,
@@ -2181,6 +2224,8 @@ var AggWebSocket = class {
     var _a, _b;
     const msg = __spreadProps(__spreadValues({}, raw), { timestamp: raw.timestamp / 1e3 });
     this.books.delete(msg.outcomeId);
+    this.bookCheckedAt.delete(msg.outcomeId);
+    this.watchdogResnapshotted.delete(msg.outcomeId);
     this.pendingResnapshots.delete(msg.outcomeId);
     this.resyncing.delete(msg.outcomeId);
     (_b = (_a = this.callbacks).onMarketResolved) == null ? void 0 : _b.call(_a, msg);
@@ -2200,6 +2245,89 @@ var AggWebSocket = class {
     const msg = __spreadProps(__spreadValues({}, raw), { timestamp: raw.timestamp / 1e3 });
     (_b = (_a = this.callbacks).onRedeemEvent) == null ? void 0 : _b.call(_a, msg);
   }
+  // ── Book watchdog ──
+  /**
+   * Heartbeats prove the socket, not each stream. Every subscribed outcome
+   * with no progress for `silenceMs` is checked against the REST `seq`:
+   *
+   * - book present, not resyncing, same `seq` → the market is just quiet;
+   * - different `seq`, no book (snapshot never arrived, or a resubscribe's
+   *   snapshot was lost), or stuck resyncing (any recovery whose snapshot
+   *   was lost) → resnapshot, then resubscribe on the next overdue check;
+   * - REST can't serve it (`null`) → counted as an attempt, so the next
+   *   batch moves on to other outcomes instead of retrying the same 100.
+   */
+  checkSilentBooks() {
+    return __async(this, null, function* () {
+      var _a;
+      const opts = this.bookWatchdog;
+      if (!opts || !this._connected || this.watchdogAbort) return;
+      const now = Date.now();
+      if (now < this.watchdogPausedUntil) return;
+      const silenceMs = (_a = opts.silenceMs) != null ? _a : WATCHDOG_SILENCE_MS;
+      const silent = this.activeOrderbookMarkets().filter((id) => this.bookCheckedAt.has(id)).filter((id) => now - this.bookCheckedAt.get(id) >= silenceMs).sort((a, b) => this.bookCheckedAt.get(a) - this.bookCheckedAt.get(b)).slice(0, WATCHDOG_BATCH_MAX);
+      if (silent.length === 0) return;
+      const checkedAt = new Map(silent.map((id) => [id, this.bookCheckedAt.get(id)]));
+      const abort = new AbortController();
+      this.watchdogAbort = abort;
+      const timeout = setTimeout(() => abort.abort(), WATCHDOG_REQUEST_TIMEOUT_MS);
+      try {
+        const url = new URL(`${opts.baseUrl.replace(/\/$/, "")}/orderbooks/outcomes`);
+        url.searchParams.set("venueMarketOutcomeIds", silent.join(","));
+        url.searchParams.set("depth", "1");
+        const response = yield fetch(url, { headers: opts.headers, signal: abort.signal });
+        if (!response.ok) {
+          const retryAfterS = Number(response.headers.get("retry-after"));
+          if (response.status === 429 && retryAfterS > 0) {
+            this.watchdogPausedUntil = Date.now() + retryAfterS * 1e3;
+          }
+          this.emitDiagnostic({ type: "book_watchdog_error", status: response.status });
+          return;
+        }
+        const body = yield response.json();
+        if (this.destroyed) return;
+        silent.forEach((outcomeId, i) => {
+          var _a2, _b;
+          if (this.bookCheckedAt.get(outcomeId) !== checkedAt.get(outcomeId)) return;
+          const server = (_a2 = body.data) == null ? void 0 : _a2[i];
+          if (!server) {
+            this.bookCheckedAt.set(outcomeId, Date.now());
+            return;
+          }
+          const book = this.books.get(outcomeId);
+          if (book && !this.resyncing.has(outcomeId) && server.seq === book.seq) {
+            this.bookCheckedAt.set(outcomeId, Date.now());
+            this.watchdogResnapshotted.delete(outcomeId);
+            return;
+          }
+          const action = this.watchdogResnapshotted.has(outcomeId) ? "resubscribe" : "resnapshot";
+          this.emitDiagnostic({
+            type: "book_watchdog_resync",
+            outcomeId,
+            localSeq: (_b = book == null ? void 0 : book.seq) != null ? _b : null,
+            serverSeq: server.seq,
+            action
+          });
+          this.bookCheckedAt.set(outcomeId, Date.now());
+          if (action === "resubscribe") {
+            this.watchdogResnapshotted.delete(outcomeId);
+            this.books.delete(outcomeId);
+            this.resyncing.add(outcomeId);
+            this.send({ action: "unsubscribe", channel: "orderbook", outcomeIds: [outcomeId] });
+            this.sendSubscribe([outcomeId]);
+          } else {
+            this.watchdogResnapshotted.add(outcomeId);
+            this.requestResnapshot(outcomeId, true);
+          }
+        });
+      } catch (e) {
+        if (!this.destroyed) this.emitDiagnostic({ type: "book_watchdog_error", status: null });
+      } finally {
+        clearTimeout(timeout);
+        if (this.watchdogAbort === abort) this.watchdogAbort = null;
+      }
+    });
+  }
   // ── Resnapshot ──
   requestResnapshot(outcomeId, force = false) {
     if (this.resyncing.has(outcomeId) && !force) return;
@@ -2424,6 +2552,21 @@ var AUTH_PATHS = /* @__PURE__ */ new Set([
   "/auth/token/exchange",
   "/auth/sign-out"
 ]);
+function withTimeout(p, ms) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new Error(`timed out after ${ms}ms`)), ms);
+    p.then(
+      (v) => {
+        clearTimeout(timer);
+        resolve(v);
+      },
+      (e) => {
+        clearTimeout(timer);
+        reject(e);
+      }
+    );
+  });
+}
 var AggClient = class {
   constructor(options) {
     this.listeners = /* @__PURE__ */ new Set();
@@ -3141,23 +3284,38 @@ Issued At: ${issuedAt}`;
   getLeaderboard() {
     return __async(this, arguments, function* (params = {}) {
       const query = {};
-      if (params.from) query.from = params.from;
-      if (params.to) query.to = params.to;
-      if (params.metric) query.metric = params.metric;
+      for (const key of [
+        "from",
+        "to",
+        "metric",
+        "cursor",
+        "userId",
+        "externalId",
+        "username",
+        "walletAddress"
+      ]) {
+        const value = params[key];
+        if (value) query[key] = value;
+      }
       if (params.limit != null) query.limit = String(params.limit);
-      if (params.cursor) query.cursor = params.cursor;
+      for (const key of ["categoryIds", "venueEventIds", "userIds"]) {
+        const value = params[key];
+        if (value == null ? void 0 : value.length) query[key] = value;
+      }
       return this.request("/leaderboard", {
         query: Object.keys(query).length ? query : void 0
       });
     });
   }
   /**
-   * One user's leaderboard stats per UTC day (default the last 30 days, at
-   * most 366) with a running cumulative realized P&L. Gross of fees;
+   * One user's (or, with no user, the whole app's) leaderboard stats per UTC
+   * day (default the last 30 days, at most 366) with a running cumulative
+   * realized P&L, optionally for a single category. Gross of fees;
    * unrealized P&L is not included.
    */
   getLeaderboardSeries(params) {
     return __async(this, null, function* () {
+      var _a;
       const query = {};
       for (const key of [
         "from",
@@ -3170,17 +3328,21 @@ Issued At: ${issuedAt}`;
         const value = params[key];
         if (value) query[key] = value;
       }
+      if ((_a = params.categoryIds) == null ? void 0 : _a.length) query.categoryIds = params.categoryIds;
       return this.request("/leaderboard/series", { query });
     });
   }
   /** List execution positions for the authenticated user (cursor pagination). */
   getExecutionPositions() {
     return __async(this, arguments, function* (params = {}) {
+      var _a;
       const query = {};
       if (params.cursor) query.cursor = params.cursor;
       if (params.limit != null) query.limit = String(params.limit);
       if (params.status) query.status = params.status;
       if (params.mode) query.mode = params.mode;
+      if ((_a = params.categoryIds) == null ? void 0 : _a.length) query.categoryIds = params.categoryIds;
+      if (params.sort) query.sort = params.sort;
       return this.request("/execution/positions", {
         query: Object.keys(query).length ? query : void 0
       });
@@ -3943,6 +4105,9 @@ Issued At: ${issuedAt}`;
       }
       if (params.referralPayer) query.referralPayer = params.referralPayer;
       if (params.referralPayerAddress) query.referralPayerAddress = params.referralPayerAddress;
+      if (params.referralActivationSponsorAddress) {
+        query.referralActivationSponsorAddress = params.referralActivationSponsorAddress;
+      }
       const response = yield this.request(
         `/orderbook/${encodeURIComponent(venueMarketOutcomeId)}/route`,
         { query, signal: options == null ? void 0 : options.signal }
@@ -3973,11 +4138,15 @@ Issued At: ${issuedAt}`;
     const url = new URL(this.wsUrl);
     if (this._appId) url.searchParams.set("appId", this._appId);
     const createSocket = (_a = this.webSocketFactory) != null ? _a : ((socketOptions) => new AggWebSocket(socketOptions));
+    const watchdogHeaders = {};
+    if (this._appId) watchdogHeaders["x-app-id"] = this._appId;
+    if (this.apiKey) watchdogHeaders["x-app-api-key"] = this.apiKey;
     return createSocket({
       url: url.toString(),
       callbacks,
       initialToken: this.accessToken,
-      enableLogs: (_b = options == null ? void 0 : options.enableLogs) != null ? _b : false
+      enableLogs: (_b = options == null ? void 0 : options.enableLogs) != null ? _b : false,
+      bookWatchdog: (options == null ? void 0 : options.bookWatchdog) === false ? void 0 : __spreadValues({ baseUrl: this.baseUrl, headers: watchdogHeaders }, options == null ? void 0 : options.bookWatchdog)
     });
   }
   /** Execute a previously quoted managed trade. Returns pending order IDs. */
@@ -4012,7 +4181,7 @@ Issued At: ${issuedAt}`;
    */
   fillSelfCustody(params) {
     return __async(this, null, function* () {
-      var _a, _b, _c;
+      var _a, _b, _c, _d;
       if (this.signer && !params.signingAddress) {
         throw new Error(
           "fillSelfCustody requires `signingAddress` \u2014 the wallet that will sign this fill."
@@ -4061,7 +4230,11 @@ Issued At: ${issuedAt}`;
         }
         lastKey = key;
         const signatures = [];
-        for (const req of pending) {
+        const ordered = [...pending].sort((a, b) => Number(!!a.optional) - Number(!!b.optional));
+        const userSigners = new Set(
+          [params.signingAddress, ...pending.filter((p) => !p.optional).map((p) => p.signerAddress)].filter((a) => !!a).map((a) => a.toLowerCase())
+        );
+        for (const req of ordered) {
           if (Date.now() > new Date(req.expiresAt).getTime()) {
             if (req.optional) {
               declinedOptional.add(req.stepId);
@@ -4073,7 +4246,7 @@ Issued At: ${issuedAt}`;
           }
           let signed;
           try {
-            signed = yield signer(req);
+            signed = req.optional && !userSigners.has((_c = req.signerAddress) == null ? void 0 : _c.toLowerCase()) ? yield withTimeout(signer(req), OPTIONAL_SIGNATURE_TIMEOUT_MS) : yield signer(req);
           } catch (err) {
             if (!req.optional) throw err;
             declinedOptional.add(req.stepId);
@@ -4088,7 +4261,7 @@ Issued At: ${issuedAt}`;
           continue;
         }
         const next = yield this.submitFillSignatures(quoteId, signatures);
-        pending = (_c = next.pendingSignatures) != null ? _c : [];
+        pending = (_d = next.pendingSignatures) != null ? _d : [];
       }
     });
   }
@@ -4241,11 +4414,14 @@ Issued At: ${issuedAt}`;
   /** Get open positions grouped by matched market with per-venue breakdown. */
   getPositions(params) {
     return __async(this, null, function* () {
+      var _a;
       const query = {};
       if (params == null ? void 0 : params.cursor) query.cursor = params.cursor;
       if ((params == null ? void 0 : params.limit) != null) query.limit = String(params.limit);
       if (params == null ? void 0 : params.status) query.status = params.status;
       if (params == null ? void 0 : params.mode) query.mode = params.mode;
+      if ((_a = params == null ? void 0 : params.categoryIds) == null ? void 0 : _a.length) query.categoryIds = params.categoryIds;
+      if (params == null ? void 0 : params.sort) query.sort = params.sort;
       return this.request("/execution/positions", {
         query: Object.keys(query).length > 0 ? query : void 0
       });
@@ -4683,6 +4859,7 @@ function createAggClient(options) {
   MarketStatus,
   MatchStatus,
   MatchType,
+  OPTIONAL_SIGNATURE_TIMEOUT_MS,
   OrderStatus,
   OrderType,
   RECURRENCE_CADENCES,

package/dist/index.mjs

@@ -59,7 +59,7 @@ import {
   safeParse,
   snapshotToOrderbook,
   sortVenues
-} from "./chunk-QXBVA5TW.mjs";
+} from "./chunk-CPMSVNBO.mjs";
 import {
   __async,
   __objRest,
@@ -244,6 +244,7 @@ function toChecksumAddress(address) {
 // src/types.ts
 var SELF_CUSTODY_FILL_TIMEOUT_MS = 5 * 6e4;
 var SELF_CUSTODY_POLL_INTERVAL_MS = 2e3;
+var OPTIONAL_SIGNATURE_TIMEOUT_MS = 15e3;
 var TERMINAL_EXECUTION_STATES = /* @__PURE__ */ new Set(["filled", "partially_filled", "failed", "cancelled", "expired"]);
 var RECURRENCE_CADENCES = [
   "PT5M",
@@ -341,6 +342,21 @@ var AUTH_PATHS = /* @__PURE__ */ new Set([
   "/auth/token/exchange",
   "/auth/sign-out"
 ]);
+function withTimeout(p, ms) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new Error(`timed out after ${ms}ms`)), ms);
+    p.then(
+      (v) => {
+        clearTimeout(timer);
+        resolve(v);
+      },
+      (e) => {
+        clearTimeout(timer);
+        reject(e);
+      }
+    );
+  });
+}
 var AggClient = class {
   constructor(options) {
     this.listeners = /* @__PURE__ */ new Set();
@@ -1058,23 +1074,38 @@ Issued At: ${issuedAt}`;
   getLeaderboard() {
     return __async(this, arguments, function* (params = {}) {
       const query = {};
-      if (params.from) query.from = params.from;
-      if (params.to) query.to = params.to;
-      if (params.metric) query.metric = params.metric;
+      for (const key of [
+        "from",
+        "to",
+        "metric",
+        "cursor",
+        "userId",
+        "externalId",
+        "username",
+        "walletAddress"
+      ]) {
+        const value = params[key];
+        if (value) query[key] = value;
+      }
       if (params.limit != null) query.limit = String(params.limit);
-      if (params.cursor) query.cursor = params.cursor;
+      for (const key of ["categoryIds", "venueEventIds", "userIds"]) {
+        const value = params[key];
+        if (value == null ? void 0 : value.length) query[key] = value;
+      }
       return this.request("/leaderboard", {
         query: Object.keys(query).length ? query : void 0
       });
     });
   }
   /**
-   * One user's leaderboard stats per UTC day (default the last 30 days, at
-   * most 366) with a running cumulative realized P&L. Gross of fees;
+   * One user's (or, with no user, the whole app's) leaderboard stats per UTC
+   * day (default the last 30 days, at most 366) with a running cumulative
+   * realized P&L, optionally for a single category. Gross of fees;
    * unrealized P&L is not included.
    */
   getLeaderboardSeries(params) {
     return __async(this, null, function* () {
+      var _a;
       const query = {};
       for (const key of [
         "from",
@@ -1087,17 +1118,21 @@ Issued At: ${issuedAt}`;
         const value = params[key];
         if (value) query[key] = value;
       }
+      if ((_a = params.categoryIds) == null ? void 0 : _a.length) query.categoryIds = params.categoryIds;
       return this.request("/leaderboard/series", { query });
     });
   }
   /** List execution positions for the authenticated user (cursor pagination). */
   getExecutionPositions() {
     return __async(this, arguments, function* (params = {}) {
+      var _a;
       const query = {};
       if (params.cursor) query.cursor = params.cursor;
       if (params.limit != null) query.limit = String(params.limit);
       if (params.status) query.status = params.status;
       if (params.mode) query.mode = params.mode;
+      if ((_a = params.categoryIds) == null ? void 0 : _a.length) query.categoryIds = params.categoryIds;
+      if (params.sort) query.sort = params.sort;
       return this.request("/execution/positions", {
         query: Object.keys(query).length ? query : void 0
       });
@@ -1860,6 +1895,9 @@ Issued At: ${issuedAt}`;
       }
       if (params.referralPayer) query.referralPayer = params.referralPayer;
       if (params.referralPayerAddress) query.referralPayerAddress = params.referralPayerAddress;
+      if (params.referralActivationSponsorAddress) {
+        query.referralActivationSponsorAddress = params.referralActivationSponsorAddress;
+      }
       const response = yield this.request(
         `/orderbook/${encodeURIComponent(venueMarketOutcomeId)}/route`,
         { query, signal: options == null ? void 0 : options.signal }
@@ -1890,11 +1928,15 @@ Issued At: ${issuedAt}`;
     const url = new URL(this.wsUrl);
     if (this._appId) url.searchParams.set("appId", this._appId);
     const createSocket = (_a = this.webSocketFactory) != null ? _a : ((socketOptions) => new AggWebSocket(socketOptions));
+    const watchdogHeaders = {};
+    if (this._appId) watchdogHeaders["x-app-id"] = this._appId;
+    if (this.apiKey) watchdogHeaders["x-app-api-key"] = this.apiKey;
     return createSocket({
       url: url.toString(),
       callbacks,
       initialToken: this.accessToken,
-      enableLogs: (_b = options == null ? void 0 : options.enableLogs) != null ? _b : false
+      enableLogs: (_b = options == null ? void 0 : options.enableLogs) != null ? _b : false,
+      bookWatchdog: (options == null ? void 0 : options.bookWatchdog) === false ? void 0 : __spreadValues({ baseUrl: this.baseUrl, headers: watchdogHeaders }, options == null ? void 0 : options.bookWatchdog)
     });
   }
   /** Execute a previously quoted managed trade. Returns pending order IDs. */
@@ -1929,7 +1971,7 @@ Issued At: ${issuedAt}`;
    */
   fillSelfCustody(params) {
     return __async(this, null, function* () {
-      var _a, _b, _c;
+      var _a, _b, _c, _d;
       if (this.signer && !params.signingAddress) {
         throw new Error(
           "fillSelfCustody requires `signingAddress` \u2014 the wallet that will sign this fill."
@@ -1978,7 +2020,11 @@ Issued At: ${issuedAt}`;
         }
         lastKey = key;
         const signatures = [];
-        for (const req of pending) {
+        const ordered = [...pending].sort((a, b) => Number(!!a.optional) - Number(!!b.optional));
+        const userSigners = new Set(
+          [params.signingAddress, ...pending.filter((p) => !p.optional).map((p) => p.signerAddress)].filter((a) => !!a).map((a) => a.toLowerCase())
+        );
+        for (const req of ordered) {
           if (Date.now() > new Date(req.expiresAt).getTime()) {
             if (req.optional) {
               declinedOptional.add(req.stepId);
@@ -1990,7 +2036,7 @@ Issued At: ${issuedAt}`;
           }
           let signed;
           try {
-            signed = yield signer(req);
+            signed = req.optional && !userSigners.has((_c = req.signerAddress) == null ? void 0 : _c.toLowerCase()) ? yield withTimeout(signer(req), OPTIONAL_SIGNATURE_TIMEOUT_MS) : yield signer(req);
           } catch (err) {
             if (!req.optional) throw err;
             declinedOptional.add(req.stepId);
@@ -2005,7 +2051,7 @@ Issued At: ${issuedAt}`;
           continue;
         }
         const next = yield this.submitFillSignatures(quoteId, signatures);
-        pending = (_c = next.pendingSignatures) != null ? _c : [];
+        pending = (_d = next.pendingSignatures) != null ? _d : [];
       }
     });
   }
@@ -2158,11 +2204,14 @@ Issued At: ${issuedAt}`;
   /** Get open positions grouped by matched market with per-venue breakdown. */
   getPositions(params) {
     return __async(this, null, function* () {
+      var _a;
       const query = {};
       if (params == null ? void 0 : params.cursor) query.cursor = params.cursor;
       if ((params == null ? void 0 : params.limit) != null) query.limit = String(params.limit);
       if (params == null ? void 0 : params.status) query.status = params.status;
       if (params == null ? void 0 : params.mode) query.mode = params.mode;
+      if ((_a = params == null ? void 0 : params.categoryIds) == null ? void 0 : _a.length) query.categoryIds = params.categoryIds;
+      if (params == null ? void 0 : params.sort) query.sort = params.sort;
       return this.request("/execution/positions", {
         query: Object.keys(query).length > 0 ? query : void 0
       });
@@ -2449,6 +2498,7 @@ export {
   MarketStatus,
   MatchStatus,
   MatchType,
+  OPTIONAL_SIGNATURE_TIMEOUT_MS,
   OrderStatus,
   OrderType,
   RECURRENCE_CADENCES,

package/dist/market-data.d.mts

@@ -1,5 +1,5 @@
-import { C as ChartBarsResponse } from './agg-websocket-Cm_8f8hA.mjs';
-export { bD as CandleTail, ci as HistoryRangeRequest, M as MarketDataEngine, cp as MarketView, cq as MarketViewBatch } from './agg-websocket-Cm_8f8hA.mjs';
+import { C as ChartBarsResponse } from './agg-websocket-x_U4-orL.mjs';
+export { bE as CandleTail, cj as HistoryRangeRequest, M as MarketDataEngine, cr as MarketView, cs as MarketViewBatch } from './agg-websocket-x_U4-orL.mjs';
 
 /** Decode bounded dynamic history where processing lives; retain milliseconds and optional mean. */
 declare function decodeChartHistory(payload: string): ChartBarsResponse;

package/dist/market-data.d.ts

@@ -1,5 +1,5 @@
-import { C as ChartBarsResponse } from './agg-websocket-Cm_8f8hA.js';
-export { bD as CandleTail, ci as HistoryRangeRequest, M as MarketDataEngine, cp as MarketView, cq as MarketViewBatch } from './agg-websocket-Cm_8f8hA.js';
+import { C as ChartBarsResponse } from './agg-websocket-x_U4-orL.js';
+export { bE as CandleTail, cj as HistoryRangeRequest, M as MarketDataEngine, cr as MarketView, cs as MarketViewBatch } from './agg-websocket-x_U4-orL.js';
 
 /** Decode bounded dynamic history where processing lives; retain milliseconds and optional mean. */
 declare function decodeChartHistory(payload: string): ChartBarsResponse;