@arkade-os/sdk 0.5.0-rc.3 → 0.5.0-rc.30

package/dist/{chunk-L4HZK4KK.cjs → chunk-AICUNREA.cjs}

@@ -1,14 +1,13 @@
 'use strict';
 
-var chunkUJTYUYY4_cjs = require('./chunk-UJTYUYY4.cjs');
-var chunk5BLDMQED_cjs = require('./chunk-5BLDMQED.cjs');
+var chunkASKOHVGX_cjs = require('./chunk-ASKOHVGX.cjs');
 var base = require('@scure/base');
 var secp256k1_js = require('@noble/curves/secp256k1.js');
 var utils_js = require('@scure/btc-signer/utils.js');
 
 // src/extension/asset/index.ts
 var asset_exports = {};
-chunk5BLDMQED_cjs.__export(asset_exports, {
+chunkASKOHVGX_cjs.__export(asset_exports, {
   ASSET_ID_VECTORS: () => ASSET_ID_VECTORS,
   AssetGroup: () => AssetGroup,
   AssetId: () => AssetId,
@@ -42,8 +41,13 @@ var AssetRefType = /* @__PURE__ */ ((AssetRefType2) => {
 var MASK_ASSET_ID = 1;
 var MASK_CONTROL_ASSET = 2;
 var MASK_METADATA = 4;
-
-// src/extension/utils.ts
+function hexOrThrow(s, message) {
+  try {
+    return base.hex.decode(s);
+  } catch {
+    throw new Error(message);
+  }
+}
 var BufferWriter = class {
   buffer = [];
   write(data) {
@@ -186,11 +190,10 @@ var AssetId = class _AssetId {
   txid;
   groupIndex;
   /**
-   * Create an asset id from a genesis transaction id and group index.
+   * Create a validated asset id from a genesis transaction id and group index.
    *
    * @param txid - Hex-encoded genesis transaction id
    * @param groupIndex - Asset group index within the genesis transaction
-   * @returns A validated asset id
    * @throws Error if the txid is missing, malformed, or not 32 bytes long
    * @see fromString
    */
@@ -198,12 +201,7 @@ var AssetId = class _AssetId {
     if (!txid) {
       throw new Error("missing txid");
     }
-    let buf;
-    try {
-      buf = base.hex.decode(txid);
-    } catch {
-      throw new Error("invalid txid format, must be hex");
-    }
+    const buf = hexOrThrow(txid, "invalid txid format, must be hex");
     if (buf.length !== TX_HASH_SIZE) {
       throw new Error(
         `invalid txid length: got ${buf.length} bytes, want ${TX_HASH_SIZE} bytes`
@@ -216,25 +214,15 @@ var AssetId = class _AssetId {
   /**
    * Decode an asset id from its hex string representation.
    *
-   * @param s - Hex-encoded asset id
-   * @returns Decoded asset id
    * @throws Error if the string is not valid hex or does not encode a valid asset id
    * @see toString
    */
   static fromString(s) {
-    let buf;
-    try {
-      buf = base.hex.decode(s);
-    } catch {
-      throw new Error("invalid asset id format, must be hex");
-    }
-    return _AssetId.fromBytes(buf);
+    return _AssetId.fromBytes(hexOrThrow(s, "invalid asset id format, must be hex"));
   }
   /**
    * Decode an asset id from its serialized bytes.
    *
-   * @param buf - Serialized asset id bytes
-   * @returns Decoded asset id
    * @throws Error if the buffer length is invalid
    */
   static fromBytes(buf) {
@@ -252,7 +240,6 @@ var AssetId = class _AssetId {
   /**
    * Serialize the asset id to raw bytes.
    *
-   * @returns Serialized asset id bytes
    * @see fromBytes
    */
   serialize() {
@@ -263,7 +250,6 @@ var AssetId = class _AssetId {
   /**
    * Encode the asset id to a hex string.
    *
-   * @returns Hex-encoded asset id
    * @see fromString
    */
   toString() {
@@ -283,10 +269,8 @@ var AssetId = class _AssetId {
     }
   }
   /**
-   * Decode an asset id from a binary reader.
+   * Decode an asset id from a binary reader positioned at one.
    *
-   * @param reader - Reader positioned at an asset id
-   * @returns Decoded asset id
    * @throws Error if the reader does not contain enough bytes
    */
   static fromReader(reader) {
@@ -304,7 +288,6 @@ var AssetId = class _AssetId {
   /**
    * Serialize the asset id into an existing binary writer.
    *
-   * @param writer - Writer to append the asset id to
    * @see serialize
    */
   serializeTo(writer) {
@@ -321,48 +304,31 @@ var AssetRef = class _AssetRef {
   get type() {
     return this.ref.type;
   }
-  /**
-   * Create an asset reference that points to a specific asset id.
-   *
-   * @param assetId - Asset id referenced by this pointer
-   * @returns Asset reference by id
-   * @see fromGroupIndex
-   */
+  /** Reference a specific asset id. @see fromGroupIndex */
   static fromId(assetId) {
     return new _AssetRef({ type: 1 /* ByID */, assetId });
   }
   /**
-   * Create an asset reference that points to another asset group by index.
+   * Reference another asset group in the packet.
    *
    * @param groupIndex - Zero-based asset group index in the packet
-   * @returns Asset reference by group index
    * @see fromId
    */
   static fromGroupIndex(groupIndex) {
     return new _AssetRef({ type: 2 /* ByGroup */, groupIndex });
   }
   /**
-   * Decode an asset reference from its hex string form.
+   * Decode an asset reference from hex.
    *
-   * @param s - Hex-encoded asset reference
-   * @returns Decoded asset reference
    * @throws Error if the string is not valid hex or does not encode a valid asset reference
    * @see toString
    */
   static fromString(s) {
-    let buf;
-    try {
-      buf = base.hex.decode(s);
-    } catch {
-      throw new Error("invalid asset ref format, must be hex");
-    }
-    return _AssetRef.fromBytes(buf);
+    return _AssetRef.fromBytes(hexOrThrow(s, "invalid asset ref format, must be hex"));
   }
   /**
    * Decode an asset reference from its serialized bytes.
    *
-   * @param buf - Serialized asset reference bytes
-   * @returns Decoded asset reference
    * @throws Error if the buffer is empty or malformed
    */
   static fromBytes(buf) {
@@ -372,31 +338,19 @@ var AssetRef = class _AssetRef {
     const reader = new BufferReader(buf);
     return _AssetRef.fromReader(reader);
   }
-  /**
-   * Serialize the asset reference to raw bytes.
-   *
-   * @returns Serialized asset reference bytes
-   * @see fromBytes
-   */
+  /** Serialize to raw bytes. @see fromBytes */
   serialize() {
     const writer = new BufferWriter();
     this.serializeTo(writer);
     return writer.toBytes();
   }
-  /**
-   * Encode the asset reference to a hex string.
-   *
-   * @returns Hex-encoded asset reference
-   * @see fromString
-   */
+  /** Encode to hex. @see fromString */
   toString() {
     return base.hex.encode(this.serialize());
   }
   /**
-   * Decode an asset reference from a binary reader.
+   * Decode an asset reference from a reader positioned at one.
    *
-   * @param reader - Reader positioned at an asset reference
-   * @returns Decoded asset reference
    * @throws Error if the type is unknown or the reader does not contain enough bytes
    */
   static fromReader(reader) {
@@ -423,12 +377,7 @@ var AssetRef = class _AssetRef {
     }
     return ref;
   }
-  /**
-   * Serialize the asset reference into an existing binary writer.
-   *
-   * @param writer - Writer to append the asset reference to
-   * @see serialize
-   */
+  /** Append the serialized reference to `writer`. @see serialize */
   serializeTo(writer) {
     writer.writeByte(this.ref.type);
     switch (this.ref.type) {
@@ -469,12 +418,7 @@ var AssetInput = class _AssetInput {
     if (!txid || txid.length === 0) {
       throw new Error("missing input intent txid");
     }
-    let buf;
-    try {
-      buf = base.hex.decode(txid);
-    } catch {
-      throw new Error("invalid input intent txid format, must be hex");
-    }
+    const buf = hexOrThrow(txid, "invalid input intent txid format, must be hex");
     if (buf.length !== TX_HASH_SIZE) {
       throw new Error("invalid input intent txid length");
     }
@@ -489,13 +433,7 @@ var AssetInput = class _AssetInput {
   }
   /** Decode an asset input from its hex string form. */
   static fromString(s) {
-    let buf;
-    try {
-      buf = base.hex.decode(s);
-    } catch {
-      throw new Error("invalid format, must be hex");
-    }
-    return _AssetInput.fromBytes(buf);
+    return _AssetInput.fromBytes(hexOrThrow(s, "invalid format, must be hex"));
   }
   /** Decode an asset input from its serialized bytes. */
   static fromBytes(buf) {
@@ -588,13 +526,7 @@ var AssetInputs = class _AssetInputs {
     if (!s || s.length === 0) {
       throw new Error("missing asset inputs");
     }
-    let buf;
-    try {
-      buf = base.hex.decode(s);
-    } catch {
-      throw new Error("invalid asset inputs format, must be hex");
-    }
-    const reader = new BufferReader(buf);
+    const reader = new BufferReader(hexOrThrow(s, "invalid asset inputs format, must be hex"));
     return _AssetInputs.fromReader(reader);
   }
   /** Serialize the asset input list to raw bytes. */
@@ -662,13 +594,7 @@ var AssetOutput = class _AssetOutput {
   }
   /** Decode an asset output from its hex string form. */
   static fromString(s) {
-    let buf;
-    try {
-      buf = base.hex.decode(s);
-    } catch {
-      throw new Error("invalid asset output format, must be hex");
-    }
-    return _AssetOutput.fromBytes(buf);
+    return _AssetOutput.fromBytes(hexOrThrow(s, "invalid asset output format, must be hex"));
   }
   /** Decode an asset output from its serialized bytes. */
   static fromBytes(buf) {
@@ -743,13 +669,7 @@ var AssetOutputs = class _AssetOutputs {
     if (!s || s.length === 0) {
       throw new Error("missing asset outputs");
     }
-    let buf;
-    try {
-      buf = base.hex.decode(s);
-    } catch {
-      throw new Error("invalid asset outputs format, must be hex");
-    }
-    const reader = new BufferReader(buf);
+    const reader = new BufferReader(hexOrThrow(s, "invalid asset outputs format, must be hex"));
     return _AssetOutputs.fromReader(reader);
   }
   /** Serialize the asset output list to raw bytes. */
@@ -811,13 +731,7 @@ var Metadata = class _Metadata {
   }
   /** Decode metadata from its hex string form. */
   static fromString(s) {
-    let buf;
-    try {
-      buf = base.hex.decode(s);
-    } catch {
-      throw new Error("invalid metadata format, must be hex");
-    }
-    return _Metadata.fromBytes(buf);
+    return _Metadata.fromBytes(hexOrThrow(s, "invalid metadata format, must be hex"));
   }
   /** Decode metadata from its serialized bytes. */
   static fromBytes(buf) {
@@ -886,13 +800,7 @@ var MetadataList = class _MetadataList {
   static ARK_LEAF_VERSION = 0;
   /** Create a metadata list from its hex string form. */
   static fromString(s) {
-    let buf;
-    try {
-      buf = base.hex.decode(s);
-    } catch {
-      throw new Error("invalid metadata list format");
-    }
-    return _MetadataList.fromBytes(buf);
+    return _MetadataList.fromBytes(hexOrThrow(s, "invalid metadata list format"));
   }
   /** Decode a metadata list from its serialized bytes. */
   static fromBytes(buf) {
@@ -1005,13 +913,7 @@ var AssetGroup = class _AssetGroup {
    * @see toString
    */
   static fromString(s) {
-    let buf;
-    try {
-      buf = base.hex.decode(s);
-    } catch {
-      throw new Error("invalid format, must be hex");
-    }
-    return _AssetGroup.fromBytes(buf);
+    return _AssetGroup.fromBytes(hexOrThrow(s, "invalid format, must be hex"));
   }
   /**
    * Decode an asset group from its serialized bytes.
@@ -1196,13 +1098,7 @@ var Packet = class _Packet {
     if (!s) {
       throw new Error("missing packet data");
     }
-    let buf;
-    try {
-      buf = base.hex.decode(s);
-    } catch {
-      throw new Error("invalid packet format, must be hex");
-    }
-    return _Packet.fromBytes(buf);
+    return _Packet.fromBytes(hexOrThrow(s, "invalid packet format, must be hex"));
   }
   /**
    * type returns the TLV packet type tag. Implements ExtensionPacket interface.
@@ -1420,10 +1316,10 @@ async function indexerFetch(input, init) {
     const lastAttempt = attempt >= maxAttempts;
     let res;
     try {
-      res = await chunkUJTYUYY4_cjs.rateGate.runHttp(input, () => chunkUJTYUYY4_cjs.baseFetch(input, init));
+      res = await chunkASKOHVGX_cjs.rateGate.runHttp(input, () => chunkASKOHVGX_cjs.baseFetch(input, init));
     } catch (err) {
-      const mapped = chunkUJTYUYY4_cjs.toProviderUnavailable(err, "indexer");
-      if (lastAttempt || !(mapped instanceof chunkUJTYUYY4_cjs.ProviderUnavailableError)) throw mapped;
+      const mapped = chunkASKOHVGX_cjs.toProviderUnavailable(err, "indexer");
+      if (lastAttempt || !(mapped instanceof chunkASKOHVGX_cjs.ProviderUnavailableError)) throw mapped;
       await sleep(retryDelayMs(attempt));
       continue;
     }
@@ -1435,7 +1331,7 @@ async function indexerFetch(input, init) {
       body = void 0;
     }
     try {
-      chunkUJTYUYY4_cjs.throwIfHttpUnavailable(res, "indexer", body);
+      chunkASKOHVGX_cjs.throwIfHttpUnavailable(res, "indexer", body);
     } catch (err) {
       if (lastAttempt) throw err;
       await sleep(retryDelayMs(attempt));
@@ -1464,24 +1360,20 @@ var ChainTxType = /* @__PURE__ */ ((ChainTxType2) => {
   return ChainTxType2;
 })(ChainTxType || {});
 var RestIndexerProvider = class {
-  constructor(serverUrl = chunkUJTYUYY4_cjs.DEFAULT_ARKADE_SERVER_URL, options = {}) {
+  constructor(serverUrl = chunkASKOHVGX_cjs.DEFAULT_ARKADE_SERVER_URL, options = {}) {
     this.serverUrl = serverUrl;
     this.eventSource = options.eventSource;
   }
   serverUrl;
   /** Overrides {@link configureEventSource} for this provider's subscription. */
   eventSource;
+  /** @see fetchVtxosJson */
+  inFlightVtxoReads = /* @__PURE__ */ new Map();
   async getVtxoTree(batchOutpoint, opts) {
-    let url = `${this.serverUrl}/v1/indexer/batch/${batchOutpoint.txid}/${batchOutpoint.vout}/tree`;
-    const params = new URLSearchParams();
-    if (opts) {
-      if (opts.pageIndex !== void 0)
-        params.append("page.index", opts.pageIndex.toString());
-      if (opts.pageSize !== void 0) params.append("page.size", opts.pageSize.toString());
-    }
-    if (params.toString()) {
-      url += "?" + params.toString();
-    }
+    const url = withPage(
+      `${this.serverUrl}/v1/indexer/batch/${batchOutpoint.txid}/${batchOutpoint.vout}/tree`,
+      opts
+    );
     const res = await indexerFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch vtxo tree: ${res.statusText}`);
@@ -1490,24 +1382,14 @@ var RestIndexerProvider = class {
     if (!Response.isVtxoTreeResponse(data)) {
       throw new Error("Invalid vtxo tree data received");
     }
-    data.vtxoTree.forEach((tx) => {
-      tx.children = Object.fromEntries(
-        Object.entries(tx.children).map(([key, value]) => [Number(key), value])
-      );
-    });
+    numberChildKeys(data.vtxoTree);
     return data;
   }
   async getVtxoTreeLeaves(batchOutpoint, opts) {
-    let url = `${this.serverUrl}/v1/indexer/batch/${batchOutpoint.txid}/${batchOutpoint.vout}/tree/leaves`;
-    const params = new URLSearchParams();
-    if (opts) {
-      if (opts.pageIndex !== void 0)
-        params.append("page.index", opts.pageIndex.toString());
-      if (opts.pageSize !== void 0) params.append("page.size", opts.pageSize.toString());
-    }
-    if (params.toString()) {
-      url += "?" + params.toString();
-    }
+    const url = withPage(
+      `${this.serverUrl}/v1/indexer/batch/${batchOutpoint.txid}/${batchOutpoint.vout}/tree/leaves`,
+      opts
+    );
     const res = await indexerFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch vtxo tree leaves: ${res.statusText}`);
@@ -1543,16 +1425,7 @@ var RestIndexerProvider = class {
     return data;
   }
   async getCommitmentTxConnectors(txid, opts) {
-    let url = `${this.serverUrl}/v1/indexer/commitmentTx/${txid}/connectors`;
-    const params = new URLSearchParams();
-    if (opts) {
-      if (opts.pageIndex !== void 0)
-        params.append("page.index", opts.pageIndex.toString());
-      if (opts.pageSize !== void 0) params.append("page.size", opts.pageSize.toString());
-    }
-    if (params.toString()) {
-      url += "?" + params.toString();
-    }
+    const url = withPage(`${this.serverUrl}/v1/indexer/commitmentTx/${txid}/connectors`, opts);
     const res = await indexerFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch commitment tx connectors: ${res.statusText}`);
@@ -1561,24 +1434,11 @@ var RestIndexerProvider = class {
     if (!Response.isConnectorsResponse(data)) {
       throw new Error("Invalid commitment tx connectors data received");
     }
-    data.connectors.forEach((tx) => {
-      tx.children = Object.fromEntries(
-        Object.entries(tx.children).map(([key, value]) => [Number(key), value])
-      );
-    });
+    numberChildKeys(data.connectors);
     return data;
   }
   async getCommitmentTxForfeitTxs(txid, opts) {
-    let url = `${this.serverUrl}/v1/indexer/commitmentTx/${txid}/forfeitTxs`;
-    const params = new URLSearchParams();
-    if (opts) {
-      if (opts.pageIndex !== void 0)
-        params.append("page.index", opts.pageIndex.toString());
-      if (opts.pageSize !== void 0) params.append("page.size", opts.pageSize.toString());
-    }
-    if (params.toString()) {
-      url += "?" + params.toString();
-    }
+    const url = withPage(`${this.serverUrl}/v1/indexer/commitmentTx/${txid}/forfeitTxs`, opts);
     const res = await indexerFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch commitment tx forfeitTxs: ${res.statusText}`);
@@ -1590,7 +1450,34 @@ var RestIndexerProvider = class {
     return data;
   }
   getSubscription(subscriptionId, abortSignal) {
-    const url = `${this.serverUrl}/v1/indexer/script/subscription/${subscriptionId}`;
+    const stream = this.subscriptionStream(
+      `${this.serverUrl}/v1/indexer/script/subscription/${subscriptionId}`,
+      abortSignal
+    );
+    const gen = (async function* () {
+      for await (const message of stream) if (message.type === "event") yield message;
+    })();
+    const origReturn = gen.return.bind(gen);
+    gen.return = (value) => {
+      stream.return?.();
+      return origReturn(value);
+    };
+    return gen;
+  }
+  getFilteredSubscription(filter, abortSignal) {
+    if (filter.expressions.length === 0) {
+      throw new Error("A filtered subscription needs at least one expression");
+    }
+    const query = new URLSearchParams(
+      filter.expressions.map((expression) => ["filter.expressions", expression])
+    );
+    return this.subscriptionStream(
+      `${this.serverUrl}/v1/indexer/subscription?${query}`,
+      abortSignal
+    );
+  }
+  /** The SSE transport behind every subscription; `ExpoIndexerProvider` replaces only this. */
+  subscriptionStream(url, abortSignal) {
     const override = this.eventSource;
     let iterator = null;
     const closeIterator = () => iterator?.close();
@@ -1600,25 +1487,15 @@ var RestIndexerProvider = class {
       try {
         while (!abortSignal?.aborted) {
           try {
-            const currentIterator = chunkUJTYUYY4_cjs.eventSourceIterator(
-              chunkUJTYUYY4_cjs.resolveEventSource(override)(url)
+            const currentIterator = chunkASKOHVGX_cjs.eventSourceIterator(
+              chunkASKOHVGX_cjs.resolveEventSource(override)(url)
             );
             iterator = currentIterator;
             for await (const event of currentIterator) {
               if (abortSignal?.aborted) break;
               try {
-                const data = JSON.parse(event.data);
-                if (data.event) {
-                  yield {
-                    txid: data.event.txid,
-                    scripts: data.event.scripts || [],
-                    newVtxos: (data.event.newVtxos || []).map(chunkUJTYUYY4_cjs.convertVtxo),
-                    spentVtxos: (data.event.spentVtxos || []).map(chunkUJTYUYY4_cjs.convertVtxo),
-                    sweptVtxos: (data.event.sweptVtxos || []).map(chunkUJTYUYY4_cjs.convertVtxo),
-                    tx: data.event.tx,
-                    checkpointTxs: data.event.checkpointTxs
-                  };
-                }
+                const message = toSubscriptionMessage(JSON.parse(event.data));
+                if (message) yield message;
               } catch (err) {
                 console.error("Failed to parse subscription event:", err);
                 throw err;
@@ -1628,14 +1505,14 @@ var RestIndexerProvider = class {
             if (abortSignal?.aborted || error instanceof Error && error.name === "AbortError") {
               break;
             }
-            if (chunkUJTYUYY4_cjs.isFetchTimeoutError(error)) {
+            if (chunkASKOHVGX_cjs.isFetchTimeoutError(error)) {
               console.debug("Timeout error ignored");
               continue;
             }
-            if (chunkUJTYUYY4_cjs.isEventSourceError(error)) {
+            if (chunkASKOHVGX_cjs.isEventSourceError(error)) {
               throw error;
             }
-            if (chunkUJTYUYY4_cjs.isEventSourceUnavailableError(error)) throw error;
+            if (chunkASKOHVGX_cjs.isEventSourceUnavailableError(error)) throw error;
             console.error("Subscription error:", error);
             throw error;
           } finally {
@@ -1656,16 +1533,7 @@ var RestIndexerProvider = class {
     return gen;
   }
   async getVirtualTxs(txids, opts) {
-    let url = `${this.serverUrl}/v1/indexer/virtualTx/${txids.join(",")}`;
-    const params = new URLSearchParams();
-    if (opts) {
-      if (opts.pageIndex !== void 0)
-        params.append("page.index", opts.pageIndex.toString());
-      if (opts.pageSize !== void 0) params.append("page.size", opts.pageSize.toString());
-    }
-    if (params.toString()) {
-      url += "?" + params.toString();
-    }
+    const url = withPage(`${this.serverUrl}/v1/indexer/virtualTx/${txids.join(",")}`, opts);
     const res = await indexerFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch virtual txs: ${res.statusText}`);
@@ -1677,16 +1545,10 @@ var RestIndexerProvider = class {
     return data;
   }
   async getVtxoChain(vtxoOutpoint, opts) {
-    let url = `${this.serverUrl}/v1/indexer/vtxo/${vtxoOutpoint.txid}/${vtxoOutpoint.vout}/chain`;
-    const params = new URLSearchParams();
-    if (opts) {
-      if (opts.pageIndex !== void 0)
-        params.append("page.index", opts.pageIndex.toString());
-      if (opts.pageSize !== void 0) params.append("page.size", opts.pageSize.toString());
-    }
-    if (params.toString()) {
-      url += "?" + params.toString();
-    }
+    const url = withPage(
+      `${this.serverUrl}/v1/indexer/vtxo/${vtxoOutpoint.txid}/${vtxoOutpoint.vout}/chain`,
+      opts
+    );
     const res = await indexerFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch vtxo chain: ${res.statusText}`);
@@ -1777,19 +1639,43 @@ var RestIndexerProvider = class {
     if (params.toString()) {
       url += "?" + params.toString();
     }
-    const res = await indexerFetch(url);
-    if (!res.ok) {
-      throw new Error(`Failed to fetch vtxos: ${res.statusText}`);
-    }
-    const data = await res.json();
-    if (!Response.isVtxosResponse(data)) {
-      throw new Error("Invalid vtxos data received");
-    }
+    const data = await this.fetchVtxosJson(url);
     return {
-      vtxos: data.vtxos.map(chunkUJTYUYY4_cjs.convertVtxo),
+      vtxos: data.vtxos.map(chunkASKOHVGX_cjs.convertVtxo),
       page: data.page
     };
   }
+  /**
+   * The wire read behind {@link fetchVtxosPage}, with an identical read
+   * already in flight served from that one request instead of repeated.
+   *
+   * Two callers can want the same page at the same instant without either
+   * being redundant, so there is no single call site to remove: a send that
+   * leaves change makes the indexer emit `vtxo_spent` and `vtxo_received` for
+   * the wallet's own contract milliseconds apart, and `handleContractEvent`
+   * delta-syncs that contract on both arms.
+   */
+  async fetchVtxosJson(url) {
+    const joined = this.inFlightVtxoReads.get(url);
+    if (joined) return joined;
+    const shared = (async () => {
+      const res = await indexerFetch(url);
+      if (!res.ok) {
+        throw new Error(`Failed to fetch vtxos: ${res.statusText}`);
+      }
+      const data = await res.json();
+      if (!Response.isVtxosResponse(data)) {
+        throw new Error("Invalid vtxos data received");
+      }
+      return data;
+    })();
+    this.inFlightVtxoReads.set(url, shared);
+    try {
+      return await shared;
+    } finally {
+      if (this.inFlightVtxoReads.get(url) === shared) this.inFlightVtxoReads.delete(url);
+    }
+  }
   async getAssetDetails(assetId) {
     const url = `${this.serverUrl}/v1/indexer/asset/${encodeURIComponent(assetId)}`;
     const res = await indexerFetch(url);
@@ -1808,14 +1694,15 @@ var RestIndexerProvider = class {
       controlAssetId: data.controlAsset || void 0
     };
   }
-  async subscribeForScripts(scripts, subscriptionId) {
+  async subscribeForScripts(scripts, subscriptionId, signal) {
     const url = `${this.serverUrl}/v1/indexer/script/subscribe`;
     const res = await indexerFetch(url, {
       headers: {
         "Content-Type": "application/json"
       },
       method: "POST",
-      body: JSON.stringify({ scripts, subscriptionId })
+      body: JSON.stringify({ scripts, subscriptionId }),
+      signal
     });
     if (!res.ok) {
       const errorText = await res.text();
@@ -1840,6 +1727,36 @@ var RestIndexerProvider = class {
     }
   }
 };
+function withPage(url, opts) {
+  const params = new URLSearchParams();
+  if (opts?.pageIndex !== void 0) params.append("page.index", opts.pageIndex.toString());
+  if (opts?.pageSize !== void 0) params.append("page.size", opts.pageSize.toString());
+  const query = params.toString();
+  return query ? `${url}?${query}` : url;
+}
+function numberChildKeys(txs) {
+  txs.forEach((tx) => {
+    tx.children = Object.fromEntries(
+      Object.entries(tx.children).map(([key, value]) => [Number(key), value])
+    );
+  });
+}
+function toSubscriptionMessage(data) {
+  if (data.event) return { type: "event", ...toSubscriptionResponse(data.event) };
+  if (data.heartbeat !== void 0) return { type: "heartbeat" };
+  return null;
+}
+function toSubscriptionResponse(event) {
+  return {
+    txid: event.txid,
+    scripts: event.scripts || [],
+    newVtxos: (event.newVtxos || []).map(chunkASKOHVGX_cjs.convertVtxo),
+    spentVtxos: (event.spentVtxos || []).map(chunkASKOHVGX_cjs.convertVtxo),
+    sweptVtxos: (event.sweptVtxos || []).map(chunkASKOHVGX_cjs.convertVtxo),
+    tx: event.tx,
+    checkpointTxs: event.checkpointTxs
+  };
+}
 function parseAssetMetadata(metadata) {
   const metadataList = MetadataList.fromString(metadata);
   const out = {};
@@ -1879,31 +1796,12 @@ var Response;
     return typeof data === "object" && typeof data.txid === "string" && typeof data.vout === "number";
   }
   Response2.isOutpoint = isOutpoint;
-  function isOutpointArray(data) {
-    return Array.isArray(data) && data.every(isOutpoint);
-  }
-  Response2.isOutpointArray = isOutpointArray;
   function isTx(data) {
     return typeof data === "object" && typeof data.txid === "string" && typeof data.children === "object" && Object.values(data.children).every(isTxid) && Object.keys(data.children).every((k) => Number.isInteger(Number(k)));
   }
-  function isTxsArray(data) {
-    return Array.isArray(data) && data.every(isTx);
-  }
-  Response2.isTxsArray = isTxsArray;
-  function isTxHistoryRecord(data) {
-    return typeof data === "object" && typeof data.amount === "string" && typeof data.createdAt === "string" && typeof data.isSettled === "boolean" && typeof data.settledBy === "string" && Object.values(IndexerTxType).includes(data.type) && (!data.commitmentTxid && typeof data.virtualTxid === "string" || typeof data.commitmentTxid === "string" && !data.virtualTxid);
-  }
-  function isTxHistoryRecordArray(data) {
-    return Array.isArray(data) && data.every(isTxHistoryRecord);
-  }
-  Response2.isTxHistoryRecordArray = isTxHistoryRecordArray;
   function isTxid(data) {
     return typeof data === "string" && data.length === 64;
   }
-  function isTxidArray(data) {
-    return Array.isArray(data) && data.every(isTxid);
-  }
-  Response2.isTxidArray = isTxidArray;
   function isVtxoAsset(data) {
     return typeof data === "object" && data !== null && typeof data.assetId === "string" && typeof data.amount === "string";
   }
@@ -1929,10 +1827,6 @@ var Response;
     return typeof data === "object" && Array.isArray(data.txids) && data.txids.every(isTxid) && (!data.page || isPageResponse(data.page));
   }
   Response2.isForfeitTxsResponse = isForfeitTxsResponse;
-  function isSweptCommitmentTxResponse(data) {
-    return typeof data === "object" && Array.isArray(data.sweptBy) && data.sweptBy.every(isTxid);
-  }
-  Response2.isSweptCommitmentTxResponse = isSweptCommitmentTxResponse;
   function isBatchSweepTransactionsResponse(data) {
     return typeof data === "object" && Array.isArray(data.sweptBy) && data.sweptBy.every(isTxid);
   }
@@ -1969,5 +1863,6 @@ exports.Metadata = Metadata;
 exports.Packet = Packet;
 exports.RestIndexerProvider = RestIndexerProvider;
 exports.asset_exports = asset_exports;
-//# sourceMappingURL=chunk-L4HZK4KK.cjs.map
-//# sourceMappingURL=chunk-L4HZK4KK.cjs.map
+exports.toSubscriptionMessage = toSubscriptionMessage;
+//# sourceMappingURL=chunk-AICUNREA.cjs.map
+//# sourceMappingURL=chunk-AICUNREA.cjs.map