brk-client 0.3.0-beta.9 → 0.3.1

package/index.js

@@ -281,6 +281,54 @@ Matches mempool.space/bitcoin-cli behavior.
  * @property {(Height|null)=} height - Block height (only if in best chain)
  * @property {(BlockHash|null)=} nextBest - Hash of the next block in the best chain (null if tip)
  */
+/**
+ * Projected next-block contents from Bitcoin Core's `getblocktemplate`
+ * (block 0 of the snapshot). Returned by
+ * `GET /api/v1/mempool/block-template`.
+ *
+ * @typedef {Object} BlockTemplate
+ * @property {NextBlockHash} hash - Pass back as `<hash>` on
+`/api/v1/mempool/block-template/diff/{hash}` to fetch deltas.
+ * @property {MempoolBlock} stats - Aggregate stats for this block (size, vsize, fee range, ...).
+ * @property {Transaction[]} transactions - Full transaction bodies in `getblocktemplate` order.
+ */
+/**
+ * Delta between the current `getblocktemplate` projection and a prior
+ * one identified by `since`. Returned by
+ * `GET /api/v1/mempool/block-template/diff/{hash}`.
+ *
+ * `order` carries the full new template in template order: each entry
+ * is either a `Retained(idx)` pointing into the prior template (which
+ * the client cached at `since`) or a `New(tx)` inline body. Walk it
+ * once to rebuild the new template; no separate `added` array to
+ * cross-reference.
+ *
+ * `removed` is redundant (computable from `order` by collecting prior
+ * indices that don't appear) but shipped for cache-eviction ergonomics.
+ *
+ * @typedef {Object} BlockTemplateDiff
+ * @property {NextBlockHash} hash - Current next-block hash. Use as `since` on the next diff call.
+ * @property {NextBlockHash} since - Echoed prior hash the diff was computed against.
+ * @property {BlockTemplateDiffEntry[]} order - New template in order. Each entry is either an index into the
+prior template's transactions or a full transaction body.
+ * @property {Txid[]} removed - Txids that left the projected next block since `since`
+(confirmed, evicted, replaced, or pushed past block 0).
+ */
+/**
+ * One slot of the new template in a `BlockTemplateDiff`.
+ *
+ * Untagged on the wire so JSON type disambiguates the variants:
+ * - `Retained(idx)` serializes as a bare integer - index into the
+ *   transactions of the prior template (which the client cached at
+ *   `since`).
+ * - `New(tx)` serializes as a transaction object - a body that was
+ *   not in the prior template and must be added at this position.
+ *
+ * Reconstruction is a single pass: for each entry, either copy
+ * `prior[idx]` or append the inline body.
+ *
+ * @typedef {(number|Transaction)} BlockTemplateDiffEntry
+ */
 /**
  * Block information returned for timestamp queries
  *
@@ -598,6 +646,14 @@ ancestors and no descendants (matches mempool.space).
  *
  * @typedef {number} Height
  */
+/**
+ * Path parameter accepting either a block height (`840000`) or a calendar date
+ * (`YYYY-MM-DD`). The handler resolves it and dispatches to the per-height or
+ * per-day variant, choosing the matching cache strategy.
+ *
+ * @typedef {Object} HeightOrDateParam
+ * @property {string} point
+ */
 /**
  * Block height path parameter
  *
@@ -711,6 +767,20 @@ ancestors and no descendants (matches mempool.space).
 /** @typedef {number} Month1 */
 /** @typedef {number} Month3 */
 /** @typedef {number} Month6 */
+/**
+ * Content hash of the projected next block (block 0 of the mempool
+ * snapshot). Same value as the mempool ETag. Opaque token: pass back
+ * as `since` on `/api/v1/mempool/block-template/diff/{hash}` to fetch
+ * deltas.
+ *
+ * @typedef {number} NextBlockHash
+ */
+/**
+ * `since` hash for `/api/v1/mempool/block-template/diff/{hash}`.
+ *
+ * @typedef {Object} NextBlockHashParam
+ * @property {NextBlockHash} hash
+ */
 /**
  * OHLC (Open, High, Low, Close) data in cents
  *
@@ -1287,9 +1357,9 @@ on serialization otherwise.
 /**
  * Aggregation strategy for URPD buckets.
  * Options: raw (no aggregation), lin200/lin500/lin1000 (linear $200/$500/$1000),
- * log10/log50/log100/log200 (logarithmic with 10/50/100/200 buckets per decade).
+ * log10/log50/log100/log200/log500/log1000/log2000 (logarithmic with 10/50/100/200/500/1000/2000 buckets per decade).
  *
- * @typedef {("raw"|"lin200"|"lin500"|"lin1000"|"log10"|"log50"|"log100"|"log200")} UrpdAggregation
+ * @typedef {("raw"|"lin200"|"lin500"|"lin1000"|"log10"|"log50"|"log100"|"log200"|"log500"|"log1000"|"log2000")} UrpdAggregation
  */
 /**
  * A single bucket in a URPD snapshot.
@@ -1812,14 +1882,17 @@ class BrkClientBase {
 
   /**
    * @param {string} path
-   * @param {{ signal?: AbortSignal }} [options]
+   * @param {{ signal?: AbortSignal, cache?: boolean }} [options]
    * @returns {Promise<Response>}
    */
-  async get(path, { signal } = {}) {
+  async get(path, { signal, cache = true } = {}) {
     const url = `${this.baseUrl}${path}`;
     const signals = [AbortSignal.timeout(this.timeout)];
     if (signal) signals.push(signal);
-    const res = await fetch(url, { signal: AbortSignal.any(signals) });
+    /** @type {RequestInit} */
+    const init = { signal: AbortSignal.any(signals) };
+    if (!cache) init.cache = 'no-store';
+    const res = await fetch(url, init);
     if (!res.ok) throw new BrkError(`HTTP ${res.status}: ${url}`, res.status);
     return res;
   }
@@ -1839,14 +1912,21 @@ class BrkClientBase {
    * @template T
    * @param {string} path
    * @param {(res: Response) => Promise<T>} parse - Response body reader
-   * @param {{ onValue?: (value: T) => void, signal?: AbortSignal }} [options]
+   * @param {{ onValue?: (value: T) => void, signal?: AbortSignal, cache?: boolean }} [options]
    * @returns {Promise<T>}
    */
-  async _getCached(path, parse, { onValue, signal } = {}) {
+  async _getCached(path, parse, { onValue, signal, cache = true } = {}) {
+    if (!cache) {
+      const res = await this.get(path, { signal, cache });
+      const value = await parse(res);
+      if (onValue) onValue(value);
+      return value;
+    }
+
     const url = `${this.baseUrl}${path}`;
     /** @type {_MemEntry<T> | undefined} */
     const memHit = this._memGet(url);
-    const browserCache = this._browserCache ?? await this._browserCachePromise;
+    const browserCache = this._browserCache;
 
     // L1 fast path: deliver from memCache, revalidate via network.
     // ETag match → zero parse, zero clone, zero cache write, no second onValue fire.
@@ -1861,8 +1941,8 @@ class BrkClientBase {
         this._memSet(url, netEtag, value);
         if (onValue) onValue(value);
         if (cloned && browserCache) {
-          const cache = browserCache;
-          _runIdle(() => cache.put(url, cloned));
+          const cacheStore = browserCache;
+          _runIdle(() => cacheStore.put(url, cloned));
         }
         return value;
       } catch {
@@ -1895,8 +1975,8 @@ class BrkClientBase {
       this._memSet(url, netEtag, value);
       if (onValue) onValue(value);
       if (cloned && browserCache) {
-        const cache = browserCache;
-        _runIdle(() => cache.put(url, cloned));
+        const cacheStore = browserCache;
+        _runIdle(() => cacheStore.put(url, cloned));
       }
       return value;
     } catch (e) {
@@ -1910,7 +1990,7 @@ class BrkClientBase {
    * Make a GET request expecting a JSON response. Cached and supports `onValue`.
    * @template T
    * @param {string} path
-   * @param {{ onValue?: (value: T) => void, signal?: AbortSignal }} [options]
+   * @param {{ onValue?: (value: T) => void, signal?: AbortSignal, cache?: boolean }} [options]
    * @returns {Promise<T>}
    */
   getJson(path, options) {
@@ -1921,7 +2001,7 @@ class BrkClientBase {
    * Make a GET request expecting a text response (text/plain, text/csv, ...).
    * Cached and supports `onValue`, same as `getJson`.
    * @param {string} path
-   * @param {{ onValue?: (value: string) => void, signal?: AbortSignal }} [options]
+   * @param {{ onValue?: (value: string) => void, signal?: AbortSignal, cache?: boolean }} [options]
    * @returns {Promise<string>}
    */
   getText(path, options) {
@@ -1932,7 +2012,7 @@ class BrkClientBase {
    * Make a GET request expecting binary data (application/octet-stream).
    * Cached and supports `onValue`, same as `getJson`.
    * @param {string} path
-   * @param {{ onValue?: (value: Uint8Array) => void, signal?: AbortSignal }} [options]
+   * @param {{ onValue?: (value: Uint8Array) => void, signal?: AbortSignal, cache?: boolean }} [options]
    * @returns {Promise<Uint8Array>}
    */
   getBytes(path, options) {
@@ -7499,7 +7579,7 @@ function createTransferPattern(client, acc) {
  * @extends BrkClientBase
  */
 class BrkClient extends BrkClientBase {
-  VERSION = "v0.3.0-beta.9";
+  VERSION = "v0.3.1";
 
   INDEXES = /** @type {const} */ ([
     "minute10",
@@ -10473,15 +10553,15 @@ class BrkClient extends BrkClientBase {
   /**
    * Health check
    *
-   * Returns the health status of the API server, including uptime information.
+   * Liveness probe. Returns server identity, uptime, and indexed/computed heights from local state only (no bitcoind round-trip). For real chain-tip catch-up, see `/api/server/sync`.
    *
    * Endpoint: `GET /health`
-   * @param {{ signal?: AbortSignal, onValue?: (value: Health) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Health) => void, cache?: boolean }} [options]
    * @returns {Promise<Health>}
    */
-  async getHealth({ signal, onValue } = {}) {
+  async getHealth({ signal, onValue, cache } = {}) {
     const path = `/health`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10490,12 +10570,12 @@ class BrkClient extends BrkClientBase {
    * Returns the current version of the API server
    *
    * Endpoint: `GET /version`
-   * @param {{ signal?: AbortSignal, onValue?: (value: string) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: string) => void, cache?: boolean }} [options]
    * @returns {Promise<string>}
    */
-  async getVersion({ signal, onValue } = {}) {
+  async getVersion({ signal, onValue, cache } = {}) {
     const path = `/version`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10504,12 +10584,12 @@ class BrkClient extends BrkClientBase {
    * Returns the sync status of the indexer, including indexed height, tip height, blocks behind, and last indexed timestamp.
    *
    * Endpoint: `GET /api/server/sync`
-   * @param {{ signal?: AbortSignal, onValue?: (value: SyncStatus) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: SyncStatus) => void, cache?: boolean }} [options]
    * @returns {Promise<SyncStatus>}
    */
-  async getSyncStatus({ signal, onValue } = {}) {
+  async getSyncStatus({ signal, onValue, cache } = {}) {
     const path = `/api/server/sync`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10518,12 +10598,12 @@ class BrkClient extends BrkClientBase {
    * Returns the disk space used by BRK and Bitcoin data.
    *
    * Endpoint: `GET /api/server/disk`
-   * @param {{ signal?: AbortSignal, onValue?: (value: DiskUsage) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: DiskUsage) => void, cache?: boolean }} [options]
    * @returns {Promise<DiskUsage>}
    */
-  async getDiskUsage({ signal, onValue } = {}) {
+  async getDiskUsage({ signal, onValue, cache } = {}) {
     const path = `/api/server/disk`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10532,12 +10612,12 @@ class BrkClient extends BrkClientBase {
    * Returns the complete hierarchical catalog of available series organized as a tree structure. Series are grouped by categories and subcategories.
    *
    * Endpoint: `GET /api/series`
-   * @param {{ signal?: AbortSignal, onValue?: (value: TreeNode) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: TreeNode) => void, cache?: boolean }} [options]
    * @returns {Promise<TreeNode>}
    */
-  async getSeriesTree({ signal, onValue } = {}) {
+  async getSeriesTree({ signal, onValue, cache } = {}) {
     const path = `/api/series`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10546,12 +10626,12 @@ class BrkClient extends BrkClientBase {
    * Returns the number of series available per index type.
    *
    * Endpoint: `GET /api/series/count`
-   * @param {{ signal?: AbortSignal, onValue?: (value: SeriesCount[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: SeriesCount[]) => void, cache?: boolean }} [options]
    * @returns {Promise<SeriesCount[]>}
    */
-  async getSeriesCount({ signal, onValue } = {}) {
+  async getSeriesCount({ signal, onValue, cache } = {}) {
     const path = `/api/series/count`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10560,12 +10640,12 @@ class BrkClient extends BrkClientBase {
    * Returns all available indexes with their accepted query aliases. Use any alias when querying series.
    *
    * Endpoint: `GET /api/series/indexes`
-   * @param {{ signal?: AbortSignal, onValue?: (value: IndexInfo[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: IndexInfo[]) => void, cache?: boolean }} [options]
    * @returns {Promise<IndexInfo[]>}
    */
-  async getIndexes({ signal, onValue } = {}) {
+  async getIndexes({ signal, onValue, cache } = {}) {
     const path = `/api/series/indexes`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10577,16 +10657,16 @@ class BrkClient extends BrkClientBase {
    *
    * @param {number=} [page] - Pagination index
    * @param {number=} [per_page] - Results per page (default: 1000, max: 1000)
-   * @param {{ signal?: AbortSignal, onValue?: (value: PaginatedSeries) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: PaginatedSeries) => void, cache?: boolean }} [options]
    * @returns {Promise<PaginatedSeries>}
    */
-  async listSeries(page, per_page, { signal, onValue } = {}) {
+  async listSeries(page, per_page, { signal, onValue, cache } = {}) {
     const params = new URLSearchParams();
     if (page !== undefined) params.set('page', String(page));
     if (per_page !== undefined) params.set('per_page', String(per_page));
     const query = params.toString();
     const path = `/api/series/list${query ? '?' + query : ''}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10598,16 +10678,16 @@ class BrkClient extends BrkClientBase {
    *
    * @param {SeriesName} q - Search query string
    * @param {Limit=} [limit] - Maximum number of results
-   * @param {{ signal?: AbortSignal, onValue?: (value: string[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: string[]) => void, cache?: boolean }} [options]
    * @returns {Promise<string[]>}
    */
-  async searchSeries(q, limit, { signal, onValue } = {}) {
+  async searchSeries(q, limit, { signal, onValue, cache } = {}) {
     const params = new URLSearchParams();
     params.set('q', String(q));
     if (limit !== undefined) params.set('limit', String(limit));
     const query = params.toString();
     const path = `/api/series/search${query ? '?' + query : ''}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10618,12 +10698,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/series/{series}`
    *
    * @param {SeriesName} series
-   * @param {{ signal?: AbortSignal, onValue?: (value: SeriesInfo) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: SeriesInfo) => void, cache?: boolean }} [options]
    * @returns {Promise<SeriesInfo>}
    */
-  async getSeriesInfo(series, { signal, onValue } = {}) {
+  async getSeriesInfo(series, { signal, onValue, cache } = {}) {
     const path = `/api/series/${series}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10639,10 +10719,10 @@ class BrkClient extends BrkClientBase {
    * @param {RangeIndex=} [end] - Exclusive end: integer index, date (YYYY-MM-DD), or timestamp (ISO 8601). Negative integers count from end. Aliases: `to`, `t`, `e`
    * @param {Limit=} [limit] - Maximum number of values to return (ignored if `end` is set). Aliases: `count`, `c`, `l`
    * @param {Format=} [format] - Format of the output
-   * @param {{ signal?: AbortSignal, onValue?: (value: AnySeriesData | string) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: AnySeriesData | string) => void, cache?: boolean }} [options]
    * @returns {Promise<AnySeriesData | string>}
    */
-  async getSeries(series, index, start, end, limit, format, { signal, onValue } = {}) {
+  async getSeries(series, index, start, end, limit, format, { signal, onValue, cache } = {}) {
     const params = new URLSearchParams();
     if (start !== undefined) params.set('start', String(start));
     if (end !== undefined) params.set('end', String(end));
@@ -10650,8 +10730,8 @@ class BrkClient extends BrkClientBase {
     if (format !== undefined) params.set('format', String(format));
     const query = params.toString();
     const path = `/api/series/${series}/${index}${query ? '?' + query : ''}`;
-    if (format === 'csv') return this.getText(path, { signal, onValue });
-    return this.getJson(path, { signal, onValue });
+    if (format === 'csv') return this.getText(path, { signal, onValue, cache });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10667,10 +10747,10 @@ class BrkClient extends BrkClientBase {
    * @param {RangeIndex=} [end] - Exclusive end: integer index, date (YYYY-MM-DD), or timestamp (ISO 8601). Negative integers count from end. Aliases: `to`, `t`, `e`
    * @param {Limit=} [limit] - Maximum number of values to return (ignored if `end` is set). Aliases: `count`, `c`, `l`
    * @param {Format=} [format] - Format of the output
-   * @param {{ signal?: AbortSignal, onValue?: (value: boolean[] | string) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: boolean[] | string) => void, cache?: boolean }} [options]
    * @returns {Promise<boolean[] | string>}
    */
-  async getSeriesData(series, index, start, end, limit, format, { signal, onValue } = {}) {
+  async getSeriesData(series, index, start, end, limit, format, { signal, onValue, cache } = {}) {
     const params = new URLSearchParams();
     if (start !== undefined) params.set('start', String(start));
     if (end !== undefined) params.set('end', String(end));
@@ -10678,8 +10758,8 @@ class BrkClient extends BrkClientBase {
     if (format !== undefined) params.set('format', String(format));
     const query = params.toString();
     const path = `/api/series/${series}/${index}/data${query ? '?' + query : ''}`;
-    if (format === 'csv') return this.getText(path, { signal, onValue });
-    return this.getJson(path, { signal, onValue });
+    if (format === 'csv') return this.getText(path, { signal, onValue, cache });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10691,12 +10771,12 @@ class BrkClient extends BrkClientBase {
    *
    * @param {SeriesName} series - Series name
    * @param {Index} index - Aggregation index
-   * @param {{ signal?: AbortSignal, onValue?: (value: *) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: *) => void, cache?: boolean }} [options]
    * @returns {Promise<*>}
    */
-  async getSeriesLatest(series, index, { signal, onValue } = {}) {
+  async getSeriesLatest(series, index, { signal, onValue, cache } = {}) {
     const path = `/api/series/${series}/${index}/latest`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10708,12 +10788,12 @@ class BrkClient extends BrkClientBase {
    *
    * @param {SeriesName} series - Series name
    * @param {Index} index - Aggregation index
-   * @param {{ signal?: AbortSignal, onValue?: (value: number) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: number) => void, cache?: boolean }} [options]
    * @returns {Promise<number>}
    */
-  async getSeriesLen(series, index, { signal, onValue } = {}) {
+  async getSeriesLen(series, index, { signal, onValue, cache } = {}) {
     const path = `/api/series/${series}/${index}/len`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10725,12 +10805,12 @@ class BrkClient extends BrkClientBase {
    *
    * @param {SeriesName} series - Series name
    * @param {Index} index - Aggregation index
-   * @param {{ signal?: AbortSignal, onValue?: (value: Version) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Version) => void, cache?: boolean }} [options]
    * @returns {Promise<Version>}
    */
-  async getSeriesVersion(series, index, { signal, onValue } = {}) {
+  async getSeriesVersion(series, index, { signal, onValue, cache } = {}) {
     const path = `/api/series/${series}/${index}/version`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10746,10 +10826,10 @@ class BrkClient extends BrkClientBase {
    * @param {RangeIndex=} [end] - Exclusive end: integer index, date (YYYY-MM-DD), or timestamp (ISO 8601). Negative integers count from end. Aliases: `to`, `t`, `e`
    * @param {Limit=} [limit] - Maximum number of values to return (ignored if `end` is set). Aliases: `count`, `c`, `l`
    * @param {Format=} [format] - Format of the output
-   * @param {{ signal?: AbortSignal, onValue?: (value: AnySeriesData[] | string) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: AnySeriesData[] | string) => void, cache?: boolean }} [options]
    * @returns {Promise<AnySeriesData[] | string>}
    */
-  async getSeriesBulk(series, index, start, end, limit, format, { signal, onValue } = {}) {
+  async getSeriesBulk(series, index, start, end, limit, format, { signal, onValue, cache } = {}) {
     const params = new URLSearchParams();
     params.set('series', String(series));
     params.set('index', String(index));
@@ -10759,8 +10839,8 @@ class BrkClient extends BrkClientBase {
     if (format !== undefined) params.set('format', String(format));
     const query = params.toString();
     const path = `/api/series/bulk${query ? '?' + query : ''}`;
-    if (format === 'csv') return this.getText(path, { signal, onValue });
-    return this.getJson(path, { signal, onValue });
+    if (format === 'csv') return this.getText(path, { signal, onValue, cache });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10769,12 +10849,12 @@ class BrkClient extends BrkClientBase {
    * Cohorts for which URPD data is available. Returns names like `all`, `sth`, `lth`, `utxos_under_1h_old`.
    *
    * Endpoint: `GET /api/urpd`
-   * @param {{ signal?: AbortSignal, onValue?: (value: Cohort[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Cohort[]) => void, cache?: boolean }} [options]
    * @returns {Promise<Cohort[]>}
    */
-  async listUrpdCohorts({ signal, onValue } = {}) {
+  async listUrpdCohorts({ signal, onValue, cache } = {}) {
     const path = `/api/urpd`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10785,12 +10865,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/urpd/{cohort}/dates`
    *
    * @param {Cohort} cohort
-   * @param {{ signal?: AbortSignal, onValue?: (value: Date[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Date[]) => void, cache?: boolean }} [options]
    * @returns {Promise<Date[]>}
    */
-  async listUrpdDates(cohort, { signal, onValue } = {}) {
+  async listUrpdDates(cohort, { signal, onValue, cache } = {}) {
     const path = `/api/urpd/${cohort}/dates`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10804,15 +10884,15 @@ class BrkClient extends BrkClientBase {
    *
    * @param {Cohort} cohort
    * @param {UrpdAggregation=} [agg] - Aggregation strategy. Default: raw (no aggregation). Accepts `bucket` as alias.
-   * @param {{ signal?: AbortSignal, onValue?: (value: Urpd) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Urpd) => void, cache?: boolean }} [options]
    * @returns {Promise<Urpd>}
    */
-  async getUrpd(cohort, agg, { signal, onValue } = {}) {
+  async getUrpd(cohort, agg, { signal, onValue, cache } = {}) {
     const params = new URLSearchParams();
     if (agg !== undefined) params.set('agg', String(agg));
     const query = params.toString();
     const path = `/api/urpd/${cohort}${query ? '?' + query : ''}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10827,15 +10907,15 @@ class BrkClient extends BrkClientBase {
    * @param {Cohort} cohort
    * @param {string} date
    * @param {UrpdAggregation=} [agg] - Aggregation strategy. Default: raw (no aggregation). Accepts `bucket` as alias.
-   * @param {{ signal?: AbortSignal, onValue?: (value: Urpd) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Urpd) => void, cache?: boolean }} [options]
    * @returns {Promise<Urpd>}
    */
-  async getUrpdAt(cohort, date, agg, { signal, onValue } = {}) {
+  async getUrpdAt(cohort, date, agg, { signal, onValue, cache } = {}) {
     const params = new URLSearchParams();
     if (agg !== undefined) params.set('agg', String(agg));
     const query = params.toString();
     const path = `/api/urpd/${cohort}/${date}${query ? '?' + query : ''}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10846,12 +10926,12 @@ class BrkClient extends BrkClientBase {
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-difficulty-adjustment)*
    *
    * Endpoint: `GET /api/v1/difficulty-adjustment`
-   * @param {{ signal?: AbortSignal, onValue?: (value: DifficultyAdjustment) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: DifficultyAdjustment) => void, cache?: boolean }} [options]
    * @returns {Promise<DifficultyAdjustment>}
    */
-  async getDifficultyAdjustment({ signal, onValue } = {}) {
+  async getDifficultyAdjustment({ signal, onValue, cache } = {}) {
     const path = `/api/v1/difficulty-adjustment`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10862,12 +10942,12 @@ class BrkClient extends BrkClientBase {
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-price)*
    *
    * Endpoint: `GET /api/v1/prices`
-   * @param {{ signal?: AbortSignal, onValue?: (value: Prices) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Prices) => void, cache?: boolean }} [options]
    * @returns {Promise<Prices>}
    */
-  async getPrices({ signal, onValue } = {}) {
+  async getPrices({ signal, onValue, cache } = {}) {
     const path = `/api/v1/prices`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10880,15 +10960,15 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/historical-price`
    *
    * @param {Timestamp=} [timestamp]
-   * @param {{ signal?: AbortSignal, onValue?: (value: HistoricalPrice) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: HistoricalPrice) => void, cache?: boolean }} [options]
    * @returns {Promise<HistoricalPrice>}
    */
-  async getHistoricalPrice(timestamp, { signal, onValue } = {}) {
+  async getHistoricalPrice(timestamp, { signal, onValue, cache } = {}) {
     const params = new URLSearchParams();
     if (timestamp !== undefined) params.set('timestamp', String(timestamp));
     const query = params.toString();
     const path = `/api/v1/historical-price${query ? '?' + query : ''}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10901,30 +10981,30 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/address/{address}`
    *
    * @param {Addr} address
-   * @param {{ signal?: AbortSignal, onValue?: (value: AddrStats) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: AddrStats) => void, cache?: boolean }} [options]
    * @returns {Promise<AddrStats>}
    */
-  async getAddress(address, { signal, onValue } = {}) {
+  async getAddress(address, { signal, onValue, cache } = {}) {
     const path = `/api/address/${address}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
    * Address transactions
    *
-   * Get transaction history for an address, sorted with newest first. Returns up to 50 entries: mempool transactions first, then confirmed transactions filling the remainder. To paginate further confirmed transactions, use `/address/{address}/txs/chain/{last_seen_txid}`.
+   * Get transaction history for an address, newest first. Returns up to 50 mempool transactions plus a confirmed page sized to fill the response to 50 total (chain floor of 25, so 25-50 confirmed depending on mempool weight). To paginate further confirmed history, use `/address/{address}/txs/chain/{last_seen_txid}`.
    *
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-address-transactions)*
    *
    * Endpoint: `GET /api/address/{address}/txs`
    *
    * @param {Addr} address
-   * @param {{ signal?: AbortSignal, onValue?: (value: Transaction[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Transaction[]) => void, cache?: boolean }} [options]
    * @returns {Promise<Transaction[]>}
    */
-  async getAddressTxs(address, { signal, onValue } = {}) {
+  async getAddressTxs(address, { signal, onValue, cache } = {}) {
     const path = `/api/address/${address}/txs`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10937,12 +11017,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/address/{address}/txs/chain`
    *
    * @param {Addr} address
-   * @param {{ signal?: AbortSignal, onValue?: (value: Transaction[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Transaction[]) => void, cache?: boolean }} [options]
    * @returns {Promise<Transaction[]>}
    */
-  async getAddressConfirmedTxs(address, { signal, onValue } = {}) {
+  async getAddressConfirmedTxs(address, { signal, onValue, cache } = {}) {
     const path = `/api/address/${address}/txs/chain`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10956,12 +11036,12 @@ class BrkClient extends BrkClientBase {
    *
    * @param {Addr} address
    * @param {Txid} after_txid - Last txid from the previous page (return transactions strictly older than this)
-   * @param {{ signal?: AbortSignal, onValue?: (value: Transaction[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Transaction[]) => void, cache?: boolean }} [options]
    * @returns {Promise<Transaction[]>}
    */
-  async getAddressConfirmedTxsAfter(address, after_txid, { signal, onValue } = {}) {
+  async getAddressConfirmedTxsAfter(address, after_txid, { signal, onValue, cache } = {}) {
     const path = `/api/address/${address}/txs/chain/${after_txid}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10974,12 +11054,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/address/{address}/txs/mempool`
    *
    * @param {Addr} address
-   * @param {{ signal?: AbortSignal, onValue?: (value: Transaction[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Transaction[]) => void, cache?: boolean }} [options]
    * @returns {Promise<Transaction[]>}
    */
-  async getAddressMempoolTxs(address, { signal, onValue } = {}) {
+  async getAddressMempoolTxs(address, { signal, onValue, cache } = {}) {
     const path = `/api/address/${address}/txs/mempool`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -10992,12 +11072,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/address/{address}/utxo`
    *
    * @param {Addr} address
-   * @param {{ signal?: AbortSignal, onValue?: (value: Utxo[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Utxo[]) => void, cache?: boolean }} [options]
    * @returns {Promise<Utxo[]>}
    */
-  async getAddressUtxos(address, { signal, onValue } = {}) {
+  async getAddressUtxos(address, { signal, onValue, cache } = {}) {
     const path = `/api/address/${address}/utxo`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11010,12 +11090,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/validate-address/{address}`
    *
    * @param {string} address - Bitcoin address to validate (can be any string)
-   * @param {{ signal?: AbortSignal, onValue?: (value: AddrValidation) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: AddrValidation) => void, cache?: boolean }} [options]
    * @returns {Promise<AddrValidation>}
    */
-  async validateAddress(address, { signal, onValue } = {}) {
+  async validateAddress(address, { signal, onValue, cache } = {}) {
     const path = `/api/v1/validate-address/${address}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11028,12 +11108,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/block/{hash}`
    *
    * @param {BlockHash} hash
-   * @param {{ signal?: AbortSignal, onValue?: (value: BlockInfo) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockInfo) => void, cache?: boolean }} [options]
    * @returns {Promise<BlockInfo>}
    */
-  async getBlock(hash, { signal, onValue } = {}) {
+  async getBlock(hash, { signal, onValue, cache } = {}) {
     const path = `/api/block/${hash}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11046,12 +11126,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/block/{hash}`
    *
    * @param {BlockHash} hash
-   * @param {{ signal?: AbortSignal, onValue?: (value: BlockInfoV1) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockInfoV1) => void, cache?: boolean }} [options]
    * @returns {Promise<BlockInfoV1>}
    */
-  async getBlockV1(hash, { signal, onValue } = {}) {
+  async getBlockV1(hash, { signal, onValue, cache } = {}) {
     const path = `/api/v1/block/${hash}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11064,12 +11144,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/block/{hash}/header`
    *
    * @param {BlockHash} hash
-   * @param {{ signal?: AbortSignal, onValue?: (value: Hex) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Hex) => void, cache?: boolean }} [options]
    * @returns {Promise<Hex>}
    */
-  async getBlockHeader(hash, { signal, onValue } = {}) {
+  async getBlockHeader(hash, { signal, onValue, cache } = {}) {
     const path = `/api/block/${hash}/header`;
-    return this.getText(path, { signal, onValue });
+    return this.getText(path, { signal, onValue, cache });
   }
 
   /**
@@ -11082,12 +11162,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/block-height/{height}`
    *
    * @param {Height} height
-   * @param {{ signal?: AbortSignal, onValue?: (value: BlockHash) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockHash) => void, cache?: boolean }} [options]
    * @returns {Promise<BlockHash>}
    */
-  async getBlockByHeight(height, { signal, onValue } = {}) {
+  async getBlockByHeight(height, { signal, onValue, cache } = {}) {
     const path = `/api/block-height/${height}`;
-    return this.getText(path, { signal, onValue });
+    return this.getText(path, { signal, onValue, cache });
   }
 
   /**
@@ -11100,12 +11180,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/mining/blocks/timestamp/{timestamp}`
    *
    * @param {Timestamp} timestamp
-   * @param {{ signal?: AbortSignal, onValue?: (value: BlockTimestamp) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockTimestamp) => void, cache?: boolean }} [options]
    * @returns {Promise<BlockTimestamp>}
    */
-  async getBlockByTimestamp(timestamp, { signal, onValue } = {}) {
+  async getBlockByTimestamp(timestamp, { signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/blocks/timestamp/${timestamp}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11118,12 +11198,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/block/{hash}/raw`
    *
    * @param {BlockHash} hash
-   * @param {{ signal?: AbortSignal, onValue?: (value: Uint8Array) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Uint8Array) => void, cache?: boolean }} [options]
    * @returns {Promise<Uint8Array>}
    */
-  async getBlockRaw(hash, { signal, onValue } = {}) {
+  async getBlockRaw(hash, { signal, onValue, cache } = {}) {
     const path = `/api/block/${hash}/raw`;
-    return this.getBytes(path, { signal, onValue });
+    return this.getBytes(path, { signal, onValue, cache });
   }
 
   /**
@@ -11136,12 +11216,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/block/{hash}/status`
    *
    * @param {BlockHash} hash
-   * @param {{ signal?: AbortSignal, onValue?: (value: BlockStatus) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockStatus) => void, cache?: boolean }} [options]
    * @returns {Promise<BlockStatus>}
    */
-  async getBlockStatus(hash, { signal, onValue } = {}) {
+  async getBlockStatus(hash, { signal, onValue, cache } = {}) {
     const path = `/api/block/${hash}/status`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11152,12 +11232,12 @@ class BrkClient extends BrkClientBase {
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-tip-height)*
    *
    * Endpoint: `GET /api/blocks/tip/height`
-   * @param {{ signal?: AbortSignal, onValue?: (value: Height) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Height) => void, cache?: boolean }} [options]
    * @returns {Promise<Height>}
    */
-  async getBlockTipHeight({ signal, onValue } = {}) {
+  async getBlockTipHeight({ signal, onValue, cache } = {}) {
     const path = `/api/blocks/tip/height`;
-    return Number(await this.getText(path, { signal, onValue: onValue ? (v) => onValue(Number(v)) : undefined }));
+    return Number(await this.getText(path, { signal, cache, onValue: onValue ? (v) => onValue(Number(v)) : undefined }));
   }
 
   /**
@@ -11168,12 +11248,12 @@ class BrkClient extends BrkClientBase {
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-block-tip-hash)*
    *
    * Endpoint: `GET /api/blocks/tip/hash`
-   * @param {{ signal?: AbortSignal, onValue?: (value: BlockHash) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockHash) => void, cache?: boolean }} [options]
    * @returns {Promise<BlockHash>}
    */
-  async getBlockTipHash({ signal, onValue } = {}) {
+  async getBlockTipHash({ signal, onValue, cache } = {}) {
     const path = `/api/blocks/tip/hash`;
-    return this.getText(path, { signal, onValue });
+    return this.getText(path, { signal, onValue, cache });
   }
 
   /**
@@ -11187,12 +11267,12 @@ class BrkClient extends BrkClientBase {
    *
    * @param {BlockHash} hash - Bitcoin block hash
    * @param {BlockTxIndex} index - Transaction index within the block (0-based)
-   * @param {{ signal?: AbortSignal, onValue?: (value: Txid) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Txid) => void, cache?: boolean }} [options]
    * @returns {Promise<Txid>}
    */
-  async getBlockTxid(hash, index, { signal, onValue } = {}) {
+  async getBlockTxid(hash, index, { signal, onValue, cache } = {}) {
     const path = `/api/block/${hash}/txid/${index}`;
-    return this.getText(path, { signal, onValue });
+    return this.getText(path, { signal, onValue, cache });
   }
 
   /**
@@ -11205,12 +11285,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/block/{hash}/txids`
    *
    * @param {BlockHash} hash
-   * @param {{ signal?: AbortSignal, onValue?: (value: Txid[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Txid[]) => void, cache?: boolean }} [options]
    * @returns {Promise<Txid[]>}
    */
-  async getBlockTxids(hash, { signal, onValue } = {}) {
+  async getBlockTxids(hash, { signal, onValue, cache } = {}) {
     const path = `/api/block/${hash}/txids`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11223,12 +11303,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/block/{hash}/txs`
    *
    * @param {BlockHash} hash
-   * @param {{ signal?: AbortSignal, onValue?: (value: Transaction[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Transaction[]) => void, cache?: boolean }} [options]
    * @returns {Promise<Transaction[]>}
    */
-  async getBlockTxs(hash, { signal, onValue } = {}) {
+  async getBlockTxs(hash, { signal, onValue, cache } = {}) {
     const path = `/api/block/${hash}/txs`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11242,12 +11322,12 @@ class BrkClient extends BrkClientBase {
    *
    * @param {BlockHash} hash - Bitcoin block hash
    * @param {BlockTxIndex} start_index - Starting transaction index within the block (0-based)
-   * @param {{ signal?: AbortSignal, onValue?: (value: Transaction[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Transaction[]) => void, cache?: boolean }} [options]
    * @returns {Promise<Transaction[]>}
    */
-  async getBlockTxsFromIndex(hash, start_index, { signal, onValue } = {}) {
+  async getBlockTxsFromIndex(hash, start_index, { signal, onValue, cache } = {}) {
     const path = `/api/block/${hash}/txs/${start_index}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11258,12 +11338,12 @@ class BrkClient extends BrkClientBase {
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-blocks)*
    *
    * Endpoint: `GET /api/blocks`
-   * @param {{ signal?: AbortSignal, onValue?: (value: BlockInfo[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockInfo[]) => void, cache?: boolean }} [options]
    * @returns {Promise<BlockInfo[]>}
    */
-  async getBlocks({ signal, onValue } = {}) {
+  async getBlocks({ signal, onValue, cache } = {}) {
     const path = `/api/blocks`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11276,12 +11356,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/blocks/{height}`
    *
    * @param {Height} height
-   * @param {{ signal?: AbortSignal, onValue?: (value: BlockInfo[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockInfo[]) => void, cache?: boolean }} [options]
    * @returns {Promise<BlockInfo[]>}
    */
-  async getBlocksFromHeight(height, { signal, onValue } = {}) {
+  async getBlocksFromHeight(height, { signal, onValue, cache } = {}) {
     const path = `/api/blocks/${height}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11292,12 +11372,12 @@ class BrkClient extends BrkClientBase {
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-blocks-v1)*
    *
    * Endpoint: `GET /api/v1/blocks`
-   * @param {{ signal?: AbortSignal, onValue?: (value: BlockInfoV1[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockInfoV1[]) => void, cache?: boolean }} [options]
    * @returns {Promise<BlockInfoV1[]>}
    */
-  async getBlocksV1({ signal, onValue } = {}) {
+  async getBlocksV1({ signal, onValue, cache } = {}) {
     const path = `/api/v1/blocks`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11310,12 +11390,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/blocks/{height}`
    *
    * @param {Height} height
-   * @param {{ signal?: AbortSignal, onValue?: (value: BlockInfoV1[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockInfoV1[]) => void, cache?: boolean }} [options]
    * @returns {Promise<BlockInfoV1[]>}
    */
-  async getBlocksV1FromHeight(height, { signal, onValue } = {}) {
+  async getBlocksV1FromHeight(height, { signal, onValue, cache } = {}) {
     const path = `/api/v1/blocks/${height}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11326,12 +11406,12 @@ class BrkClient extends BrkClientBase {
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-mining-pools)*
    *
    * Endpoint: `GET /api/v1/mining/pools`
-   * @param {{ signal?: AbortSignal, onValue?: (value: PoolInfo[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: PoolInfo[]) => void, cache?: boolean }} [options]
    * @returns {Promise<PoolInfo[]>}
    */
-  async getPools({ signal, onValue } = {}) {
+  async getPools({ signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/pools`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11344,12 +11424,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/mining/pools/{time_period}`
    *
    * @param {TimePeriod} time_period
-   * @param {{ signal?: AbortSignal, onValue?: (value: PoolsSummary) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: PoolsSummary) => void, cache?: boolean }} [options]
    * @returns {Promise<PoolsSummary>}
    */
-  async getPoolStats(time_period, { signal, onValue } = {}) {
+  async getPoolStats(time_period, { signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/pools/${time_period}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11362,12 +11442,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/mining/pool/{slug}`
    *
    * @param {PoolSlug} slug
-   * @param {{ signal?: AbortSignal, onValue?: (value: PoolDetail) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: PoolDetail) => void, cache?: boolean }} [options]
    * @returns {Promise<PoolDetail>}
    */
-  async getPool(slug, { signal, onValue } = {}) {
+  async getPool(slug, { signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/pool/${slug}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11378,12 +11458,12 @@ class BrkClient extends BrkClientBase {
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-mining-pool-hashrates)*
    *
    * Endpoint: `GET /api/v1/mining/hashrate/pools`
-   * @param {{ signal?: AbortSignal, onValue?: (value: PoolHashrateEntry[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: PoolHashrateEntry[]) => void, cache?: boolean }} [options]
    * @returns {Promise<PoolHashrateEntry[]>}
    */
-  async getPoolsHashrate({ signal, onValue } = {}) {
+  async getPoolsHashrate({ signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/hashrate/pools`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11396,12 +11476,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/mining/hashrate/pools/{time_period}`
    *
    * @param {TimePeriod} time_period
-   * @param {{ signal?: AbortSignal, onValue?: (value: PoolHashrateEntry[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: PoolHashrateEntry[]) => void, cache?: boolean }} [options]
    * @returns {Promise<PoolHashrateEntry[]>}
    */
-  async getPoolsHashrateByPeriod(time_period, { signal, onValue } = {}) {
+  async getPoolsHashrateByPeriod(time_period, { signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/hashrate/pools/${time_period}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11414,12 +11494,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/mining/pool/{slug}/hashrate`
    *
    * @param {PoolSlug} slug
-   * @param {{ signal?: AbortSignal, onValue?: (value: PoolHashrateEntry[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: PoolHashrateEntry[]) => void, cache?: boolean }} [options]
    * @returns {Promise<PoolHashrateEntry[]>}
    */
-  async getPoolHashrate(slug, { signal, onValue } = {}) {
+  async getPoolHashrate(slug, { signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/pool/${slug}/hashrate`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11432,12 +11512,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/mining/pool/{slug}/blocks`
    *
    * @param {PoolSlug} slug
-   * @param {{ signal?: AbortSignal, onValue?: (value: BlockInfoV1[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockInfoV1[]) => void, cache?: boolean }} [options]
    * @returns {Promise<BlockInfoV1[]>}
    */
-  async getPoolBlocks(slug, { signal, onValue } = {}) {
+  async getPoolBlocks(slug, { signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/pool/${slug}/blocks`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11451,12 +11531,12 @@ class BrkClient extends BrkClientBase {
    *
    * @param {PoolSlug} slug
    * @param {Height} height
-   * @param {{ signal?: AbortSignal, onValue?: (value: BlockInfoV1[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockInfoV1[]) => void, cache?: boolean }} [options]
    * @returns {Promise<BlockInfoV1[]>}
    */
-  async getPoolBlocksFrom(slug, height, { signal, onValue } = {}) {
+  async getPoolBlocksFrom(slug, height, { signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/pool/${slug}/blocks/${height}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11467,12 +11547,12 @@ class BrkClient extends BrkClientBase {
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-hashrate)*
    *
    * Endpoint: `GET /api/v1/mining/hashrate`
-   * @param {{ signal?: AbortSignal, onValue?: (value: HashrateSummary) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: HashrateSummary) => void, cache?: boolean }} [options]
    * @returns {Promise<HashrateSummary>}
    */
-  async getHashrate({ signal, onValue } = {}) {
+  async getHashrate({ signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/hashrate`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11485,12 +11565,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/mining/hashrate/{time_period}`
    *
    * @param {TimePeriod} time_period
-   * @param {{ signal?: AbortSignal, onValue?: (value: HashrateSummary) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: HashrateSummary) => void, cache?: boolean }} [options]
    * @returns {Promise<HashrateSummary>}
    */
-  async getHashrateByPeriod(time_period, { signal, onValue } = {}) {
+  async getHashrateByPeriod(time_period, { signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/hashrate/${time_period}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11501,12 +11581,12 @@ class BrkClient extends BrkClientBase {
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-difficulty-adjustments)*
    *
    * Endpoint: `GET /api/v1/mining/difficulty-adjustments`
-   * @param {{ signal?: AbortSignal, onValue?: (value: DifficultyAdjustmentEntry[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: DifficultyAdjustmentEntry[]) => void, cache?: boolean }} [options]
    * @returns {Promise<DifficultyAdjustmentEntry[]>}
    */
-  async getDifficultyAdjustments({ signal, onValue } = {}) {
+  async getDifficultyAdjustments({ signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/difficulty-adjustments`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11519,12 +11599,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/mining/difficulty-adjustments/{time_period}`
    *
    * @param {TimePeriod} time_period
-   * @param {{ signal?: AbortSignal, onValue?: (value: DifficultyAdjustmentEntry[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: DifficultyAdjustmentEntry[]) => void, cache?: boolean }} [options]
    * @returns {Promise<DifficultyAdjustmentEntry[]>}
    */
-  async getDifficultyAdjustmentsByPeriod(time_period, { signal, onValue } = {}) {
+  async getDifficultyAdjustmentsByPeriod(time_period, { signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/difficulty-adjustments/${time_period}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11537,12 +11617,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/mining/reward-stats/{block_count}`
    *
    * @param {number} block_count - Number of recent blocks to include
-   * @param {{ signal?: AbortSignal, onValue?: (value: RewardStats) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: RewardStats) => void, cache?: boolean }} [options]
    * @returns {Promise<RewardStats>}
    */
-  async getRewardStats(block_count, { signal, onValue } = {}) {
+  async getRewardStats(block_count, { signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/reward-stats/${block_count}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11555,12 +11635,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/mining/blocks/fees/{time_period}`
    *
    * @param {TimePeriod} time_period
-   * @param {{ signal?: AbortSignal, onValue?: (value: BlockFeesEntry[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockFeesEntry[]) => void, cache?: boolean }} [options]
    * @returns {Promise<BlockFeesEntry[]>}
    */
-  async getBlockFees(time_period, { signal, onValue } = {}) {
+  async getBlockFees(time_period, { signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/blocks/fees/${time_period}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11573,12 +11653,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/mining/blocks/rewards/{time_period}`
    *
    * @param {TimePeriod} time_period
-   * @param {{ signal?: AbortSignal, onValue?: (value: BlockRewardsEntry[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockRewardsEntry[]) => void, cache?: boolean }} [options]
    * @returns {Promise<BlockRewardsEntry[]>}
    */
-  async getBlockRewards(time_period, { signal, onValue } = {}) {
+  async getBlockRewards(time_period, { signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/blocks/rewards/${time_period}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11591,12 +11671,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/mining/blocks/fee-rates/{time_period}`
    *
    * @param {TimePeriod} time_period
-   * @param {{ signal?: AbortSignal, onValue?: (value: BlockFeeRatesEntry[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockFeeRatesEntry[]) => void, cache?: boolean }} [options]
    * @returns {Promise<BlockFeeRatesEntry[]>}
    */
-  async getBlockFeeRates(time_period, { signal, onValue } = {}) {
+  async getBlockFeeRates(time_period, { signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/blocks/fee-rates/${time_period}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11609,60 +11689,60 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/mining/blocks/sizes-weights/{time_period}`
    *
    * @param {TimePeriod} time_period
-   * @param {{ signal?: AbortSignal, onValue?: (value: BlockSizesWeights) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockSizesWeights) => void, cache?: boolean }} [options]
    * @returns {Promise<BlockSizesWeights>}
    */
-  async getBlockSizesWeights(time_period, { signal, onValue } = {}) {
+  async getBlockSizesWeights(time_period, { signal, onValue, cache } = {}) {
     const path = `/api/v1/mining/blocks/sizes-weights/${time_period}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
    * Projected mempool blocks
    *
-   * Get projected blocks from the mempool for fee estimation.
+   * Projected blocks for fee estimation. Block 0 reflects Bitcoin Core's actual next-block selection; blocks 1+ are a fee-tier approximation.
    *
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-mempool-blocks-fees)*
    *
    * Endpoint: `GET /api/v1/fees/mempool-blocks`
-   * @param {{ signal?: AbortSignal, onValue?: (value: MempoolBlock[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: MempoolBlock[]) => void, cache?: boolean }} [options]
    * @returns {Promise<MempoolBlock[]>}
    */
-  async getMempoolBlocks({ signal, onValue } = {}) {
+  async getMempoolBlocks({ signal, onValue, cache } = {}) {
     const path = `/api/v1/fees/mempool-blocks`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
    * Recommended fees
    *
-   * Get recommended fee rates for different confirmation targets.
+   * Recommended fee rates by confirmation target.
    *
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-recommended-fees)*
    *
    * Endpoint: `GET /api/v1/fees/recommended`
-   * @param {{ signal?: AbortSignal, onValue?: (value: RecommendedFees) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: RecommendedFees) => void, cache?: boolean }} [options]
    * @returns {Promise<RecommendedFees>}
    */
-  async getRecommendedFees({ signal, onValue } = {}) {
+  async getRecommendedFees({ signal, onValue, cache } = {}) {
     const path = `/api/v1/fees/recommended`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
    * Precise recommended fees
    *
-   * Get recommended fee rates with up to 3 decimal places.
+   * Recommended fee rates with sub-integer precision.
    *
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-recommended-fees-precise)*
    *
    * Endpoint: `GET /api/v1/fees/precise`
-   * @param {{ signal?: AbortSignal, onValue?: (value: RecommendedFees) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: RecommendedFees) => void, cache?: boolean }} [options]
    * @returns {Promise<RecommendedFees>}
    */
-  async getPreciseFees({ signal, onValue } = {}) {
+  async getPreciseFees({ signal, onValue, cache } = {}) {
     const path = `/api/v1/fees/precise`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11673,26 +11753,26 @@ class BrkClient extends BrkClientBase {
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-mempool)*
    *
    * Endpoint: `GET /api/mempool`
-   * @param {{ signal?: AbortSignal, onValue?: (value: MempoolInfo) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: MempoolInfo) => void, cache?: boolean }} [options]
    * @returns {Promise<MempoolInfo>}
    */
-  async getMempool({ signal, onValue } = {}) {
+  async getMempool({ signal, onValue, cache } = {}) {
     const path = `/api/mempool`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
    * Mempool content hash
    *
-   * Returns an opaque `u64` that changes whenever the projected next block changes. Same value as the mempool ETag. Useful as a freshness/liveness signal: if it stays constant for tens of seconds on a live network, the mempool sync loop has stalled.
+   * Returns an opaque hash that changes whenever the projected next block changes. Same value as the mempool ETag. Useful as a freshness/liveness signal: if it stays constant for tens of seconds on a live network, the mempool sync loop has stalled.
    *
    * Endpoint: `GET /api/mempool/hash`
-   * @param {{ signal?: AbortSignal, onValue?: (value: number) => void }} [options]
-   * @returns {Promise<number>}
+   * @param {{ signal?: AbortSignal, onValue?: (value: NextBlockHash) => void, cache?: boolean }} [options]
+   * @returns {Promise<NextBlockHash>}
    */
-  async getMempoolHash({ signal, onValue } = {}) {
+  async getMempoolHash({ signal, onValue, cache } = {}) {
     const path = `/api/mempool/hash`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11703,12 +11783,12 @@ class BrkClient extends BrkClientBase {
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-mempool-transaction-ids)*
    *
    * Endpoint: `GET /api/mempool/txids`
-   * @param {{ signal?: AbortSignal, onValue?: (value: Txid[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Txid[]) => void, cache?: boolean }} [options]
    * @returns {Promise<Txid[]>}
    */
-  async getMempoolTxids({ signal, onValue } = {}) {
+  async getMempoolTxids({ signal, onValue, cache } = {}) {
     const path = `/api/mempool/txids`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11719,12 +11799,12 @@ class BrkClient extends BrkClientBase {
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-mempool-recent)*
    *
    * Endpoint: `GET /api/mempool/recent`
-   * @param {{ signal?: AbortSignal, onValue?: (value: MempoolRecentTx[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: MempoolRecentTx[]) => void, cache?: boolean }} [options]
    * @returns {Promise<MempoolRecentTx[]>}
    */
-  async getMempoolRecent({ signal, onValue } = {}) {
+  async getMempoolRecent({ signal, onValue, cache } = {}) {
     const path = `/api/mempool/recent`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11735,12 +11815,12 @@ class BrkClient extends BrkClientBase {
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-replacements)*
    *
    * Endpoint: `GET /api/v1/replacements`
-   * @param {{ signal?: AbortSignal, onValue?: (value: ReplacementNode[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: ReplacementNode[]) => void, cache?: boolean }} [options]
    * @returns {Promise<ReplacementNode[]>}
    */
-  async getReplacements({ signal, onValue } = {}) {
+  async getReplacements({ signal, onValue, cache } = {}) {
     const path = `/api/v1/replacements`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11751,12 +11831,42 @@ class BrkClient extends BrkClientBase {
    * *[Mempool.space docs](https://mempool.space/docs/api/rest#get-fullrbf-replacements)*
    *
    * Endpoint: `GET /api/v1/fullrbf/replacements`
-   * @param {{ signal?: AbortSignal, onValue?: (value: ReplacementNode[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: ReplacementNode[]) => void, cache?: boolean }} [options]
    * @returns {Promise<ReplacementNode[]>}
    */
-  async getFullrbfReplacements({ signal, onValue } = {}) {
+  async getFullrbfReplacements({ signal, onValue, cache } = {}) {
     const path = `/api/v1/fullrbf/replacements`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
+  }
+
+  /**
+   * Projected next block template
+   *
+   * Bitcoin Core's `getblocktemplate` selection: full transaction bodies in GBT order with aggregate stats. The returned `hash` is an opaque content token; pass it as `<hash>` on `/api/v1/mempool/block-template/diff/{hash}` to fetch deltas instead of refetching the whole template.
+   *
+   * Endpoint: `GET /api/v1/mempool/block-template`
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockTemplate) => void, cache?: boolean }} [options]
+   * @returns {Promise<BlockTemplate>}
+   */
+  async getBlockTemplate({ signal, onValue, cache } = {}) {
+    const path = `/api/v1/mempool/block-template`;
+    return this.getJson(path, { signal, onValue, cache });
+  }
+
+  /**
+   * Block template diff since hash
+   *
+   * Delta of the projected next block since `<hash>`. `order` is the full new template in order: each entry is either a number (index into the prior template the client cached at `<hash>`) or a transaction object (new body to insert at this position). Walk `order` once to rebuild; `removed` is a convenience list of txids that left so clients can evict cached bodies. After applying, use the response `hash` as `<hash>` on the next call to keep iterating. Returns `404` when `<hash>` has aged out of server history; clients should fall back to `/api/v1/mempool/block-template`.
+   *
+   * Endpoint: `GET /api/v1/mempool/block-template/diff/{hash}`
+   *
+   * @param {NextBlockHash} hash
+   * @param {{ signal?: AbortSignal, onValue?: (value: BlockTemplateDiff) => void, cache?: boolean }} [options]
+   * @returns {Promise<BlockTemplateDiff>}
+   */
+  async getBlockTemplateDiff(hash, { signal, onValue, cache } = {}) {
+    const path = `/api/v1/mempool/block-template/diff/${hash}`;
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11765,12 +11875,86 @@ class BrkClient extends BrkClientBase {
    * Returns the current BTC/USD price in dollars, derived from on-chain round-dollar output patterns in the last 12 blocks plus mempool.
    *
    * Endpoint: `GET /api/mempool/price`
-   * @param {{ signal?: AbortSignal, onValue?: (value: Dollars) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Dollars) => void, cache?: boolean }} [options]
    * @returns {Promise<Dollars>}
    */
-  async getLivePrice({ signal, onValue } = {}) {
+  async getLivePrice({ signal, onValue, cache } = {}) {
     const path = `/api/mempool/price`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
+  }
+
+  /**
+   * Live BTC/USD price
+   *
+   * Current BTC/USD price in dollars. Same value as `/api/mempool/price`. Confirmed per-height history is available at `/api/vecs/height-to-price`.
+   *
+   * Endpoint: `GET /api/oracle/price`
+   * @param {{ signal?: AbortSignal, onValue?: (value: Dollars) => void, cache?: boolean }} [options]
+   * @returns {Promise<Dollars>}
+   */
+  async getOraclePrice({ signal, onValue, cache } = {}) {
+    const path = `/api/oracle/price`;
+    return this.getJson(path, { signal, onValue, cache });
+  }
+
+  /**
+   * Live payment output histogram
+   *
+   * Live smoothed histogram of oracle-eligible payment outputs, binned by output value on the oracle log scale. It combines the committed oracle window with the forming mempool block. A flat array of log-scale bins.
+   *
+   * Endpoint: `GET /api/oracle/histogram/payments/live`
+   * @param {{ signal?: AbortSignal, onValue?: (value: number[]) => void, cache?: boolean }} [options]
+   * @returns {Promise<number[]>}
+   */
+  async getOracleHistogramPaymentsLive({ signal, onValue, cache } = {}) {
+    const path = `/api/oracle/histogram/payments/live`;
+    return this.getJson(path, { signal, onValue, cache });
+  }
+
+  /**
+   * Payment output histogram at height or day
+   *
+   * Smoothed histogram of oracle-eligible payment outputs for a confirmed point. A block height (`840000`) gives that block's oracle payment histogram; a calendar date (`YYYY-MM-DD`) gives the average of that day's per-block payment histograms. A flat array of log-scale bins.
+   *
+   * Endpoint: `GET /api/oracle/histogram/payments/{point}`
+   *
+   * @param {string} point
+   * @param {{ signal?: AbortSignal, onValue?: (value: number[]) => void, cache?: boolean }} [options]
+   * @returns {Promise<number[]>}
+   */
+  async getOracleHistogramPayments(point, { signal, onValue, cache } = {}) {
+    const path = `/api/oracle/histogram/payments/${point}`;
+    return this.getJson(path, { signal, onValue, cache });
+  }
+
+  /**
+   * Live output value histogram
+   *
+   * Live unfiltered output value histogram for the forming mempool block. Every live output is binned by value on the oracle log scale; no oracle payment filters are applied. A flat array of log-scale bins, all zero when no mempool is configured.
+   *
+   * Endpoint: `GET /api/oracle/histogram/outputs/live`
+   * @param {{ signal?: AbortSignal, onValue?: (value: number[]) => void, cache?: boolean }} [options]
+   * @returns {Promise<number[]>}
+   */
+  async getOracleHistogramOutputsLive({ signal, onValue, cache } = {}) {
+    const path = `/api/oracle/histogram/outputs/live`;
+    return this.getJson(path, { signal, onValue, cache });
+  }
+
+  /**
+   * Output value histogram at height or day
+   *
+   * Unfiltered output value histogram for a confirmed point. A block height (`840000`) gives every output in that block, coinbase included, binned by value on the oracle log scale; a calendar date (`YYYY-MM-DD`) sums every block that day. A flat array of log-scale bins.
+   *
+   * Endpoint: `GET /api/oracle/histogram/outputs/{point}`
+   *
+   * @param {string} point
+   * @param {{ signal?: AbortSignal, onValue?: (value: number[]) => void, cache?: boolean }} [options]
+   * @returns {Promise<number[]>}
+   */
+  async getOracleHistogramOutputs(point, { signal, onValue, cache } = {}) {
+    const path = `/api/oracle/histogram/outputs/${point}`;
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11781,12 +11965,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/tx-index/{index}`
    *
    * @param {TxIndex} index
-   * @param {{ signal?: AbortSignal, onValue?: (value: Txid) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Txid) => void, cache?: boolean }} [options]
    * @returns {Promise<Txid>}
    */
-  async getTxByIndex(index, { signal, onValue } = {}) {
+  async getTxByIndex(index, { signal, onValue, cache } = {}) {
     const path = `/api/tx-index/${index}`;
-    return this.getText(path, { signal, onValue });
+    return this.getText(path, { signal, onValue, cache });
   }
 
   /**
@@ -11799,12 +11983,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/cpfp/{txid}`
    *
    * @param {Txid} txid
-   * @param {{ signal?: AbortSignal, onValue?: (value: CpfpInfo) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: CpfpInfo) => void, cache?: boolean }} [options]
    * @returns {Promise<CpfpInfo>}
    */
-  async getCpfp(txid, { signal, onValue } = {}) {
+  async getCpfp(txid, { signal, onValue, cache } = {}) {
     const path = `/api/v1/cpfp/${txid}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11817,12 +12001,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/tx/{txid}/rbf`
    *
    * @param {Txid} txid
-   * @param {{ signal?: AbortSignal, onValue?: (value: RbfResponse) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: RbfResponse) => void, cache?: boolean }} [options]
    * @returns {Promise<RbfResponse>}
    */
-  async getTxRbf(txid, { signal, onValue } = {}) {
+  async getTxRbf(txid, { signal, onValue, cache } = {}) {
     const path = `/api/v1/tx/${txid}/rbf`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11835,12 +12019,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/tx/{txid}`
    *
    * @param {Txid} txid
-   * @param {{ signal?: AbortSignal, onValue?: (value: Transaction) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Transaction) => void, cache?: boolean }} [options]
    * @returns {Promise<Transaction>}
    */
-  async getTx(txid, { signal, onValue } = {}) {
+  async getTx(txid, { signal, onValue, cache } = {}) {
     const path = `/api/tx/${txid}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11853,12 +12037,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/tx/{txid}/hex`
    *
    * @param {Txid} txid
-   * @param {{ signal?: AbortSignal, onValue?: (value: Hex) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Hex) => void, cache?: boolean }} [options]
    * @returns {Promise<Hex>}
    */
-  async getTxHex(txid, { signal, onValue } = {}) {
+  async getTxHex(txid, { signal, onValue, cache } = {}) {
     const path = `/api/tx/${txid}/hex`;
-    return this.getText(path, { signal, onValue });
+    return this.getText(path, { signal, onValue, cache });
   }
 
   /**
@@ -11871,12 +12055,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/tx/{txid}/merkleblock-proof`
    *
    * @param {Txid} txid
-   * @param {{ signal?: AbortSignal, onValue?: (value: Hex) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Hex) => void, cache?: boolean }} [options]
    * @returns {Promise<Hex>}
    */
-  async getTxMerkleblockProof(txid, { signal, onValue } = {}) {
+  async getTxMerkleblockProof(txid, { signal, onValue, cache } = {}) {
     const path = `/api/tx/${txid}/merkleblock-proof`;
-    return this.getText(path, { signal, onValue });
+    return this.getText(path, { signal, onValue, cache });
   }
 
   /**
@@ -11889,12 +12073,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/tx/{txid}/merkle-proof`
    *
    * @param {Txid} txid
-   * @param {{ signal?: AbortSignal, onValue?: (value: MerkleProof) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: MerkleProof) => void, cache?: boolean }} [options]
    * @returns {Promise<MerkleProof>}
    */
-  async getTxMerkleProof(txid, { signal, onValue } = {}) {
+  async getTxMerkleProof(txid, { signal, onValue, cache } = {}) {
     const path = `/api/tx/${txid}/merkle-proof`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11908,12 +12092,12 @@ class BrkClient extends BrkClientBase {
    *
    * @param {Txid} txid - Transaction ID
    * @param {Vout} vout - Output index
-   * @param {{ signal?: AbortSignal, onValue?: (value: TxOutspend) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: TxOutspend) => void, cache?: boolean }} [options]
    * @returns {Promise<TxOutspend>}
    */
-  async getTxOutspend(txid, vout, { signal, onValue } = {}) {
+  async getTxOutspend(txid, vout, { signal, onValue, cache } = {}) {
     const path = `/api/tx/${txid}/outspend/${vout}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11926,12 +12110,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/tx/{txid}/outspends`
    *
    * @param {Txid} txid
-   * @param {{ signal?: AbortSignal, onValue?: (value: TxOutspend[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: TxOutspend[]) => void, cache?: boolean }} [options]
    * @returns {Promise<TxOutspend[]>}
    */
-  async getTxOutspends(txid, { signal, onValue } = {}) {
+  async getTxOutspends(txid, { signal, onValue, cache } = {}) {
     const path = `/api/tx/${txid}/outspends`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11944,12 +12128,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/tx/{txid}/raw`
    *
    * @param {Txid} txid
-   * @param {{ signal?: AbortSignal, onValue?: (value: Uint8Array) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: Uint8Array) => void, cache?: boolean }} [options]
    * @returns {Promise<Uint8Array>}
    */
-  async getTxRaw(txid, { signal, onValue } = {}) {
+  async getTxRaw(txid, { signal, onValue, cache } = {}) {
     const path = `/api/tx/${txid}/raw`;
-    return this.getBytes(path, { signal, onValue });
+    return this.getBytes(path, { signal, onValue, cache });
   }
 
   /**
@@ -11962,12 +12146,12 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/tx/{txid}/status`
    *
    * @param {Txid} txid
-   * @param {{ signal?: AbortSignal, onValue?: (value: TxStatus) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: TxStatus) => void, cache?: boolean }} [options]
    * @returns {Promise<TxStatus>}
    */
-  async getTxStatus(txid, { signal, onValue } = {}) {
+  async getTxStatus(txid, { signal, onValue, cache } = {}) {
     const path = `/api/tx/${txid}/status`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -11980,15 +12164,15 @@ class BrkClient extends BrkClientBase {
    * Endpoint: `GET /api/v1/transaction-times`
    *
    * @param {Txid[]} txId - Transaction IDs to look up (max 250 per request).
-   * @param {{ signal?: AbortSignal, onValue?: (value: number[]) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: number[]) => void, cache?: boolean }} [options]
    * @returns {Promise<number[]>}
    */
-  async getTransactionTimes(txId, { signal, onValue } = {}) {
+  async getTransactionTimes(txId, { signal, onValue, cache } = {}) {
     const params = new URLSearchParams();
     for (const _v of txId) params.append('txId[]', String(_v));
     const query = params.toString();
     const path = `/api/v1/transaction-times${query ? '?' + query : ''}`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
   /**
@@ -12015,12 +12199,12 @@ class BrkClient extends BrkClientBase {
    * Full OpenAPI 3.1 specification for this API.
    *
    * Endpoint: `GET /openapi.json`
-   * @param {{ signal?: AbortSignal, onValue?: (value: *) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: *) => void, cache?: boolean }} [options]
    * @returns {Promise<*>}
    */
-  async getOpenapi({ signal, onValue } = {}) {
+  async getOpenapi({ signal, onValue, cache } = {}) {
     const path = `/openapi.json`;
-    return this.getText(path, { signal, onValue });
+    return this.getText(path, { signal, onValue, cache });
   }
 
   /**
@@ -12029,12 +12213,12 @@ class BrkClient extends BrkClientBase {
    * Compact OpenAPI specification optimized for LLM consumption. Removes redundant fields while preserving essential API information. Full spec available at `/openapi.json`.
    *
    * Endpoint: `GET /api.json`
-   * @param {{ signal?: AbortSignal, onValue?: (value: *) => void }} [options]
+   * @param {{ signal?: AbortSignal, onValue?: (value: *) => void, cache?: boolean }} [options]
    * @returns {Promise<*>}
    */
-  async getApi({ signal, onValue } = {}) {
+  async getApi({ signal, onValue, cache } = {}) {
     const path = `/api.json`;
-    return this.getJson(path, { signal, onValue });
+    return this.getJson(path, { signal, onValue, cache });
   }
 
 }