@arkade-os/boltz-swap 0.3.32 → 0.3.34

package/README.md

@@ -242,18 +242,18 @@ Custom implementations must set `readonly version = 1` — TypeScript will error
 
 > [!WARNING]
 > If you previously used the v1 `StorageAdapter`-based repositories, migrate
-> data before use:
+> data before use. `migrateToSwapRepository` copies legacy `reverseSwaps` and
+> `submarineSwaps` collections from the old `ContractRepository` into the new
+> `SwapRepository`. It writes its own swap-specific migration flag, so it is
+> idempotent and safe to call on every startup — do not gate it on the
+> wallet-side `getMigrationStatus`.
 >
 > ```typescript
 > import { IndexedDbSwapRepository, migrateToSwapRepository } from '@arkade-os/boltz-swap'
-> import { getMigrationStatus } from '@arkade-os/sdk'
 > import { IndexedDBStorageAdapter } from '@arkade-os/sdk/adapters/indexedDB'
 >
 > const oldStorage = new IndexedDBStorageAdapter('arkade-service-worker', 1)
-> const status = await getMigrationStatus('wallet', oldStorage)
-> if (status !== 'not-needed') {
->   await migrateToSwapRepository(oldStorage, new IndexedDbSwapRepository())
-> }
+> await migrateToSwapRepository(oldStorage, new IndexedDbSwapRepository())
 > ```
 
 ## Expo / React Native
@@ -283,16 +283,14 @@ Expo/React Native cannot run a long-lived Service Worker, and background work is
 npx expo install expo-task-manager expo-background-task
 npx expo install @react-native-async-storage/async-storage expo-secure-store
 npx expo install expo-crypto
-npx expo install expo-sqlite && npm install indexeddbshim
+npx expo install expo-sqlite
 ```
 
-- If you rely on the default IndexedDB-backed repositories in Expo, call `setupExpoDb()` **before any SDK/boltz-swap import**:
-
-```ts
-import { setupExpoDb } from "@arkade-os/sdk/adapters/expo-db";
-
-setupExpoDb();
-```
+- For persistence on Expo, prefer the SQLite-backed repositories
+  (`@arkade-os/boltz-swap/repositories/sqlite` and
+  `@arkade-os/sdk/repositories/sqlite`) on top of `expo-sqlite`, or the Realm
+  repositories on top of `realm`. There is no SDK-shipped IndexedDB helper
+  for Expo.
 
 - Expo requires a `crypto.getRandomValues()` polyfill for cryptographic operations:
 
@@ -310,13 +308,20 @@ global.crypto.getRandomValues = Crypto.getRandomValues;
 // App entry point (e.g., _layout.tsx) — GLOBAL SCOPE
 import AsyncStorage from "@react-native-async-storage/async-storage";
 import * as SecureStore from "expo-secure-store";
+import * as SQLite from "expo-sqlite";
 import { SingleKey } from "@arkade-os/sdk";
 import { AsyncStorageTaskQueue } from "@arkade-os/sdk/worker/expo";
-import { IndexedDbSwapRepository } from "@arkade-os/boltz-swap";
+import { SQLiteSwapRepository } from "@arkade-os/boltz-swap/repositories/sqlite";
 import { defineExpoSwapBackgroundTask } from "@arkade-os/boltz-swap/expo/background";
 
 const swapTaskQueue = new AsyncStorageTaskQueue(AsyncStorage, "ark:swap-queue");
-const swapRepository = new IndexedDbSwapRepository();
+
+const swapDb = SQLite.openDatabaseSync("ark-swaps.db");
+const swapRepository = new SQLiteSwapRepository({
+  run: (sql, params) => swapDb.runAsync(sql, params ?? []),
+  get: (sql, params) => swapDb.getFirstAsync(sql, params ?? []),
+  all: (sql, params) => swapDb.getAllAsync(sql, params ?? []),
+});
 
 defineExpoSwapBackgroundTask("ark-swap-poll", {
   taskQueue: swapTaskQueue,
@@ -424,16 +429,7 @@ import {
 
 ### Releasing
 
-```bash
-# Release new version (will prompt for version patch, minor, major)
-pnpm release
-
-# You can test release process without making changes
-pnpm release:dry-run
-
-# Cleanup: checkout version commit and remove release branch
-pnpm release:cleanup
-```
+Package-local releases are disabled. Releases run from the monorepo root and are package-scoped: `pnpm run release -- boltz-swap patch` bumps and publishes just `@arkade-os/boltz-swap` with a `@arkade-os/boltz-swap/<version>` tag, against the currently published `@arkade-os/sdk` version. See the [root README](../../README.md#releasing) for full flags and `pnpm run release -- --help`.
 
 ## License
 

package/dist/{arkade-swaps-CS8FZSVL.d.cts → arkade-swaps-BXAD1s8j.d.ts}

@@ -1,5 +1,5 @@
 import { IWallet, ArkProvider, IndexerProvider, ArkInfo, Identity, ArkTxInput, VHTLC } from '@arkade-os/sdk';
-import { p as BoltzSwapProvider, Y as SwapManager, m as SwapRepository, _ as ArkadeSwapsCreateConfig, A as ArkadeSwapsConfig, n as SwapManagerClient, C as CreateLightningInvoiceRequest, e as CreateLightningInvoiceResponse, b as BoltzReverseSwap, S as SendLightningPaymentRequest, f as SendLightningPaymentResponse, c as BoltzSubmarineSwap, g as SubmarineRefundOutcome, h as SubmarineRecoveryInfo, i as SubmarineRecoveryResult, k as ArkToBtcResponse, a as BoltzChainSwap, l as BtcToArkResponse, d as Chain, F as FeesResponse, j as ChainFeesResponse, L as LimitsResponse, G as GetSwapStatusResponse, B as BoltzSwap } from './types-BBI7-KJ0.cjs';
+import { r as BoltzSwapProvider, x as SwapManager, n as SwapRepository, q as ArkadeSwapsCreateConfig, A as ArkadeSwapsConfig, o as SwapManagerClient, C as CreateLightningInvoiceRequest, e as CreateLightningInvoiceResponse, b as BoltzReverseSwap, S as SendLightningPaymentRequest, f as SendLightningPaymentResponse, c as BoltzSubmarineSwap, g as SubmarineRefundOutcome, h as SubmarineRecoveryInfo, i as SubmarineRecoveryResult, k as ArkToBtcResponse, a as BoltzChainSwap, m as ChainArkRefundOutcome, l as BtcToArkResponse, d as Chain, F as FeesResponse, j as ChainFeesResponse, L as LimitsResponse, G as GetSwapStatusResponse, B as BoltzSwap } from './types--axEWA8c.js';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
 
 /**
@@ -267,10 +267,19 @@ declare class ArkadeSwaps {
      */
     claimBtc(pendingSwap: BoltzChainSwap): Promise<void>;
     /**
-     * When an ARK to BTC swap fails, refund sats on ARK chain by claiming the VHTLC.
+     * When an ARK to BTC swap fails, refund every unspent VTXO at the chain
+     * swap's ARK lockup address.
+     *
+     * Path selection per VTXO:
+     * - CLTV has elapsed → `refundWithoutReceiver` via `joinBatch` (no Boltz).
+     * - Pre-CLTV recoverable → skipped (Boltz can't co-sign swept-batch refund).
+     * - Pre-CLTV non-recoverable → cooperative 3-of-3 refund via Boltz.
+     *
      * @param pendingSwap - The pending chain swap to refund.
+     * @returns Counts of VTXOs swept vs. deferred. A `swept: 0` outcome means
+     *          the call was a no-op — callers should retry after CLTV.
      */
-    refundArk(pendingSwap: BoltzChainSwap): Promise<void>;
+    refundArk(pendingSwap: BoltzChainSwap): Promise<ChainArkRefundOutcome>;
     /**
      * Creates a chain swap from BTC to ARK.
      * @param args.feeSatsPerByte - Fee rate for BTC transactions (default: 1).
@@ -337,11 +346,46 @@ declare class ArkadeSwaps {
         arkInfo: ArkInfo;
     }): Promise<boolean>;
     /**
-     * Renegotiates the quote for an existing swap.
+     * Renegotiates the quote for an existing chain swap. Convenience wrapper
+     * over `getSwapQuote` + `acceptSwapQuote` with a safety floor.
+     *
+     * The floor is resolved in order:
+     *   1. `options.minAcceptableAmount` if provided.
+     *   2. The original `response.claimDetails.amount` of the stored
+     *      pending swap (Boltz-confirmed server-lock amount at creation).
+     *   3. Otherwise throws `QuoteRejectedError({ reason: "no_baseline" })`.
+     *
+     * `options.maxSlippageBps` (default 0) relaxes the floor by basis points.
+     * Quotes ≤ 0 are always rejected. On rejection the acceptance is NOT
+     * posted to Boltz.
+     *
+     * Prefer `getSwapQuote` / `acceptSwapQuote` for callers that want to
+     * inspect the quote before committing.
+     *
      * @param swapId - The ID of the swap.
+     * @param options - Optional floor and slippage configuration.
      * @returns The accepted quote amount.
+     * @throws QuoteRejectedError if the quote is non-positive, below the
+     *     effective floor, or no baseline is available.
+     */
+    quoteSwap(swapId: string, options?: QuoteSwapOptions): Promise<number>;
+    /**
+     * Fetches a renegotiated quote from Boltz without accepting it.
+     * Pair with `acceptSwapQuote` to commit a specific value.
      */
-    quoteSwap(swapId: string): Promise<number>;
+    getSwapQuote(swapId: string): Promise<number>;
+    /**
+     * Accepts a quote amount for an existing chain swap, after validating it
+     * against the configured floor. See `quoteSwap` for floor-resolution rules.
+     *
+     * @throws QuoteRejectedError if `amount` ≤ 0, below the effective floor,
+     *     or no baseline is available.
+     */
+    acceptSwapQuote(swapId: string, amount: number, options?: QuoteSwapOptions): Promise<number>;
+    private resolveEffectiveFloor;
+    private resolveQuoteFloor;
+    private validateQuoteOptions;
+    private validateQuote;
     /**
      * Joins a batch to spend the vtxo via commitment transaction.
      * @param identity - The identity to use for signing.
@@ -429,6 +473,21 @@ declare class ArkadeSwaps {
      */
     enrichSubmarineSwapInvoice(swap: BoltzSubmarineSwap, invoice: string): BoltzSubmarineSwap;
 }
+/** Options controlling acceptance of a renegotiated chain-swap quote. */
+type QuoteSwapOptions = {
+    /**
+     * Hard floor on the accepted quote (in sats). When provided, skips the
+     * repository lookup. Pass the original `response.claimDetails.amount`
+     * to require the renegotiated amount to be no worse than what Boltz
+     * confirmed at swap creation.
+     */
+    minAcceptableAmount?: number;
+    /**
+     * Slippage tolerance in basis points, applied to the floor. Default 0
+     * (strict). E.g. 100 allows accepting quotes within 1% below the floor.
+     */
+    maxSlippageBps?: number;
+};
 /** Public interface for ArkadeSwaps, defining all swap operations available to consumers. */
 interface IArkadeSwaps extends AsyncDisposable {
     startSwapManager(): Promise<void>;
@@ -465,7 +524,7 @@ interface IArkadeSwaps extends AsyncDisposable {
         txid: string;
     }>;
     claimBtc(pendingSwap: BoltzChainSwap): Promise<void>;
-    refundArk(pendingSwap: BoltzChainSwap): Promise<void>;
+    refundArk(pendingSwap: BoltzChainSwap): Promise<ChainArkRefundOutcome>;
     btcToArk(args: {
         feeSatsPerByte?: number;
         senderLockAmount?: number;
@@ -493,7 +552,9 @@ interface IArkadeSwaps extends AsyncDisposable {
         swap: BoltzChainSwap;
         arkInfo: ArkInfo;
     }): Promise<boolean>;
-    quoteSwap(swapId: string): Promise<number>;
+    quoteSwap(swapId: string, options?: QuoteSwapOptions): Promise<number>;
+    getSwapQuote(swapId: string): Promise<number>;
+    acceptSwapQuote(swapId: string, amount: number, options?: QuoteSwapOptions): Promise<number>;
     joinBatch(identity: Identity, input: ArkTxInput, output: TransactionOutput, arkInfo: ArkInfo, isRecoverable?: boolean): Promise<string>;
     createVHTLCScript(args: {
         network: string;
@@ -528,4 +589,4 @@ interface IArkadeSwaps extends AsyncDisposable {
     dispose(): Promise<void>;
 }
 
-export { ArkadeSwaps as A, type IArkadeSwaps as I, type VhtlcTimeouts as V };
+export { ArkadeSwaps as A, type IArkadeSwaps as I, type QuoteSwapOptions as Q, type VhtlcTimeouts as V };

package/dist/{arkade-swaps-WiKCanCL.d.ts → arkade-swaps-CfMets16.d.cts}

@@ -1,5 +1,5 @@
 import { IWallet, ArkProvider, IndexerProvider, ArkInfo, Identity, ArkTxInput, VHTLC } from '@arkade-os/sdk';
-import { p as BoltzSwapProvider, Y as SwapManager, m as SwapRepository, _ as ArkadeSwapsCreateConfig, A as ArkadeSwapsConfig, n as SwapManagerClient, C as CreateLightningInvoiceRequest, e as CreateLightningInvoiceResponse, b as BoltzReverseSwap, S as SendLightningPaymentRequest, f as SendLightningPaymentResponse, c as BoltzSubmarineSwap, g as SubmarineRefundOutcome, h as SubmarineRecoveryInfo, i as SubmarineRecoveryResult, k as ArkToBtcResponse, a as BoltzChainSwap, l as BtcToArkResponse, d as Chain, F as FeesResponse, j as ChainFeesResponse, L as LimitsResponse, G as GetSwapStatusResponse, B as BoltzSwap } from './types-BBI7-KJ0.js';
+import { r as BoltzSwapProvider, x as SwapManager, n as SwapRepository, q as ArkadeSwapsCreateConfig, A as ArkadeSwapsConfig, o as SwapManagerClient, C as CreateLightningInvoiceRequest, e as CreateLightningInvoiceResponse, b as BoltzReverseSwap, S as SendLightningPaymentRequest, f as SendLightningPaymentResponse, c as BoltzSubmarineSwap, g as SubmarineRefundOutcome, h as SubmarineRecoveryInfo, i as SubmarineRecoveryResult, k as ArkToBtcResponse, a as BoltzChainSwap, m as ChainArkRefundOutcome, l as BtcToArkResponse, d as Chain, F as FeesResponse, j as ChainFeesResponse, L as LimitsResponse, G as GetSwapStatusResponse, B as BoltzSwap } from './types--axEWA8c.cjs';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
 
 /**
@@ -267,10 +267,19 @@ declare class ArkadeSwaps {
      */
     claimBtc(pendingSwap: BoltzChainSwap): Promise<void>;
     /**
-     * When an ARK to BTC swap fails, refund sats on ARK chain by claiming the VHTLC.
+     * When an ARK to BTC swap fails, refund every unspent VTXO at the chain
+     * swap's ARK lockup address.
+     *
+     * Path selection per VTXO:
+     * - CLTV has elapsed → `refundWithoutReceiver` via `joinBatch` (no Boltz).
+     * - Pre-CLTV recoverable → skipped (Boltz can't co-sign swept-batch refund).
+     * - Pre-CLTV non-recoverable → cooperative 3-of-3 refund via Boltz.
+     *
      * @param pendingSwap - The pending chain swap to refund.
+     * @returns Counts of VTXOs swept vs. deferred. A `swept: 0` outcome means
+     *          the call was a no-op — callers should retry after CLTV.
      */
-    refundArk(pendingSwap: BoltzChainSwap): Promise<void>;
+    refundArk(pendingSwap: BoltzChainSwap): Promise<ChainArkRefundOutcome>;
     /**
      * Creates a chain swap from BTC to ARK.
      * @param args.feeSatsPerByte - Fee rate for BTC transactions (default: 1).
@@ -337,11 +346,46 @@ declare class ArkadeSwaps {
         arkInfo: ArkInfo;
     }): Promise<boolean>;
     /**
-     * Renegotiates the quote for an existing swap.
+     * Renegotiates the quote for an existing chain swap. Convenience wrapper
+     * over `getSwapQuote` + `acceptSwapQuote` with a safety floor.
+     *
+     * The floor is resolved in order:
+     *   1. `options.minAcceptableAmount` if provided.
+     *   2. The original `response.claimDetails.amount` of the stored
+     *      pending swap (Boltz-confirmed server-lock amount at creation).
+     *   3. Otherwise throws `QuoteRejectedError({ reason: "no_baseline" })`.
+     *
+     * `options.maxSlippageBps` (default 0) relaxes the floor by basis points.
+     * Quotes ≤ 0 are always rejected. On rejection the acceptance is NOT
+     * posted to Boltz.
+     *
+     * Prefer `getSwapQuote` / `acceptSwapQuote` for callers that want to
+     * inspect the quote before committing.
+     *
      * @param swapId - The ID of the swap.
+     * @param options - Optional floor and slippage configuration.
      * @returns The accepted quote amount.
+     * @throws QuoteRejectedError if the quote is non-positive, below the
+     *     effective floor, or no baseline is available.
+     */
+    quoteSwap(swapId: string, options?: QuoteSwapOptions): Promise<number>;
+    /**
+     * Fetches a renegotiated quote from Boltz without accepting it.
+     * Pair with `acceptSwapQuote` to commit a specific value.
      */
-    quoteSwap(swapId: string): Promise<number>;
+    getSwapQuote(swapId: string): Promise<number>;
+    /**
+     * Accepts a quote amount for an existing chain swap, after validating it
+     * against the configured floor. See `quoteSwap` for floor-resolution rules.
+     *
+     * @throws QuoteRejectedError if `amount` ≤ 0, below the effective floor,
+     *     or no baseline is available.
+     */
+    acceptSwapQuote(swapId: string, amount: number, options?: QuoteSwapOptions): Promise<number>;
+    private resolveEffectiveFloor;
+    private resolveQuoteFloor;
+    private validateQuoteOptions;
+    private validateQuote;
     /**
      * Joins a batch to spend the vtxo via commitment transaction.
      * @param identity - The identity to use for signing.
@@ -429,6 +473,21 @@ declare class ArkadeSwaps {
      */
     enrichSubmarineSwapInvoice(swap: BoltzSubmarineSwap, invoice: string): BoltzSubmarineSwap;
 }
+/** Options controlling acceptance of a renegotiated chain-swap quote. */
+type QuoteSwapOptions = {
+    /**
+     * Hard floor on the accepted quote (in sats). When provided, skips the
+     * repository lookup. Pass the original `response.claimDetails.amount`
+     * to require the renegotiated amount to be no worse than what Boltz
+     * confirmed at swap creation.
+     */
+    minAcceptableAmount?: number;
+    /**
+     * Slippage tolerance in basis points, applied to the floor. Default 0
+     * (strict). E.g. 100 allows accepting quotes within 1% below the floor.
+     */
+    maxSlippageBps?: number;
+};
 /** Public interface for ArkadeSwaps, defining all swap operations available to consumers. */
 interface IArkadeSwaps extends AsyncDisposable {
     startSwapManager(): Promise<void>;
@@ -465,7 +524,7 @@ interface IArkadeSwaps extends AsyncDisposable {
         txid: string;
     }>;
     claimBtc(pendingSwap: BoltzChainSwap): Promise<void>;
-    refundArk(pendingSwap: BoltzChainSwap): Promise<void>;
+    refundArk(pendingSwap: BoltzChainSwap): Promise<ChainArkRefundOutcome>;
     btcToArk(args: {
         feeSatsPerByte?: number;
         senderLockAmount?: number;
@@ -493,7 +552,9 @@ interface IArkadeSwaps extends AsyncDisposable {
         swap: BoltzChainSwap;
         arkInfo: ArkInfo;
     }): Promise<boolean>;
-    quoteSwap(swapId: string): Promise<number>;
+    quoteSwap(swapId: string, options?: QuoteSwapOptions): Promise<number>;
+    getSwapQuote(swapId: string): Promise<number>;
+    acceptSwapQuote(swapId: string, amount: number, options?: QuoteSwapOptions): Promise<number>;
     joinBatch(identity: Identity, input: ArkTxInput, output: TransactionOutput, arkInfo: ArkInfo, isRecoverable?: boolean): Promise<string>;
     createVHTLCScript(args: {
         network: string;
@@ -528,4 +589,4 @@ interface IArkadeSwaps extends AsyncDisposable {
     dispose(): Promise<void>;
 }
 
-export { ArkadeSwaps as A, type IArkadeSwaps as I, type VhtlcTimeouts as V };
+export { ArkadeSwaps as A, type IArkadeSwaps as I, type QuoteSwapOptions as Q, type VhtlcTimeouts as V };

package/dist/{chunk-NHBWNN6H.js → chunk-5K2FS2FE.js}

@@ -7,26 +7,18 @@ import {
   isSubmarineFinalStatus,
   isSubmarineSwapRefundable,
   logger
-} from "./chunk-B3Q4TFWT.js";
+} from "./chunk-TDBUZE4N.js";
 
 // src/expo/swapsPollProcessor.ts
 var SWAP_POLL_TASK_TYPE = "swap-poll";
 var swapsPollProcessor = {
   taskType: SWAP_POLL_TASK_TYPE,
   async execute(item, deps) {
-    const {
-      swapRepository,
-      swapProvider,
-      wallet,
-      arkProvider,
-      indexerProvider
-    } = deps;
+    const { swapRepository, swapProvider, wallet, arkProvider, indexerProvider } = deps;
     const allSwaps = await swapRepository.getAllSwaps();
     const pendingSwaps = allSwaps.filter((swap) => {
-      if (isPendingReverseSwap(swap))
-        return !isReverseFinalStatus(swap.status);
-      if (isPendingSubmarineSwap(swap))
-        return !isSubmarineFinalStatus(swap.status);
+      if (isPendingReverseSwap(swap)) return !isReverseFinalStatus(swap.status);
+      if (isPendingSubmarineSwap(swap)) return !isSubmarineFinalStatus(swap.status);
       return false;
     });
     let polled = 0;
@@ -56,19 +48,14 @@ var swapsPollProcessor = {
           }
           if (isPendingReverseSwap(swap) && isReverseClaimableStatus(currentStatus)) {
             if (!swap.preimage) {
-              logger.warn(
-                `[swap-poll] Skipping claim for ${swap.id}: no preimage`
-              );
+              logger.warn(`[swap-poll] Skipping claim for ${swap.id}: no preimage`);
               continue;
             }
             try {
               await tempSwaps.claimVHTLC(swap);
               claimed++;
             } catch (claimError) {
-              logger.error(
-                `[swap-poll] Claim failed for ${swap.id}:`,
-                claimError
-              );
+              logger.error(`[swap-poll] Claim failed for ${swap.id}:`, claimError);
               errors++;
             }
           }
@@ -84,18 +71,12 @@ var swapsPollProcessor = {
               await tempSwaps.refundVHTLC(swapWithStatus);
               refunded++;
             } catch (refundError) {
-              logger.error(
-                `[swap-poll] Refund failed for ${swap.id}:`,
-                refundError
-              );
+              logger.error(`[swap-poll] Refund failed for ${swap.id}:`, refundError);
               errors++;
             }
           }
         } catch (swapError) {
-          logger.error(
-            `[swap-poll] Error processing swap ${swap.id}:`,
-            swapError
-          );
+          logger.error(`[swap-poll] Error processing swap ${swap.id}:`, swapError);
           errors++;
         }
       }

package/dist/chunk-SJQJQO7P.js

@@ -0,0 +1,25 @@
+// src/repositories/swap-repository.ts
+function hasImpossibleSwapsFilter(filter) {
+  if (!filter) return false;
+  return Array.isArray(filter.id) && filter.id.length === 0 || Array.isArray(filter.status) && filter.status.length === 0 || Array.isArray(filter.type) && filter.type.length === 0;
+}
+function matchesCriterion(value, criterion) {
+  if (criterion === void 0) return true;
+  return Array.isArray(criterion) ? criterion.includes(value) : value === criterion;
+}
+function applySwapsFilter(swaps, filter) {
+  return swaps.filter(
+    (swap) => !!swap && matchesCriterion(swap.id, filter.id) && matchesCriterion(swap.status, filter.status) && matchesCriterion(swap.type, filter.type)
+  );
+}
+function applyCreatedAtOrder(swaps, filter) {
+  if (filter?.orderBy !== "createdAt") return swaps;
+  const direction = filter.orderDirection === "asc" ? 1 : -1;
+  return swaps.slice().sort((a, b) => (a.createdAt - b.createdAt) * direction);
+}
+
+export {
+  hasImpossibleSwapsFilter,
+  applySwapsFilter,
+  applyCreatedAtOrder
+};