@arkade-os/sdk 0.5.0-rc.11 → 0.5.0-rc.13

package/dist/{chunk-WSQAWSEH.js → chunk-3JLYJ5KZ.js}

@@ -1,4 +1,4 @@
-import { __export, DEFAULT_ARKADE_SERVER_URL, eventSourceIterator, resolveEventSource, convertVtxo, isFetchTimeoutError, isEventSourceError, isEventSourceUnavailableError, rateGate, baseFetch, toProviderUnavailable, ProviderUnavailableError, throwIfHttpUnavailable } from './chunk-CMLSTGOC.js';
+import { __export, DEFAULT_ARKADE_SERVER_URL, eventSourceIterator, resolveEventSource, isFetchTimeoutError, isEventSourceError, isEventSourceUnavailableError, convertVtxo, rateGate, baseFetch, toProviderUnavailable, ProviderUnavailableError, throwIfHttpUnavailable } from './chunk-EJYWGTZ7.js';
 import { hex } from '@scure/base';
 import { schnorr } from '@noble/curves/secp256k1.js';
 import { compareBytes } from '@scure/btc-signer/utils.js';
@@ -39,8 +39,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 hex.decode(s);
+  } catch {
+    throw new Error(message);
+  }
+}
 var BufferWriter = class {
   buffer = [];
   write(data) {
@@ -183,11 +188,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
    */
@@ -195,12 +199,7 @@ var AssetId = class _AssetId {
     if (!txid) {
       throw new Error("missing txid");
     }
-    let buf;
-    try {
-      buf = 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`
@@ -213,25 +212,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 = 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) {
@@ -249,7 +238,6 @@ var AssetId = class _AssetId {
   /**
    * Serialize the asset id to raw bytes.
    *
-   * @returns Serialized asset id bytes
    * @see fromBytes
    */
   serialize() {
@@ -260,7 +248,6 @@ var AssetId = class _AssetId {
   /**
    * Encode the asset id to a hex string.
    *
-   * @returns Hex-encoded asset id
    * @see fromString
    */
   toString() {
@@ -280,10 +267,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) {
@@ -301,7 +286,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) {
@@ -318,48 +302,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 = 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) {
@@ -369,31 +336,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 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) {
@@ -420,12 +375,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) {
@@ -466,12 +416,7 @@ var AssetInput = class _AssetInput {
     if (!txid || txid.length === 0) {
       throw new Error("missing input intent txid");
     }
-    let buf;
-    try {
-      buf = 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");
     }
@@ -486,13 +431,7 @@ var AssetInput = class _AssetInput {
   }
   /** Decode an asset input from its hex string form. */
   static fromString(s) {
-    let buf;
-    try {
-      buf = 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) {
@@ -585,13 +524,7 @@ var AssetInputs = class _AssetInputs {
     if (!s || s.length === 0) {
       throw new Error("missing asset inputs");
     }
-    let buf;
-    try {
-      buf = 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. */
@@ -659,13 +592,7 @@ var AssetOutput = class _AssetOutput {
   }
   /** Decode an asset output from its hex string form. */
   static fromString(s) {
-    let buf;
-    try {
-      buf = 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) {
@@ -740,13 +667,7 @@ var AssetOutputs = class _AssetOutputs {
     if (!s || s.length === 0) {
       throw new Error("missing asset outputs");
     }
-    let buf;
-    try {
-      buf = 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. */
@@ -808,13 +729,7 @@ var Metadata = class _Metadata {
   }
   /** Decode metadata from its hex string form. */
   static fromString(s) {
-    let buf;
-    try {
-      buf = 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) {
@@ -883,13 +798,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 = 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) {
@@ -1002,13 +911,7 @@ var AssetGroup = class _AssetGroup {
    * @see toString
    */
   static fromString(s) {
-    let buf;
-    try {
-      buf = 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.
@@ -1193,13 +1096,7 @@ var Packet = class _Packet {
     if (!s) {
       throw new Error("missing packet data");
     }
-    let buf;
-    try {
-      buf = 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.
@@ -1471,16 +1368,10 @@ var RestIndexerProvider = class {
   /** @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}`);
@@ -1489,24 +1380,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}`);
@@ -1542,16 +1423,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}`);
@@ -1560,24 +1432,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}`);
@@ -1608,15 +1467,7 @@ var RestIndexerProvider = class {
               try {
                 const data = JSON.parse(event.data);
                 if (data.event) {
-                  yield {
-                    txid: data.event.txid,
-                    scripts: data.event.scripts || [],
-                    newVtxos: (data.event.newVtxos || []).map(convertVtxo),
-                    spentVtxos: (data.event.spentVtxos || []).map(convertVtxo),
-                    sweptVtxos: (data.event.sweptVtxos || []).map(convertVtxo),
-                    tx: data.event.tx,
-                    checkpointTxs: data.event.checkpointTxs
-                  };
+                  yield toSubscriptionResponse(data.event);
                 }
               } catch (err) {
                 console.error("Failed to parse subscription event:", err);
@@ -1655,16 +1506,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}`);
@@ -1676,16 +1518,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}`);
@@ -1863,6 +1699,31 @@ 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 toSubscriptionResponse(event) {
+  return {
+    txid: event.txid,
+    scripts: event.scripts || [],
+    newVtxos: (event.newVtxos || []).map(convertVtxo),
+    spentVtxos: (event.spentVtxos || []).map(convertVtxo),
+    sweptVtxos: (event.sweptVtxos || []).map(convertVtxo),
+    tx: event.tx,
+    checkpointTxs: event.checkpointTxs
+  };
+}
 function parseAssetMetadata(metadata) {
   const metadataList = MetadataList.fromString(metadata);
   const out = {};
@@ -1902,31 +1763,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";
   }
@@ -1952,10 +1794,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);
   }
@@ -1978,6 +1816,6 @@ var Response;
   Response2.isGetAssetResponse = isGetAssetResponse;
 })(Response || (Response = {}));
 
-export { AssetGroup, AssetId, AssetInput, AssetOutput, AssetRef, BufferReader, BufferWriter, ChainTxType, DEFAULT_VTXO_PAGE_SIZE, IndexerTxType, Metadata, Packet, RestIndexerProvider, asset_exports };
-//# sourceMappingURL=chunk-WSQAWSEH.js.map
-//# sourceMappingURL=chunk-WSQAWSEH.js.map
+export { AssetGroup, AssetId, AssetInput, AssetOutput, AssetRef, BufferReader, BufferWriter, ChainTxType, DEFAULT_VTXO_PAGE_SIZE, IndexerTxType, Metadata, Packet, RestIndexerProvider, asset_exports, toSubscriptionResponse };
+//# sourceMappingURL=chunk-3JLYJ5KZ.js.map
+//# sourceMappingURL=chunk-3JLYJ5KZ.js.map