@arkade-os/sdk 0.4.64 → 0.4.66

package/dist/{chunk-RXITDAV4.cjs → chunk-3S3JZUEN.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkFZFSGOTZ_cjs = require('./chunk-FZFSGOTZ.cjs');
+var chunkZIRFXBKL_cjs = require('./chunk-ZIRFXBKL.cjs');
 var chunk5BLDMQED_cjs = require('./chunk-5BLDMQED.cjs');
 var base = require('@scure/base');
 var secp256k1_js = require('@noble/curves/secp256k1.js');
@@ -9,6 +9,7 @@ var utils_js = require('@scure/btc-signer/utils.js');
 // src/extension/asset/index.ts
 var asset_exports = {};
 chunk5BLDMQED_cjs.__export(asset_exports, {
+  ASSET_ID_VECTORS: () => ASSET_ID_VECTORS,
   AssetGroup: () => AssetGroup,
   AssetId: () => AssetId,
   AssetInput: () => AssetInput,
@@ -1273,6 +1274,143 @@ var Packet = class _Packet {
     return packet;
   }
 };
+
+// src/extension/asset/assetIdVectors.json
+var assetIdVectors_default = {
+  version: 1,
+  note: "Source of truth for the Arkade Asset ID encodings. See ts-sdk plans/asset-id-shared-vectors.md.",
+  txid_hex: "0102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f20",
+  script_txid_hex: "201f1e1d1c1b1a191817161514131211100f0e0d0c0b0a090807060504030201",
+  valid: [
+    {
+      label: "group 0 (issuance mints this one)",
+      group_index: 0,
+      asset_id_hex: "0102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f200000",
+      script_group_index_item_hex: ""
+    },
+    {
+      label: "group 1 \u2014 high byte zero, so endianness bugs hide here",
+      group_index: 1,
+      asset_id_hex: "0102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f200100",
+      script_group_index_item_hex: "01"
+    },
+    {
+      label: "endianness discriminator (gidx 258 = 0x0102)",
+      group_index: 258,
+      asset_id_hex: "0102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f200201",
+      script_group_index_item_hex: "0201"
+    },
+    {
+      label: "upper bound \u2014 script number needs a third byte, the u16 blob does not",
+      group_index: 65535,
+      asset_id_hex: "0102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f20ffff",
+      script_group_index_item_hex: "ffff00"
+    }
+  ],
+  invalid_identity: [
+    {
+      label: "uppercase",
+      value: "0102030405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F200201",
+      why: "identity is lowercase-only",
+      normalizes_to: "0102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f200201"
+    },
+    {
+      label: "too short",
+      value: "0102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f2002",
+      why: "33 bytes; the identity is 34"
+    },
+    {
+      label: "non-hex",
+      value: "z102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f200201",
+      why: "ASCII hex only"
+    }
+  ],
+  invalid_decode: [
+    {
+      label: "empty",
+      value: "",
+      expected_error: "missing asset id"
+    },
+    {
+      label: "too short",
+      value: "0102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f2002",
+      expected_error: "invalid asset id length"
+    },
+    {
+      label: "too long",
+      value: "0102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f200201ff",
+      expected_error: "invalid asset id length"
+    },
+    {
+      label: "non-hex",
+      value: "z102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f200201",
+      expected_error: "invalid asset id format"
+    },
+    {
+      label: "zero txid",
+      value: "00000000000000000000000000000000000000000000000000000000000000000201",
+      expected_error: "empty txid"
+    }
+  ],
+  invalid_construction: [
+    {
+      label: "missing txid",
+      txid_hex: "",
+      group_index: 0,
+      expected_error: "missing txid"
+    },
+    {
+      label: "non-hex txid",
+      txid_hex: "z102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f20",
+      group_index: 0,
+      expected_error: "invalid txid format"
+    },
+    {
+      label: "txid too long",
+      txid_hex: "0102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f2021",
+      group_index: 0,
+      expected_error: "invalid txid length"
+    },
+    {
+      label: "txid too short",
+      txid_hex: "0102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e",
+      group_index: 0,
+      expected_error: "invalid txid length"
+    },
+    {
+      label: "zero txid",
+      txid_hex: "0000000000000000000000000000000000000000000000000000000000000000",
+      group_index: 0,
+      expected_error: "empty txid"
+    },
+    {
+      label: "gidx out of range",
+      txid_hex: "0102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f20",
+      group_index: 65536,
+      expected_error: "invalid group index",
+      outside_uint16: true
+    },
+    {
+      label: "gidx negative",
+      txid_hex: "0102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f20",
+      group_index: -1,
+      expected_error: "invalid group index",
+      outside_uint16: true
+    }
+  ]
+};
+
+// src/extension/asset/assetIdVectors.ts
+function deepFreeze(value) {
+  if (value !== null && typeof value === "object" && !Object.isFrozen(value)) {
+    Object.freeze(value);
+    for (const key of Object.getOwnPropertyNames(value)) {
+      deepFreeze(value[key]);
+    }
+  }
+  return value;
+}
+var ASSET_ID_VECTORS = deepFreeze(assetIdVectors_default);
 var INDEXER_MAX_ATTEMPTS = 3;
 var INDEXER_RETRY_BASE_MS = 250;
 async function indexerFetch(input, init) {
@@ -1282,10 +1420,10 @@ async function indexerFetch(input, init) {
     const lastAttempt = attempt >= maxAttempts;
     let res;
     try {
-      res = await chunkFZFSGOTZ_cjs.rateGate.runHttp(input, () => chunkFZFSGOTZ_cjs.baseFetch(input, init));
+      res = await chunkZIRFXBKL_cjs.rateGate.runHttp(input, () => chunkZIRFXBKL_cjs.baseFetch(input, init));
     } catch (err) {
-      const mapped = chunkFZFSGOTZ_cjs.toProviderUnavailable(err, "indexer");
-      if (lastAttempt || !(mapped instanceof chunkFZFSGOTZ_cjs.ProviderUnavailableError)) throw mapped;
+      const mapped = chunkZIRFXBKL_cjs.toProviderUnavailable(err, "indexer");
+      if (lastAttempt || !(mapped instanceof chunkZIRFXBKL_cjs.ProviderUnavailableError)) throw mapped;
       await sleep(retryDelayMs(attempt));
       continue;
     }
@@ -1297,7 +1435,7 @@ async function indexerFetch(input, init) {
       body = void 0;
     }
     try {
-      chunkFZFSGOTZ_cjs.throwIfHttpUnavailable(res, "indexer", body);
+      chunkZIRFXBKL_cjs.throwIfHttpUnavailable(res, "indexer", body);
     } catch (err) {
       if (lastAttempt) throw err;
       await sleep(retryDelayMs(attempt));
@@ -1310,6 +1448,7 @@ function retryDelayMs(attempt) {
   return INDEXER_RETRY_BASE_MS * 2 ** (attempt - 1);
 }
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var DEFAULT_VTXO_PAGE_SIZE = 500;
 var IndexerTxType = /* @__PURE__ */ ((IndexerTxType2) => {
   IndexerTxType2[IndexerTxType2["INDEXER_TX_TYPE_UNSPECIFIED"] = 0] = "INDEXER_TX_TYPE_UNSPECIFIED";
   IndexerTxType2[IndexerTxType2["INDEXER_TX_TYPE_RECEIVED"] = 1] = "INDEXER_TX_TYPE_RECEIVED";
@@ -1325,7 +1464,7 @@ var ChainTxType = /* @__PURE__ */ ((ChainTxType2) => {
   return ChainTxType2;
 })(ChainTxType || {});
 var RestIndexerProvider = class {
-  constructor(serverUrl = chunkFZFSGOTZ_cjs.DEFAULT_ARKADE_SERVER_URL, options = {}) {
+  constructor(serverUrl = chunkZIRFXBKL_cjs.DEFAULT_ARKADE_SERVER_URL, options = {}) {
     this.serverUrl = serverUrl;
     this.eventSource = options.eventSource;
   }
@@ -1461,8 +1600,8 @@ var RestIndexerProvider = class {
       try {
         while (!abortSignal?.aborted) {
           try {
-            const currentIterator = chunkFZFSGOTZ_cjs.eventSourceIterator(
-              chunkFZFSGOTZ_cjs.resolveEventSource(override)(url)
+            const currentIterator = chunkZIRFXBKL_cjs.eventSourceIterator(
+              chunkZIRFXBKL_cjs.resolveEventSource(override)(url)
             );
             iterator = currentIterator;
             for await (const event of currentIterator) {
@@ -1473,9 +1612,9 @@ var RestIndexerProvider = class {
                   yield {
                     txid: data.event.txid,
                     scripts: data.event.scripts || [],
-                    newVtxos: (data.event.newVtxos || []).map(chunkFZFSGOTZ_cjs.convertVtxo),
-                    spentVtxos: (data.event.spentVtxos || []).map(chunkFZFSGOTZ_cjs.convertVtxo),
-                    sweptVtxos: (data.event.sweptVtxos || []).map(chunkFZFSGOTZ_cjs.convertVtxo),
+                    newVtxos: (data.event.newVtxos || []).map(chunkZIRFXBKL_cjs.convertVtxo),
+                    spentVtxos: (data.event.spentVtxos || []).map(chunkZIRFXBKL_cjs.convertVtxo),
+                    sweptVtxos: (data.event.sweptVtxos || []).map(chunkZIRFXBKL_cjs.convertVtxo),
                     tx: data.event.tx,
                     checkpointTxs: data.event.checkpointTxs
                   };
@@ -1489,14 +1628,14 @@ var RestIndexerProvider = class {
             if (abortSignal?.aborted || error instanceof Error && error.name === "AbortError") {
               break;
             }
-            if (chunkFZFSGOTZ_cjs.isFetchTimeoutError(error)) {
+            if (chunkZIRFXBKL_cjs.isFetchTimeoutError(error)) {
               console.debug("Timeout error ignored");
               continue;
             }
-            if (chunkFZFSGOTZ_cjs.isEventSourceError(error)) {
+            if (chunkZIRFXBKL_cjs.isEventSourceError(error)) {
               throw error;
             }
-            if (chunkFZFSGOTZ_cjs.isEventSourceUnavailableError(error)) throw error;
+            if (chunkZIRFXBKL_cjs.isEventSourceUnavailableError(error)) throw error;
             console.error("Subscription error:", error);
             throw error;
           } finally {
@@ -1582,14 +1721,39 @@ var RestIndexerProvider = class {
     if (opts?.after !== void 0 && opts?.before !== void 0 && opts.after !== 0 && opts.before !== 0 && opts.before <= opts.after) {
       throw new Error("before must be greater than after");
     }
+    if (opts?.pageIndex === void 0 && opts?.pageSize === void 0) {
+      const all = [];
+      let pageIndex = 0;
+      for (; ; ) {
+        const { vtxos, page } = await this.fetchVtxosPage({
+          ...opts,
+          pageIndex,
+          pageSize: DEFAULT_VTXO_PAGE_SIZE
+        });
+        all.push(...vtxos);
+        if (!page || page.current >= page.total || vtxos.length < DEFAULT_VTXO_PAGE_SIZE) {
+          break;
+        }
+        pageIndex = page.next;
+      }
+      return { vtxos: all };
+    }
+    return this.fetchVtxosPage(opts);
+  }
+  /**
+   * Fetch a single page of vtxos. Callers paging to exhaustion get no
+   * deliberate inter-page backoff here: `indexerFetch` already enforces
+   * politeness through the rate gate, so don't add a redundant sleep.
+   */
+  async fetchVtxosPage(opts) {
     let url = `${this.serverUrl}/v1/indexer/vtxos`;
     const params = new URLSearchParams();
-    if (hasScripts) {
+    if (opts?.scripts?.length) {
       opts.scripts.forEach((script) => {
         params.append("scripts", script);
       });
     }
-    if (hasOutpoints) {
+    if (opts?.outpoints?.length) {
       opts.outpoints.forEach((outpoint) => {
         params.append("outpoints", `${outpoint.txid}:${outpoint.vout}`);
       });
@@ -1622,7 +1786,7 @@ var RestIndexerProvider = class {
       throw new Error("Invalid vtxos data received");
     }
     return {
-      vtxos: data.vtxos.map(chunkFZFSGOTZ_cjs.convertVtxo),
+      vtxos: data.vtxos.map(chunkZIRFXBKL_cjs.convertVtxo),
       page: data.page
     };
   }
@@ -1799,10 +1963,11 @@ exports.AssetRef = AssetRef;
 exports.BufferReader = BufferReader;
 exports.BufferWriter = BufferWriter;
 exports.ChainTxType = ChainTxType;
+exports.DEFAULT_VTXO_PAGE_SIZE = DEFAULT_VTXO_PAGE_SIZE;
 exports.IndexerTxType = IndexerTxType;
 exports.Metadata = Metadata;
 exports.Packet = Packet;
 exports.RestIndexerProvider = RestIndexerProvider;
 exports.asset_exports = asset_exports;
-//# sourceMappingURL=chunk-RXITDAV4.cjs.map
-//# sourceMappingURL=chunk-RXITDAV4.cjs.map
+//# sourceMappingURL=chunk-3S3JZUEN.cjs.map
+//# sourceMappingURL=chunk-3S3JZUEN.cjs.map