@arkade-os/sdk 0.4.34 → 0.4.35

package/dist/{chunk-FXFBPXV3.js → chunk-3JR77WQ4.js}

@@ -136,23 +136,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) {
@@ -435,7 +439,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";
@@ -452,6 +481,67 @@ var RestArkProvider = class {
   constructor(serverUrl = 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);
@@ -460,10 +550,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 ?? ""
       })) ?? [],
@@ -493,10 +589,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"
@@ -519,7 +617,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"
@@ -536,7 +634,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"
@@ -557,7 +655,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"
@@ -576,7 +674,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"
@@ -592,7 +690,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"
@@ -610,7 +708,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"
@@ -628,7 +726,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"
@@ -758,7 +856,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"
@@ -2201,7 +2299,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}`);
     }
@@ -2227,7 +2325,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}`);
     }
@@ -2239,7 +2337,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}`);
     }
@@ -2251,7 +2349,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}`);
     }
@@ -2272,7 +2370,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}`);
     }
@@ -2298,7 +2396,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}`);
     }
@@ -2381,7 +2479,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}`);
     }
@@ -2402,7 +2500,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}`);
     }
@@ -2461,7 +2559,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}`);
     }
@@ -2476,7 +2574,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}`);
     }
@@ -2494,7 +2592,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"
       },
@@ -2511,7 +2609,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"
       },
@@ -2666,6 +2764,6 @@ var Response;
   Response2.isGetAssetResponse = isGetAssetResponse;
 })(Response || (Response = {}));
 
-export { ArkError, ArkPsbtFieldKey, ArkPsbtFieldKeyType, AssetGroup, AssetId, AssetInput, AssetOutput, AssetRef, BufferReader, ChainTxType, ConditionWitness, CosignerPublicKey, IndexerTxType, Intent, Metadata, OP_RETURN_EMPTY_PKSCRIPT, Packet, RestArkProvider, RestIndexerProvider, SettlementEventType, Transaction, VtxoTaprootTree, VtxoTreeExpiry, asset_exports, craftToSpendTx, getArkPsbtFields, isEventSourceError, isFetchTimeoutError, maybeArkError, setArkPsbtField };
-//# sourceMappingURL=chunk-FXFBPXV3.js.map
-//# sourceMappingURL=chunk-FXFBPXV3.js.map
+export { ArkError, ArkPsbtFieldKey, ArkPsbtFieldKeyType, AssetGroup, AssetId, AssetInput, AssetOutput, AssetRef, BufferReader, ChainTxType, ConditionWitness, CosignerPublicKey, DigestMismatchError, 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-3JR77WQ4.js.map
+//# sourceMappingURL=chunk-3JR77WQ4.js.map