@arkade-os/sdk 0.4.44 → 0.4.46

package/dist/{chunk-UBYY2TPK.cjs → chunk-7IYIFMF4.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkHXDZ2QTW_cjs = require('./chunk-HXDZ2QTW.cjs');
+var chunkMQB5H4X5_cjs = require('./chunk-MQB5H4X5.cjs');
 var chunk5BLDMQED_cjs = require('./chunk-5BLDMQED.cjs');
 var btcSigner = require('@scure/btc-signer');
 var base = require('@scure/base');
@@ -106,7 +106,7 @@ var VtxoTreeExpiry = {
     if (!checkKeyIncludes(unknown[0], "expiry" /* VtxoTreeExpiry */)) return null;
     const v = btcSigner.ScriptNum(6, true).decode(unknown[1]);
     if (!v) return null;
-    return chunkHXDZ2QTW_cjs.sequenceToTimelock(Number(v));
+    return chunkMQB5H4X5_cjs.sequenceToTimelock(Number(v));
   })
 };
 var encodedPsbtFieldKey = Object.fromEntries(
@@ -124,6 +124,59 @@ function checkKeyIncludes(key, arkPsbtFieldKey) {
   return base.hex.encode(new Uint8Array([key.type, ...key.key])).includes(expected);
 }
 
+// package.json
+var version = "0.4.46";
+
+// src/utils/fetch.ts
+var buildVersion = "0.9.9";
+var sdkVersion = `ts-sdk/${version}`;
+var FetchError = class extends Error {
+  /** The request URL that failed, when derivable from the `fetch` input. */
+  url;
+  /** The HTTP method of the failed request (defaults to `"GET"`). */
+  method;
+  constructor(message, options) {
+    super(message, { cause: options.cause });
+    this.name = "FetchError";
+    this.url = options.url;
+    this.method = options.method;
+  }
+};
+function baseFetch(input, init) {
+  if (typeof globalThis.fetch !== "function") {
+    throw new Error("Fetch API is not available in this environment.");
+  }
+  return globalThis.fetch(input, init).catch((cause) => {
+    const { url, method } = describeRequest(input, init);
+    throw new FetchError(`Network request failed: ${method} ${url}`, { url, method, cause });
+  });
+}
+function fetch(input, init) {
+  const headers = new Headers(init?.headers);
+  headers.set("X-Build-Version", buildVersion);
+  headers.set("X-SDK-VERSION", sdkVersion);
+  return baseFetch(input, { ...init, headers });
+}
+function describeRequest(input, init) {
+  let url;
+  if (typeof input === "string") {
+    url = input;
+  } else if (input instanceof URL) {
+    url = input.href;
+  } else {
+    url = input.url;
+  }
+  let method;
+  if (init?.method !== void 0) {
+    method = init.method;
+  } else if (input instanceof Request) {
+    method = input.method;
+  } else {
+    method = "GET";
+  }
+  return { url, method };
+}
+
 // src/providers/errors.ts
 var ArkError = class extends Error {
   constructor(code, message, name, metadata) {
@@ -133,7 +186,52 @@ var ArkError = class extends Error {
     this.name = name;
     this.metadata = metadata;
   }
+  code;
+  message;
+  name;
+  metadata;
+};
+var ArkErrorName = {
+  DIGEST_MISMATCH: "DIGEST_MISMATCH",
+  VTXO_ALREADY_SPENT: "VTXO_ALREADY_SPENT",
+  INVALID_TX_FILTER: "INVALID_TX_FILTER",
+  TX_FILTERS_LIMIT_EXCEEDED: "TX_FILTERS_LIMIT_EXCEEDED",
+  /**
+   * A CLTV closure was spent before its absolute locktime matured. Raised only by
+   * `submitTx` (never `finalizeTx`), with metadata
+   * `{ locktime, current_locktime, type: "height" | "time" }`.
+   *
+   * Self-healing, so defer and retry rather than fail: the server matures a
+   * seconds-locktime against the **chain tip block's timestamp**, not its wall clock,
+   * so a spend attempted promptly at maturity is rejected until a later block lands.
+   */
+  FORFEIT_CLOSURE_LOCKED: "FORFEIT_CLOSURE_LOCKED"
+};
+function isArkError(error, name) {
+  return error instanceof ArkError && (name === void 0 || error.name === name);
+}
+var ProviderUnavailableError = class extends Error {
+  /** Always `true`: this error type only ever wraps retryable conditions. */
+  retryable = true;
+  constructor(message, options) {
+    super(message, { cause: options?.cause });
+    this.name = "ProviderUnavailableError";
+  }
 };
+function throwIfHttpUnavailable(response, kind, body) {
+  if (body !== void 0 && maybeArkError(new Error(body))) return;
+  if (response.status === 429 || response.status >= 500) {
+    throw new ProviderUnavailableError(
+      `${kind} unavailable: ${response.status} ${response.statusText}`
+    );
+  }
+}
+function toProviderUnavailable(err, kind) {
+  if (err instanceof FetchError) {
+    return new ProviderUnavailableError(`${kind} request failed`, { cause: err });
+  }
+  return err;
+}
 function maybeArkError(error) {
   try {
     if (!(error instanceof Error)) return void 0;
@@ -331,8 +429,8 @@ function prepareCoinAsIntentProofInput(coin) {
   if (!("tapTree" in coin)) {
     return coin;
   }
-  const vtxoScript = chunkHXDZ2QTW_cjs.VtxoScript.decode(coin.tapTree);
-  const sequence = chunkHXDZ2QTW_cjs.getSequence(coin.intentTapLeafScript);
+  const vtxoScript = chunkMQB5H4X5_cjs.VtxoScript.decode(coin.tapTree);
+  const sequence = chunkMQB5H4X5_cjs.getSequence(coin.intentTapLeafScript);
   const unknown = [VtxoTaprootTree.encode(coin.tapTree)];
   if (coin.extraWitness) {
     unknown.push(ConditionWitness.encode(coin.extraWitness));
@@ -350,59 +448,6 @@ function prepareCoinAsIntentProofInput(coin) {
   };
 }
 
-// package.json
-var version = "0.4.44";
-
-// src/utils/fetch.ts
-var buildVersion = "0.9.9";
-var sdkVersion = `ts-sdk/${version}`;
-var FetchError = class extends Error {
-  /** The request URL that failed, when derivable from the `fetch` input. */
-  url;
-  /** The HTTP method of the failed request (defaults to `"GET"`). */
-  method;
-  constructor(message, options) {
-    super(message, { cause: options.cause });
-    this.name = "FetchError";
-    this.url = options.url;
-    this.method = options.method;
-  }
-};
-function baseFetch(input, init) {
-  if (typeof globalThis.fetch !== "function") {
-    throw new Error("Fetch API is not available in this environment.");
-  }
-  return globalThis.fetch(input, init).catch((cause) => {
-    const { url, method } = describeRequest(input, init);
-    throw new FetchError(`Network request failed: ${method} ${url}`, { url, method, cause });
-  });
-}
-function fetch(input, init) {
-  const headers = new Headers(init?.headers);
-  headers.set("X-Build-Version", buildVersion);
-  headers.set("X-SDK-VERSION", sdkVersion);
-  return baseFetch(input, { ...init, headers });
-}
-function describeRequest(input, init) {
-  let url;
-  if (typeof input === "string") {
-    url = input;
-  } else if (input instanceof URL) {
-    url = input.href;
-  } else {
-    url = input.url;
-  }
-  let method;
-  if (init?.method !== void 0) {
-    method = init.method;
-  } else if (input instanceof Request) {
-    method = input.method;
-  } else {
-    method = "GET";
-  }
-  return { url, method };
-}
-
 // src/providers/utils.ts
 function createAbortError() {
   const error = new Error("EventSource closed");
@@ -523,9 +568,10 @@ var SettlementEventType = /* @__PURE__ */ ((SettlementEventType2) => {
   return SettlementEventType2;
 })(SettlementEventType || {});
 var RestArkProvider = class {
-  constructor(serverUrl = chunkHXDZ2QTW_cjs.DEFAULT_ARKADE_SERVER_URL) {
+  constructor(serverUrl = chunkMQB5H4X5_cjs.DEFAULT_ARKADE_SERVER_URL) {
     this.serverUrl = serverUrl;
   }
+  serverUrl;
   /**
    * Last server-info digest seen (from {@link getInfo}). Sent as `X-Digest`
    * on outgoing requests so arkd can reject a client whose cached info is
@@ -570,16 +616,24 @@ var RestArkProvider = class {
       ...init.headers
     };
     if (digest) headers["X-Digest"] = digest;
-    const response = await fetch(url, { ...init, headers });
+    let response;
+    try {
+      response = await fetch(url, { ...init, headers });
+    } catch (err) {
+      throw toProviderUnavailable(err, "arkade");
+    }
     if (response.ok) return response;
     let body;
     try {
       body = await response.clone().text();
     } catch (e) {
       console.warn("authedFetch could not read response body for digest check", e);
+      throwIfHttpUnavailable(response, "arkade");
       return response;
     }
-    if (maybeArkError(new Error(body))?.name !== "DIGEST_MISMATCH") return response;
+    const arkError = maybeArkError(new Error(body));
+    if (!arkError) throwIfHttpUnavailable(response, "arkade");
+    if (!isArkError(arkError, ArkErrorName.DIGEST_MISMATCH)) return response;
     this._digest = "";
     const info = await this.getInfo();
     this.emitServerInfoChanged(info);
@@ -592,6 +646,7 @@ var RestArkProvider = class {
     const response = await fetch(url);
     if (!response.ok) {
       const errorText = await response.text();
+      throwIfHttpUnavailable(response, "arkade", errorText);
       handleError(errorText, `Failed to get server info: ${response.statusText}`);
     }
     const fromServer = await response.json();
@@ -1240,6 +1295,8 @@ var AssetId = class _AssetId {
     this.txid = txid;
     this.groupIndex = groupIndex;
   }
+  txid;
+  groupIndex;
   /**
    * Create an asset id from a genesis transaction id and group index.
    *
@@ -1371,6 +1428,7 @@ var AssetRef = class _AssetRef {
   constructor(ref) {
     this.ref = ref;
   }
+  ref;
   /** Reference type discriminator. */
   get type() {
     return this.ref.type;
@@ -1499,6 +1557,7 @@ var AssetInput = class _AssetInput {
   constructor(input) {
     this.input = input;
   }
+  input;
   /** Gets the transaction input index for an asset input, e.g. 0 */
   get vin() {
     return this.input.vin;
@@ -1629,6 +1688,7 @@ var AssetInputs = class _AssetInputs {
   constructor(inputs) {
     this.inputs = inputs;
   }
+  inputs;
   /** Create a validated list of asset inputs. */
   static create(inputs) {
     const list = new _AssetInputs(inputs);
@@ -1701,6 +1761,8 @@ var AssetOutput = class _AssetOutput {
     this.vout = vout;
     this.amount = amount;
   }
+  vout;
+  amount;
   // 0x01 means local output, there is only 1 local output type currently
   // however we serialize it for future upgrades
   static TYPE_LOCAL = 1;
@@ -1781,6 +1843,7 @@ var AssetOutputs = class _AssetOutputs {
   constructor(outputs) {
     this.outputs = outputs;
   }
+  outputs;
   /** Create a validated list of asset outputs. */
   static create(outputs) {
     const list = new _AssetOutputs(outputs);
@@ -1850,6 +1913,8 @@ var Metadata = class _Metadata {
     this.key = key;
     this.value = value;
   }
+  key;
+  value;
   /** Create a metadata entry from raw key and value bytes. */
   static create(key, value) {
     const md = new _Metadata(key, value);
@@ -1927,6 +1992,7 @@ var MetadataList = class _MetadataList {
   constructor(items) {
     this.items = items;
   }
+  items;
   static ARK_LEAF_TAG = "ArkadeAssetLeaf";
   static ARK_BRANCH_TAG = "ArkadeAssetBranch";
   static ARK_LEAF_VERSION = 0;
@@ -2020,6 +2086,10 @@ var AssetGroup = class _AssetGroup {
     this.outputs = outputs;
     this.metadataList = new MetadataList(metadata);
   }
+  assetId;
+  controlAsset;
+  inputs;
+  outputs;
   metadataList;
   /**
    * Create and validate an asset group.
@@ -2216,6 +2286,7 @@ var Packet = class _Packet {
   constructor(groups) {
     this.groups = groups;
   }
+  groups;
   /** PACKET_TYPE is the 1-byte TLV type tag used in the Extension envelope. */
   static PACKET_TYPE = 0;
   /** Create a validated asset packet from a list of asset groups. */
@@ -2315,6 +2386,24 @@ var Packet = class _Packet {
     return packet;
   }
 };
+async function indexerFetch(input, init) {
+  let res;
+  try {
+    res = await baseFetch(input, init);
+  } catch (err) {
+    throw toProviderUnavailable(err, "indexer");
+  }
+  if (!res.ok) {
+    let body;
+    try {
+      body = await res.clone().text();
+    } catch {
+      body = void 0;
+    }
+    throwIfHttpUnavailable(res, "indexer", body);
+  }
+  return res;
+}
 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";
@@ -2330,9 +2419,10 @@ var ChainTxType = /* @__PURE__ */ ((ChainTxType2) => {
   return ChainTxType2;
 })(ChainTxType || {});
 var RestIndexerProvider = class {
-  constructor(serverUrl = chunkHXDZ2QTW_cjs.DEFAULT_ARKADE_SERVER_URL) {
+  constructor(serverUrl = chunkMQB5H4X5_cjs.DEFAULT_ARKADE_SERVER_URL) {
     this.serverUrl = serverUrl;
   }
+  serverUrl;
   async getVtxoTree(batchOutpoint, opts) {
     let url = `${this.serverUrl}/v1/indexer/batch/${batchOutpoint.txid}/${batchOutpoint.vout}/tree`;
     const params = new URLSearchParams();
@@ -2344,7 +2434,7 @@ var RestIndexerProvider = class {
     if (params.toString()) {
       url += "?" + params.toString();
     }
-    const res = await baseFetch(url);
+    const res = await indexerFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch vtxo tree: ${res.statusText}`);
     }
@@ -2370,7 +2460,7 @@ var RestIndexerProvider = class {
     if (params.toString()) {
       url += "?" + params.toString();
     }
-    const res = await baseFetch(url);
+    const res = await indexerFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch vtxo tree leaves: ${res.statusText}`);
     }
@@ -2382,7 +2472,7 @@ var RestIndexerProvider = class {
   }
   async getBatchSweepTransactions(batchOutpoint) {
     const url = `${this.serverUrl}/v1/indexer/batch/${batchOutpoint.txid}/${batchOutpoint.vout}/sweepTxs`;
-    const res = await baseFetch(url);
+    const res = await indexerFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch batch sweep transactions: ${res.statusText}`);
     }
@@ -2394,7 +2484,7 @@ var RestIndexerProvider = class {
   }
   async getCommitmentTx(txid) {
     const url = `${this.serverUrl}/v1/indexer/commitmentTx/${txid}`;
-    const res = await baseFetch(url);
+    const res = await indexerFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch commitment tx: ${res.statusText}`);
     }
@@ -2415,7 +2505,7 @@ var RestIndexerProvider = class {
     if (params.toString()) {
       url += "?" + params.toString();
     }
-    const res = await baseFetch(url);
+    const res = await indexerFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch commitment tx connectors: ${res.statusText}`);
     }
@@ -2441,7 +2531,7 @@ var RestIndexerProvider = class {
     if (params.toString()) {
       url += "?" + params.toString();
     }
-    const res = await baseFetch(url);
+    const res = await indexerFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch commitment tx forfeitTxs: ${res.statusText}`);
     }
@@ -2524,7 +2614,7 @@ var RestIndexerProvider = class {
     if (params.toString()) {
       url += "?" + params.toString();
     }
-    const res = await baseFetch(url);
+    const res = await indexerFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch virtual txs: ${res.statusText}`);
     }
@@ -2545,7 +2635,7 @@ var RestIndexerProvider = class {
     if (params.toString()) {
       url += "?" + params.toString();
     }
-    const res = await baseFetch(url);
+    const res = await indexerFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch vtxo chain: ${res.statusText}`);
     }
@@ -2564,12 +2654,16 @@ var RestIndexerProvider = class {
     if (!hasScripts && !hasOutpoints) {
       throw new Error("Either scripts or outpoints must be provided");
     }
-    const filterCount = [opts?.spendableOnly, opts?.spentOnly, opts?.recoverableOnly].filter(
-      Boolean
-    ).length;
+    const filterCount = [
+      opts?.spendableOnly,
+      opts?.spentOnly,
+      opts?.recoverableOnly,
+      opts?.pendingOnly,
+      opts?.renewableOnly
+    ].filter(Boolean).length;
     if (filterCount > 1) {
       throw new Error(
-        "spendableOnly, spentOnly, and recoverableOnly are mutually exclusive options"
+        "spendableOnly, spentOnly, recoverableOnly, pendingOnly, and renewableOnly are mutually exclusive options"
       );
     }
     if (opts?.after !== void 0 && opts?.before !== void 0 && opts.after !== 0 && opts.before !== 0 && opts.before <= opts.after) {
@@ -2595,6 +2689,8 @@ var RestIndexerProvider = class {
         params.append("recoverableOnly", opts.recoverableOnly.toString());
       if (opts.pendingOnly !== void 0)
         params.append("pendingOnly", opts.pendingOnly.toString());
+      if (opts.renewableOnly !== void 0)
+        params.append("renewableOnly", opts.renewableOnly.toString());
       if (opts.after !== void 0) params.append("after", opts.after.toString());
       if (opts.before !== void 0) params.append("before", opts.before.toString());
       if (opts.pageIndex !== void 0)
@@ -2604,7 +2700,7 @@ var RestIndexerProvider = class {
     if (params.toString()) {
       url += "?" + params.toString();
     }
-    const res = await baseFetch(url);
+    const res = await indexerFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch vtxos: ${res.statusText}`);
     }
@@ -2619,7 +2715,7 @@ var RestIndexerProvider = class {
   }
   async getAssetDetails(assetId) {
     const url = `${this.serverUrl}/v1/indexer/asset/${encodeURIComponent(assetId)}`;
-    const res = await baseFetch(url);
+    const res = await indexerFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch asset details: ${res.statusText}`);
     }
@@ -2637,7 +2733,7 @@ var RestIndexerProvider = class {
   }
   async subscribeForScripts(scripts, subscriptionId) {
     const url = `${this.serverUrl}/v1/indexer/script/subscribe`;
-    const res = await baseFetch(url, {
+    const res = await indexerFetch(url, {
       headers: {
         "Content-Type": "application/json"
       },
@@ -2654,7 +2750,7 @@ var RestIndexerProvider = class {
   }
   async unsubscribeForScripts(subscriptionId, scripts) {
     const url = `${this.serverUrl}/v1/indexer/script/unsubscribe`;
-    const res = await baseFetch(url, {
+    const res = await indexerFetch(url, {
       headers: {
         "Content-Type": "application/json"
       },
@@ -2810,6 +2906,7 @@ var Response;
 })(Response || (Response = {}));
 
 exports.ArkError = ArkError;
+exports.ArkErrorName = ArkErrorName;
 exports.ArkPsbtFieldKey = ArkPsbtFieldKey;
 exports.ArkPsbtFieldKeyType = ArkPsbtFieldKeyType;
 exports.AssetGroup = AssetGroup;
@@ -2827,6 +2924,7 @@ exports.IndexerTxType = IndexerTxType;
 exports.Metadata = Metadata;
 exports.OP_RETURN_EMPTY_PKSCRIPT = OP_RETURN_EMPTY_PKSCRIPT;
 exports.Packet = Packet;
+exports.ProviderUnavailableError = ProviderUnavailableError;
 exports.RestArkProvider = RestArkProvider;
 exports.RestIndexerProvider = RestIndexerProvider;
 exports.SettlementEventType = SettlementEventType;
@@ -2839,10 +2937,11 @@ exports.buildVersion = buildVersion;
 exports.craftToSpendTx = craftToSpendTx;
 exports.fetch = fetch;
 exports.getArkPsbtFields = getArkPsbtFields;
+exports.isArkError = isArkError;
 exports.isEventSourceError = isEventSourceError;
 exports.isFetchTimeoutError = isFetchTimeoutError;
 exports.maybeArkError = maybeArkError;
 exports.sdkVersion = sdkVersion;
 exports.setArkPsbtField = setArkPsbtField;
-//# sourceMappingURL=chunk-UBYY2TPK.cjs.map
-//# sourceMappingURL=chunk-UBYY2TPK.cjs.map
+//# sourceMappingURL=chunk-7IYIFMF4.cjs.map
+//# sourceMappingURL=chunk-7IYIFMF4.cjs.map