@agg-build/sdk 4.17.4 → 4.19.0

package/dist/index.js

@@ -90,6 +90,7 @@ __export(index_exports, {
   OrderStatus: () => OrderStatus,
   OrderType: () => OrderType,
   RECURRENCE_CADENCES: () => RECURRENCE_CADENCES,
+  RETINA_IMAGE_SIZES: () => RETINA_IMAGE_SIZES,
   SELF_CUSTODY_FILL_TIMEOUT_MS: () => SELF_CUSTODY_FILL_TIMEOUT_MS,
   SELF_CUSTODY_POLL_INTERVAL_MS: () => SELF_CUSTODY_POLL_INTERVAL_MS,
   TERMINAL_EXECUTION_STATES: () => TERMINAL_EXECUTION_STATES,
@@ -123,13 +124,17 @@ __export(index_exports, {
   isVenueActive: () => isVenueActive,
   isVenueDataVisible: () => isVenueDataVisible,
   isVenueInactive: () => isVenueInactive,
+  loadImmutableHistory: () => loadImmutableHistory,
   mergeCandles: () => mergeCandles,
   mergeClosedCandles: () => mergeClosedCandles,
   normalizeVenueMarketCluster: () => normalizeVenueMarketCluster,
   optimizedImageUrl: () => optimizedImageUrl,
+  orderbookCrc32: () => orderbookCrc32,
   parse: () => parse,
   parseEmail: () => parseEmail,
   parseEmailStrict: () => parseEmailStrict,
+  projectedOrderbookChecksum: () => projectedOrderbookChecksum,
+  retinaImageUrl: () => retinaImageUrl,
   safeParse: () => safeParse,
   snapshotToOrderbook: () => snapshotToOrderbook,
   sortVenues: () => sortVenues,
@@ -145,11 +150,13 @@ var Venue = /* @__PURE__ */ ((Venue3) => {
   Venue3["opinion"] = "opinion";
   Venue3["predict"] = "predict";
   Venue3["pred"] = "pred";
+  Venue3["tiprun"] = "tiprun";
   Venue3["probable"] = "probable";
   Venue3["myriad"] = "myriad";
   Venue3["hyperliquid"] = "hyperliquid";
   Venue3["novig"] = "novig";
   Venue3["prophetx"] = "prophetx";
+  Venue3["betdex"] = "betdex";
   return Venue3;
 })(Venue || {});
 var VENUES = [
@@ -159,11 +166,13 @@ var VENUES = [
   "opinion" /* opinion */,
   "predict" /* predict */,
   "pred" /* pred */,
+  "tiprun" /* tiprun */,
   "probable" /* probable */,
   "myriad" /* myriad */,
   "hyperliquid" /* hyperliquid */,
   "novig" /* novig */,
-  "prophetx" /* prophetx */
+  "prophetx" /* prophetx */,
+  "betdex" /* betdex */
 ];
 var VENUE_CHAIN_IDS = {
   ["kalshi" /* kalshi */]: 792703809,
@@ -171,6 +180,7 @@ var VENUE_CHAIN_IDS = {
   ["limitless" /* limitless */]: 8453,
   ["predict" /* predict */]: 56,
   ["pred" /* pred */]: 8453,
+  ["tiprun" /* tiprun */]: 42161,
   ["myriad" /* myriad */]: 56,
   ["hyperliquid" /* hyperliquid */]: 1337,
   ["novig" /* novig */]: 792703809,
@@ -183,14 +193,22 @@ var ACTIVE_VENUES = [
   "opinion" /* opinion */,
   "predict" /* predict */,
   "pred" /* pred */,
+  "tiprun" /* tiprun */,
   "probable" /* probable */,
   "myriad" /* myriad */,
   "hyperliquid" /* hyperliquid */,
   "novig" /* novig */,
-  "prophetx" /* prophetx */
+  "prophetx" /* prophetx */,
+  "betdex" /* betdex */
 ];
 var INACTIVE_VENUES = [];
-var DEFAULT_DISABLED_VENUES = ["pred" /* pred */, "novig" /* novig */, "prophetx" /* prophetx */];
+var DEFAULT_DISABLED_VENUES = [
+  "pred" /* pred */,
+  "tiprun" /* tiprun */,
+  "novig" /* novig */,
+  "prophetx" /* prophetx */,
+  "betdex" /* betdex */
+];
 var ACTIVE_VENUE_SET = new Set(ACTIVE_VENUES);
 var INACTIVE_VENUE_SET = new Set(INACTIVE_VENUES);
 function normalizeVenue(venue) {
@@ -226,10 +244,21 @@ var ImageSize = /* @__PURE__ */ ((ImageSize2) => {
   ImageSize2[ImageSize2["sm"] = 44] = "sm";
   ImageSize2[ImageSize2["md"] = 48] = "md";
   ImageSize2[ImageSize2["lg"] = 60] = "lg";
+  ImageSize2[ImageSize2["xl"] = 80] = "xl";
+  ImageSize2[ImageSize2["xxl"] = 96] = "xxl";
+  ImageSize2[ImageSize2["xxxl"] = 120] = "xxxl";
   ImageSize2[ImageSize2["original"] = 0] = "original";
   return ImageSize2;
 })(ImageSize || {});
-var IMAGE_SIZES = [44 /* sm */, 48 /* md */, 60 /* lg */];
+var IMAGE_SIZES = [
+  44 /* sm */,
+  48 /* md */,
+  60 /* lg */,
+  80 /* xl */,
+  96 /* xxl */,
+  120 /* xxxl */
+];
+var RETINA_IMAGE_SIZES = [80 /* xl */, 96 /* xxl */, 120 /* xxxl */];
 
 // ../common/src/enums/account.ts
 var AccountType = /* @__PURE__ */ ((AccountType2) => {
@@ -442,7 +471,7 @@ function computeBestSplitsByAmount(selections, side, maxDollarAmount) {
   if (selections.length === 0 || maxDollarAmount <= 0) {
     return { splits: [], totalSize: 0, totalCost: 0 };
   }
-  const levels = [];
+  const levels2 = [];
   for (const o of selections) {
     const venue = o.market.venue;
     const venueMarketOutcomeId = o.outcome.id;
@@ -451,7 +480,7 @@ function computeBestSplitsByAmount(selections, side, maxDollarAmount) {
       [...o.orderbook.asks].sort((a, b) => a.price - b.price).forEach(
         (l) => {
           var _a2;
-          return levels.push({
+          return levels2.push({
             venue,
             venueMarketOutcomeId,
             outcomeExternalIdentifier,
@@ -465,7 +494,7 @@ function computeBestSplitsByAmount(selections, side, maxDollarAmount) {
       [...o.orderbook.bids].sort((a, b) => b.price - a.price).forEach(
         (l) => {
           var _a2;
-          return levels.push({
+          return levels2.push({
             venue,
             venueMarketOutcomeId,
             outcomeExternalIdentifier,
@@ -477,10 +506,10 @@ function computeBestSplitsByAmount(selections, side, maxDollarAmount) {
       );
     }
   }
-  levels.sort((a, b) => a.price - b.price);
+  levels2.sort((a, b) => a.price - b.price);
   let totalCost = 0;
   const fills = [];
-  for (const l of levels) {
+  for (const l of levels2) {
     if (totalCost >= maxDollarAmount) break;
     const remainingBudget = maxDollarAmount - totalCost;
     const maxSizeAtLevel = Math.min(l.size, remainingBudget / l.price);
@@ -565,6 +594,13 @@ function optimizedImageUrl(url, maxPx) {
   const filename = variant === 0 /* original */ ? "original.webp" : `${variant}.webp`;
   return url.replace(VARIANT_RE, `/${filename}`);
 }
+function retinaImageUrl(url, maxPx) {
+  if (!url) return void 0;
+  if (!VARIANT_RE.test(url)) return void 0;
+  const variant = RETINA_IMAGE_SIZES.find((size) => size >= maxPx * 2);
+  if (variant == null) return void 0;
+  return url.replace(VARIANT_RE, `/${variant}.webp`);
+}
 
 // ../common/src/utils/venue-market-cluster.ts
 var toNonEmptyString = (value) => {
@@ -689,10 +725,12 @@ var VENUE_SORT_ORDER = [
   "hyperliquid" /* hyperliquid */,
   "predict" /* predict */,
   "prophetx" /* prophetx */,
+  "betdex" /* betdex */,
   "kalshi" /* kalshi */,
   "limitless" /* limitless */,
   "myriad" /* myriad */,
   "pred" /* pred */,
+  "tiprun" /* tiprun */,
   "probable" /* probable */,
   "novig" /* novig */,
   "opinion" /* opinion */
@@ -817,6 +855,93 @@ var isBalanceRefillWithinDailyCap = (minimumRaw, refillAmountRaw, dailyCapRaw, m
   return BigInt(minimumRaw) <= maximum && BigInt(refillAmountRaw) <= maximum;
 };
 
+// ../common/src/orderbook-checksum.ts
+function orderbookCrc32(value) {
+  let crc = 4294967295;
+  for (let i = 0; i < value.length; i++) {
+    crc ^= value.charCodeAt(i);
+    for (let bit = 0; bit < 8; bit++) crc = crc >>> 1 ^ (crc & 1 ? 3988292384 : 0);
+  }
+  return (crc ^ 4294967295) >>> 0;
+}
+function projectedOrderbookChecksum(book) {
+  let result = 0;
+  for (const level of book.bids) result ^= orderbookCrc32(`B${level.price}:${level.size}`);
+  for (const level of book.asks) result ^= orderbookCrc32(`A${level.price}:${level.size}`);
+  return result >>> 0;
+}
+
+// src/retry-after.ts
+function parseRetryAfterSeconds(value) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) return void 0;
+  const milliseconds = value * 1e3;
+  return Number.isSafeInteger(milliseconds) ? milliseconds : void 0;
+}
+function parseRetryAfterHeader(value, now = Date.now()) {
+  if (!value) return void 0;
+  const text = value.trim();
+  if (/^\d+$/.test(text)) return parseRetryAfterSeconds(Number(text));
+  if (!/^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), \d{2} (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) \d{4} \d{2}:\d{2}:\d{2} GMT$/.test(
+    text
+  ))
+    return void 0;
+  const timestamp = Date.parse(text);
+  if (!Number.isFinite(timestamp) || new Date(timestamp).toUTCString() !== text) return void 0;
+  const milliseconds = timestamp - now;
+  return Number.isSafeInteger(milliseconds) && milliseconds >= 0 ? milliseconds : void 0;
+}
+
+// src/market-data/history-decoder.ts
+function decodeChartHistory(payload) {
+  if (payload.length > 1048576) throw new Error("Chart history exceeds decode budget");
+  const body = JSON.parse(payload);
+  if (!body || !Array.isArray(body.data) || body.data.length > 5e3 || typeof body.venueMarketOutcomeId !== "string" || typeof body.venue !== "string" || !["1m", "5m", "1h", "1d"].includes(body.resolution) || !body.meta)
+    throw new Error("Invalid chart history response");
+  const price = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0 && value <= 1;
+  for (const bar of body.data) {
+    if (!Number.isSafeInteger(bar.t) || bar.t < 0 || ![bar.o, bar.h, bar.l, bar.c].every(price) || bar.l > Math.min(bar.o, bar.c) || bar.h < Math.max(bar.o, bar.c) || bar.v !== null && (!Number.isFinite(bar.v) || bar.v < 0) || bar.mean !== void 0 && !price(bar.mean))
+      throw new Error("Invalid chart history candle");
+  }
+  const data = [...body.data].sort((a, b) => a.t - b.t);
+  if (data.some((bar, index) => index > 0 && data[index - 1].t === bar.t))
+    throw new Error("Duplicate chart history timestamp");
+  return __spreadProps(__spreadValues({}, body), { data });
+}
+function readChartHistoryText(response) {
+  return __async(this, null, function* () {
+    var _a, _b;
+    const maxBytes = 1048576;
+    if (Number(response.headers.get("content-length")) > maxBytes) {
+      yield (_a = response.body) == null ? void 0 : _a.cancel();
+      throw new Error("Chart history exceeds decode budget");
+    }
+    if (!((_b = response.body) == null ? void 0 : _b.getReader)) {
+      const text2 = yield response.text();
+      if (new TextEncoder().encode(text2).byteLength > maxBytes)
+        throw new Error("Chart history exceeds decode budget");
+      return text2;
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let size = 0;
+    let text = "";
+    try {
+      while (true) {
+        const { value, done } = yield reader.read();
+        if (done) return text + decoder.decode();
+        size += value.byteLength;
+        if (size > maxBytes) {
+          yield reader.cancel();
+          throw new Error("Chart history exceeds decode budget");
+        }
+        text += decoder.decode(value, { stream: true });
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  });
+}
+
 // src/errors.ts
 var TurnstileChallengeError = class extends Error {
   constructor(siteKey) {
@@ -832,6 +957,7 @@ var AggApiError = class _AggApiError extends Error {
     this.status = status;
     if (init.code !== void 0) this.code = init.code;
     if (init.retryable !== void 0) this.retryable = init.retryable;
+    if (init.retryAfterMs !== void 0) this.retryAfterMs = init.retryAfterMs;
     if (init.errors !== void 0) this.errors = init.errors;
     Object.setPrototypeOf(this, _AggApiError.prototype);
   }
@@ -987,23 +1113,153 @@ var RECURRENCE_CADENCES = [
   "P1Y"
 ];
 
-// src/orderbook-utils.ts
-var PRICE_KEY_SCALE = 1e9;
-function crc32(str) {
-  let crc = 4294967295;
-  for (let i = 0; i < str.length; i++) {
-    crc ^= str.charCodeAt(i);
-    for (let j = 0; j < 8; j++) {
-      crc = crc >>> 1 ^ (crc & 1 ? 3988292384 : 0);
+// src/market-data/validate.ts
+var object = (value) => !!value && typeof value === "object" && !Array.isArray(value);
+var finite = (value) => typeof value === "number" && Number.isFinite(value);
+var nullable = (value) => value === null || finite(value);
+var levels = (value, attributed) => Array.isArray(value) && value.length <= 1e4 && value.every(
+  (level) => Array.isArray(level) && finite(level[0]) && level[0] >= 0 && finite(level[1]) && level[1] >= 0 && (!attributed || object(level[2]) && Object.values(level[2]).every((size) => finite(size) && size >= 0))
+);
+function validMarketFrame(frame) {
+  if (typeof frame.outcomeId !== "string" || !frame.outcomeId || !finite(frame.timestamp) || frame.timestamp < 0)
+    return false;
+  if (frame.type === "trade")
+    return finite(frame.price) && frame.price >= 0 && finite(frame.size) && frame.size >= 0 && typeof frame.venue === "string" && (frame.side === "buy" || frame.side === "sell");
+  if (!Number.isSafeInteger(frame.seq) || frame.seq < 0 || !Number.isInteger(frame.checksum) || frame.checksum < 0 || frame.checksum > 4294967295 || !nullable(frame.midpoint) || !nullable(frame.spread) || !object(frame.venues))
+    return false;
+  for (const info of Object.values(frame.venues))
+    if (!object(info) || !nullable(info.bestBid) || !nullable(info.bestAsk)) return false;
+  const snapshot = frame.type === "orderbook_snapshot";
+  if (!levels(frame[snapshot ? "bids" : "bidChanges"], true) || !levels(frame[snapshot ? "asks" : "askChanges"], true))
+    return false;
+  const books = frame[snapshot ? "venueOrderbooks" : "venueDeltaBooks"];
+  return object(books) && Object.values(books).every(
+    (book) => object(book) && levels(book[snapshot ? "bids" : "bidChanges"], false) && levels(book[snapshot ? "asks" : "askChanges"], false)
+  );
+}
+
+// src/market-history.ts
+function readBoundedBody(response, signal) {
+  return __async(this, null, function* () {
+    var _a, _b;
+    if (!response.body) throw new Error("Missing history body");
+    const reader = response.body.getReader();
+    const chunks = [];
+    let size = 0;
+    const abort = () => {
+      void reader.cancel(signal.reason).catch(() => void 0);
+    };
+    signal.addEventListener("abort", abort, { once: true });
+    try {
+      while (true) {
+        if (signal.aborted) throw (_a = signal.reason) != null ? _a : new Error("History request aborted");
+        const { done, value } = yield reader.read();
+        if (signal.aborted) throw (_b = signal.reason) != null ? _b : new Error("History request aborted");
+        if (done) break;
+        size += value.byteLength;
+        if (size > 262144) {
+          yield reader.cancel();
+          throw new Error("Oversized history object");
+        }
+        chunks.push(value);
+      }
+      const bytes = new Uint8Array(size);
+      let offset = 0;
+      for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+      }
+      return bytes;
+    } finally {
+      signal.removeEventListener("abort", abort);
+      reader.releaseLock();
     }
-  }
-  return (crc ^ 4294967295) >>> 0;
+  });
 }
+function loadImmutableHistory(_0) {
+  return __async(this, arguments, function* ({
+    manifest,
+    fetch: fetcher = globalThis.fetch,
+    signal,
+    digest
+  }) {
+    if (manifest.version !== 1 || !["venue-ohlcv-v1", "polymarket-price-samples-v1", "kalshi-ohlcv-quote-fallback-v2"].includes(
+      manifest.semantics
+    ) || manifest.chunks.length > 8 || manifest.chunks.reduce((n, c) => n + c.points, 0) > 4096 || !manifest.meta.complete) {
+      throw new Error("History manifest is incomplete or unsupported");
+    }
+    const hash = digest != null ? digest : ((bytes) => __async(null, null, function* () {
+      var _a;
+      if (!((_a = globalThis.crypto) == null ? void 0 : _a.subtle))
+        throw new Error(
+          "History integrity requires WebCrypto or an injected SHA-256 implementation"
+        );
+      const value = yield globalThis.crypto.subtle.digest("SHA-256", bytes);
+      return Array.from(new Uint8Array(value), (b) => b.toString(16).padStart(2, "0")).join("");
+    }));
+    const results = new Array(manifest.chunks.length);
+    let next = 0;
+    const controller = new AbortController();
+    const deadline = setTimeout(
+      () => controller.abort(new Error("History download budget exhausted")),
+      2e3
+    );
+    const abort = () => controller.abort(signal == null ? void 0 : signal.reason);
+    signal == null ? void 0 : signal.addEventListener("abort", abort, { once: true });
+    if (signal == null ? void 0 : signal.aborted) abort();
+    try {
+      yield Promise.all(
+        Array.from({ length: Math.min(2, manifest.chunks.length) }, () => __async(null, null, function* () {
+          var _a;
+          while (next < manifest.chunks.length) {
+            if (controller.signal.aborted)
+              throw (_a = controller.signal.reason) != null ? _a : new Error("History request aborted");
+            const index = next++;
+            const chunk = manifest.chunks[index];
+            if (chunk.points < 0 || chunk.points > 512 || chunk.from >= chunk.to || new URL(chunk.url).protocol !== "https:")
+              throw new Error("Invalid history reference");
+            const response = yield fetcher(chunk.url, {
+              signal: controller.signal,
+              credentials: "omit"
+            });
+            if (!response.ok) throw new Error(`History download failed (${response.status})`);
+            if (Number(response.headers.get("content-length")) > 262144)
+              throw new Error("Oversized history object");
+            const bytes = yield readBoundedBody(response, controller.signal);
+            if (bytes.byteLength > 262144 || (yield hash(bytes)) !== chunk.sha256)
+              throw new Error("History integrity mismatch");
+            const object2 = JSON.parse(new TextDecoder().decode(bytes));
+            if (object2.version !== 1 || object2.venueMarketOutcomeId !== manifest.venueMarketOutcomeId || object2.venue !== manifest.venue || object2.resolution !== manifest.resolution || object2.semantics !== manifest.semantics || object2.from !== chunk.from || object2.to !== chunk.to || !Array.isArray(object2.data) || object2.data.length !== chunk.points) {
+              throw new Error("History identity mismatch");
+            }
+            let previous = -Infinity;
+            for (const bar of object2.data) {
+              if (!Number.isSafeInteger(bar.t) || bar.t <= previous || bar.t < chunk.from || bar.t >= chunk.to || ![bar.o, bar.h, bar.l, bar.c].every((v) => Number.isFinite(v) && v >= 0 && v <= 1) || bar.l > Math.min(bar.o, bar.c) || bar.h < Math.max(bar.o, bar.c) || bar.v !== null && (!Number.isFinite(bar.v) || bar.v < 0) || bar.mean !== void 0 && (!Number.isFinite(bar.mean) || bar.mean < 0 || bar.mean > 1))
+                throw new Error("Invalid history candle");
+              previous = bar.t;
+            }
+            results[index] = object2.data;
+          }
+        }))
+      );
+      const bars = results.flat().filter((b) => b.t >= manifest.from && b.t < manifest.to).sort((a, b) => a.t - b.t);
+      if (bars.some((b, i) => i > 0 && bars[i - 1].t === b.t))
+        throw new Error("Overlapping history chunks");
+      return bars;
+    } catch (error) {
+      controller.abort(error);
+      throw error;
+    } finally {
+      clearTimeout(deadline);
+      signal == null ? void 0 : signal.removeEventListener("abort", abort);
+    }
+  });
+}
+
+// src/orderbook-utils.ts
+var PRICE_KEY_SCALE = 1e9;
 function computeChecksum(book) {
-  let checksum = 0;
-  for (const b of book.bids) checksum ^= crc32(`B${b.price}:${b.size}`);
-  for (const a of book.asks) checksum ^= crc32(`A${a.price}:${a.size}`);
-  return checksum >>> 0;
+  return projectedOrderbookChecksum(book);
 }
 function attributedToLevel(wire) {
   return { price: wire[0], size: wire[1], venues: __spreadValues({}, wire[2]) };
@@ -1088,8 +1344,8 @@ function applyOrderbookDelta(state, delta) {
 function toPriceKey(price) {
   return String(Math.round(price * PRICE_KEY_SCALE));
 }
-function applyChanges(levels, changes, sort) {
-  const levelsByPrice = new Map(levels.map((level) => [toPriceKey(level.price), level]));
+function applyChanges(levels2, changes, sort) {
+  const levelsByPrice = new Map(levels2.map((level) => [toPriceKey(level.price), level]));
   for (const [price, size, venues] of changes) {
     const key = toPriceKey(price);
     if (size === 0) {
@@ -1102,12 +1358,12 @@ function applyChanges(levels, changes, sort) {
       venues: __spreadValues({}, venues != null ? venues : {})
     });
   }
-  levels = [...levelsByPrice.values()];
-  levels.sort(sort === "desc" ? (a, b) => b.price - a.price : (a, b) => a.price - b.price);
-  return levels;
+  levels2 = [...levelsByPrice.values()];
+  levels2.sort(sort === "desc" ? (a, b) => b.price - a.price : (a, b) => a.price - b.price);
+  return levels2;
 }
-function applyVenueChanges(levels, changes, sort) {
-  const levelsByPrice = new Map(levels.map((level) => [toPriceKey(level.price), level]));
+function applyVenueChanges(levels2, changes, sort) {
+  const levelsByPrice = new Map(levels2.map((level) => [toPriceKey(level.price), level]));
   for (const [price, size] of changes) {
     const key = toPriceKey(price);
     if (size === 0) {
@@ -1116,9 +1372,9 @@ function applyVenueChanges(levels, changes, sort) {
     }
     levelsByPrice.set(key, { price, size });
   }
-  levels = [...levelsByPrice.values()];
-  levels.sort(sort === "desc" ? (a, b) => b.price - a.price : (a, b) => a.price - b.price);
-  return levels;
+  levels2 = [...levelsByPrice.values()];
+  levels2.sort(sort === "desc" ? (a, b) => b.price - a.price : (a, b) => a.price - b.price);
+  return levels2;
 }
 function mergeVenueLevelChanges(primary, fallback) {
   if (!(primary == null ? void 0 : primary.length)) return fallback ? [...fallback] : [];
@@ -1164,6 +1420,121 @@ function deriveVenueChangesFromAttributedChanges(previousLevels, changes) {
   }
   return venueChanges;
 }
+var IndexedOrderbook = class {
+  constructor(state) {
+    this.venueBooks = /* @__PURE__ */ new Map();
+    this.bids = new Map(state.bids.map((level) => [toPriceKey(level.price), level]));
+    this.asks = new Map(state.asks.map((level) => [toPriceKey(level.price), level]));
+    for (const [venue, book] of Object.entries(state.venueOrderbooks)) {
+      this.venueBooks.set(venue, {
+        bids: new Map(book.bids.map((level) => [toPriceKey(level.price), level])),
+        asks: new Map(book.asks.map((level) => [toPriceKey(level.price), level]))
+      });
+    }
+    const _a = state, { bids: _bids, asks: _asks, venueOrderbooks: _venueBooks } = _a, metadata = __objRest(_a, ["bids", "asks", "venueOrderbooks"]);
+    this.metadata = metadata;
+    this.cached = state;
+    this.checksumValue = computeChecksum(state);
+  }
+  get seq() {
+    return this.metadata.seq;
+  }
+  get checksum() {
+    return this.checksumValue;
+  }
+  /** Verify before committing, including duplicate-price changes within a frame. */
+  apply(delta) {
+    var _a;
+    let checksum = this.checksumValue;
+    for (const [levels2, changes, side] of [
+      [this.bids, delta.bidChanges, "B"],
+      [this.asks, delta.askChanges, "A"]
+    ]) {
+      const changed = /* @__PURE__ */ new Map();
+      for (const [price, size, venues] of changes) {
+        const key = toPriceKey(price);
+        const previous = changed.has(key) ? changed.get(key) : levels2.get(key);
+        if (previous) checksum ^= orderbookCrc32(`${side}${previous.price}:${previous.size}`);
+        if (size !== 0) checksum ^= orderbookCrc32(`${side}${price}:${size}`);
+        changed.set(key, size === 0 ? void 0 : { price, size, venues: __spreadValues({}, venues) });
+      }
+    }
+    checksum >>>= 0;
+    if (checksum !== delta.checksum) return checksum;
+    const previousBids = delta.bidChanges.flatMap(
+      ([price]) => {
+        var _a2;
+        return (_a2 = this.bids.get(toPriceKey(price))) != null ? _a2 : [];
+      }
+    );
+    const previousAsks = delta.askChanges.flatMap(
+      ([price]) => {
+        var _a2;
+        return (_a2 = this.asks.get(toPriceKey(price))) != null ? _a2 : [];
+      }
+    );
+    const impliedBids = deriveVenueChangesFromAttributedChanges(previousBids, delta.bidChanges);
+    const impliedAsks = deriveVenueChangesFromAttributedChanges(previousAsks, delta.askChanges);
+    for (const venue of /* @__PURE__ */ new Set([
+      ...Object.keys(delta.venueDeltaBooks),
+      ...Object.keys(impliedBids),
+      ...Object.keys(impliedAsks)
+    ])) {
+      let book = this.venueBooks.get(venue);
+      if (!book) {
+        book = { bids: /* @__PURE__ */ new Map(), asks: /* @__PURE__ */ new Map() };
+        this.venueBooks.set(venue, book);
+      }
+      const explicit = delta.venueDeltaBooks[venue];
+      for (const [levels2, changes] of [
+        [book.bids, mergeVenueLevelChanges(explicit == null ? void 0 : explicit.bidChanges, impliedBids[venue])],
+        [book.asks, mergeVenueLevelChanges(explicit == null ? void 0 : explicit.askChanges, impliedAsks[venue])]
+      ]) {
+        for (const [price, size] of changes) {
+          if (size === 0) levels2.delete(toPriceKey(price));
+          else levels2.set(toPriceKey(price), { price, size });
+        }
+      }
+    }
+    for (const [levels2, changes] of [
+      [this.bids, delta.bidChanges],
+      [this.asks, delta.askChanges]
+    ]) {
+      for (const [price, size, venues] of changes) {
+        if (size === 0) levels2.delete(toPriceKey(price));
+        else levels2.set(toPriceKey(price), { price, size, venues: __spreadValues({}, venues) });
+      }
+    }
+    this.metadata = __spreadProps(__spreadValues({}, this.metadata), {
+      outcomeId: (_a = this.metadata.outcomeId) != null ? _a : delta.outcomeId,
+      venues: __spreadValues(__spreadValues({}, this.metadata.venues), delta.venues),
+      midpoint: delta.midpoint,
+      spread: delta.spread,
+      seq: delta.seq,
+      checksum: delta.checksum,
+      timestamp: delta.timestamp
+    });
+    this.checksumValue = checksum;
+    this.cached = null;
+    return checksum;
+  }
+  view() {
+    if (this.cached) return this.cached;
+    const bids = (levels2) => [...levels2.values()].sort((a, b) => b.price - a.price);
+    const asks = (levels2) => [...levels2.values()].sort((a, b) => a.price - b.price);
+    this.cached = __spreadProps(__spreadValues({}, this.metadata), {
+      bids: bids(this.bids),
+      asks: asks(this.asks),
+      venueOrderbooks: Object.fromEntries(
+        [...this.venueBooks].map(([venue, book]) => [
+          venue,
+          { bids: bids(book.bids), asks: asks(book.asks) }
+        ])
+      )
+    });
+    return this.cached;
+  }
+};
 
 // src/agg-websocket.ts
 var RECONNECT_BASE_MS = 1e3;
@@ -1203,20 +1574,74 @@ var AggWebSocket = class {
     this.staleTimer = null;
     this.lastMessageTime = 0;
     this.destroyed = false;
-    var _a, _b;
+    this.historyControllers = /* @__PURE__ */ new Set();
+    var _a, _b, _c;
+    this.deferBookViews = (_a = options.deferBookViews) != null ? _a : false;
     this.url = options.url;
-    this.callbacks = (_a = options.callbacks) != null ? _a : {};
+    this.callbacks = (_b = options.callbacks) != null ? _b : {};
     this.initialToken = options.initialToken;
-    this.enableLogs = (_b = options.enableLogs) != null ? _b : false;
+    this.enableLogs = (_c = options.enableLogs) != null ? _c : false;
   }
   // ── Public API ──
   get connected() {
     return this._connected;
   }
+  /** Decode dynamic authenticated REST bytes in the same processing environment as live data. */
+  decodeHistory(payload) {
+    return __async(this, null, function* () {
+      return decodeChartHistory(payload);
+    });
+  }
+  /** Immutable history decoder. Browser adapters execute this inside their Worker. */
+  loadHistory(manifest, options) {
+    return __async(this, null, function* () {
+      var _a, _b, _c;
+      if (this.destroyed) throw new Error("Market-data client disposed");
+      const controller = new AbortController();
+      const abort = () => {
+        var _a2;
+        return controller.abort((_a2 = options == null ? void 0 : options.signal) == null ? void 0 : _a2.reason);
+      };
+      (_a = options == null ? void 0 : options.signal) == null ? void 0 : _a.addEventListener("abort", abort, { once: true });
+      if ((_b = options == null ? void 0 : options.signal) == null ? void 0 : _b.aborted) abort();
+      this.historyControllers.add(controller);
+      try {
+        controller.signal.throwIfAborted();
+        const result = yield loadImmutableHistory({ manifest, signal: controller.signal });
+        controller.signal.throwIfAborted();
+        return result;
+      } finally {
+        this.historyControllers.delete(controller);
+        (_c = options == null ? void 0 : options.signal) == null ? void 0 : _c.removeEventListener("abort", abort);
+      }
+    });
+  }
+  /** Optional framework-independent host diagnostics, cleared on disposal. */
+  setHostDiagnostics(provider) {
+    this.hostDiagnostics = provider;
+  }
+  /** On-demand ownership diagnostics; contains no credentials or user/account data. */
+  getDiagnostics() {
+    var _a;
+    return {
+      connected: this.connected,
+      host: (_a = this.hostDiagnostics) == null ? void 0 : _a.call(this),
+      transport: this.destroyed ? "disposed" : "direct",
+      orderbookOutcomeIds: this.activeOrderbookMarkets(),
+      tradeOutcomeIds: this.activeTradeMarkets(),
+      arbMarketIds: this.activeArbMarkets(),
+      arbFeedSubscribers: this.arbFeedCbs.size,
+      cachedBooks: this.books.size,
+      cachedArb: this.latestArb.size,
+      resyncingBooks: this.resyncing.size,
+      pendingResnapshots: this.pendingResnapshots.size,
+      pendingHistoryRequests: this.historyControllers.size
+    };
+  }
   /** Get the current orderbook state for an outcome (or null if no snapshot received yet). */
   getBook(outcomeId) {
-    var _a;
-    return (_a = this.books.get(outcomeId)) != null ? _a : null;
+    var _a, _b;
+    return (_b = (_a = this.books.get(outcomeId)) == null ? void 0 : _a.view()) != null ? _b : null;
   }
   /** Whether an outcome is currently resyncing (waiting for fresh snapshot). */
   isResyncing(outcomeId) {
@@ -1299,6 +1724,8 @@ var AggWebSocket = class {
     if (!sub) {
       sub = { refCount: 0, tradeRefs: 0 };
       this.subs.set(outcomeId, sub);
+    }
+    if (sub.refCount === 0) {
       this.pendingSubs.add(outcomeId);
       this.ensureConnected();
       if (this._connected) {
@@ -1309,13 +1736,19 @@ var AggWebSocket = class {
       }
     }
     sub.refCount++;
+    let released = false;
     return () => {
+      if (released) return;
+      released = true;
       const s = this.subs.get(outcomeId);
       if (!s) return;
       s.refCount--;
-      if (s.refCount <= 0 && s.tradeRefs <= 0) {
-        this.subs.delete(outcomeId);
-        this.books.delete(outcomeId);
+      if (s.refCount <= 0) {
+        s.refCount = 0;
+        if (s.tradeRefs <= 0) {
+          this.subs.delete(outcomeId);
+          this.books.delete(outcomeId);
+        }
         this.resyncing.delete(outcomeId);
         if (this._connected) {
           if (this.pendingFlushSubs.has(outcomeId)) {
@@ -1355,7 +1788,10 @@ var AggWebSocket = class {
       }
     }
     sub.tradeRefs++;
+    let released = false;
     return () => {
+      if (released) return;
+      released = true;
       const s = this.subs.get(outcomeId);
       if (!s) return;
       s.tradeRefs--;
@@ -1373,6 +1809,8 @@ var AggWebSocket = class {
         this.pendingResnapshots.delete(outcomeId);
         if (s.refCount <= 0) {
           this.subs.delete(outcomeId);
+          this.books.delete(outcomeId);
+          this.resyncing.delete(outcomeId);
         }
       }
     };
@@ -1411,7 +1849,12 @@ var AggWebSocket = class {
   /** Permanently destroy. Cannot reconnect after this. */
   destroy() {
     this.destroyed = true;
+    for (const controller of this.historyControllers)
+      controller.abort(new Error("Market-data client disposed"));
+    this.historyControllers.clear();
     this.disconnect();
+    this.hostDiagnostics = void 0;
+    this.callbacks = {};
     this.subs.clear();
     this.books.clear();
     this.resyncing.clear();
@@ -1446,6 +1889,7 @@ var AggWebSocket = class {
     const ws = new WebSocket(this.url);
     this.ws = ws;
     ws.onopen = () => {
+      if (this.destroyed || this.ws !== ws) return;
       this.connecting = false;
       this.reconnectAttempts = 0;
       this.resetStaleTimer();
@@ -1454,7 +1898,10 @@ var AggWebSocket = class {
       }
     };
     ws.onmessage = (event) => {
+      var _a, _b;
+      if (this.destroyed || this.ws !== ws) return;
       this.lastMessageTime = Date.now();
+      (_b = (_a = this.callbacks).onFrameReceived) == null ? void 0 : _b.call(_a, this.lastMessageTime);
       this.resetStaleTimer();
       try {
         const raw = JSON.parse(event.data);
@@ -1517,8 +1964,14 @@ var AggWebSocket = class {
   }
   // ── Message handling ──
   handleMessage(raw) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r;
     const type = raw.type;
+    if (["orderbook_snapshot", "orderbook_delta", "trade"].includes(type) && !validMarketFrame(raw)) {
+      (_b = (_a = this.callbacks).onError) == null ? void 0 : _b.call(_a, { type: "error", message: "Invalid market-data frame" });
+      if (typeof raw.outcomeId === "string" && this.subs.has(raw.outcomeId))
+        this.requestResnapshot(raw.outcomeId);
+      return;
+    }
     switch (type) {
       case "orderbook_snapshot":
         this.handleSnapshot(raw);
@@ -1533,22 +1986,22 @@ var AggWebSocket = class {
         this.handleHeartbeat(raw);
         break;
       case "subscribed":
-        (_b = (_a = this.callbacks).onSubscribed) == null ? void 0 : _b.call(_a, raw);
+        (_d = (_c = this.callbacks).onSubscribed) == null ? void 0 : _d.call(_c, raw);
         break;
       case "unsubscribed":
-        (_d = (_c = this.callbacks).onUnsubscribed) == null ? void 0 : _d.call(_c, raw);
+        (_f = (_e = this.callbacks).onUnsubscribed) == null ? void 0 : _f.call(_e, raw);
         break;
       case "connected":
         this.handleConnected(raw);
         break;
       case "authenticated":
-        (_f = (_e = this.callbacks).onAuthenticated) == null ? void 0 : _f.call(_e, raw);
+        (_h = (_g = this.callbacks).onAuthenticated) == null ? void 0 : _h.call(_g, raw);
         break;
       case "market_resolved":
         this.handleMarketResolved(raw);
         break;
       case "error":
-        (_h = (_g = this.callbacks).onError) == null ? void 0 : _h.call(_g, raw);
+        (_j = (_i = this.callbacks).onError) == null ? void 0 : _j.call(_i, raw);
         break;
       case "order_submitted":
         this.handleOrderSubmitted(raw);
@@ -1557,13 +2010,13 @@ var AggWebSocket = class {
         this.handleBalanceUpdate(raw);
         break;
       case "order_event":
-        (_j = (_i = this.callbacks).onOrderEvent) == null ? void 0 : _j.call(_i, raw);
+        (_l = (_k = this.callbacks).onOrderEvent) == null ? void 0 : _l.call(_k, raw);
         break;
       case "redeem_event":
         this.handleRedeemEvent(raw);
         break;
       case "withdrawal_lifecycle":
-        (_l = (_k = this.callbacks).onWithdrawalLifecycle) == null ? void 0 : _l.call(_k, raw);
+        (_n = (_m = this.callbacks).onWithdrawalLifecycle) == null ? void 0 : _n.call(_m, raw);
         break;
       case "arb_market_update": {
         const arbMsg = raw;
@@ -1572,13 +2025,13 @@ var AggWebSocket = class {
         if (arbEntry) {
           for (const cb of arbEntry.cbs) cb(arbMsg);
         }
-        (_n = (_m = this.callbacks).onArbMarket) == null ? void 0 : _n.call(_m, arbMsg);
+        (_p = (_o = this.callbacks).onArbMarket) == null ? void 0 : _p.call(_o, arbMsg);
         break;
       }
       case "arb_feed_batch": {
         const feedMsg = raw;
         for (const cb of this.arbFeedCbs) cb(feedMsg);
-        (_p = (_o = this.callbacks).onArbFeed) == null ? void 0 : _p.call(_o, feedMsg);
+        (_r = (_q = this.callbacks).onArbFeed) == null ? void 0 : _r.call(_q, feedMsg);
         break;
       }
     }
@@ -1630,10 +2083,11 @@ var AggWebSocket = class {
     }
   }
   handleSnapshot(raw) {
-    var _a, _b;
+    var _a, _b, _c, _d;
+    if (!this.subs.has(raw.outcomeId)) return;
     const msg = __spreadProps(__spreadValues({}, raw), { timestamp: raw.timestamp / 1e3 });
     const book = snapshotToOrderbook(msg);
-    this.books.set(msg.outcomeId, book);
+    this.books.set(msg.outcomeId, new IndexedOrderbook(book));
     this.resyncing.delete(msg.outcomeId);
     this.pendingResnapshots.delete(msg.outcomeId);
     this.debugOrderbook("snapshot_applied", {
@@ -1643,29 +2097,18 @@ var AggWebSocket = class {
       bidsTop: this.summarizeTopLevels(book.bids),
       asksTop: this.summarizeTopLevels(book.asks)
     });
-    (_b = (_a = this.callbacks).onSnapshot) == null ? void 0 : _b.call(_a, msg.outcomeId, book);
+    (_b = (_a = this.callbacks).onBookTick) == null ? void 0 : _b.call(_a, msg.outcomeId, {
+      midpoint: msg.midpoint,
+      timestamp: msg.timestamp,
+      source: "snapshot"
+    });
+    if (!this.deferBookViews) (_d = (_c = this.callbacks).onSnapshot) == null ? void 0 : _d.call(_c, msg.outcomeId, book);
   }
   handleDelta(raw) {
-    var _a, _b;
+    var _a, _b, _c, _d;
+    if (!this.subs.has(raw.outcomeId)) return;
     const outcomeId = raw.outcomeId;
     const current = this.books.get(outcomeId);
-    const deltaTop = {
-      bids: raw.bidChanges.slice(0, ORDERBOOK_DEBUG_TOP_LEVELS).map(([price, size]) => ({
-        price,
-        size
-      })),
-      asks: raw.askChanges.slice(0, ORDERBOOK_DEBUG_TOP_LEVELS).map(([price, size]) => ({
-        price,
-        size
-      }))
-    };
-    this.debugOrderbook("delta_received", {
-      outcomeId,
-      seq: raw.seq,
-      checksum: raw.checksum,
-      hasCurrentBook: Boolean(current),
-      deltaTop
-    });
     if (!current) {
       this.debugOrderbook("delta_missing_snapshot", { outcomeId, seq: raw.seq });
       this.requestResnapshot(outcomeId);
@@ -1696,21 +2139,7 @@ var AggWebSocket = class {
       return;
     }
     const msg = __spreadProps(__spreadValues({}, raw), { timestamp: raw.timestamp / 1e3 });
-    const newBook = applyOrderbookDelta(current, msg);
-    this.debugOrderbook("delta_applied_locally", {
-      outcomeId,
-      fromSeq: current.seq,
-      toSeq: newBook.seq,
-      beforeTop: {
-        bids: this.summarizeTopLevels(current.bids),
-        asks: this.summarizeTopLevels(current.asks)
-      },
-      afterTop: {
-        bids: this.summarizeTopLevels(newBook.bids),
-        asks: this.summarizeTopLevels(newBook.asks)
-      }
-    });
-    const computed = computeChecksum(newBook);
+    const computed = current.apply(msg);
     if (computed !== msg.checksum) {
       this.debugOrderbook("delta_checksum_mismatch", {
         outcomeId,
@@ -1728,18 +2157,16 @@ var AggWebSocket = class {
       this.requestResnapshot(outcomeId);
       return;
     }
-    this.books.set(outcomeId, newBook);
-    this.debugOrderbook("delta_committed", {
-      outcomeId,
-      seq: newBook.seq,
-      checksum: newBook.checksum,
-      bidsTop: this.summarizeTopLevels(newBook.bids),
-      asksTop: this.summarizeTopLevels(newBook.asks)
+    (_b = (_a = this.callbacks).onBookTick) == null ? void 0 : _b.call(_a, outcomeId, {
+      midpoint: msg.midpoint,
+      timestamp: msg.timestamp,
+      source: "delta"
     });
-    (_b = (_a = this.callbacks).onDelta) == null ? void 0 : _b.call(_a, outcomeId, newBook);
+    if (!this.deferBookViews) (_d = (_c = this.callbacks).onDelta) == null ? void 0 : _d.call(_c, outcomeId, current.view());
   }
   handleTrade(raw) {
     var _a, _b;
+    if (!this.subs.has(raw.outcomeId)) return;
     const msg = __spreadProps(__spreadValues({}, raw), { timestamp: raw.timestamp / 1e3 });
     (_b = (_a = this.callbacks).onTrade) == null ? void 0 : _b.call(_a, msg);
   }
@@ -1900,8 +2327,8 @@ var AggWebSocket = class {
     var _a, _b;
     (_b = (_a = this.callbacks).onDiagnostics) == null ? void 0 : _b.call(_a, event);
   }
-  summarizeTopLevels(levels) {
-    return levels.slice(0, ORDERBOOK_DEBUG_TOP_LEVELS).map((level) => ({ price: level.price, size: level.size }));
+  summarizeTopLevels(levels2) {
+    return levels2.slice(0, ORDERBOOK_DEBUG_TOP_LEVELS).map((level) => ({ price: level.price, size: level.size }));
   }
   debugOrderbook(event, payload) {
     if (!this.isOrderbookDebugEnabled()) return;
@@ -2002,7 +2429,7 @@ var AggClient = class {
     this.authChannel = null;
     /** In-flight refresh promise — serializes concurrent 401 retries so only one refresh runs. */
     this.pendingRefresh = null;
-    var _a, _b;
+    var _a, _b, _c;
     if (!options.appId && !options.adminKey) {
       throw new Error("AggClient requires at least one of appId or adminKey");
     }
@@ -2012,9 +2439,11 @@ var AggClient = class {
     this.signer = options.signer;
     this.baseUrl = options.baseUrl.replace(/\/$/, "");
     this.wsUrl = options.wsUrl;
+    this.preferImmutableHistory = (_a = options.preferImmutableHistory) != null ? _a : false;
+    this.webSocketFactory = options.webSocketFactory;
     this.authOptions = options.auth;
-    this.storageKey = `agg_auth_${(_a = this._appId) != null ? _a : "default"}`;
-    this.authDelivery = (_b = options.authDelivery) != null ? _b : "body";
+    this.storageKey = `agg_auth_${(_b = this._appId) != null ? _b : "default"}`;
+    this.authDelivery = (_c = options.authDelivery) != null ? _c : "body";
     this.shouldPersistSession = options.persistSession !== false;
     this.restoreSession();
     this.initAuthChannel();
@@ -2142,7 +2571,7 @@ var AggClient = class {
    * @param path - API path (e.g. `/venue-events`)
    * @param init - Fetch init options, plus optional `query` object for URL search params
    */
-  request(path, init) {
+  request(path, init, decode) {
     return __async(this, null, function* () {
       const response = yield this.rawFetch(path, init);
       if (response.status === 401 && this.accessToken && !AUTH_PATHS.has(path)) {
@@ -2153,7 +2582,7 @@ var AggClient = class {
             return this.throwResponseError(retryResponse);
           }
           if (retryResponse.status === 204) return void 0;
-          return retryResponse.json();
+          return decode ? decode(retryResponse) : retryResponse.json();
         } catch (e) {
           this.clearAccessToken();
           return this.throwResponseError(response);
@@ -2163,7 +2592,7 @@ var AggClient = class {
         return this.throwResponseError(response);
       }
       if (response.status === 204) return void 0;
-      return response.json();
+      return decode ? decode(response) : response.json();
     });
   }
   rawFetch(path, init) {
@@ -2200,12 +2629,15 @@ var AggClient = class {
   }
   throwResponseError(response) {
     return __async(this, null, function* () {
+      var _a;
       let message = response.status === 404 ? "Market not found" : `AGG API error: ${response.status} ${response.statusText}`;
       let code;
       let retryable;
+      let retryAfterMs = parseRetryAfterHeader((_a = response.headers) == null ? void 0 : _a.get("Retry-After"));
       let errors;
       try {
         const body = yield response.json();
+        retryAfterMs != null ? retryAfterMs : retryAfterMs = parseRetryAfterSeconds(body == null ? void 0 : body.retryAfter);
         if (typeof body.message === "string" && body.message.length > 0) {
           message = body.message;
         }
@@ -2224,7 +2656,7 @@ var AggClient = class {
         }
       } catch (e) {
       }
-      throw new AggApiError(message, response.status, { code, retryable, errors });
+      throw new AggApiError(message, response.status, { code, retryable, retryAfterMs, errors });
     });
   }
   /**
@@ -2651,14 +3083,19 @@ Issued At: ${issuedAt}`;
    *
    * Pass `quoteId` to fetch every leg of a multi-venue split route in
    * one call — `useQuoteSummary(quoteId)` reduces the list into a
-   * rollup (total cost, share-weighted avg price, to-win).
+   * rollup (total cost, share-weighted avg price, to-win). Pass
+   * `venueMarketIds` to narrow to the orders on those markets. Sent as
+   * repeated params in one request; batch long lists yourself (or use
+   * `useExecutionOrdersForMarkets`) to keep the URL short.
    */
   getExecutionOrders() {
     return __async(this, arguments, function* (params = {}) {
+      var _a;
       const query = {};
       if (params.orderId) query.orderId = params.orderId;
       if (params.quoteId) query.quoteId = params.quoteId;
       if (params.externalId) query.externalId = params.externalId;
+      if ((_a = params.venueMarketIds) == null ? void 0 : _a.length) query.venueMarketIds = params.venueMarketIds;
       if (params.status) query.status = params.status;
       if (params.orderType) query.orderType = params.orderType;
       if (params.mode) query.mode = params.mode;
@@ -2695,6 +3132,23 @@ Issued At: ${issuedAt}`;
       });
     });
   }
+  /**
+   * Per-app trader leaderboard ranked by realized P&L or volume over an
+   * inclusive UTC day range. `rank` is exact within the top 100.
+   */
+  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;
+      if (params.limit != null) query.limit = String(params.limit);
+      if (params.cursor) query.cursor = params.cursor;
+      return this.request("/leaderboard", {
+        query: Object.keys(query).length ? query : void 0
+      });
+    });
+  }
   /** List execution positions for the authenticated user (cursor pagination). */
   getExecutionPositions() {
     return __async(this, arguments, function* (params = {}) {
@@ -2708,16 +3162,92 @@ Issued At: ${issuedAt}`;
       });
     });
   }
-  /** Get managed wallet balances, including per-chain cash balances and per-venue position balances. */
+  /**
+   * Get cash balances and per-venue position balances.
+   *
+   * `custody: "self"` returns the wallets linked to this account — plus their
+   * Polymarket deposit and legacy wallets — instead of the managed wallet. Each
+   * chain row then carries `address` and `custodyKind`; `positions` is
+   * account-wide either way.
+   *
+   * Caveat on the headline number: a chain row with `custodyKind:
+   * "POLYMARKET_LEGACY"` and `legacyKind: "proxy"` holds funds that can only
+   * be spent on Polymarket, but it still counts towards its token's
+   * `totalRaw`/`availableRaw` (a token's totals are always the sum of its
+   * chain rows). If you show "spendable anywhere", subtract those rows.
+   */
   getManagedBalances() {
     return __async(this, arguments, function* (params = {}) {
       const query = {};
       if (params.mode) query.mode = params.mode;
+      if (params.custody) query.custody = params.custody;
       return this.request("/execution/balances", {
         query: Object.keys(query).length ? query : void 0
       });
     });
   }
+  /** Read hosted custody status without creating a signing wallet or account. */
+  getHostedVenueAccount(_0) {
+    return __async(this, arguments, function* (venue, params = {}) {
+      return this.request(
+        `/users/me/venue-accounts/${encodeURIComponent(venue)}`,
+        {
+          query: params.mode ? { mode: params.mode } : void 0
+        }
+      );
+    });
+  }
+  /** Owned exact ledger entries; not balances, fill fees or withdrawal finality. */
+  getHostedVenueActivity(_0) {
+    return __async(this, arguments, function* (venue, params = {}) {
+      return this.request(
+        `/users/me/venue-accounts/${encodeURIComponent(venue)}/activity`,
+        {
+          query: __spreadValues(__spreadValues({}, params.mode ? { mode: params.mode } : {}), params.page !== void 0 ? { page: String(params.page) } : {})
+        }
+      );
+    });
+  }
+  /** Explicit hosted-account creation; no signing wallet or credential upload. */
+  provisionHostedVenueAccount(venue, body) {
+    return __async(this, null, function* () {
+      return this.request(
+        `/users/me/venue-accounts/${encodeURIComponent(venue)}`,
+        {
+          method: "POST",
+          body: JSON.stringify(body)
+        }
+      );
+    });
+  }
+  /** Fetch the owned hosted account's verified Solana USDC deposit address. */
+  getHostedVenueDepositAddress(_0) {
+    return __async(this, arguments, function* (venue, params = {}) {
+      return this.request(
+        `/users/me/venue-accounts/${encodeURIComponent(venue)}/deposit-address`,
+        { query: params.mode ? { mode: params.mode } : void 0 }
+      );
+    });
+  }
+  /** Submit exactly one explicit hosted withdrawal under a caller idempotency key. */
+  withdrawHostedVenue(venue, body) {
+    return __async(this, null, function* () {
+      return this.request(
+        `/users/me/venue-accounts/${encodeURIComponent(venue)}/withdrawals`,
+        { method: "POST", body: JSON.stringify(body) }
+      );
+    });
+  }
+  /** Read only Agg's persisted withdrawal state; this never replays a native request. */
+  getHostedVenueWithdrawal(_0, _1) {
+    return __async(this, arguments, function* (venue, withdrawalId, params = {}) {
+      if (!withdrawalId) throw new Error("withdrawalId is required");
+      return this.request(
+        `/users/me/venue-accounts/${encodeURIComponent(venue)}/withdrawals/${encodeURIComponent(withdrawalId)}`,
+        { query: params.mode ? { mode: params.mode } : void 0 }
+      );
+    });
+  }
   /** Store or replace encrypted credentials for a venue. Secrets are never returned. */
   upsertVenueKey(body) {
     return __async(this, null, function* () {
@@ -2840,21 +3370,32 @@ Issued At: ${issuedAt}`;
     });
   }
   /**
-   * Cancel an execution by order id. Self-custody needs Polymarket ClobAuth
+   * Cancel an agg order by id. Self-custody needs Polymarket ClobAuth
    * or a fresh Hyperliquid cancel action signed by the EOA/client-held agent.
    */
   cancelManagedOrder(orderId, options) {
     return __async(this, null, function* () {
-      return this.request(
-        `/execution/orders/${encodeURIComponent(orderId)}/cancel`,
-        {
-          method: "POST",
-          body: JSON.stringify(
-            (options == null ? void 0 : options.cancelSignature) ? { cancelSignature: options.cancelSignature } : {}
-          ),
-          signal: options == null ? void 0 : options.signal
-        }
-      );
+      return this.request("/execution/orders/cancel", {
+        method: "POST",
+        body: JSON.stringify(__spreadValues({
+          orderId
+        }, (options == null ? void 0 : options.cancelSignature) ? { cancelSignature: options.cancelSignature } : {})),
+        signal: options == null ? void 0 : options.signal
+      });
+    });
+  }
+  /**
+   * Cancel a Polymarket or Hyperliquid limit order that one of the user's
+   * linked self-custody wallets placed outside AGG. `signerAddress` must be
+   * that wallet and must have produced `cancelSignature`.
+   */
+  cancelVenueOrder(params, options) {
+    return __async(this, null, function* () {
+      return this.request("/execution/orders/cancel", {
+        method: "POST",
+        body: JSON.stringify(params),
+        signal: options == null ? void 0 : options.signal
+      });
     });
   }
   // --- Venue events & venue markets (primary) ---
@@ -2887,6 +3428,17 @@ Issued At: ${issuedAt}`;
     });
   }
   /** Get a single venue event by ID. Requires appId or admin auth. */
+  getEventBootstrap(eventId, options) {
+    return __async(this, null, function* () {
+      return this.request(
+        `/venue-events/${encodeURIComponent(eventId)}/bootstrap`,
+        {
+          query: (options == null ? void 0 : options.limit) ? { limit: String(options.limit) } : void 0,
+          signal: options == null ? void 0 : options.signal
+        }
+      );
+    });
+  }
   getVenueEventById(id, options) {
     return __async(this, null, function* () {
       return this.request(`/venue-events/${encodeURIComponent(id)}`, {
@@ -3015,14 +3567,15 @@ Issued At: ${issuedAt}`;
     });
   }
   /** List venue markets with optional filters. Requires appId or admin auth. Supports cursor-based pagination. */
-  getVenueMarkets(options) {
+  getVenueMarkets(options, requestOptions) {
     return __async(this, null, function* () {
-      var _a;
+      var _a, _b;
       const query = {};
       if (options == null ? void 0 : options.venue) query.venue = options.venue;
+      if ((_a = options == null ? void 0 : options.externalIdentifier) == null ? void 0 : _a.length) query.externalIdentifier = options.externalIdentifier;
       if (options == null ? void 0 : options.venueEventId) query.venueEventId = options.venueEventId;
       if ((options == null ? void 0 : options.cluster) === false) query.cluster = "false";
-      if ((_a = options == null ? void 0 : options.search) == null ? void 0 : _a.trim()) query.search = options.search.trim();
+      if ((_b = options == null ? void 0 : options.search) == null ? void 0 : _b.trim()) query.search = options.search.trim();
       if (options == null ? void 0 : options.matchStatus) query.matchStatus = options.matchStatus;
       if (options == null ? void 0 : options.status) query.status = options.status;
       if ((options == null ? void 0 : options.aggKey) && options.aggKey.length > 0) query.aggKey = options.aggKey;
@@ -3042,7 +3595,8 @@ Issued At: ${issuedAt}`;
       if (options == null ? void 0 : options.sortDir) query.sortDir = options.sortDir;
       if (options == null ? void 0 : options.context) query.context = options.context;
       return this.request("/venue-markets", {
-        query: Object.keys(query).length > 0 ? query : void 0
+        query: Object.keys(query).length > 0 ? query : void 0,
+        signal: requestOptions == null ? void 0 : requestOptions.signal
       });
     });
   }
@@ -3144,7 +3698,7 @@ Issued At: ${issuedAt}`;
    * format intentionally omits the param so the server hits the cheaper
    * (and longer-TTL) light cache slot.
    */
-  search(params) {
+  search(params, options) {
     return __async(this, null, function* () {
       const query = {
         q: params.q,
@@ -3155,8 +3709,10 @@ Issued At: ${issuedAt}`;
       if (params.limit != null) query.limit = String(params.limit);
       if (params.cursor) query.cursor = params.cursor;
       if (params.deep) query.deepSearch = "true";
+      if (params.mode) query.mode = params.mode;
       return this.request("/search", {
-        query
+        query,
+        signal: options == null ? void 0 : options.signal
       });
     });
   }
@@ -3218,6 +3774,7 @@ Issued At: ${issuedAt}`;
   /** Get the canonical TradingView-style bar series for a single venue market outcome. */
   getChartBars(params, options) {
     return __async(this, null, function* () {
+      var _a, _b;
       const resolution = mapChartResolution(params.resolution);
       const query = {
         venueMarketOutcomeId: params.venueMarketOutcomeId,
@@ -3226,12 +3783,39 @@ Issued At: ${issuedAt}`;
       if (resolution) query.resolution = resolution;
       if (params.from != null) query.from = String(params.from);
       if (params.countBack != null) query.countBack = String(params.countBack);
+      if (options == null ? void 0 : options.decode) {
+        const text = yield this.request(
+          "/charts/bars",
+          { query, signal: options.signal },
+          (response) => readChartHistoryText(response)
+        );
+        (_a = options.signal) == null ? void 0 : _a.throwIfAborted();
+        const decoded = yield options.decode(text);
+        (_b = options.signal) == null ? void 0 : _b.throwIfAborted();
+        return decoded;
+      }
       return this.request("/charts/bars", {
         query,
         signal: options == null ? void 0 : options.signal
       });
     });
   }
+  getChartHistoryManifest(params, options) {
+    return __async(this, null, function* () {
+      const query = {
+        venueMarketOutcomeId: params.venueMarketOutcomeId,
+        to: String(params.to)
+      };
+      const resolution = mapChartResolution(params.resolution);
+      if (resolution) query.resolution = resolution;
+      if (params.from != null) query.from = String(params.from);
+      if (params.countBack != null) query.countBack = String(params.countBack);
+      return this.request("/charts/history/manifest", {
+        query,
+        signal: options == null ? void 0 : options.signal
+      });
+    });
+  }
   // --- Batch orderbooks ---
   /** Get live per-venue orderbooks for the explicit venueMarketIds requested. */
   getOrderbooks(params, options) {
@@ -3326,22 +3910,34 @@ Issued At: ${issuedAt}`;
       return params.side ? __spreadProps(__spreadValues({}, response), { side: params.side }) : response;
     });
   }
+  /** Seed subscribed outcomes with one bounded batch of compatible snapshots. */
+  getOutcomeOrderbooks(params, options) {
+    return __async(this, null, function* () {
+      return this.request("/orderbooks/outcomes", {
+        query: __spreadValues({
+          venueMarketOutcomeIds: params.venueMarketOutcomeIds.join(",")
+        }, params.depth == null ? {} : { depth: String(params.depth) }),
+        signal: options == null ? void 0 : options.signal
+      });
+    });
+  }
   /**
    * Create an AggWebSocket instance configured with this client's appId and optional auth token.
    * Requires `wsUrl` to be set in the client options.
    */
   createWebSocket(callbacks, options) {
-    var _a;
+    var _a, _b;
     if (!this.wsUrl) {
       throw new Error("AggClient.createWebSocket() requires wsUrl to be set in client options");
     }
     const url = new URL(this.wsUrl);
     if (this._appId) url.searchParams.set("appId", this._appId);
-    return new AggWebSocket({
+    const createSocket = (_a = this.webSocketFactory) != null ? _a : ((socketOptions) => new AggWebSocket(socketOptions));
+    return createSocket({
       url: url.toString(),
       callbacks,
       initialToken: this.accessToken,
-      enableLogs: (_a = options == null ? void 0 : options.enableLogs) != null ? _a : false
+      enableLogs: (_b = options == null ? void 0 : options.enableLogs) != null ? _b : false
     });
   }
   /** Execute a previously quoted managed trade. Returns pending order IDs. */
@@ -3686,6 +4282,24 @@ var CandleBuilder = class {
     var _a;
     return (_a = this.closedMap.get(interval)) != null ? _a : [];
   }
+  /** Apply a bounded Worker view without recomputing candles from presentation samples. */
+  replaceTail(tail) {
+    var _a, _b;
+    for (const interval of ALL_INTERVALS) {
+      const view = tail[interval];
+      if (view.forming) this.forming.set(interval, __spreadValues({}, view.forming));
+      else this.forming.delete(interval);
+      if (!view.closed.length) continue;
+      const closed = new Map(this.getClosed(interval).map((candle) => [candle.openTime, candle]));
+      for (const candle of view.closed) closed.set(candle.openTime, __spreadValues({}, candle));
+      this.closedMap.set(
+        interval,
+        [...closed.values()].sort((a, b) => a.openTime - b.openTime).slice(-MAX_CLOSED)
+      );
+    }
+    this._midpoint = (_b = (_a = tail["1m"].forming) == null ? void 0 : _a.c) != null ? _b : null;
+    this.markDirty();
+  }
   /** Current midpoint (latest value fed). */
   get midpoint() {
     return this._midpoint;
@@ -3848,6 +4462,7 @@ function createAggClient(options) {
   OrderStatus,
   OrderType,
   RECURRENCE_CADENCES,
+  RETINA_IMAGE_SIZES,
   SELF_CUSTODY_FILL_TIMEOUT_MS,
   SELF_CUSTODY_POLL_INTERVAL_MS,
   TERMINAL_EXECUTION_STATES,
@@ -3881,13 +4496,17 @@ function createAggClient(options) {
   isVenueActive,
   isVenueDataVisible,
   isVenueInactive,
+  loadImmutableHistory,
   mergeCandles,
   mergeClosedCandles,
   normalizeVenueMarketCluster,
   optimizedImageUrl,
+  orderbookCrc32,
   parse,
   parseEmail,
   parseEmailStrict,
+  projectedOrderbookChecksum,
+  retinaImageUrl,
   safeParse,
   snapshotToOrderbook,
   sortVenues,