@arkade-os/boltz-swap 0.3.25 → 0.3.27

package/dist/expo/index.d.ts

@@ -1,5 +1,5 @@
-import { I as IArkadeSwaps, A as ArkadeSwaps, V as VhtlcTimeouts } from '../arkade-swaps-pfAgQUMP.js';
-import { A as ArkadeSwapsConfig, m as SwapRepository, p as BoltzSwapProvider, N as Network, n as SwapManagerClient, C as CreateLightningInvoiceRequest, e as CreateLightningInvoiceResponse, S as SendLightningPaymentRequest, f as SendLightningPaymentResponse, c as BoltzSubmarineSwap, b as BoltzReverseSwap, g as SubmarineRefundOutcome, h as SubmarineRecoveryInfo, i as SubmarineRecoveryResult, F as FeesResponse, a as BoltzChainSwap, k as ArkToBtcResponse, l as BtcToArkResponse, d as Chain, j as ChainFeesResponse, L as LimitsResponse, G as GetSwapStatusResponse, B as BoltzSwap } from '../types-LCXS1AVA.js';
+import { I as IArkadeSwaps, A as ArkadeSwaps, V as VhtlcTimeouts } from '../arkade-swaps-WiKCanCL.js';
+import { A as ArkadeSwapsConfig, m as SwapRepository, p as BoltzSwapProvider, N as Network, n as SwapManagerClient, C as CreateLightningInvoiceRequest, e as CreateLightningInvoiceResponse, S as SendLightningPaymentRequest, f as SendLightningPaymentResponse, c as BoltzSubmarineSwap, b as BoltzReverseSwap, g as SubmarineRefundOutcome, h as SubmarineRecoveryInfo, i as SubmarineRecoveryResult, F as FeesResponse, a as BoltzChainSwap, k as ArkToBtcResponse, l as BtcToArkResponse, d as Chain, j as ChainFeesResponse, L as LimitsResponse, G as GetSwapStatusResponse, B as BoltzSwap } from '../types-BBI7-KJ0.js';
 import { Identity, ArkProvider, IndexerProvider, IWallet, ArkInfo, ArkTxInput, VHTLC } from '@arkade-os/sdk';
 import { AsyncStorageTaskQueue, TaskProcessor } from '@arkade-os/sdk/worker/expo';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';

package/dist/expo/index.js

@@ -4,10 +4,10 @@ import {
   registerExpoSwapBackgroundTask,
   swapsPollProcessor,
   unregisterExpoSwapBackgroundTask
-} from "../chunk-FEXQELYZ.js";
+} from "../chunk-X3JNWDAR.js";
 import {
   ArkadeSwaps
-} from "../chunk-XC2ARJZO.js";
+} from "../chunk-LWUXSE5N.js";
 import "../chunk-3RG5ZIWI.js";
 
 // src/expo/arkade-lightning.ts
@@ -56,7 +56,7 @@ var ExpoArkadeSwaps = class _ExpoArkadeSwaps {
     await instance.seedSwapPollTask();
     if (config.background.minimumBackgroundInterval) {
       try {
-        const { registerExpoSwapBackgroundTask: registerExpoSwapBackgroundTask2 } = await import("../background-GCBCKLGY.js");
+        const { registerExpoSwapBackgroundTask: registerExpoSwapBackgroundTask2 } = await import("../background-UQDFQCGM.js");
         await registerExpoSwapBackgroundTask2(
           config.background.taskName,
           {
@@ -129,7 +129,7 @@ var ExpoArkadeSwaps = class _ExpoArkadeSwaps {
     }
     await this.inner.dispose();
     try {
-      const { unregisterExpoSwapBackgroundTask: unregisterExpoSwapBackgroundTask2 } = await import("../background-GCBCKLGY.js");
+      const { unregisterExpoSwapBackgroundTask: unregisterExpoSwapBackgroundTask2 } = await import("../background-UQDFQCGM.js");
       await unregisterExpoSwapBackgroundTask2(this.taskName);
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);

package/dist/index.cjs

@@ -47,6 +47,7 @@ __export(index_exports, {
   SwapError: () => SwapError,
   SwapExpiredError: () => SwapExpiredError,
   SwapManager: () => SwapManager,
+  SwapNotFoundError: () => SwapNotFoundError,
   TransactionFailedError: () => TransactionFailedError,
   decodeInvoice: () => decodeInvoice,
   enrichReverseSwapPreimage: () => enrichReverseSwapPreimage,
@@ -138,6 +139,19 @@ var NetworkError = class extends Error {
     this.errorData = errorData;
   }
 };
+var SwapNotFoundError = class extends NetworkError {
+  /** The swap ID Boltz did not recognise. */
+  swapId;
+  constructor(swapId, errorData) {
+    super(
+      `Boltz returned 404 for swap '${swapId}': swap unknown to this Boltz instance`,
+      404,
+      errorData
+    );
+    this.name = "SwapNotFoundError";
+    this.swapId = swapId;
+  }
+};
 var SchemaError = class extends SwapError {
   constructor(options = {}) {
     super({ message: "Invalid API response", ...options });
@@ -396,10 +410,17 @@ var isCreateSwapsRestoreResponse = (data) => {
   );
 };
 var BASE_URLS = {
-  bitcoin: "https://api.ark.boltz.exchange",
+  bitcoin: "https://api.boltz.exchange",
   mutinynet: "https://api.boltz.mutinynet.arkade.sh",
   regtest: "http://localhost:9069"
 };
+var isSwapNotFoundBody = (error) => {
+  const needle = "could not find swap";
+  const fromJson = error.errorData?.error;
+  if (typeof fromJson === "string" && fromJson.toLowerCase().includes(needle))
+    return true;
+  return error.message.toLowerCase().includes(needle);
+};
 var BoltzSwapProvider = class {
   wsUrl;
   apiUrl;
@@ -491,12 +512,27 @@ var BoltzSwapProvider = class {
       });
     return res;
   }
-  /** Queries the current status of a swap by ID. */
+  /**
+   * Queries the current status of a swap by ID.
+   *
+   * @throws {SwapNotFoundError} when Boltz responds with HTTP 404 and a body
+   * matching the "could not find swap" pattern. Distinct from a generic 404
+   * so callers (e.g. SwapManager polling) can drive a per-swap unknown-to-
+   * provider counter without tripping on transient route or proxy errors.
+   */
   async getSwapStatus(id) {
-    const response = await this.request(
-      `/v2/swap/${id}`,
-      "GET"
-    );
+    let response;
+    try {
+      response = await this.request(
+        `/v2/swap/${id}`,
+        "GET"
+      );
+    } catch (error) {
+      if (error instanceof NetworkError && error.statusCode === 404 && isSwapNotFoundBody(error)) {
+        throw new SwapNotFoundError(id, error.errorData);
+      }
+      throw error;
+    }
     if (!isGetSwapStatusResponse(response))
       throw new SchemaError({
         message: `error fetching status for swap: ${id}`
@@ -1400,7 +1436,15 @@ function setLogger(customLogger) {
 }
 
 // src/swap-manager.ts
-var SwapManager = class {
+var SwapManager = class _SwapManager {
+  /**
+   * Number of consecutive Boltz 404s for a single swap ID before the
+   * polling loop gives up and transitions the swap to a terminal state.
+   * At the default 30s poll cadence this is roughly a 5-minute grace
+   * window — long enough to ride out a transient Boltz blip, short
+   * enough that a real "swap unknown to this provider" surfaces quickly.
+   */
+  static NOT_FOUND_THRESHOLD = 10;
   swapProvider;
   config;
   // Event listeners storage (supports multiple listeners per event)
@@ -1419,6 +1463,13 @@ var SwapManager = class {
   reconnectTimer = null;
   initialPollTimer = null;
   pollRetryTimers = /* @__PURE__ */ new Map();
+  // Per-swap counter of consecutive `SwapNotFoundError` responses from
+  // `getSwapStatus`. Reset on any successful poll. Once a swap reaches
+  // `NOT_FOUND_THRESHOLD` consecutive 404s the safety net trips and the
+  // swap is transitioned to `swap.expired` (terminal) and dropped from
+  // monitoring — typically the canonical failure mode after a Boltz
+  // endpoint switch, where old swap IDs are unknown to the new instance.
+  notFoundCounts = /* @__PURE__ */ new Map();
   isRunning = false;
   currentReconnectDelay;
   currentPollRetryDelay;
@@ -1610,6 +1661,7 @@ var SwapManager = class {
       clearTimeout(timer);
     }
     this.pollRetryTimers.clear();
+    this.notFoundCounts.clear();
   }
   /**
    * Set the polling interval (ms).
@@ -1670,6 +1722,7 @@ var SwapManager = class {
       clearTimeout(retryTimer);
       this.pollRetryTimers.delete(swapId);
     }
+    this.notFoundCounts.delete(swapId);
     logger.log(`Removed swap ${swapId} from monitoring`);
   }
   /**
@@ -1946,6 +1999,7 @@ var SwapManager = class {
    * This is the core logic that determines what actions to take
    */
   async handleSwapStatusUpdate(swap, newStatus) {
+    this.notFoundCounts.delete(swap.id);
     const oldStatus = swap.status;
     if (oldStatus === newStatus) return;
     swap.status = newStatus;
@@ -2231,51 +2285,135 @@ var SwapManager = class {
   async pollAllSwaps() {
     if (this.monitoredSwaps.size === 0) return;
     const pollPromises = Array.from(this.monitoredSwaps.values()).map(
-      async (swap) => {
+      (swap) => this.pollSingleSwap(swap)
+    );
+    await Promise.allSettled(pollPromises);
+  }
+  async pollSingleSwap(swap) {
+    try {
+      const statusResponse = await this.swapProvider.getSwapStatus(
+        swap.id
+      );
+      this.notFoundCounts.delete(swap.id);
+      if (statusResponse.status !== swap.status) {
+        await this.handleSwapStatusUpdate(swap, statusResponse.status);
+      }
+    } catch (error) {
+      if (error instanceof SwapNotFoundError) {
+        await this.handleSwapNotFound(swap);
+        return;
+      }
+      if (error instanceof NetworkError && error.statusCode === 429) {
+        logger.warn(
+          `Rate-limited polling swap ${swap.id}, retrying in 2s`
+        );
+        const existing = this.pollRetryTimers.get(swap.id);
+        if (existing) clearTimeout(existing);
+        this.pollRetryTimers.set(
+          swap.id,
+          setTimeout(async () => {
+            this.pollRetryTimers.delete(swap.id);
+            try {
+              const retry = await this.swapProvider.getSwapStatus(
+                swap.id
+              );
+              this.notFoundCounts.delete(swap.id);
+              if (retry.status !== swap.status) {
+                await this.handleSwapStatusUpdate(
+                  swap,
+                  retry.status
+                );
+              }
+            } catch (retryError) {
+              if (retryError instanceof SwapNotFoundError) {
+                await this.handleSwapNotFound(swap);
+                return;
+              }
+              logger.error(
+                `Retry poll for swap ${swap.id} also failed:`,
+                retryError
+              );
+            }
+          }, 2e3)
+        );
+      } else {
+        logger.error(`Failed to poll swap ${swap.id}:`, error);
+      }
+    }
+  }
+  /**
+   * Increment the consecutive-not-found counter and, once the threshold is
+   * reached, transition the swap to a terminal state and stop polling it.
+   * Driven from {@link pollSingleSwap} when `getSwapStatus` throws
+   * {@link SwapNotFoundError}. The threshold rides out a transient blip
+   * but ensures we stop hammering Boltz with requests for swap IDs the
+   * server has no record of (e.g. after switching the configured
+   * Boltz endpoint).
+   */
+  async handleSwapNotFound(swap) {
+    const count = (this.notFoundCounts.get(swap.id) ?? 0) + 1;
+    this.notFoundCounts.set(swap.id, count);
+    logger.warn(
+      `Swap ${swap.id}: unknown to Boltz (${count}/${_SwapManager.NOT_FOUND_THRESHOLD} consecutive)`
+    );
+    if (count >= _SwapManager.NOT_FOUND_THRESHOLD) {
+      await this.markSwapAsUnknownToProvider(swap);
+    }
+  }
+  /**
+   * Transition a swap to {@code swap.expired} (terminal for all swap types)
+   * after Boltz has consistently reported it unknown for
+   * {@link SwapManager.NOT_FOUND_THRESHOLD} consecutive polls. The swap is
+   * persisted, removed from monitoring, and reported via `onSwapFailed`.
+   * Bypasses {@link handleSwapStatusUpdate} on purpose: we don't want to
+   * trigger autonomous claim/refund actions against a Boltz instance that
+   * has no record of this swap — the requests would just generate more
+   * 404s without recovering anything.
+   */
+  async markSwapAsUnknownToProvider(swap) {
+    if (!this.monitoredSwaps.has(swap.id)) {
+      this.notFoundCounts.delete(swap.id);
+      return;
+    }
+    const oldStatus = swap.status;
+    swap.status = "swap.expired";
+    this.monitoredSwaps.delete(swap.id);
+    const retryTimer = this.pollRetryTimers.get(swap.id);
+    if (retryTimer) {
+      clearTimeout(retryTimer);
+      this.pollRetryTimers.delete(swap.id);
+    }
+    this.notFoundCounts.delete(swap.id);
+    this.swapUpdateListeners.forEach(
+      (listener) => listener(swap, oldStatus)
+    );
+    const subscribers = this.swapSubscriptions.get(swap.id);
+    if (subscribers) {
+      subscribers.forEach((callback) => {
         try {
-          const statusResponse = await this.swapProvider.getSwapStatus(swap.id);
-          if (statusResponse.status !== swap.status) {
-            await this.handleSwapStatusUpdate(
-              swap,
-              statusResponse.status
-            );
-          }
-        } catch (error) {
-          if (error instanceof NetworkError && error.statusCode === 429) {
-            logger.warn(
-              `Rate-limited polling swap ${swap.id}, retrying in 2s`
-            );
-            const existing = this.pollRetryTimers.get(swap.id);
-            if (existing) clearTimeout(existing);
-            this.pollRetryTimers.set(
-              swap.id,
-              setTimeout(async () => {
-                this.pollRetryTimers.delete(swap.id);
-                try {
-                  const retry = await this.swapProvider.getSwapStatus(
-                    swap.id
-                  );
-                  if (retry.status !== swap.status) {
-                    await this.handleSwapStatusUpdate(
-                      swap,
-                      retry.status
-                    );
-                  }
-                } catch (retryError) {
-                  logger.error(
-                    `Retry poll for swap ${swap.id} also failed:`,
-                    retryError
-                  );
-                }
-              }, 2e3)
-            );
-          } else {
-            logger.error(`Failed to poll swap ${swap.id}:`, error);
-          }
+          callback(swap, oldStatus);
+        } catch (subscriberError) {
+          logger.error(
+            `Error in swap subscription callback for ${swap.id}:`,
+            subscriberError
+          );
         }
-      }
+      });
+    }
+    try {
+      await this.saveSwap(swap);
+    } catch (saveError) {
+      logger.error(
+        `Failed to persist unknown-to-provider state for swap ${swap.id}:`,
+        saveError
+      );
+    }
+    logger.warn(
+      `Swap ${swap.id}: marked failed after ${_SwapManager.NOT_FOUND_THRESHOLD} consecutive Boltz 404s \u2014 swap is unknown to the configured Boltz instance`
     );
-    await Promise.allSettled(pollPromises);
+    const error = new SwapNotFoundError(swap.id);
+    this.swapFailedListeners.forEach((listener) => listener(swap, error));
+    this.swapSubscriptions.delete(swap.id);
   }
   /**
    * Check if a status is final (no more updates expected)
@@ -6633,6 +6771,7 @@ async function getContractCollection(storage, contractType) {
   SwapError,
   SwapExpiredError,
   SwapManager,
+  SwapNotFoundError,
   TransactionFailedError,
   decodeInvoice,
   enrichReverseSwapPreimage,

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { I as IArkadeSwaps, V as VhtlcTimeouts } from './arkade-swaps-CZF9XoFR.cjs';
-export { A as ArkadeSwaps } from './arkade-swaps-CZF9XoFR.cjs';
-import { B as BoltzSwap, D as DecodedInvoice, a as BoltzChainSwap, b as BoltzReverseSwap, c as BoltzSubmarineSwap, A as ArkadeSwapsConfig, N as Network, C as CreateLightningInvoiceRequest, S as SendLightningPaymentRequest, F as FeesResponse, d as Chain, e as CreateLightningInvoiceResponse, f as SendLightningPaymentResponse, g as SubmarineRefundOutcome, h as SubmarineRecoveryInfo, i as SubmarineRecoveryResult, j as ChainFeesResponse, L as LimitsResponse, G as GetSwapStatusResponse, k as ArkToBtcResponse, l as BtcToArkResponse, m as SwapRepository, n as SwapManagerClient, o as GetSwapsFilter } from './types-LCXS1AVA.cjs';
-export { _ as ArkadeSwapsCreateConfig, p as BoltzSwapProvider, q as BoltzSwapStatus, Z as IncomingPaymentSubscription, a1 as PendingChainSwap, a0 as PendingReverseSwap, $ as PendingSubmarineSwap, a2 as PendingSwap, a4 as SubmarineRecoveryStatus, Y as SwapManager, a7 as SwapManagerCallbacks, a5 as SwapManagerConfig, a6 as SwapManagerEvents, a3 as Vtxo, r as isChainClaimableStatus, s as isChainFailedStatus, t as isChainFinalStatus, u as isChainPendingStatus, v as isChainRefundableStatus, w as isChainSignableStatus, x as isChainSuccessStatus, y as isChainSwapClaimable, z as isChainSwapRefundable, E as isPendingChainSwap, H as isPendingReverseSwap, I as isPendingSubmarineSwap, J as isReverseClaimableStatus, K as isReverseFailedStatus, M as isReverseFinalStatus, O as isReversePendingStatus, P as isReverseSuccessStatus, Q as isReverseSwapClaimable, R as isSubmarineFailedStatus, T as isSubmarineFinalStatus, U as isSubmarinePendingStatus, W as isSubmarineRefundableStatus, V as isSubmarineSuccessStatus, X as isSubmarineSwapRefundable } from './types-LCXS1AVA.cjs';
+import { I as IArkadeSwaps, V as VhtlcTimeouts } from './arkade-swaps-CS8FZSVL.cjs';
+export { A as ArkadeSwaps } from './arkade-swaps-CS8FZSVL.cjs';
+import { B as BoltzSwap, D as DecodedInvoice, a as BoltzChainSwap, b as BoltzReverseSwap, c as BoltzSubmarineSwap, A as ArkadeSwapsConfig, N as Network, C as CreateLightningInvoiceRequest, S as SendLightningPaymentRequest, F as FeesResponse, d as Chain, e as CreateLightningInvoiceResponse, f as SendLightningPaymentResponse, g as SubmarineRefundOutcome, h as SubmarineRecoveryInfo, i as SubmarineRecoveryResult, j as ChainFeesResponse, L as LimitsResponse, G as GetSwapStatusResponse, k as ArkToBtcResponse, l as BtcToArkResponse, m as SwapRepository, n as SwapManagerClient, o as GetSwapsFilter } from './types-BBI7-KJ0.cjs';
+export { _ as ArkadeSwapsCreateConfig, p as BoltzSwapProvider, q as BoltzSwapStatus, Z as IncomingPaymentSubscription, a1 as PendingChainSwap, a0 as PendingReverseSwap, $ as PendingSubmarineSwap, a2 as PendingSwap, a4 as SubmarineRecoveryStatus, Y as SwapManager, a7 as SwapManagerCallbacks, a5 as SwapManagerConfig, a6 as SwapManagerEvents, a3 as Vtxo, r as isChainClaimableStatus, s as isChainFailedStatus, t as isChainFinalStatus, u as isChainPendingStatus, v as isChainRefundableStatus, w as isChainSignableStatus, x as isChainSuccessStatus, y as isChainSwapClaimable, z as isChainSwapRefundable, E as isPendingChainSwap, H as isPendingReverseSwap, I as isPendingSubmarineSwap, J as isReverseClaimableStatus, K as isReverseFailedStatus, M as isReverseFinalStatus, O as isReversePendingStatus, P as isReverseSuccessStatus, Q as isReverseSwapClaimable, R as isSubmarineFailedStatus, T as isSubmarineFinalStatus, U as isSubmarinePendingStatus, W as isSubmarineRefundableStatus, V as isSubmarineSuccessStatus, X as isSubmarineSwapRefundable } from './types-BBI7-KJ0.cjs';
 import { Transaction } from '@scure/btc-signer';
 import { MessageHandler, RequestEnvelope, ArkInfo, ResponseEnvelope, IWallet, IReadonlyWallet, VHTLC, Identity, ArkTxInput } from '@arkade-os/sdk';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
@@ -53,6 +53,20 @@ declare class NetworkError extends Error {
     errorData?: any;
     constructor(message: string, statusCode?: number, errorData?: any);
 }
+/**
+ * Thrown when Boltz responds to `GET /v2/swap/{id}` with HTTP 404 and a body
+ * matching `{"error":"could not find swap with id: ..."}`. Signals that the
+ * configured Boltz instance has no record of this swap — typically because
+ * the swap was created against a different Boltz endpoint. Distinct from a
+ * generic 404 (route change, proxy misconfig) so the polling loop can drive
+ * a per-swap "unknown to provider" counter without conflating it with
+ * transient network errors.
+ */
+declare class SwapNotFoundError extends NetworkError {
+    /** The swap ID Boltz did not recognise. */
+    readonly swapId: string;
+    constructor(swapId: string, errorData?: any);
+}
 /** Thrown when the Boltz API returns a response that doesn't match the expected schema. */
 declare class SchemaError extends SwapError {
     constructor(options?: ErrorOptions);
@@ -769,4 +783,4 @@ declare class IndexedDbSwapRepository implements SwapRepository {
     [Symbol.asyncDispose](): Promise<void>;
 }
 
-export { ArkToBtcResponse, ArkadeSwapsMessageHandler as ArkadeLightningMessageHandler, ArkadeSwapsConfig, ArkadeSwapsMessageHandler, BoltzChainSwap, BoltzRefundError, BoltzReverseSwap, BoltzSubmarineSwap, BoltzSwap, BtcToArkResponse, Chain, ChainFeesResponse, CreateLightningInvoiceRequest, CreateLightningInvoiceResponse, DecodedInvoice, FeesResponse, IndexedDbSwapRepository, InsufficientFundsError, InvoiceExpiredError, InvoiceFailedToPayError, LimitsResponse, type Logger, Network, NetworkError, PreimageFetchError, SchemaError, SendLightningPaymentRequest, SendLightningPaymentResponse, ServiceWorkerArkadeSwaps as ServiceWorkerArkadeLightning, ServiceWorkerArkadeSwaps, SubmarineRecoveryInfo, SubmarineRecoveryResult, SubmarineRefundOutcome, SwapError, SwapExpiredError, SwapManagerClient, SwapRepository, type SwapSaver, TransactionFailedError, decodeInvoice, enrichReverseSwapPreimage, enrichSubmarineSwapInvoice, getInvoicePaymentHash, getInvoiceSatoshis, isValidArkAddress, logger, migrateToSwapRepository, saveSwap, setLogger, updateChainSwapStatus, updateReverseSwapStatus, updateSubmarineSwapStatus, verifySignatures };
+export { ArkToBtcResponse, ArkadeSwapsMessageHandler as ArkadeLightningMessageHandler, ArkadeSwapsConfig, ArkadeSwapsMessageHandler, BoltzChainSwap, BoltzRefundError, BoltzReverseSwap, BoltzSubmarineSwap, BoltzSwap, BtcToArkResponse, Chain, ChainFeesResponse, CreateLightningInvoiceRequest, CreateLightningInvoiceResponse, DecodedInvoice, FeesResponse, IndexedDbSwapRepository, InsufficientFundsError, InvoiceExpiredError, InvoiceFailedToPayError, LimitsResponse, type Logger, Network, NetworkError, PreimageFetchError, SchemaError, SendLightningPaymentRequest, SendLightningPaymentResponse, ServiceWorkerArkadeSwaps as ServiceWorkerArkadeLightning, ServiceWorkerArkadeSwaps, SubmarineRecoveryInfo, SubmarineRecoveryResult, SubmarineRefundOutcome, SwapError, SwapExpiredError, SwapManagerClient, SwapNotFoundError, SwapRepository, type SwapSaver, TransactionFailedError, decodeInvoice, enrichReverseSwapPreimage, enrichSubmarineSwapInvoice, getInvoicePaymentHash, getInvoiceSatoshis, isValidArkAddress, logger, migrateToSwapRepository, saveSwap, setLogger, updateChainSwapStatus, updateReverseSwapStatus, updateSubmarineSwapStatus, verifySignatures };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { I as IArkadeSwaps, V as VhtlcTimeouts } from './arkade-swaps-pfAgQUMP.js';
-export { A as ArkadeSwaps } from './arkade-swaps-pfAgQUMP.js';
-import { B as BoltzSwap, D as DecodedInvoice, a as BoltzChainSwap, b as BoltzReverseSwap, c as BoltzSubmarineSwap, A as ArkadeSwapsConfig, N as Network, C as CreateLightningInvoiceRequest, S as SendLightningPaymentRequest, F as FeesResponse, d as Chain, e as CreateLightningInvoiceResponse, f as SendLightningPaymentResponse, g as SubmarineRefundOutcome, h as SubmarineRecoveryInfo, i as SubmarineRecoveryResult, j as ChainFeesResponse, L as LimitsResponse, G as GetSwapStatusResponse, k as ArkToBtcResponse, l as BtcToArkResponse, m as SwapRepository, n as SwapManagerClient, o as GetSwapsFilter } from './types-LCXS1AVA.js';
-export { _ as ArkadeSwapsCreateConfig, p as BoltzSwapProvider, q as BoltzSwapStatus, Z as IncomingPaymentSubscription, a1 as PendingChainSwap, a0 as PendingReverseSwap, $ as PendingSubmarineSwap, a2 as PendingSwap, a4 as SubmarineRecoveryStatus, Y as SwapManager, a7 as SwapManagerCallbacks, a5 as SwapManagerConfig, a6 as SwapManagerEvents, a3 as Vtxo, r as isChainClaimableStatus, s as isChainFailedStatus, t as isChainFinalStatus, u as isChainPendingStatus, v as isChainRefundableStatus, w as isChainSignableStatus, x as isChainSuccessStatus, y as isChainSwapClaimable, z as isChainSwapRefundable, E as isPendingChainSwap, H as isPendingReverseSwap, I as isPendingSubmarineSwap, J as isReverseClaimableStatus, K as isReverseFailedStatus, M as isReverseFinalStatus, O as isReversePendingStatus, P as isReverseSuccessStatus, Q as isReverseSwapClaimable, R as isSubmarineFailedStatus, T as isSubmarineFinalStatus, U as isSubmarinePendingStatus, W as isSubmarineRefundableStatus, V as isSubmarineSuccessStatus, X as isSubmarineSwapRefundable } from './types-LCXS1AVA.js';
+import { I as IArkadeSwaps, V as VhtlcTimeouts } from './arkade-swaps-WiKCanCL.js';
+export { A as ArkadeSwaps } from './arkade-swaps-WiKCanCL.js';
+import { B as BoltzSwap, D as DecodedInvoice, a as BoltzChainSwap, b as BoltzReverseSwap, c as BoltzSubmarineSwap, A as ArkadeSwapsConfig, N as Network, C as CreateLightningInvoiceRequest, S as SendLightningPaymentRequest, F as FeesResponse, d as Chain, e as CreateLightningInvoiceResponse, f as SendLightningPaymentResponse, g as SubmarineRefundOutcome, h as SubmarineRecoveryInfo, i as SubmarineRecoveryResult, j as ChainFeesResponse, L as LimitsResponse, G as GetSwapStatusResponse, k as ArkToBtcResponse, l as BtcToArkResponse, m as SwapRepository, n as SwapManagerClient, o as GetSwapsFilter } from './types-BBI7-KJ0.js';
+export { _ as ArkadeSwapsCreateConfig, p as BoltzSwapProvider, q as BoltzSwapStatus, Z as IncomingPaymentSubscription, a1 as PendingChainSwap, a0 as PendingReverseSwap, $ as PendingSubmarineSwap, a2 as PendingSwap, a4 as SubmarineRecoveryStatus, Y as SwapManager, a7 as SwapManagerCallbacks, a5 as SwapManagerConfig, a6 as SwapManagerEvents, a3 as Vtxo, r as isChainClaimableStatus, s as isChainFailedStatus, t as isChainFinalStatus, u as isChainPendingStatus, v as isChainRefundableStatus, w as isChainSignableStatus, x as isChainSuccessStatus, y as isChainSwapClaimable, z as isChainSwapRefundable, E as isPendingChainSwap, H as isPendingReverseSwap, I as isPendingSubmarineSwap, J as isReverseClaimableStatus, K as isReverseFailedStatus, M as isReverseFinalStatus, O as isReversePendingStatus, P as isReverseSuccessStatus, Q as isReverseSwapClaimable, R as isSubmarineFailedStatus, T as isSubmarineFinalStatus, U as isSubmarinePendingStatus, W as isSubmarineRefundableStatus, V as isSubmarineSuccessStatus, X as isSubmarineSwapRefundable } from './types-BBI7-KJ0.js';
 import { Transaction } from '@scure/btc-signer';
 import { MessageHandler, RequestEnvelope, ArkInfo, ResponseEnvelope, IWallet, IReadonlyWallet, VHTLC, Identity, ArkTxInput } from '@arkade-os/sdk';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
@@ -53,6 +53,20 @@ declare class NetworkError extends Error {
     errorData?: any;
     constructor(message: string, statusCode?: number, errorData?: any);
 }
+/**
+ * Thrown when Boltz responds to `GET /v2/swap/{id}` with HTTP 404 and a body
+ * matching `{"error":"could not find swap with id: ..."}`. Signals that the
+ * configured Boltz instance has no record of this swap — typically because
+ * the swap was created against a different Boltz endpoint. Distinct from a
+ * generic 404 (route change, proxy misconfig) so the polling loop can drive
+ * a per-swap "unknown to provider" counter without conflating it with
+ * transient network errors.
+ */
+declare class SwapNotFoundError extends NetworkError {
+    /** The swap ID Boltz did not recognise. */
+    readonly swapId: string;
+    constructor(swapId: string, errorData?: any);
+}
 /** Thrown when the Boltz API returns a response that doesn't match the expected schema. */
 declare class SchemaError extends SwapError {
     constructor(options?: ErrorOptions);
@@ -769,4 +783,4 @@ declare class IndexedDbSwapRepository implements SwapRepository {
     [Symbol.asyncDispose](): Promise<void>;
 }
 
-export { ArkToBtcResponse, ArkadeSwapsMessageHandler as ArkadeLightningMessageHandler, ArkadeSwapsConfig, ArkadeSwapsMessageHandler, BoltzChainSwap, BoltzRefundError, BoltzReverseSwap, BoltzSubmarineSwap, BoltzSwap, BtcToArkResponse, Chain, ChainFeesResponse, CreateLightningInvoiceRequest, CreateLightningInvoiceResponse, DecodedInvoice, FeesResponse, IndexedDbSwapRepository, InsufficientFundsError, InvoiceExpiredError, InvoiceFailedToPayError, LimitsResponse, type Logger, Network, NetworkError, PreimageFetchError, SchemaError, SendLightningPaymentRequest, SendLightningPaymentResponse, ServiceWorkerArkadeSwaps as ServiceWorkerArkadeLightning, ServiceWorkerArkadeSwaps, SubmarineRecoveryInfo, SubmarineRecoveryResult, SubmarineRefundOutcome, SwapError, SwapExpiredError, SwapManagerClient, SwapRepository, type SwapSaver, TransactionFailedError, decodeInvoice, enrichReverseSwapPreimage, enrichSubmarineSwapInvoice, getInvoicePaymentHash, getInvoiceSatoshis, isValidArkAddress, logger, migrateToSwapRepository, saveSwap, setLogger, updateChainSwapStatus, updateReverseSwapStatus, updateSubmarineSwapStatus, verifySignatures };
+export { ArkToBtcResponse, ArkadeSwapsMessageHandler as ArkadeLightningMessageHandler, ArkadeSwapsConfig, ArkadeSwapsMessageHandler, BoltzChainSwap, BoltzRefundError, BoltzReverseSwap, BoltzSubmarineSwap, BoltzSwap, BtcToArkResponse, Chain, ChainFeesResponse, CreateLightningInvoiceRequest, CreateLightningInvoiceResponse, DecodedInvoice, FeesResponse, IndexedDbSwapRepository, InsufficientFundsError, InvoiceExpiredError, InvoiceFailedToPayError, LimitsResponse, type Logger, Network, NetworkError, PreimageFetchError, SchemaError, SendLightningPaymentRequest, SendLightningPaymentResponse, ServiceWorkerArkadeSwaps as ServiceWorkerArkadeLightning, ServiceWorkerArkadeSwaps, SubmarineRecoveryInfo, SubmarineRecoveryResult, SubmarineRefundOutcome, SwapError, SwapExpiredError, SwapManagerClient, SwapNotFoundError, SwapRepository, type SwapSaver, TransactionFailedError, decodeInvoice, enrichReverseSwapPreimage, enrichSubmarineSwapInvoice, getInvoicePaymentHash, getInvoiceSatoshis, isValidArkAddress, logger, migrateToSwapRepository, saveSwap, setLogger, updateChainSwapStatus, updateReverseSwapStatus, updateSubmarineSwapStatus, verifySignatures };

package/dist/index.js

@@ -12,6 +12,7 @@ import {
   SwapError,
   SwapExpiredError,
   SwapManager,
+  SwapNotFoundError,
   TransactionFailedError,
   decodeInvoice,
   enrichReverseSwapPreimage,
@@ -50,7 +51,7 @@ import {
   updateReverseSwapStatus,
   updateSubmarineSwapStatus,
   verifySignatures
-} from "./chunk-XC2ARJZO.js";
+} from "./chunk-LWUXSE5N.js";
 import "./chunk-3RG5ZIWI.js";
 
 // src/serviceWorker/arkade-swaps-message-handler.ts
@@ -1494,6 +1495,7 @@ export {
   SwapError,
   SwapExpiredError,
   SwapManager,
+  SwapNotFoundError,
   TransactionFailedError,
   decodeInvoice,
   enrichReverseSwapPreimage,

package/dist/repositories/realm/index.d.cts

@@ -1,4 +1,4 @@
-import { m as SwapRepository, B as BoltzSwap, o as GetSwapsFilter } from '../../types-LCXS1AVA.cjs';
+import { m as SwapRepository, B as BoltzSwap, o as GetSwapsFilter } from '../../types-BBI7-KJ0.cjs';
 import '@arkade-os/sdk';
 
 /**

package/dist/repositories/realm/index.d.ts

@@ -1,4 +1,4 @@
-import { m as SwapRepository, B as BoltzSwap, o as GetSwapsFilter } from '../../types-LCXS1AVA.js';
+import { m as SwapRepository, B as BoltzSwap, o as GetSwapsFilter } from '../../types-BBI7-KJ0.js';
 import '@arkade-os/sdk';
 
 /**

package/dist/repositories/sqlite/index.d.cts

@@ -1,5 +1,5 @@
 import { SQLExecutor } from '@arkade-os/sdk/repositories/sqlite';
-import { m as SwapRepository, B as BoltzSwap, o as GetSwapsFilter } from '../../types-LCXS1AVA.cjs';
+import { m as SwapRepository, B as BoltzSwap, o as GetSwapsFilter } from '../../types-BBI7-KJ0.cjs';
 import '@arkade-os/sdk';
 
 /**

package/dist/repositories/sqlite/index.d.ts

@@ -1,5 +1,5 @@
 import { SQLExecutor } from '@arkade-os/sdk/repositories/sqlite';
-import { m as SwapRepository, B as BoltzSwap, o as GetSwapsFilter } from '../../types-LCXS1AVA.js';
+import { m as SwapRepository, B as BoltzSwap, o as GetSwapsFilter } from '../../types-BBI7-KJ0.js';
 import '@arkade-os/sdk';
 
 /**

package/dist/{types-LCXS1AVA.d.cts → types-BBI7-KJ0.d.cts}

@@ -310,7 +310,14 @@ declare class BoltzSwapProvider {
     getChainHeight(): Promise<number>;
     /** Gets the lockup transaction ID for a reverse swap. */
     getReverseSwapTxId(id: string): Promise<GetReverseSwapTxIdResponse>;
-    /** Queries the current status of a swap by ID. */
+    /**
+     * Queries the current status of a swap by ID.
+     *
+     * @throws {SwapNotFoundError} when Boltz responds with HTTP 404 and a body
+     * matching the "could not find swap" pattern. Distinct from a generic 404
+     * so callers (e.g. SwapManager polling) can drive a per-swap unknown-to-
+     * provider counter without tripping on transient route or proxy errors.
+     */
     getSwapStatus(id: string): Promise<GetSwapStatusResponse>;
     /** Gets the preimage for a settled submarine swap (proof of payment). */
     getSwapPreimage(id: string): Promise<GetSwapPreimageResponse>;
@@ -477,6 +484,14 @@ interface SwapManagerCallbacks {
  * for both reconnection and polling intervals.
  */
 declare class SwapManager implements SwapManagerClient {
+    /**
+     * Number of consecutive Boltz 404s for a single swap ID before the
+     * polling loop gives up and transitions the swap to a terminal state.
+     * At the default 30s poll cadence this is roughly a 5-minute grace
+     * window — long enough to ride out a transient Boltz blip, short
+     * enough that a real "swap unknown to this provider" surfaces quickly.
+     */
+    private static readonly NOT_FOUND_THRESHOLD;
     private readonly swapProvider;
     private readonly config;
     private swapUpdateListeners;
@@ -492,6 +507,7 @@ declare class SwapManager implements SwapManagerClient {
     private reconnectTimer;
     private initialPollTimer;
     private pollRetryTimers;
+    private notFoundCounts;
     private isRunning;
     private currentReconnectDelay;
     private currentPollRetryDelay;
@@ -706,6 +722,28 @@ declare class SwapManager implements SwapManagerClient {
      * 4. As fallback when WebSocket is unavailable
      */
     private pollAllSwaps;
+    private pollSingleSwap;
+    /**
+     * Increment the consecutive-not-found counter and, once the threshold is
+     * reached, transition the swap to a terminal state and stop polling it.
+     * Driven from {@link pollSingleSwap} when `getSwapStatus` throws
+     * {@link SwapNotFoundError}. The threshold rides out a transient blip
+     * but ensures we stop hammering Boltz with requests for swap IDs the
+     * server has no record of (e.g. after switching the configured
+     * Boltz endpoint).
+     */
+    private handleSwapNotFound;
+    /**
+     * Transition a swap to {@code swap.expired} (terminal for all swap types)
+     * after Boltz has consistently reported it unknown for
+     * {@link SwapManager.NOT_FOUND_THRESHOLD} consecutive polls. The swap is
+     * persisted, removed from monitoring, and reported via `onSwapFailed`.
+     * Bypasses {@link handleSwapStatusUpdate} on purpose: we don't want to
+     * trigger autonomous claim/refund actions against a Boltz instance that
+     * has no record of this swap — the requests would just generate more
+     * 404s without recovering anything.
+     */
+    private markSwapAsUnknownToProvider;
     /**
      * Check if a status is final (no more updates expected)
      */

package/dist/{types-LCXS1AVA.d.ts → types-BBI7-KJ0.d.ts}

@@ -310,7 +310,14 @@ declare class BoltzSwapProvider {
     getChainHeight(): Promise<number>;
     /** Gets the lockup transaction ID for a reverse swap. */
     getReverseSwapTxId(id: string): Promise<GetReverseSwapTxIdResponse>;
-    /** Queries the current status of a swap by ID. */
+    /**
+     * Queries the current status of a swap by ID.
+     *
+     * @throws {SwapNotFoundError} when Boltz responds with HTTP 404 and a body
+     * matching the "could not find swap" pattern. Distinct from a generic 404
+     * so callers (e.g. SwapManager polling) can drive a per-swap unknown-to-
+     * provider counter without tripping on transient route or proxy errors.
+     */
     getSwapStatus(id: string): Promise<GetSwapStatusResponse>;
     /** Gets the preimage for a settled submarine swap (proof of payment). */
     getSwapPreimage(id: string): Promise<GetSwapPreimageResponse>;
@@ -477,6 +484,14 @@ interface SwapManagerCallbacks {
  * for both reconnection and polling intervals.
  */
 declare class SwapManager implements SwapManagerClient {
+    /**
+     * Number of consecutive Boltz 404s for a single swap ID before the
+     * polling loop gives up and transitions the swap to a terminal state.
+     * At the default 30s poll cadence this is roughly a 5-minute grace
+     * window — long enough to ride out a transient Boltz blip, short
+     * enough that a real "swap unknown to this provider" surfaces quickly.
+     */
+    private static readonly NOT_FOUND_THRESHOLD;
     private readonly swapProvider;
     private readonly config;
     private swapUpdateListeners;
@@ -492,6 +507,7 @@ declare class SwapManager implements SwapManagerClient {
     private reconnectTimer;
     private initialPollTimer;
     private pollRetryTimers;
+    private notFoundCounts;
     private isRunning;
     private currentReconnectDelay;
     private currentPollRetryDelay;
@@ -706,6 +722,28 @@ declare class SwapManager implements SwapManagerClient {
      * 4. As fallback when WebSocket is unavailable
      */
     private pollAllSwaps;
+    private pollSingleSwap;
+    /**
+     * Increment the consecutive-not-found counter and, once the threshold is
+     * reached, transition the swap to a terminal state and stop polling it.
+     * Driven from {@link pollSingleSwap} when `getSwapStatus` throws
+     * {@link SwapNotFoundError}. The threshold rides out a transient blip
+     * but ensures we stop hammering Boltz with requests for swap IDs the
+     * server has no record of (e.g. after switching the configured
+     * Boltz endpoint).
+     */
+    private handleSwapNotFound;
+    /**
+     * Transition a swap to {@code swap.expired} (terminal for all swap types)
+     * after Boltz has consistently reported it unknown for
+     * {@link SwapManager.NOT_FOUND_THRESHOLD} consecutive polls. The swap is
+     * persisted, removed from monitoring, and reported via `onSwapFailed`.
+     * Bypasses {@link handleSwapStatusUpdate} on purpose: we don't want to
+     * trigger autonomous claim/refund actions against a Boltz instance that
+     * has no record of this swap — the requests would just generate more
+     * 404s without recovering anything.
+     */
+    private markSwapAsUnknownToProvider;
     /**
      * Check if a status is final (no more updates expected)
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkade-os/boltz-swap",
-  "version": "0.3.25",
+  "version": "0.3.27",
   "type": "module",
   "description": "A production-ready TypeScript package that brings Boltz submarine-swaps to Arkade.",
   "main": "./dist/index.js",
@@ -60,7 +60,7 @@
   "author": "Arkade-OS",
   "license": "MIT",
   "dependencies": {
-    "@arkade-os/sdk": "0.4.23",
+    "@arkade-os/sdk": "0.4.24",
     "@noble/hashes": "2.0.1",
     "@scure/base": "2.0.0",
     "@scure/btc-signer": "2.0.1",