@arkade-os/sdk 0.4.44 → 0.4.46

package/dist/{chunk-LJ35HPJW.js → chunk-CWJ7ZCP7.js}

@@ -1,4 +1,4 @@
-import { VtxoScript, getSequence, sequenceToTimelock, DEFAULT_ARKADE_SERVER_URL } from './chunk-BE5MUB7T.js';
+import { VtxoScript, getSequence, sequenceToTimelock, DEFAULT_ARKADE_SERVER_URL } from './chunk-FWG4TSPN.js';
 import { __export } from './chunk-NSBPE2FW.js';
 import { OP, Script, SigHash, RawWitness, Transaction as Transaction$1, ScriptNum } from '@scure/btc-signer';
 import { hex } from '@scure/base';
@@ -122,6 +122,59 @@ function checkKeyIncludes(key, arkPsbtFieldKey) {
   return 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) {
@@ -131,7 +184,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;
@@ -348,59 +446,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");
@@ -524,6 +569,7 @@ var RestArkProvider = class {
   constructor(serverUrl = 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
@@ -568,16 +614,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);
@@ -590,6 +644,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();
@@ -1238,6 +1293,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.
    *
@@ -1369,6 +1426,7 @@ var AssetRef = class _AssetRef {
   constructor(ref) {
     this.ref = ref;
   }
+  ref;
   /** Reference type discriminator. */
   get type() {
     return this.ref.type;
@@ -1497,6 +1555,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;
@@ -1627,6 +1686,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);
@@ -1699,6 +1759,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;
@@ -1779,6 +1841,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);
@@ -1848,6 +1911,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);
@@ -1925,6 +1990,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;
@@ -2018,6 +2084,10 @@ var AssetGroup = class _AssetGroup {
     this.outputs = outputs;
     this.metadataList = new MetadataList(metadata);
   }
+  assetId;
+  controlAsset;
+  inputs;
+  outputs;
   metadataList;
   /**
    * Create and validate an asset group.
@@ -2214,6 +2284,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. */
@@ -2313,6 +2384,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";
@@ -2331,6 +2420,7 @@ var RestIndexerProvider = class {
   constructor(serverUrl = 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();
@@ -2342,7 +2432,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}`);
     }
@@ -2368,7 +2458,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}`);
     }
@@ -2380,7 +2470,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}`);
     }
@@ -2392,7 +2482,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}`);
     }
@@ -2413,7 +2503,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}`);
     }
@@ -2439,7 +2529,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}`);
     }
@@ -2522,7 +2612,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}`);
     }
@@ -2543,7 +2633,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}`);
     }
@@ -2562,12 +2652,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) {
@@ -2593,6 +2687,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)
@@ -2602,7 +2698,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}`);
     }
@@ -2617,7 +2713,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}`);
     }
@@ -2635,7 +2731,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"
       },
@@ -2652,7 +2748,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"
       },
@@ -2807,6 +2903,6 @@ var Response;
   Response2.isGetAssetResponse = isGetAssetResponse;
 })(Response || (Response = {}));
 
-export { ArkError, ArkPsbtFieldKey, ArkPsbtFieldKeyType, AssetGroup, AssetId, AssetInput, AssetOutput, AssetRef, BufferReader, ChainTxType, ConditionWitness, CosignerPublicKey, DigestMismatchError, FetchError, IndexerTxType, Intent, Metadata, OP_RETURN_EMPTY_PKSCRIPT, Packet, RestArkProvider, RestIndexerProvider, SettlementEventType, Transaction, VtxoTaprootTree, VtxoTreeExpiry, asset_exports, baseFetch, buildVersion, craftToSpendTx, fetch, getArkPsbtFields, isEventSourceError, isFetchTimeoutError, maybeArkError, sdkVersion, setArkPsbtField };
-//# sourceMappingURL=chunk-LJ35HPJW.js.map
-//# sourceMappingURL=chunk-LJ35HPJW.js.map
+export { ArkError, ArkErrorName, ArkPsbtFieldKey, ArkPsbtFieldKeyType, AssetGroup, AssetId, AssetInput, AssetOutput, AssetRef, BufferReader, ChainTxType, ConditionWitness, CosignerPublicKey, DigestMismatchError, FetchError, IndexerTxType, Intent, Metadata, OP_RETURN_EMPTY_PKSCRIPT, Packet, ProviderUnavailableError, RestArkProvider, RestIndexerProvider, SettlementEventType, Transaction, VtxoTaprootTree, VtxoTreeExpiry, asset_exports, baseFetch, buildVersion, craftToSpendTx, fetch, getArkPsbtFields, isArkError, isEventSourceError, isFetchTimeoutError, maybeArkError, sdkVersion, setArkPsbtField };
+//# sourceMappingURL=chunk-CWJ7ZCP7.js.map
+//# sourceMappingURL=chunk-CWJ7ZCP7.js.map