@arkade-os/boltz-swap 0.3.23 → 0.3.25

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { I as IArkadeSwaps } from './arkade-swaps-CvA3RP7_.cjs';
-export { A as ArkadeSwaps } from './arkade-swaps-CvA3RP7_.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 ChainFeesResponse, L as LimitsResponse, G as GetSwapStatusResponse, h as ArkToBtcResponse, i as BtcToArkResponse, j as SwapRepository, k as SwapManagerClient, l as GetSwapsFilter } from './types-OyAdK824.cjs';
-export { X as ArkadeSwapsCreateConfig, m as BoltzSwapProvider, n as BoltzSwapStatus, W as IncomingPaymentSubscription, _ as PendingChainSwap, Z as PendingReverseSwap, Y as PendingSubmarineSwap, $ as PendingSwap, V as SwapManager, a3 as SwapManagerCallbacks, a1 as SwapManagerConfig, a2 as SwapManagerEvents, a0 as Vtxo, o as isChainClaimableStatus, p as isChainFailedStatus, q as isChainFinalStatus, r as isChainPendingStatus, s as isChainRefundableStatus, t as isChainSignableStatus, u as isChainSuccessStatus, v as isChainSwapClaimable, w as isChainSwapRefundable, x as isPendingChainSwap, y as isPendingReverseSwap, z as isPendingSubmarineSwap, E as isReverseClaimableStatus, H as isReverseFailedStatus, I as isReverseFinalStatus, J as isReversePendingStatus, K as isReverseSuccessStatus, M as isReverseSwapClaimable, O as isSubmarineFailedStatus, P as isSubmarineFinalStatus, Q as isSubmarinePendingStatus, T as isSubmarineRefundableStatus, R as isSubmarineSuccessStatus, U as isSubmarineSwapRefundable } from './types-OyAdK824.cjs';
+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 { 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';
@@ -195,6 +195,38 @@ type RequestRefundVhtlc = RequestEnvelope & {
 };
 type ResponseRefundVhtlc = ResponseEnvelope & {
     type: "VHTLC_REFUNDED";
+    payload: SubmarineRefundOutcome;
+};
+type RequestInspectSubmarineRecovery = RequestEnvelope & {
+    type: "INSPECT_SUBMARINE_RECOVERY";
+    payload: BoltzSubmarineSwap;
+};
+type ResponseInspectSubmarineRecovery = ResponseEnvelope & {
+    type: "SUBMARINE_RECOVERY_INSPECTED";
+    payload: SubmarineRecoveryInfo;
+};
+type RequestScanRecoverableSubmarineSwaps = RequestEnvelope & {
+    type: "SCAN_RECOVERABLE_SUBMARINE_SWAPS";
+};
+type ResponseScanRecoverableSubmarineSwaps = ResponseEnvelope & {
+    type: "RECOVERABLE_SUBMARINE_SWAPS_SCANNED";
+    payload: SubmarineRecoveryInfo[];
+};
+type RequestRecoverSubmarineFunds = RequestEnvelope & {
+    type: "RECOVER_SUBMARINE_FUNDS";
+    payload: BoltzSubmarineSwap;
+};
+type ResponseRecoverSubmarineFunds = ResponseEnvelope & {
+    type: "SUBMARINE_FUNDS_RECOVERED";
+    payload: SubmarineRefundOutcome;
+};
+type RequestRecoverAllSubmarineFunds = RequestEnvelope & {
+    type: "RECOVER_ALL_SUBMARINE_FUNDS";
+    payload: BoltzSubmarineSwap[];
+};
+type ResponseRecoverAllSubmarineFunds = ResponseEnvelope & {
+    type: "ALL_SUBMARINE_FUNDS_RECOVERED";
+    payload: SubmarineRecoveryResult[];
 };
 type RequestWaitAndClaim = RequestEnvelope & {
     type: "WAIT_AND_CLAIM";
@@ -526,8 +558,8 @@ type ResponseSwapManagerWaitForCompletion = ResponseEnvelope & {
         txid: string;
     };
 };
-type ArkadeSwapsUpdaterRequest = RequestInitArkSwaps | RequestCreateLightningInvoice | RequestSendLightningPayment | RequestCreateSubmarineSwap | RequestCreateReverseSwap | RequestClaimVhtlc | RequestRefundVhtlc | RequestWaitAndClaim | RequestWaitForSwapSettlement | RequestRestoreSwaps | RequestEnrichReverseSwapPreimage | RequestEnrichSubmarineSwapInvoice | RequestGetFees | RequestGetLimits | RequestGetSwapStatus | RequestGetPendingSubmarineSwaps | RequestGetPendingReverseSwaps | RequestGetPendingChainSwaps | RequestGetSwapHistory | RequestRefreshSwapsStatus | RequestArkToBtc | RequestBtcToArk | RequestCreateChainSwap | RequestWaitAndClaimChain | RequestWaitAndClaimArk | RequestWaitAndClaimBtc | RequestClaimArk | RequestClaimBtc | RequestRefundArk | RequestSignServerClaim | RequestVerifyChainSwap | RequestQuoteSwap | RequestSwapManagerStart | RequestSwapManagerStop | RequestSwapManagerAddSwap | RequestSwapManagerRemoveSwap | RequestSwapManagerGetPending | RequestSwapManagerHasSwap | RequestSwapManagerIsProcessing | RequestSwapManagerGetStats | RequestSwapManagerWaitForCompletion;
-type ArkadeSwapsUpdaterResponse = ResponseInitArkSwaps | ResponseCreateLightningInvoice | ResponseSendLightningPayment | ResponseCreateSubmarineSwap | ResponseCreateReverseSwap | ResponseClaimVhtlc | ResponseRefundVhtlc | ResponseWaitAndClaim | ResponseWaitForSwapSettlement | ResponseRestoreSwaps | ResponseEnrichReverseSwapPreimage | ResponseEnrichSubmarineSwapInvoice | ResponseGetFees | ResponseGetLimits | ResponseGetSwapStatus | ResponseGetPendingSubmarineSwaps | ResponseGetPendingReverseSwaps | ResponseGetPendingChainSwaps | ResponseGetSwapHistory | ResponseRefreshSwapsStatus | ResponseArkToBtc | ResponseBtcToArk | ResponseCreateChainSwap | ResponseWaitAndClaimChain | ResponseWaitAndClaimArk | ResponseWaitAndClaimBtc | ResponseClaimArk | ResponseClaimBtc | ResponseRefundArk | ResponseSignServerClaim | ResponseVerifyChainSwap | ResponseQuoteSwap | ResponseSwapManagerStart | ResponseSwapManagerStop | ResponseSwapManagerAddSwap | ResponseSwapManagerRemoveSwap | ResponseSwapManagerGetPending | ResponseSwapManagerHasSwap | ResponseSwapManagerIsProcessing | ResponseSwapManagerGetStats | ResponseSwapManagerWaitForCompletion;
+type ArkadeSwapsUpdaterRequest = RequestInitArkSwaps | RequestCreateLightningInvoice | RequestSendLightningPayment | RequestCreateSubmarineSwap | RequestCreateReverseSwap | RequestClaimVhtlc | RequestRefundVhtlc | RequestInspectSubmarineRecovery | RequestScanRecoverableSubmarineSwaps | RequestRecoverSubmarineFunds | RequestRecoverAllSubmarineFunds | RequestWaitAndClaim | RequestWaitForSwapSettlement | RequestRestoreSwaps | RequestEnrichReverseSwapPreimage | RequestEnrichSubmarineSwapInvoice | RequestGetFees | RequestGetLimits | RequestGetSwapStatus | RequestGetPendingSubmarineSwaps | RequestGetPendingReverseSwaps | RequestGetPendingChainSwaps | RequestGetSwapHistory | RequestRefreshSwapsStatus | RequestArkToBtc | RequestBtcToArk | RequestCreateChainSwap | RequestWaitAndClaimChain | RequestWaitAndClaimArk | RequestWaitAndClaimBtc | RequestClaimArk | RequestClaimBtc | RequestRefundArk | RequestSignServerClaim | RequestVerifyChainSwap | RequestQuoteSwap | RequestSwapManagerStart | RequestSwapManagerStop | RequestSwapManagerAddSwap | RequestSwapManagerRemoveSwap | RequestSwapManagerGetPending | RequestSwapManagerHasSwap | RequestSwapManagerIsProcessing | RequestSwapManagerGetStats | RequestSwapManagerWaitForCompletion;
+type ArkadeSwapsUpdaterResponse = ResponseInitArkSwaps | ResponseCreateLightningInvoice | ResponseSendLightningPayment | ResponseCreateSubmarineSwap | ResponseCreateReverseSwap | ResponseClaimVhtlc | ResponseRefundVhtlc | ResponseInspectSubmarineRecovery | ResponseScanRecoverableSubmarineSwaps | ResponseRecoverSubmarineFunds | ResponseRecoverAllSubmarineFunds | ResponseWaitAndClaim | ResponseWaitForSwapSettlement | ResponseRestoreSwaps | ResponseEnrichReverseSwapPreimage | ResponseEnrichSubmarineSwapInvoice | ResponseGetFees | ResponseGetLimits | ResponseGetSwapStatus | ResponseGetPendingSubmarineSwaps | ResponseGetPendingReverseSwaps | ResponseGetPendingChainSwaps | ResponseGetSwapHistory | ResponseRefreshSwapsStatus | ResponseArkToBtc | ResponseBtcToArk | ResponseCreateChainSwap | ResponseWaitAndClaimChain | ResponseWaitAndClaimArk | ResponseWaitAndClaimBtc | ResponseClaimArk | ResponseClaimBtc | ResponseRefundArk | ResponseSignServerClaim | ResponseVerifyChainSwap | ResponseQuoteSwap | ResponseSwapManagerStart | ResponseSwapManagerStop | ResponseSwapManagerAddSwap | ResponseSwapManagerRemoveSwap | ResponseSwapManagerGetPending | ResponseSwapManagerHasSwap | ResponseSwapManagerIsProcessing | ResponseSwapManagerGetStats | ResponseSwapManagerWaitForCompletion;
 declare class ArkadeSwapsMessageHandler implements MessageHandler<ArkadeSwapsUpdaterRequest, ArkadeSwapsUpdaterResponse> {
     private readonly swapRepository;
     static messageTag: string;
@@ -546,6 +578,7 @@ declare class ArkadeSwapsMessageHandler implements MessageHandler<ArkadeSwapsUpd
     }): Promise<void>;
     stop(): Promise<void>;
     tick(_now: number): Promise<never[]>;
+    isLongRunning(message: ArkadeSwapsUpdaterRequest): boolean;
     private tagged;
     private broadcastEvent;
     handleMessage(message: ArkadeSwapsUpdaterRequest): Promise<ArkadeSwapsUpdaterResponse>;
@@ -584,7 +617,11 @@ declare class ServiceWorkerArkadeSwaps implements IArkadeSwaps {
     createSubmarineSwap(args: SendLightningPaymentRequest): Promise<BoltzSubmarineSwap>;
     createReverseSwap(args: CreateLightningInvoiceRequest): Promise<BoltzReverseSwap>;
     claimVHTLC(pendingSwap: BoltzReverseSwap): Promise<void>;
-    refundVHTLC(pendingSwap: BoltzSubmarineSwap): Promise<void>;
+    refundVHTLC(pendingSwap: BoltzSubmarineSwap): Promise<SubmarineRefundOutcome>;
+    inspectSubmarineRecovery(swap: BoltzSubmarineSwap): Promise<SubmarineRecoveryInfo>;
+    scanRecoverableSubmarineSwaps(): Promise<SubmarineRecoveryInfo[]>;
+    recoverSubmarineFunds(swap: BoltzSubmarineSwap): Promise<SubmarineRefundOutcome>;
+    recoverAllSubmarineFunds(swaps: BoltzSubmarineSwap[]): Promise<SubmarineRecoveryResult[]>;
     waitAndClaim(pendingSwap: BoltzReverseSwap): Promise<{
         txid: string;
     }>;
@@ -643,12 +680,7 @@ declare class ServiceWorkerArkadeSwaps implements IArkadeSwaps {
         receiverPubkey: string;
         senderPubkey: string;
         serverPubkey: string;
-        timeoutBlockHeights: {
-            refund: number;
-            unilateralClaim: number;
-            unilateralRefund: number;
-            unilateralRefundWithoutReceiver: number;
-        };
+        timeoutBlockHeights: VhtlcTimeouts;
     }): {
         vhtlcScript: VHTLC.Script;
         vhtlcAddress: string;
@@ -737,4 +769,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, 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, 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 } from './arkade-swaps-DEvf-2g2.js';
-export { A as ArkadeSwaps } from './arkade-swaps-DEvf-2g2.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 ChainFeesResponse, L as LimitsResponse, G as GetSwapStatusResponse, h as ArkToBtcResponse, i as BtcToArkResponse, j as SwapRepository, k as SwapManagerClient, l as GetSwapsFilter } from './types-OyAdK824.js';
-export { X as ArkadeSwapsCreateConfig, m as BoltzSwapProvider, n as BoltzSwapStatus, W as IncomingPaymentSubscription, _ as PendingChainSwap, Z as PendingReverseSwap, Y as PendingSubmarineSwap, $ as PendingSwap, V as SwapManager, a3 as SwapManagerCallbacks, a1 as SwapManagerConfig, a2 as SwapManagerEvents, a0 as Vtxo, o as isChainClaimableStatus, p as isChainFailedStatus, q as isChainFinalStatus, r as isChainPendingStatus, s as isChainRefundableStatus, t as isChainSignableStatus, u as isChainSuccessStatus, v as isChainSwapClaimable, w as isChainSwapRefundable, x as isPendingChainSwap, y as isPendingReverseSwap, z as isPendingSubmarineSwap, E as isReverseClaimableStatus, H as isReverseFailedStatus, I as isReverseFinalStatus, J as isReversePendingStatus, K as isReverseSuccessStatus, M as isReverseSwapClaimable, O as isSubmarineFailedStatus, P as isSubmarineFinalStatus, Q as isSubmarinePendingStatus, T as isSubmarineRefundableStatus, R as isSubmarineSuccessStatus, U as isSubmarineSwapRefundable } from './types-OyAdK824.js';
+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 { 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';
@@ -195,6 +195,38 @@ type RequestRefundVhtlc = RequestEnvelope & {
 };
 type ResponseRefundVhtlc = ResponseEnvelope & {
     type: "VHTLC_REFUNDED";
+    payload: SubmarineRefundOutcome;
+};
+type RequestInspectSubmarineRecovery = RequestEnvelope & {
+    type: "INSPECT_SUBMARINE_RECOVERY";
+    payload: BoltzSubmarineSwap;
+};
+type ResponseInspectSubmarineRecovery = ResponseEnvelope & {
+    type: "SUBMARINE_RECOVERY_INSPECTED";
+    payload: SubmarineRecoveryInfo;
+};
+type RequestScanRecoverableSubmarineSwaps = RequestEnvelope & {
+    type: "SCAN_RECOVERABLE_SUBMARINE_SWAPS";
+};
+type ResponseScanRecoverableSubmarineSwaps = ResponseEnvelope & {
+    type: "RECOVERABLE_SUBMARINE_SWAPS_SCANNED";
+    payload: SubmarineRecoveryInfo[];
+};
+type RequestRecoverSubmarineFunds = RequestEnvelope & {
+    type: "RECOVER_SUBMARINE_FUNDS";
+    payload: BoltzSubmarineSwap;
+};
+type ResponseRecoverSubmarineFunds = ResponseEnvelope & {
+    type: "SUBMARINE_FUNDS_RECOVERED";
+    payload: SubmarineRefundOutcome;
+};
+type RequestRecoverAllSubmarineFunds = RequestEnvelope & {
+    type: "RECOVER_ALL_SUBMARINE_FUNDS";
+    payload: BoltzSubmarineSwap[];
+};
+type ResponseRecoverAllSubmarineFunds = ResponseEnvelope & {
+    type: "ALL_SUBMARINE_FUNDS_RECOVERED";
+    payload: SubmarineRecoveryResult[];
 };
 type RequestWaitAndClaim = RequestEnvelope & {
     type: "WAIT_AND_CLAIM";
@@ -526,8 +558,8 @@ type ResponseSwapManagerWaitForCompletion = ResponseEnvelope & {
         txid: string;
     };
 };
-type ArkadeSwapsUpdaterRequest = RequestInitArkSwaps | RequestCreateLightningInvoice | RequestSendLightningPayment | RequestCreateSubmarineSwap | RequestCreateReverseSwap | RequestClaimVhtlc | RequestRefundVhtlc | RequestWaitAndClaim | RequestWaitForSwapSettlement | RequestRestoreSwaps | RequestEnrichReverseSwapPreimage | RequestEnrichSubmarineSwapInvoice | RequestGetFees | RequestGetLimits | RequestGetSwapStatus | RequestGetPendingSubmarineSwaps | RequestGetPendingReverseSwaps | RequestGetPendingChainSwaps | RequestGetSwapHistory | RequestRefreshSwapsStatus | RequestArkToBtc | RequestBtcToArk | RequestCreateChainSwap | RequestWaitAndClaimChain | RequestWaitAndClaimArk | RequestWaitAndClaimBtc | RequestClaimArk | RequestClaimBtc | RequestRefundArk | RequestSignServerClaim | RequestVerifyChainSwap | RequestQuoteSwap | RequestSwapManagerStart | RequestSwapManagerStop | RequestSwapManagerAddSwap | RequestSwapManagerRemoveSwap | RequestSwapManagerGetPending | RequestSwapManagerHasSwap | RequestSwapManagerIsProcessing | RequestSwapManagerGetStats | RequestSwapManagerWaitForCompletion;
-type ArkadeSwapsUpdaterResponse = ResponseInitArkSwaps | ResponseCreateLightningInvoice | ResponseSendLightningPayment | ResponseCreateSubmarineSwap | ResponseCreateReverseSwap | ResponseClaimVhtlc | ResponseRefundVhtlc | ResponseWaitAndClaim | ResponseWaitForSwapSettlement | ResponseRestoreSwaps | ResponseEnrichReverseSwapPreimage | ResponseEnrichSubmarineSwapInvoice | ResponseGetFees | ResponseGetLimits | ResponseGetSwapStatus | ResponseGetPendingSubmarineSwaps | ResponseGetPendingReverseSwaps | ResponseGetPendingChainSwaps | ResponseGetSwapHistory | ResponseRefreshSwapsStatus | ResponseArkToBtc | ResponseBtcToArk | ResponseCreateChainSwap | ResponseWaitAndClaimChain | ResponseWaitAndClaimArk | ResponseWaitAndClaimBtc | ResponseClaimArk | ResponseClaimBtc | ResponseRefundArk | ResponseSignServerClaim | ResponseVerifyChainSwap | ResponseQuoteSwap | ResponseSwapManagerStart | ResponseSwapManagerStop | ResponseSwapManagerAddSwap | ResponseSwapManagerRemoveSwap | ResponseSwapManagerGetPending | ResponseSwapManagerHasSwap | ResponseSwapManagerIsProcessing | ResponseSwapManagerGetStats | ResponseSwapManagerWaitForCompletion;
+type ArkadeSwapsUpdaterRequest = RequestInitArkSwaps | RequestCreateLightningInvoice | RequestSendLightningPayment | RequestCreateSubmarineSwap | RequestCreateReverseSwap | RequestClaimVhtlc | RequestRefundVhtlc | RequestInspectSubmarineRecovery | RequestScanRecoverableSubmarineSwaps | RequestRecoverSubmarineFunds | RequestRecoverAllSubmarineFunds | RequestWaitAndClaim | RequestWaitForSwapSettlement | RequestRestoreSwaps | RequestEnrichReverseSwapPreimage | RequestEnrichSubmarineSwapInvoice | RequestGetFees | RequestGetLimits | RequestGetSwapStatus | RequestGetPendingSubmarineSwaps | RequestGetPendingReverseSwaps | RequestGetPendingChainSwaps | RequestGetSwapHistory | RequestRefreshSwapsStatus | RequestArkToBtc | RequestBtcToArk | RequestCreateChainSwap | RequestWaitAndClaimChain | RequestWaitAndClaimArk | RequestWaitAndClaimBtc | RequestClaimArk | RequestClaimBtc | RequestRefundArk | RequestSignServerClaim | RequestVerifyChainSwap | RequestQuoteSwap | RequestSwapManagerStart | RequestSwapManagerStop | RequestSwapManagerAddSwap | RequestSwapManagerRemoveSwap | RequestSwapManagerGetPending | RequestSwapManagerHasSwap | RequestSwapManagerIsProcessing | RequestSwapManagerGetStats | RequestSwapManagerWaitForCompletion;
+type ArkadeSwapsUpdaterResponse = ResponseInitArkSwaps | ResponseCreateLightningInvoice | ResponseSendLightningPayment | ResponseCreateSubmarineSwap | ResponseCreateReverseSwap | ResponseClaimVhtlc | ResponseRefundVhtlc | ResponseInspectSubmarineRecovery | ResponseScanRecoverableSubmarineSwaps | ResponseRecoverSubmarineFunds | ResponseRecoverAllSubmarineFunds | ResponseWaitAndClaim | ResponseWaitForSwapSettlement | ResponseRestoreSwaps | ResponseEnrichReverseSwapPreimage | ResponseEnrichSubmarineSwapInvoice | ResponseGetFees | ResponseGetLimits | ResponseGetSwapStatus | ResponseGetPendingSubmarineSwaps | ResponseGetPendingReverseSwaps | ResponseGetPendingChainSwaps | ResponseGetSwapHistory | ResponseRefreshSwapsStatus | ResponseArkToBtc | ResponseBtcToArk | ResponseCreateChainSwap | ResponseWaitAndClaimChain | ResponseWaitAndClaimArk | ResponseWaitAndClaimBtc | ResponseClaimArk | ResponseClaimBtc | ResponseRefundArk | ResponseSignServerClaim | ResponseVerifyChainSwap | ResponseQuoteSwap | ResponseSwapManagerStart | ResponseSwapManagerStop | ResponseSwapManagerAddSwap | ResponseSwapManagerRemoveSwap | ResponseSwapManagerGetPending | ResponseSwapManagerHasSwap | ResponseSwapManagerIsProcessing | ResponseSwapManagerGetStats | ResponseSwapManagerWaitForCompletion;
 declare class ArkadeSwapsMessageHandler implements MessageHandler<ArkadeSwapsUpdaterRequest, ArkadeSwapsUpdaterResponse> {
     private readonly swapRepository;
     static messageTag: string;
@@ -546,6 +578,7 @@ declare class ArkadeSwapsMessageHandler implements MessageHandler<ArkadeSwapsUpd
     }): Promise<void>;
     stop(): Promise<void>;
     tick(_now: number): Promise<never[]>;
+    isLongRunning(message: ArkadeSwapsUpdaterRequest): boolean;
     private tagged;
     private broadcastEvent;
     handleMessage(message: ArkadeSwapsUpdaterRequest): Promise<ArkadeSwapsUpdaterResponse>;
@@ -584,7 +617,11 @@ declare class ServiceWorkerArkadeSwaps implements IArkadeSwaps {
     createSubmarineSwap(args: SendLightningPaymentRequest): Promise<BoltzSubmarineSwap>;
     createReverseSwap(args: CreateLightningInvoiceRequest): Promise<BoltzReverseSwap>;
     claimVHTLC(pendingSwap: BoltzReverseSwap): Promise<void>;
-    refundVHTLC(pendingSwap: BoltzSubmarineSwap): Promise<void>;
+    refundVHTLC(pendingSwap: BoltzSubmarineSwap): Promise<SubmarineRefundOutcome>;
+    inspectSubmarineRecovery(swap: BoltzSubmarineSwap): Promise<SubmarineRecoveryInfo>;
+    scanRecoverableSubmarineSwaps(): Promise<SubmarineRecoveryInfo[]>;
+    recoverSubmarineFunds(swap: BoltzSubmarineSwap): Promise<SubmarineRefundOutcome>;
+    recoverAllSubmarineFunds(swaps: BoltzSubmarineSwap[]): Promise<SubmarineRecoveryResult[]>;
     waitAndClaim(pendingSwap: BoltzReverseSwap): Promise<{
         txid: string;
     }>;
@@ -643,12 +680,7 @@ declare class ServiceWorkerArkadeSwaps implements IArkadeSwaps {
         receiverPubkey: string;
         senderPubkey: string;
         serverPubkey: string;
-        timeoutBlockHeights: {
-            refund: number;
-            unilateralClaim: number;
-            unilateralRefund: number;
-            unilateralRefundWithoutReceiver: number;
-        };
+        timeoutBlockHeights: VhtlcTimeouts;
     }): {
         vhtlcScript: VHTLC.Script;
         vhtlcAddress: string;
@@ -737,4 +769,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, 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, SwapRepository, type SwapSaver, TransactionFailedError, decodeInvoice, enrichReverseSwapPreimage, enrichSubmarineSwapInvoice, getInvoicePaymentHash, getInvoiceSatoshis, isValidArkAddress, logger, migrateToSwapRepository, saveSwap, setLogger, updateChainSwapStatus, updateReverseSwapStatus, updateSubmarineSwapStatus, verifySignatures };

package/dist/index.js

@@ -50,7 +50,7 @@ import {
   updateReverseSwapStatus,
   updateSubmarineSwapStatus,
   verifySignatures
-} from "./chunk-K3QEFL7D.js";
+} from "./chunk-XC2ARJZO.js";
 import "./chunk-3RG5ZIWI.js";
 
 // src/serviceWorker/arkade-swaps-message-handler.ts
@@ -59,6 +59,25 @@ import {
   RestIndexerProvider
 } from "@arkade-os/sdk";
 var DEFAULT_MESSAGE_TAG = "ARKADE_SWAPS_UPDATER";
+var LONG_RUNNING_ARKADE_SWAPS_REQUEST_TYPES = /* @__PURE__ */ new Set([
+  "SEND_LIGHTNING_PAYMENT",
+  "CLAIM_VHTLC",
+  "REFUND_VHTLC",
+  "INSPECT_SUBMARINE_RECOVERY",
+  "SCAN_RECOVERABLE_SUBMARINE_SWAPS",
+  "RECOVER_SUBMARINE_FUNDS",
+  "RECOVER_ALL_SUBMARINE_FUNDS",
+  "WAIT_AND_CLAIM",
+  "WAIT_FOR_SWAP_SETTLEMENT",
+  "RESTORE_SWAPS",
+  "WAIT_AND_CLAIM_CHAIN",
+  "WAIT_AND_CLAIM_ARK",
+  "WAIT_AND_CLAIM_BTC",
+  "CLAIM_ARK",
+  "CLAIM_BTC",
+  "REFUND_ARK",
+  "SM-WAIT_FOR_COMPLETION"
+]);
 var ArkadeSwapsMessageHandler = class _ArkadeSwapsMessageHandler {
   constructor(swapRepository) {
     this.swapRepository = swapRepository;
@@ -100,6 +119,14 @@ var ArkadeSwapsMessageHandler = class _ArkadeSwapsMessageHandler {
   async tick(_now) {
     return [];
   }
+  // Flows that surrender control to Boltz, the Ark server, or other
+  // participants in a batch round: quiet gaps between protocol events can
+  // easily exceed the bus-level messageTimeoutMs. Liveness is covered
+  // out-of-band by the page-side PING / MESSAGE_BUS_NOT_INITIALIZED path
+  // triggered by concurrent short requests (GET_FEES, GET_SWAP_STATUS, ...).
+  isLongRunning(message) {
+    return LONG_RUNNING_ARKADE_SWAPS_REQUEST_TYPES.has(message.type);
+  }
   tagged(res) {
     return {
       ...res,
@@ -181,9 +208,54 @@ var ArkadeSwapsMessageHandler = class _ArkadeSwapsMessageHandler {
         case "CLAIM_VHTLC":
           await this.handler.claimVHTLC(message.payload);
           return this.tagged({ id, type: "VHTLC_CLAIMED" });
-        case "REFUND_VHTLC":
-          await this.handler.refundVHTLC(message.payload);
-          return this.tagged({ id, type: "VHTLC_REFUNDED" });
+        case "REFUND_VHTLC": {
+          const outcome = await this.handler.refundVHTLC(
+            message.payload
+          );
+          return this.tagged({
+            id,
+            type: "VHTLC_REFUNDED",
+            payload: outcome
+          });
+        }
+        case "INSPECT_SUBMARINE_RECOVERY": {
+          const info = await this.handler.inspectSubmarineRecovery(
+            message.payload
+          );
+          return this.tagged({
+            id,
+            type: "SUBMARINE_RECOVERY_INSPECTED",
+            payload: info
+          });
+        }
+        case "SCAN_RECOVERABLE_SUBMARINE_SWAPS": {
+          const infos = await this.handler.scanRecoverableSubmarineSwaps();
+          return this.tagged({
+            id,
+            type: "RECOVERABLE_SUBMARINE_SWAPS_SCANNED",
+            payload: infos
+          });
+        }
+        case "RECOVER_SUBMARINE_FUNDS": {
+          const outcome = await this.handler.recoverSubmarineFunds(
+            message.payload
+          );
+          return this.tagged({
+            id,
+            type: "SUBMARINE_FUNDS_RECOVERED",
+            payload: outcome
+          });
+        }
+        case "RECOVER_ALL_SUBMARINE_FUNDS": {
+          const results = await this.handler.recoverAllSubmarineFunds(
+            message.payload
+          );
+          return this.tagged({
+            id,
+            type: "ALL_SUBMARINE_FUNDS_RECOVERED",
+            payload: results
+          });
+        }
         case "WAIT_AND_CLAIM": {
           const res = await this.handler.waitAndClaim(
             message.payload
@@ -534,6 +606,8 @@ import {
 function isMessageBusNotInitializedError(error) {
   return error instanceof Error && error.message.includes(MESSAGE_BUS_NOT_INITIALIZED);
 }
+var DEFAULT_MESSAGE_TIMEOUT_MS = 3e4;
+var NO_MESSAGE_TIMEOUT_MS = 0;
 var DEDUPABLE_REQUEST_TYPES = /* @__PURE__ */ new Set([
   "GET_FEES",
   "GET_LIMITS",
@@ -809,12 +883,48 @@ var ServiceWorkerArkadeSwaps = class _ServiceWorkerArkadeSwaps {
     });
   }
   async refundVHTLC(pendingSwap) {
-    await this.sendMessage({
+    const res = await this.sendMessage({
       id: getRandomId(),
       tag: this.messageTag,
       type: "REFUND_VHTLC",
       payload: pendingSwap
     });
+    return res.payload;
+  }
+  async inspectSubmarineRecovery(swap) {
+    const res = await this.sendMessage({
+      id: getRandomId(),
+      tag: this.messageTag,
+      type: "INSPECT_SUBMARINE_RECOVERY",
+      payload: swap
+    });
+    return res.payload;
+  }
+  async scanRecoverableSubmarineSwaps() {
+    const res = await this.sendMessage({
+      id: getRandomId(),
+      tag: this.messageTag,
+      type: "SCAN_RECOVERABLE_SUBMARINE_SWAPS"
+    });
+    return res.payload;
+  }
+  async recoverSubmarineFunds(swap) {
+    const res = await this.sendMessage({
+      id: getRandomId(),
+      tag: this.messageTag,
+      type: "RECOVER_SUBMARINE_FUNDS",
+      payload: swap
+    });
+    return res.payload;
+  }
+  async recoverAllSubmarineFunds(swaps) {
+    const res = await this.sendMessage({
+      id: getRandomId(),
+      tag: this.messageTag,
+      type: "RECOVER_ALL_SUBMARINE_FUNDS",
+      payload: swaps
+    });
+    return res.payload;
   }
   async waitAndClaim(pendingSwap) {
     try {
@@ -1143,7 +1253,7 @@ var ServiceWorkerArkadeSwaps = class _ServiceWorkerArkadeSwaps {
   async [Symbol.asyncDispose]() {
     return this.dispose();
   }
-  sendMessageDirect(request) {
+  sendMessageDirect(request, timeoutMs) {
     return new Promise((resolve, reject) => {
       const cleanup = () => {
         clearTimeout(timeoutId);
@@ -1152,14 +1262,14 @@ var ServiceWorkerArkadeSwaps = class _ServiceWorkerArkadeSwaps {
           messageHandler
         );
       };
-      const timeoutId = setTimeout(() => {
+      const timeoutId = timeoutMs > 0 ? setTimeout(() => {
         cleanup();
         reject(
           new ServiceWorkerTimeoutError(
             `Service worker message timed out (${request.type})`
           )
         );
-      }, 3e4);
+      }, timeoutMs) : void 0;
       const messageHandler = (event) => {
         const response = event.data;
         if (!response || response.tag !== this.messageTag || response.id !== request.id) {
@@ -1234,10 +1344,13 @@ var ServiceWorkerArkadeSwaps = class _ServiceWorkerArkadeSwaps {
         await this.reinitialize();
       }
     }
+    const timeoutMs = LONG_RUNNING_ARKADE_SWAPS_REQUEST_TYPES.has(
+      request.type
+    ) ? NO_MESSAGE_TIMEOUT_MS : DEFAULT_MESSAGE_TIMEOUT_MS;
     const maxRetries = 2;
     for (let attempt = 0; ; attempt++) {
       try {
-        return await this.sendMessageDirect(request);
+        return await this.sendMessageDirect(request, timeoutMs);
       } catch (error) {
         if (!isMessageBusNotInitializedError(error) || attempt >= maxRetries) {
           throw error;
@@ -1258,7 +1371,10 @@ var ServiceWorkerArkadeSwaps = class _ServiceWorkerArkadeSwaps {
         id: getRandomId(),
         payload: this.initPayload
       };
-      await this.sendMessageDirect(initMessage);
+      await this.sendMessageDirect(
+        initMessage,
+        DEFAULT_MESSAGE_TIMEOUT_MS
+      );
     })().finally(() => {
       this.reinitPromise = null;
     });

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

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

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

@@ -1,4 +1,4 @@
-import { j as SwapRepository, B as BoltzSwap, l as GetSwapsFilter } from '../../types-OyAdK824.js';
+import { m as SwapRepository, B as BoltzSwap, o as GetSwapsFilter } from '../../types-LCXS1AVA.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 { j as SwapRepository, B as BoltzSwap, l as GetSwapsFilter } from '../../types-OyAdK824.cjs';
+import { m as SwapRepository, B as BoltzSwap, o as GetSwapsFilter } from '../../types-LCXS1AVA.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 { j as SwapRepository, B as BoltzSwap, l as GetSwapsFilter } from '../../types-OyAdK824.js';
+import { m as SwapRepository, B as BoltzSwap, o as GetSwapsFilter } from '../../types-LCXS1AVA.js';
 import '@arkade-os/sdk';
 
 /**

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

@@ -856,6 +856,68 @@ interface BoltzSubmarineSwap {
     /** Boltz API response with payment address and expected amount. */
     response: CreateSubmarineSwapResponse;
 }
+/**
+ * Outcome of inspecting a submarine swap's lockup address for recoverable
+ * funds.
+ *
+ * - `recoverable` — unspent VTXOs exist and can be swept now, either because
+ *   the refund CLTV has elapsed or because the Boltz 3-of-3 refund path is
+ *   immediately available.
+ * - `pre_cltv` — unspent VTXOs exist but the refund locktime has not
+ *   passed yet and no immediate Boltz 3-of-3 refund path was detected.
+ * - `none` — no unspent VTXOs at the address (never funded, fully
+ *   pruned, or only preconfirmed-only state).
+ * - `already_spent` — the address has VTXOs but every one is spent
+ *   (typical for a healthy completed swap).
+ * - `invalid_swap` — the swap is not a recovery candidate (pending
+ *   status), the swap data is incomplete, or the reconstructed VHTLC
+ *   address doesn't match the one Boltz returned.
+ */
+type SubmarineRecoveryStatus = "recoverable" | "pre_cltv" | "none" | "already_spent" | "invalid_swap";
+/** Diagnostic snapshot of a submarine swap's recovery state. */
+interface SubmarineRecoveryInfo {
+    /** The submarine swap this snapshot describes. */
+    swap: BoltzSubmarineSwap;
+    /** Classification of the lockup address state. */
+    status: SubmarineRecoveryStatus;
+    /** Number of unspent VTXOs at the lockup address. */
+    vtxoCount: number;
+    /** Total satoshis across the unspent VTXOs. */
+    amountSats: number;
+    /**
+     * Absolute Unix-timestamp CLTV from the swap's VHTLC, when available.
+     * Compared against wall-clock seconds for refund readiness.
+     */
+    refundLocktime?: number;
+    /** Reason populated when `status === "invalid_swap"`. */
+    error?: string;
+}
+/** Outcome of a single `refundVHTLC` call: how many VTXOs were swept vs. deferred. */
+interface SubmarineRefundOutcome {
+    /** Number of VTXOs successfully refunded (joined a batch or via Boltz co-sign). */
+    swept: number;
+    /**
+     * Number of VTXOs that could not be refunded yet (e.g. recoverable VTXO
+     * pre-CLTV, or Boltz rejected and CLTV still not satisfied). The caller
+     * is expected to retry these later.
+     */
+    skipped: number;
+}
+/** Per-swap outcome of a bulk recovery call. */
+interface SubmarineRecoveryResult {
+    /** ID of the swap whose VHTLC we attempted to refund. */
+    swapId: string;
+    /** True only when at least one VTXO was actually swept by `refundVHTLC`. */
+    recovered: boolean;
+    /**
+     * True when `refundVHTLC` returned without throwing but at least one
+     * VTXO was deferred — distinguishes a real sweep from a no-op skip
+     * path. Always false when `error` is set (the error supersedes).
+     */
+    skipped: boolean;
+    /** Failure message when `refundVHTLC` threw. */
+    error?: string;
+}
 /** Tracks an in-progress chain swap (ARK ↔ BTC). */
 interface BoltzChainSwap {
     /** Unique swap ID from Boltz. */
@@ -999,4 +1061,4 @@ interface ChainFeesResponse {
     };
 }
 
-export { type PendingSwap as $, type ArkadeSwapsConfig as A, type BoltzSwap as B, type CreateLightningInvoiceRequest as C, type DecodedInvoice as D, isReverseClaimableStatus as E, type FeesResponse as F, type GetSwapStatusResponse as G, isReverseFailedStatus as H, isReverseFinalStatus as I, isReversePendingStatus as J, isReverseSuccessStatus as K, type LimitsResponse as L, isReverseSwapClaimable as M, type Network as N, isSubmarineFailedStatus as O, isSubmarineFinalStatus as P, isSubmarinePendingStatus as Q, isSubmarineSuccessStatus as R, type SendLightningPaymentRequest as S, isSubmarineRefundableStatus as T, isSubmarineSwapRefundable as U, SwapManager as V, type IncomingPaymentSubscription as W, type ArkadeSwapsCreateConfig as X, type PendingSubmarineSwap as Y, type PendingReverseSwap as Z, type PendingChainSwap as _, type BoltzChainSwap as a, type Vtxo as a0, type SwapManagerConfig as a1, type SwapManagerEvents as a2, type SwapManagerCallbacks as a3, type BoltzReverseSwap as b, type BoltzSubmarineSwap as c, type Chain as d, type CreateLightningInvoiceResponse as e, type SendLightningPaymentResponse as f, type ChainFeesResponse as g, type ArkToBtcResponse as h, type BtcToArkResponse as i, type SwapRepository as j, type SwapManagerClient as k, type GetSwapsFilter as l, BoltzSwapProvider as m, type BoltzSwapStatus as n, isChainClaimableStatus as o, isChainFailedStatus as p, isChainFinalStatus as q, isChainPendingStatus as r, isChainRefundableStatus as s, isChainSignableStatus as t, isChainSuccessStatus as u, isChainSwapClaimable as v, isChainSwapRefundable as w, isPendingChainSwap as x, isPendingReverseSwap as y, isPendingSubmarineSwap as z };
+export { type PendingSubmarineSwap as $, type ArkadeSwapsConfig as A, type BoltzSwap as B, type CreateLightningInvoiceRequest as C, type DecodedInvoice as D, isPendingChainSwap as E, type FeesResponse as F, type GetSwapStatusResponse as G, isPendingReverseSwap as H, isPendingSubmarineSwap as I, isReverseClaimableStatus as J, isReverseFailedStatus as K, type LimitsResponse as L, isReverseFinalStatus as M, type Network as N, isReversePendingStatus as O, isReverseSuccessStatus as P, isReverseSwapClaimable as Q, isSubmarineFailedStatus as R, type SendLightningPaymentRequest as S, isSubmarineFinalStatus as T, isSubmarinePendingStatus as U, isSubmarineSuccessStatus as V, isSubmarineRefundableStatus as W, isSubmarineSwapRefundable as X, SwapManager as Y, type IncomingPaymentSubscription as Z, type ArkadeSwapsCreateConfig as _, type BoltzChainSwap as a, type PendingReverseSwap as a0, type PendingChainSwap as a1, type PendingSwap as a2, type Vtxo as a3, type SubmarineRecoveryStatus as a4, type SwapManagerConfig as a5, type SwapManagerEvents as a6, type SwapManagerCallbacks as a7, type BoltzReverseSwap as b, type BoltzSubmarineSwap as c, type Chain as d, type CreateLightningInvoiceResponse as e, type SendLightningPaymentResponse as f, type SubmarineRefundOutcome as g, type SubmarineRecoveryInfo as h, type SubmarineRecoveryResult as i, type ChainFeesResponse as j, type ArkToBtcResponse as k, type BtcToArkResponse as l, type SwapRepository as m, type SwapManagerClient as n, type GetSwapsFilter as o, BoltzSwapProvider as p, type BoltzSwapStatus as q, isChainClaimableStatus as r, isChainFailedStatus as s, isChainFinalStatus as t, isChainPendingStatus as u, isChainRefundableStatus as v, isChainSignableStatus as w, isChainSuccessStatus as x, isChainSwapClaimable as y, isChainSwapRefundable as z };

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

@@ -856,6 +856,68 @@ interface BoltzSubmarineSwap {
     /** Boltz API response with payment address and expected amount. */
     response: CreateSubmarineSwapResponse;
 }
+/**
+ * Outcome of inspecting a submarine swap's lockup address for recoverable
+ * funds.
+ *
+ * - `recoverable` — unspent VTXOs exist and can be swept now, either because
+ *   the refund CLTV has elapsed or because the Boltz 3-of-3 refund path is
+ *   immediately available.
+ * - `pre_cltv` — unspent VTXOs exist but the refund locktime has not
+ *   passed yet and no immediate Boltz 3-of-3 refund path was detected.
+ * - `none` — no unspent VTXOs at the address (never funded, fully
+ *   pruned, or only preconfirmed-only state).
+ * - `already_spent` — the address has VTXOs but every one is spent
+ *   (typical for a healthy completed swap).
+ * - `invalid_swap` — the swap is not a recovery candidate (pending
+ *   status), the swap data is incomplete, or the reconstructed VHTLC
+ *   address doesn't match the one Boltz returned.
+ */
+type SubmarineRecoveryStatus = "recoverable" | "pre_cltv" | "none" | "already_spent" | "invalid_swap";
+/** Diagnostic snapshot of a submarine swap's recovery state. */
+interface SubmarineRecoveryInfo {
+    /** The submarine swap this snapshot describes. */
+    swap: BoltzSubmarineSwap;
+    /** Classification of the lockup address state. */
+    status: SubmarineRecoveryStatus;
+    /** Number of unspent VTXOs at the lockup address. */
+    vtxoCount: number;
+    /** Total satoshis across the unspent VTXOs. */
+    amountSats: number;
+    /**
+     * Absolute Unix-timestamp CLTV from the swap's VHTLC, when available.
+     * Compared against wall-clock seconds for refund readiness.
+     */
+    refundLocktime?: number;
+    /** Reason populated when `status === "invalid_swap"`. */
+    error?: string;
+}
+/** Outcome of a single `refundVHTLC` call: how many VTXOs were swept vs. deferred. */
+interface SubmarineRefundOutcome {
+    /** Number of VTXOs successfully refunded (joined a batch or via Boltz co-sign). */
+    swept: number;
+    /**
+     * Number of VTXOs that could not be refunded yet (e.g. recoverable VTXO
+     * pre-CLTV, or Boltz rejected and CLTV still not satisfied). The caller
+     * is expected to retry these later.
+     */
+    skipped: number;
+}
+/** Per-swap outcome of a bulk recovery call. */
+interface SubmarineRecoveryResult {
+    /** ID of the swap whose VHTLC we attempted to refund. */
+    swapId: string;
+    /** True only when at least one VTXO was actually swept by `refundVHTLC`. */
+    recovered: boolean;
+    /**
+     * True when `refundVHTLC` returned without throwing but at least one
+     * VTXO was deferred — distinguishes a real sweep from a no-op skip
+     * path. Always false when `error` is set (the error supersedes).
+     */
+    skipped: boolean;
+    /** Failure message when `refundVHTLC` threw. */
+    error?: string;
+}
 /** Tracks an in-progress chain swap (ARK ↔ BTC). */
 interface BoltzChainSwap {
     /** Unique swap ID from Boltz. */
@@ -999,4 +1061,4 @@ interface ChainFeesResponse {
     };
 }
 
-export { type PendingSwap as $, type ArkadeSwapsConfig as A, type BoltzSwap as B, type CreateLightningInvoiceRequest as C, type DecodedInvoice as D, isReverseClaimableStatus as E, type FeesResponse as F, type GetSwapStatusResponse as G, isReverseFailedStatus as H, isReverseFinalStatus as I, isReversePendingStatus as J, isReverseSuccessStatus as K, type LimitsResponse as L, isReverseSwapClaimable as M, type Network as N, isSubmarineFailedStatus as O, isSubmarineFinalStatus as P, isSubmarinePendingStatus as Q, isSubmarineSuccessStatus as R, type SendLightningPaymentRequest as S, isSubmarineRefundableStatus as T, isSubmarineSwapRefundable as U, SwapManager as V, type IncomingPaymentSubscription as W, type ArkadeSwapsCreateConfig as X, type PendingSubmarineSwap as Y, type PendingReverseSwap as Z, type PendingChainSwap as _, type BoltzChainSwap as a, type Vtxo as a0, type SwapManagerConfig as a1, type SwapManagerEvents as a2, type SwapManagerCallbacks as a3, type BoltzReverseSwap as b, type BoltzSubmarineSwap as c, type Chain as d, type CreateLightningInvoiceResponse as e, type SendLightningPaymentResponse as f, type ChainFeesResponse as g, type ArkToBtcResponse as h, type BtcToArkResponse as i, type SwapRepository as j, type SwapManagerClient as k, type GetSwapsFilter as l, BoltzSwapProvider as m, type BoltzSwapStatus as n, isChainClaimableStatus as o, isChainFailedStatus as p, isChainFinalStatus as q, isChainPendingStatus as r, isChainRefundableStatus as s, isChainSignableStatus as t, isChainSuccessStatus as u, isChainSwapClaimable as v, isChainSwapRefundable as w, isPendingChainSwap as x, isPendingReverseSwap as y, isPendingSubmarineSwap as z };
+export { type PendingSubmarineSwap as $, type ArkadeSwapsConfig as A, type BoltzSwap as B, type CreateLightningInvoiceRequest as C, type DecodedInvoice as D, isPendingChainSwap as E, type FeesResponse as F, type GetSwapStatusResponse as G, isPendingReverseSwap as H, isPendingSubmarineSwap as I, isReverseClaimableStatus as J, isReverseFailedStatus as K, type LimitsResponse as L, isReverseFinalStatus as M, type Network as N, isReversePendingStatus as O, isReverseSuccessStatus as P, isReverseSwapClaimable as Q, isSubmarineFailedStatus as R, type SendLightningPaymentRequest as S, isSubmarineFinalStatus as T, isSubmarinePendingStatus as U, isSubmarineSuccessStatus as V, isSubmarineRefundableStatus as W, isSubmarineSwapRefundable as X, SwapManager as Y, type IncomingPaymentSubscription as Z, type ArkadeSwapsCreateConfig as _, type BoltzChainSwap as a, type PendingReverseSwap as a0, type PendingChainSwap as a1, type PendingSwap as a2, type Vtxo as a3, type SubmarineRecoveryStatus as a4, type SwapManagerConfig as a5, type SwapManagerEvents as a6, type SwapManagerCallbacks as a7, type BoltzReverseSwap as b, type BoltzSubmarineSwap as c, type Chain as d, type CreateLightningInvoiceResponse as e, type SendLightningPaymentResponse as f, type SubmarineRefundOutcome as g, type SubmarineRecoveryInfo as h, type SubmarineRecoveryResult as i, type ChainFeesResponse as j, type ArkToBtcResponse as k, type BtcToArkResponse as l, type SwapRepository as m, type SwapManagerClient as n, type GetSwapsFilter as o, BoltzSwapProvider as p, type BoltzSwapStatus as q, isChainClaimableStatus as r, isChainFailedStatus as s, isChainFinalStatus as t, isChainPendingStatus as u, isChainRefundableStatus as v, isChainSignableStatus as w, isChainSuccessStatus as x, isChainSwapClaimable as y, isChainSwapRefundable as z };