@arkade-os/sdk 0.4.33 → 0.4.35

package/dist/{chunk-SPDNHPM4.cjs → chunk-X2EQLK4O.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkWMIPYZSB_cjs = require('./chunk-WMIPYZSB.cjs');
+var chunkCMPJR3HS_cjs = require('./chunk-CMPJR3HS.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 chunkWMIPYZSB_cjs.sequenceToTimelock(Number(v));
+    return chunkCMPJR3HS_cjs.sequenceToTimelock(Number(v));
   })
 };
 var encodedPsbtFieldKey = Object.fromEntries(
@@ -138,23 +138,27 @@ function maybeArkError(error) {
   try {
     if (!(error instanceof Error)) return void 0;
     const decoded = JSON.parse(error.message);
-    if (!("details" in decoded)) return void 0;
-    if (!Array.isArray(decoded.details)) return void 0;
-    for (const details of decoded.details) {
-      if (!("@type" in details)) continue;
-      const type = details["@type"];
-      if (type !== "type.googleapis.com/ark.v1.ErrorDetails") continue;
-      if (!("code" in details)) continue;
-      const code = details.code;
-      if (!("message" in details)) continue;
-      const message = details.message;
-      if (!("name" in details)) continue;
-      const name = details.name;
-      let metadata;
-      if ("metadata" in details && isMetadata(details.metadata)) {
-        metadata = details.metadata;
+    if (Array.isArray(decoded.details)) {
+      for (const details of decoded.details) {
+        if (!("@type" in details)) continue;
+        const type = details["@type"];
+        if (type !== "type.googleapis.com/ark.v1.ErrorDetails") continue;
+        if (!("code" in details)) continue;
+        const code = details.code;
+        if (!("message" in details)) continue;
+        const message = details.message;
+        if (!("name" in details)) continue;
+        const name = details.name;
+        let metadata;
+        if ("metadata" in details && isMetadata(details.metadata)) {
+          metadata = details.metadata;
+        }
+        return new ArkError(code, message, name, metadata);
       }
-      return new ArkError(code, message, name, metadata);
+    }
+    if (typeof decoded.message === "string") {
+      const m = decoded.message.match(/^([A-Z][A-Z0-9_]*) \((\d+)\): ([\s\S]*)$/);
+      if (m) return new ArkError(Number(m[2]), m[3], m[1]);
     }
     return void 0;
   } catch (e) {
@@ -318,8 +322,8 @@ function prepareCoinAsIntentProofInput(coin) {
   if (!("tapTree" in coin)) {
     return coin;
   }
-  const vtxoScript = chunkWMIPYZSB_cjs.VtxoScript.decode(coin.tapTree);
-  const sequence = chunkWMIPYZSB_cjs.getSequence(coin.intentTapLeafScript);
+  const vtxoScript = chunkCMPJR3HS_cjs.VtxoScript.decode(coin.tapTree);
+  const sequence = chunkCMPJR3HS_cjs.getSequence(coin.intentTapLeafScript);
   const unknown = [VtxoTaprootTree.encode(coin.tapTree)];
   if (coin.extraWitness) {
     unknown.push(ConditionWitness.encode(coin.extraWitness));
@@ -437,7 +441,32 @@ function isEventSourceError(error) {
   return error instanceof Error && error.name === "EventSourceError";
 }
 
+// package.json
+var version = "0.4.35";
+
+// src/utils/fetch.ts
+var buildVersion = "0.9.9";
+var sdkVersion = `ts-sdk/${version}`;
+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);
+}
+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 });
+}
+
 // src/providers/ark.ts
+var DigestMismatchError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "DigestMismatchError";
+  }
+};
 var SettlementEventType = /* @__PURE__ */ ((SettlementEventType2) => {
   SettlementEventType2["BatchStarted"] = "batch_started";
   SettlementEventType2["BatchFinalization"] = "batch_finalization";
@@ -451,9 +480,70 @@ var SettlementEventType = /* @__PURE__ */ ((SettlementEventType2) => {
   return SettlementEventType2;
 })(SettlementEventType || {});
 var RestArkProvider = class {
-  constructor(serverUrl = chunkWMIPYZSB_cjs.DEFAULT_ARKADE_SERVER_URL) {
+  constructor(serverUrl = chunkCMPJR3HS_cjs.DEFAULT_ARKADE_SERVER_URL) {
     this.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
+   * stale. Empty until the first {@link getInfo}.
+   */
+  _digest = "";
+  _serverInfoListeners = /* @__PURE__ */ new Set();
+  /**
+   * Subscribe to server-info changes. Fired when a request is rejected with
+   * `DIGEST_MISMATCH` and fresh info is re-fetched, so consumers (the wallet)
+   * can re-derive signer-dependent state mid-session without polling. Returns
+   * an unsubscribe function.
+   */
+  onServerInfoChanged(listener) {
+    this._serverInfoListeners.add(listener);
+    return () => {
+      this._serverInfoListeners.delete(listener);
+    };
+  }
+  emitServerInfoChanged(info) {
+    for (const listener of this._serverInfoListeners) {
+      try {
+        listener(info);
+      } catch (e) {
+        console.warn("onServerInfoChanged listener threw", e);
+      }
+    }
+  }
+  /**
+   * `fetch` wrapper for arkd requests that participates in server-info digest
+   * negotiation. Sends the cached `X-Digest`; when arkd rejects a request with
+   * `DIGEST_MISMATCH`, refreshes {@link getInfo} (updating the digest), fires
+   * {@link onServerInfoChanged}, and THROWS {@link DigestMismatchError} — it
+   * never silently retries, since the in-flight request was built against the
+   * now-stale config. Dormant until arkd returns the error — then it is the
+   * instant, event-driven signer-rotation trigger. {@link getInfo} itself never
+   * routes through here: it is the refresh path and must not be digest-gated.
+   */
+  async authedFetch(url, init) {
+    const digest = this._digest;
+    const headers = {
+      ...init.headers
+    };
+    if (digest) headers["X-Digest"] = digest;
+    const response = await fetch(url, { ...init, headers });
+    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);
+      return response;
+    }
+    if (maybeArkError(new Error(body))?.name !== "DIGEST_MISMATCH") return response;
+    this._digest = "";
+    const info = await this.getInfo();
+    this.emitServerInfoChanged(info);
+    throw new DigestMismatchError(
+      "Arkade server reported a configuration digest mismatch; server info was refreshed. Rebuild and retry the request under the new server info."
+    );
+  }
   async getInfo() {
     const url = `${this.serverUrl}/v1/info`;
     const response = await fetch(url);
@@ -462,10 +552,16 @@ var RestArkProvider = class {
       handleError(errorText, `Failed to get server info: ${response.statusText}`);
     }
     const fromServer = await response.json();
-    return {
+    const info = {
       boardingExitDelay: BigInt(fromServer.boardingExitDelay ?? 0),
       checkpointTapscript: fromServer.checkpointTapscript ?? "",
       deprecatedSigners: fromServer.deprecatedSigners?.map((signer) => ({
+        // arkd advertises `cutoffDate` as a non-nullable field, so it
+        // is always a bigint here — `0n` is the sentinel for "no
+        // cutoff" (the classifier maps it to DUE_NOW). The grpc-gateway
+        // marshals with EmitUnpopulated, so an unset `cutoff_date`
+        // already arrives as `"0"`; a genuinely missing field defaults
+        // to `0n` too. Never collapse to `undefined`.
         cutoffDate: BigInt(signer.cutoffDate ?? 0),
         pubkey: signer.pubkey ?? ""
       })) ?? [],
@@ -495,10 +591,12 @@ var RestArkProvider = class {
       vtxoMaxAmount: BigInt(fromServer.vtxoMaxAmount ?? -1),
       vtxoMinAmount: BigInt(fromServer.vtxoMinAmount ?? 0)
     };
+    this._digest = info.digest;
+    return info;
   }
   async submitTx(signedArkTx, checkpointTxs) {
     const url = `${this.serverUrl}/v1/tx/submit`;
-    const response = await fetch(url, {
+    const response = await this.authedFetch(url, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
@@ -521,7 +619,7 @@ var RestArkProvider = class {
   }
   async finalizeTx(arkTxid, finalCheckpointTxs) {
     const url = `${this.serverUrl}/v1/tx/finalize`;
-    const response = await fetch(url, {
+    const response = await this.authedFetch(url, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
@@ -538,7 +636,7 @@ var RestArkProvider = class {
   }
   async registerIntent(intent) {
     const url = `${this.serverUrl}/v1/batch/registerIntent`;
-    const response = await fetch(url, {
+    const response = await this.authedFetch(url, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
@@ -559,7 +657,7 @@ var RestArkProvider = class {
   }
   async deleteIntent(intent) {
     const url = `${this.serverUrl}/v1/batch/deleteIntent`;
-    const response = await fetch(url, {
+    const response = await this.authedFetch(url, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
@@ -578,7 +676,7 @@ var RestArkProvider = class {
   }
   async confirmRegistration(intentId) {
     const url = `${this.serverUrl}/v1/batch/ack`;
-    const response = await fetch(url, {
+    const response = await this.authedFetch(url, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
@@ -594,7 +692,7 @@ var RestArkProvider = class {
   }
   async submitTreeNonces(batchId, pubkey, nonces) {
     const url = `${this.serverUrl}/v1/batch/tree/submitNonces`;
-    const response = await fetch(url, {
+    const response = await this.authedFetch(url, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
@@ -612,7 +710,7 @@ var RestArkProvider = class {
   }
   async submitTreeSignatures(batchId, pubkey, signatures) {
     const url = `${this.serverUrl}/v1/batch/tree/submitSignatures`;
-    const response = await fetch(url, {
+    const response = await this.authedFetch(url, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
@@ -630,7 +728,7 @@ var RestArkProvider = class {
   }
   async submitSignedForfeitTxs(signedForfeitTxs, signedCommitmentTx) {
     const url = `${this.serverUrl}/v1/batch/submitForfeitTxs`;
-    const response = await fetch(url, {
+    const response = await this.authedFetch(url, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
@@ -760,7 +858,7 @@ var RestArkProvider = class {
   }
   async getPendingTxs(intent) {
     const url = `${this.serverUrl}/v1/tx/pending`;
-    const response = await fetch(url, {
+    const response = await this.authedFetch(url, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
@@ -2189,7 +2287,7 @@ var ChainTxType = /* @__PURE__ */ ((ChainTxType2) => {
   return ChainTxType2;
 })(ChainTxType || {});
 var RestIndexerProvider = class {
-  constructor(serverUrl = chunkWMIPYZSB_cjs.DEFAULT_ARKADE_SERVER_URL) {
+  constructor(serverUrl = chunkCMPJR3HS_cjs.DEFAULT_ARKADE_SERVER_URL) {
     this.serverUrl = serverUrl;
   }
   async getVtxoTree(batchOutpoint, opts) {
@@ -2203,7 +2301,7 @@ var RestIndexerProvider = class {
     if (params.toString()) {
       url += "?" + params.toString();
     }
-    const res = await fetch(url);
+    const res = await baseFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch vtxo tree: ${res.statusText}`);
     }
@@ -2229,7 +2327,7 @@ var RestIndexerProvider = class {
     if (params.toString()) {
       url += "?" + params.toString();
     }
-    const res = await fetch(url);
+    const res = await baseFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch vtxo tree leaves: ${res.statusText}`);
     }
@@ -2241,7 +2339,7 @@ var RestIndexerProvider = class {
   }
   async getBatchSweepTransactions(batchOutpoint) {
     const url = `${this.serverUrl}/v1/indexer/batch/${batchOutpoint.txid}/${batchOutpoint.vout}/sweepTxs`;
-    const res = await fetch(url);
+    const res = await baseFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch batch sweep transactions: ${res.statusText}`);
     }
@@ -2253,7 +2351,7 @@ var RestIndexerProvider = class {
   }
   async getCommitmentTx(txid) {
     const url = `${this.serverUrl}/v1/indexer/commitmentTx/${txid}`;
-    const res = await fetch(url);
+    const res = await baseFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch commitment tx: ${res.statusText}`);
     }
@@ -2274,7 +2372,7 @@ var RestIndexerProvider = class {
     if (params.toString()) {
       url += "?" + params.toString();
     }
-    const res = await fetch(url);
+    const res = await baseFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch commitment tx connectors: ${res.statusText}`);
     }
@@ -2300,7 +2398,7 @@ var RestIndexerProvider = class {
     if (params.toString()) {
       url += "?" + params.toString();
     }
-    const res = await fetch(url);
+    const res = await baseFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch commitment tx forfeitTxs: ${res.statusText}`);
     }
@@ -2383,7 +2481,7 @@ var RestIndexerProvider = class {
     if (params.toString()) {
       url += "?" + params.toString();
     }
-    const res = await fetch(url);
+    const res = await baseFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch virtual txs: ${res.statusText}`);
     }
@@ -2404,7 +2502,7 @@ var RestIndexerProvider = class {
     if (params.toString()) {
       url += "?" + params.toString();
     }
-    const res = await fetch(url);
+    const res = await baseFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch vtxo chain: ${res.statusText}`);
     }
@@ -2463,7 +2561,7 @@ var RestIndexerProvider = class {
     if (params.toString()) {
       url += "?" + params.toString();
     }
-    const res = await fetch(url);
+    const res = await baseFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch vtxos: ${res.statusText}`);
     }
@@ -2478,7 +2576,7 @@ var RestIndexerProvider = class {
   }
   async getAssetDetails(assetId) {
     const url = `${this.serverUrl}/v1/indexer/asset/${encodeURIComponent(assetId)}`;
-    const res = await fetch(url);
+    const res = await baseFetch(url);
     if (!res.ok) {
       throw new Error(`Failed to fetch asset details: ${res.statusText}`);
     }
@@ -2496,7 +2594,7 @@ var RestIndexerProvider = class {
   }
   async subscribeForScripts(scripts, subscriptionId) {
     const url = `${this.serverUrl}/v1/indexer/script/subscribe`;
-    const res = await fetch(url, {
+    const res = await baseFetch(url, {
       headers: {
         "Content-Type": "application/json"
       },
@@ -2513,7 +2611,7 @@ var RestIndexerProvider = class {
   }
   async unsubscribeForScripts(subscriptionId, scripts) {
     const url = `${this.serverUrl}/v1/indexer/script/unsubscribe`;
-    const res = await fetch(url, {
+    const res = await baseFetch(url, {
       headers: {
         "Content-Type": "application/json"
       },
@@ -2680,6 +2778,7 @@ exports.BufferReader = BufferReader;
 exports.ChainTxType = ChainTxType;
 exports.ConditionWitness = ConditionWitness;
 exports.CosignerPublicKey = CosignerPublicKey;
+exports.DigestMismatchError = DigestMismatchError;
 exports.IndexerTxType = IndexerTxType;
 exports.Metadata = Metadata;
 exports.OP_RETURN_EMPTY_PKSCRIPT = OP_RETURN_EMPTY_PKSCRIPT;
@@ -2691,11 +2790,15 @@ exports.Transaction = Transaction;
 exports.VtxoTaprootTree = VtxoTaprootTree;
 exports.VtxoTreeExpiry = VtxoTreeExpiry;
 exports.asset_exports = asset_exports;
+exports.baseFetch = baseFetch;
+exports.buildVersion = buildVersion;
 exports.craftToSpendTx = craftToSpendTx;
+exports.fetch = fetch;
 exports.getArkPsbtFields = getArkPsbtFields;
 exports.isEventSourceError = isEventSourceError;
 exports.isFetchTimeoutError = isFetchTimeoutError;
 exports.maybeArkError = maybeArkError;
+exports.sdkVersion = sdkVersion;
 exports.setArkPsbtField = setArkPsbtField;
-//# sourceMappingURL=chunk-SPDNHPM4.cjs.map
-//# sourceMappingURL=chunk-SPDNHPM4.cjs.map
+//# sourceMappingURL=chunk-X2EQLK4O.cjs.map
+//# sourceMappingURL=chunk-X2EQLK4O.cjs.map