@lendasat/lendaswap-sdk 0.1.65 → 0.1.68

package/dist/index.d.ts

@@ -6,26 +6,27 @@
  *
  * @example
  * ```typescript
- * import {
- *   Client,
- *   createDexieWalletStorage,
- *   createDexieSwapStorage,
- *   createDexieVtxoSwapStorage,
- * } from '@lendasat/lendaswap-sdk';
- *
- * // Create storage providers using Dexie (IndexedDB)
- * const walletStorage = createDexieWalletStorage();
- * const swapStorage = createDexieSwapStorage();
- * const vtxoSwapStorage = createDexieVtxoSwapStorage();
- *
- * // Create client
- * const client = await Client.create(
+ * import { Client, ClientBuilder, openIdbDatabase } from '@lendasat/lendaswap-sdk';
+ *
+ * // Open the IndexedDB database
+ * const storage = await openIdbDatabase();
+ *
+ * // Create client using builder (recommended)
+ * const client = Client.builder()
+ *   .url('https://apilendaswap.lendasat.com')
+ *   .storage(storage)
+ *   .network('bitcoin')
+ *   .arkadeUrl('https://arkade.computer')
+ *   .esploraUrl('https://mempool.space/api')
+ *   .build();
+ *
+ * // Or use the static create method
+ * const client2 = await Client.create(
  *   'https://apilendaswap.lendasat.com',
- *   walletStorage,
- *   swapStorage,
- *   vtxoSwapStorage,
+ *   storage,
  *   'bitcoin',
- *   'https://arkade.computer'
+ *   'https://arkade.computer',
+ *   'https://mempool.space/api'
  * );
  *
  * // Initialize wallet (generates mnemonic if needed)
@@ -38,10 +39,9 @@
  * @packageDocumentation
  */
 export type { NetworkInput } from "./api.js";
-export { type AssetPair, type BtcToArkadeSwapRequest, type BtcToArkadeSwapResponse, type BtcToEvmSwapResponse, type Chain, Client, CreateVtxoSwapResult, EstimateVtxoSwapResponse, type EvmToArkadeSwapRequest, type EvmToBtcSwapResponse, type EvmToLightningSwapRequest, type ExtendedSwapStorageData, type ExtendedSwapStorageDataWasm, type ExtendedSwapStorageProvider, ExtendedVtxoSwapStorageData, type GelatoSubmitRequest, type GelatoSubmitResponse, type GetSwapResponse, getLogLevel, type LogLevel, type Network, type QuoteRequest, QuoteResponse, type RecoveredSwap, type RecoverSwapsResponse, type SwapRequest, SwapStatus, swapStatusToString, type SwapStorageProvider, type SwapType, setLogLevel, TokenId, type TokenIdString, type TokenInfo, Version, VhtlcAmounts, VtxoSwapParams, VtxoSwapResponse, type VtxoSwapStorageProvider, type WalletStorageProvider, } from "./api.js";
+export { type AssetPair, type BtcToArkadeSwapRequest, type BtcToArkadeSwapResponse, type BtcToEvmSwapResponse, type Chain, Client, ClientBuilder, CreateVtxoSwapResult, EstimateVtxoSwapResponse, type EvmToArkadeSwapRequest, type EvmToBtcSwapResponse, type EvmToLightningSwapRequest, type ExtendedSwapStorageData, type ExtendedSwapStorageDataWasm, ExtendedVtxoSwapStorageData, type GelatoSubmitRequest, type GelatoSubmitResponse, type GetSwapResponse, getLogLevel, type IdbStorageHandle, type LogLevel, type Network, openIdbDatabase, type QuoteRequest, QuoteResponse, type RecoveredSwap, type RecoverSwapsResponse, type SwapRequest, SwapStatus, swapStatusToString, type SwapType, setLogLevel, TokenId, type TokenIdString, type TokenInfo, Version, VhtlcAmounts, VtxoSwapParams, VtxoSwapResponse, } from "./api.js";
 export { PriceFeedService, type PriceTiers, type PriceUpdateCallback, type PriceUpdateMessage, type TradingPairPrices, } from "./price-feed.js";
 export { calculateSourceAmount, calculateTargetAmount, computeExchangeRate, selectTierRate, } from "./price-calculations.js";
-export { createDexieSwapStorage, createDexieVtxoSwapStorage, createDexieWalletStorage, DexieSwapStorageProvider, DexieVtxoSwapStorageProvider, DexieWalletStorageProvider, STORAGE_KEYS, } from "./storage/index.js";
 export type { SwapData, SwapParams } from "./types.js";
 export { type GetUsdPriceOptions, getCoinGeckoId, getSupportedTokensForUsdPrice, getUsdPrice, getUsdPrices, type UsdPriceResult, } from "./usd-price.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAK7C,OAAO,EACL,KAAK,SAAS,EACd,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,KAAK,EACV,MAAM,EACN,oBAAoB,EACpB,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,2BAA2B,EAC3B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,WAAW,EACX,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,UAAU,EACV,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,QAAQ,EACb,WAAW,EACX,OAAO,EACP,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,OAAO,EACP,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC3B,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,GACf,MAAM,yBAAyB,CAAC;AAKjC,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,4BAA4B,EAC5B,0BAA0B,EAC1B,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EACL,KAAK,kBAAkB,EACvB,cAAc,EACd,6BAA6B,EAC7B,WAAW,EACX,YAAY,EACZ,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,EACL,KAAK,SAAS,EACd,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,KAAK,EACV,MAAM,EACN,aAAa,EACb,oBAAoB,EACpB,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,2BAA2B,EAC3B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,eAAe,EACf,KAAK,YAAY,EACjB,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,UAAU,EACV,kBAAkB,EAClB,KAAK,QAAQ,EACb,WAAW,EACX,OAAO,EACP,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,OAAO,EACP,YAAY,EACZ,cAAc,EACd,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EACL,KAAK,kBAAkB,EACvB,cAAc,EACd,6BAA6B,EAC7B,WAAW,EACX,YAAY,EACZ,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -6,26 +6,27 @@
  *
  * @example
  * ```typescript
- * import {
- *   Client,
- *   createDexieWalletStorage,
- *   createDexieSwapStorage,
- *   createDexieVtxoSwapStorage,
- * } from '@lendasat/lendaswap-sdk';
- *
- * // Create storage providers using Dexie (IndexedDB)
- * const walletStorage = createDexieWalletStorage();
- * const swapStorage = createDexieSwapStorage();
- * const vtxoSwapStorage = createDexieVtxoSwapStorage();
- *
- * // Create client
- * const client = await Client.create(
+ * import { Client, ClientBuilder, openIdbDatabase } from '@lendasat/lendaswap-sdk';
+ *
+ * // Open the IndexedDB database
+ * const storage = await openIdbDatabase();
+ *
+ * // Create client using builder (recommended)
+ * const client = Client.builder()
+ *   .url('https://apilendaswap.lendasat.com')
+ *   .storage(storage)
+ *   .network('bitcoin')
+ *   .arkadeUrl('https://arkade.computer')
+ *   .esploraUrl('https://mempool.space/api')
+ *   .build();
+ *
+ * // Or use the static create method
+ * const client2 = await Client.create(
  *   'https://apilendaswap.lendasat.com',
- *   walletStorage,
- *   swapStorage,
- *   vtxoSwapStorage,
+ *   storage,
  *   'bitcoin',
- *   'https://arkade.computer'
+ *   'https://arkade.computer',
+ *   'https://mempool.space/api'
  * );
  *
  * // Initialize wallet (generates mnemonic if needed)
@@ -37,17 +38,9 @@
  *
  * @packageDocumentation
  */
-// Re-export WASM types that are commonly used
-// Storage provider types for Client.create()
-// API client
 // Re-export WASM types and API types
-export { Client, CreateVtxoSwapResult, EstimateVtxoSwapResponse, ExtendedVtxoSwapStorageData, getLogLevel, QuoteResponse, SwapStatus, swapStatusToString, setLogLevel, TokenId, Version, VhtlcAmounts, VtxoSwapParams, VtxoSwapResponse, } from "./api.js";
+export { Client, ClientBuilder, CreateVtxoSwapResult, EstimateVtxoSwapResponse, ExtendedVtxoSwapStorageData, getLogLevel, openIdbDatabase, QuoteResponse, SwapStatus, swapStatusToString, setLogLevel, TokenId, Version, VhtlcAmounts, VtxoSwapParams, VtxoSwapResponse, } from "./api.js";
 export { PriceFeedService, } from "./price-feed.js";
 export { calculateSourceAmount, calculateTargetAmount, computeExchangeRate, selectTierRate, } from "./price-calculations.js";
-// Storage (wallet data)
-// Swap storage (typed swap data using Dexie/IndexedDB)
-// VTXO swap storage (typed VTXO swap data using Dexie/IndexedDB)
-// Wallet storage (typed wallet data using Dexie/IndexedDB)
-export { createDexieSwapStorage, createDexieVtxoSwapStorage, createDexieWalletStorage, DexieSwapStorageProvider, DexieVtxoSwapStorageProvider, DexieWalletStorageProvider, STORAGE_KEYS, } from "./storage/index.js";
 export { getCoinGeckoId, getSupportedTokensForUsdPrice, getUsdPrice, getUsdPrices, } from "./usd-price.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,8CAA8C;AAC9C,6CAA6C;AAC7C,aAAa;AACb,qCAAqC;AACrC,OAAO,EAML,MAAM,EACN,oBAAoB,EACpB,wBAAwB,EAOxB,2BAA2B,EAI3B,WAAW,EAIX,aAAa,EAIb,UAAU,EACV,kBAAkB,EAGlB,WAAW,EACX,OAAO,EAGP,OAAO,EACP,YAAY,EACZ,cAAc,EACd,gBAAgB,GAGjB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,gBAAgB,GAKjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,wBAAwB;AACxB,uDAAuD;AACvD,iEAAiE;AACjE,2DAA2D;AAC3D,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,4BAA4B,EAC5B,0BAA0B,EAC1B,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAEL,cAAc,EACd,6BAA6B,EAC7B,WAAW,EACX,YAAY,GAEb,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,qCAAqC;AACrC,OAAO,EAML,MAAM,EACN,aAAa,EACb,oBAAoB,EACpB,wBAAwB,EAMxB,2BAA2B,EAI3B,WAAW,EAIX,eAAe,EAEf,aAAa,EAIb,UAAU,EACV,kBAAkB,EAElB,WAAW,EACX,OAAO,EAGP,OAAO,EACP,YAAY,EACZ,cAAc,EACd,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,gBAAgB,GAKjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,GACf,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAEL,cAAc,EACd,6BAA6B,EAC7B,WAAW,EACX,YAAY,GAEb,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lendasat/lendaswap-sdk",
-  "version": "0.1.65",
+  "version": "0.1.68",
   "description": "Lendaswap Client SDK for TypeScript/JavaScript",
   "type": "module",
   "main": "dist/index.js",
@@ -16,9 +16,19 @@
     "dist",
     "wasm"
   ],
-  "dependencies": {
-    "dexie": "^4.0.0"
+  "scripts": {
+    "build:wasm": "cd ../wasm-sdk && wasm-pack build --target bundler --out-dir ../ts-sdk/wasm && echo '# Allow npm to publish wasm files' > ../ts-sdk/wasm/.gitignore",
+    "build:wasm:release": "cd ../wasm-sdk && wasm-pack build --target bundler --release --out-dir ../ts-sdk/wasm && echo '# Allow npm to publish wasm files' > ../ts-sdk/wasm/.gitignore",
+    "build:ts": "tsc",
+    "build": "pnpm run build:wasm && pnpm run build:ts",
+    "build:release": "pnpm run build:wasm:release && pnpm run build:ts",
+    "test": "vitest",
+    "clean": "rm -rf dist wasm",
+    "prepublishOnly": "pnpm run build:release",
+    "publish:npm": "pnpm run build:release && pnpm publish --access public",
+    "publish:npm:dry-run": "pnpm run build:release && pnpm publish --access public --dry-run"
   },
+  "dependencies": {},
   "devDependencies": {
     "@biomejs/biome": "2.3.7",
     "@types/node": "^20.0.0",
@@ -42,16 +52,5 @@
   },
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "build:wasm": "cd ../wasm-sdk && wasm-pack build --target bundler --out-dir ../ts-sdk/wasm && echo '# Allow npm to publish wasm files' > ../ts-sdk/wasm/.gitignore",
-    "build:wasm:release": "cd ../wasm-sdk && wasm-pack build --target bundler --release --out-dir ../ts-sdk/wasm && echo '# Allow npm to publish wasm files' > ../ts-sdk/wasm/.gitignore",
-    "build:ts": "tsc",
-    "build": "pnpm run build:wasm && pnpm run build:ts",
-    "build:release": "pnpm run build:wasm:release && pnpm run build:ts",
-    "test": "vitest",
-    "clean": "rm -rf dist wasm",
-    "publish:npm": "pnpm run build:release && pnpm publish --access public",
-    "publish:npm:dry-run": "pnpm run build:release && pnpm publish --access public --dry-run"
   }
-}
+}

package/wasm/lendaswap_wasm_sdk.d.ts

@@ -4,6 +4,20 @@
  * Returns a human-readable string representation of the swap status.
  */
 export function swapStatusToString(status: SwapStatus): string;
+/**
+ * Open the IndexedDB database with migrations.
+ *
+ * This function opens (or creates) the lendaswap IndexedDB database
+ * and runs any necessary migrations. It also migrates wallet data from
+ * the old Dexie-based `lendaswap-wallet` database if present.
+ *
+ * # Arguments
+ * * `db_name` - Optional database name (default: "lendaswap-v2")
+ *
+ * # Returns
+ * An `IdbStorageHandle` that can be used to create storage implementations.
+ */
+export function openIdbDatabase(db_name?: string | null): Promise<IdbStorageHandle>;
 /**
  * Initialize the WASM module.
  *
@@ -162,29 +176,68 @@ export class BtcToEvmSwapResponse {
   set evm_htlc_fund_txid(value: string | null | undefined);
 }
 /**
- * Lendaswap client.
+ * Lendaswap client using IndexedDB storage.
+ *
+ * This client uses native Rust IndexedDB storage via the `idb` crate.
+ *
+ * # Example
+ *
+ * ```javascript
+ * import init, { openIdbDatabase, Client, ClientBuilder } from '@lendasat/lendaswap-sdk';
+ *
+ * await init();
+ *
+ * // Open the IndexedDB database
+ * const storage = await openIdbDatabase();
+ *
+ * // Create the client using the builder (recommended)
+ * const client = new ClientBuilder()
+ *     .url('https://api.lendaswap.com')
+ *     .storage(storage)
+ *     .network('bitcoin')
+ *     .arkadeUrl('https://arkade.computer')
+ *     .esploraUrl('https://mempool.space/api')
+ *     .build();
+ *
+ * // Or use the constructor directly
+ * const client2 = new Client(
+ *     'https://api.lendaswap.com',
+ *     storage,
+ *     'bitcoin',
+ *     'https://arkade.computer',
+ *     'https://mempool.space/api'
+ * );
+ *
+ * await client.init();
+ * ```
  */
 export class Client {
   free(): void;
   [Symbol.dispose](): void;
   /**
-   * Create a new client with separate wallet, swap, and VTXO swap storage.
+   * Create a new [`ClientBuilder`] for constructing a client.
+   */
+  static builder(): ClientBuilder;
+  /**
+   * Create a new client with IndexedDB storage.
    *
    * # Arguments
    * * `base_url` - The Lendaswap API URL
-   * * `wallet_storage` - Storage provider for wallet data (mnemonic, key index)
-   * * `swap_storage` - Storage provider for swap data
-   * * `vtxo_swap_storage` - Storage provider for VTXO swap data
+   * * `storage` - Storage handle from `openIdbDatabase()`
    * * `network` - The Bitcoin network ("bitcoin" or "testnet")
    * * `arkade_url` - The Arkade server URL
    * * `esplora_url` - The Esplora API URL for on-chain Bitcoin operations
    */
-  constructor(base_url: string, wallet_storage: JsWalletStorageProvider, swap_storage: JsSwapStorageProvider, vtxo_swap_storage: JsVtxoSwapStorageProvider, network: string, arkade_url: string, esplora_url: string);
+  constructor(base_url: string, storage: IdbStorageHandle, network: string, arkade_url: string, esplora_url: string);
   init(mnemonic?: string | null): Promise<void>;
   /**
    * Create an Arkade to EVM swap.
    */
-  createArkadeToEvmSwap(target_address: string, target_amount: number, target_token: string, target_chain: string, referral_code?: string | null): Promise<BtcToEvmSwapResponse>;
+  createArkadeToEvmSwap(target_address: string, source_amount: bigint | null | undefined, target_amount: number | null | undefined, target_token: string, target_chain: string, referral_code?: string | null): Promise<BtcToEvmSwapResponse>;
+  /**
+   * Create a Lightning to EVM swap.
+   */
+  createLightningToEvmSwap(target_address: string, source_amount: bigint | null | undefined, target_amount: number | null | undefined, target_token: string, target_chain: string, referral_code?: string | null): Promise<BtcToEvmSwapResponse>;
   /**
    * Create an EVM to Arkade swap.
    */
@@ -247,16 +300,6 @@ export class Client {
    * Delete specific swap
    */
   deleteSwap(id: string): Promise<void>;
-  /**
-   * Get the list of swap IDs that failed to deserialize during the last listAll() call.
-   * These are "corrupted" entries that couldn't be loaded.
-   */
-  getCorruptedSwapIds(): string[];
-  /**
-   * Delete all corrupted swap entries from storage.
-   * Returns the number of entries deleted.
-   */
-  deleteCorruptedSwaps(): Promise<number>;
   /**
    * Estimate the fee for a VTXO swap.
    *
@@ -301,6 +344,63 @@ export class Client {
    */
   listAllVtxoSwaps(): Promise<ExtendedVtxoSwapStorageData[]>;
 }
+/**
+ * Builder for constructing a [`Client`] with a fluent API.
+ *
+ * # Example
+ *
+ * ```javascript
+ * import init, { openIdbDatabase, ClientBuilder } from '@lendasat/lendaswap-sdk';
+ *
+ * await init();
+ *
+ * const storage = await openIdbDatabase();
+ *
+ * const client = await ClientBuilder.new()
+ *     .url('https://api.lendaswap.com')
+ *     .storage(storage)
+ *     .network('bitcoin')
+ *     .arkadeUrl('https://arkade.computer')
+ *     .esploraUrl('https://mempool.space/api')
+ *     .build();
+ *
+ * await client.init();
+ * ```
+ */
+export class ClientBuilder {
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Create a new client builder with all fields unset.
+   */
+  constructor();
+  /**
+   * Set the Lendaswap API URL.
+   */
+  url(url: string): ClientBuilder;
+  /**
+   * Set the storage handle from `openIdbDatabase()`.
+   */
+  storage(storage: IdbStorageHandle): ClientBuilder;
+  /**
+   * Set the Bitcoin network ("bitcoin", "testnet", "regtest", or "mutinynet").
+   */
+  network(network: string): ClientBuilder;
+  /**
+   * Set the Arkade server URL.
+   */
+  arkadeUrl(url: string): ClientBuilder;
+  /**
+   * Set the Esplora API URL for on-chain Bitcoin operations.
+   */
+  esploraUrl(url: string): ClientBuilder;
+  /**
+   * Build the client, consuming the builder.
+   *
+   * Returns an error if any required field is missing.
+   */
+  build(): Client;
+}
 /**
  * Result from creating a VTXO swap.
  */
@@ -448,6 +548,22 @@ export class ExtendedVtxoSwapStorageData {
    */
   swap_params: SwapParams;
 }
+/**
+ * Shared database handle for all storage implementations.
+ */
+export class IdbStorageHandle {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Close the database connection.
+   */
+  close(): void;
+  /**
+   * Get the database name.
+   */
+  readonly name: string;
+}
 export class IntoUnderlyingByteSource {
   private constructor();
   free(): void;
@@ -473,112 +589,6 @@ export class IntoUnderlyingSource {
   pull(controller: ReadableStreamDefaultController): Promise<any>;
   cancel(): void;
 }
-/**
- * JavaScript swap storage provider passed from TypeScript.
- *
- * This struct wraps JavaScript callback functions that implement
- * typed swap storage operations. Each function should return a Promise.
- *
- * # Example (TypeScript with Dexie)
- *
- * ```typescript
- * import Dexie from 'dexie';
- *
- * const db = new Dexie('lendaswap');
- * db.version(1).stores({ swaps: 'id' });
- *
- * const swapStorage = new JsSwapStorageProvider(
- *     async (swapId) => await db.swaps.get(swapId) ?? null,
- *     async (swapId, data) => { await db.swaps.put({ id: swapId, ...data }); },
- *     async (swapId) => { await db.swaps.delete(swapId); },
- *     async () => await db.swaps.toCollection().primaryKeys()
- * );
- * ```
- */
-export class JsSwapStorageProvider {
-  free(): void;
-  [Symbol.dispose](): void;
-  /**
-   * Create a new JsSwapStorageProvider from JavaScript callbacks.
-   *
-   * # Arguments
-   * * `get_fn` - Function: `(swapId: string) => Promise<ExtendedSwapStorageData | null>`
-   * * `store_fn` - Function: `(swapId: string, data: ExtendedSwapStorageData) => Promise<void>`
-   * * `delete_fn` - Function: `(swapId: string) => Promise<void>`
-   * * `list_fn` - Function: `() => Promise<string[]>`
-   * * `get_all_fn` - Function: `() => Promise<ExtendedSwapStorageData[]>`
-   */
-  constructor(get_fn: Function, store_fn: Function, delete_fn: Function, list_fn: Function, get_all_fn: Function);
-}
-/**
- * JavaScript VTXO swap storage provider passed from TypeScript.
- *
- * This struct wraps JavaScript callback functions that implement
- * typed VTXO swap storage operations. Each function should return a Promise.
- *
- * # Example (TypeScript with Dexie)
- *
- * ```typescript
- * import Dexie from 'dexie';
- *
- * const db = new Dexie('lendaswap');
- * db.version(1).stores({ vtxoSwaps: 'id' });
- *
- * const vtxoSwapStorage = new JsVtxoSwapStorageProvider(
- *     async (swapId) => await db.vtxoSwaps.get(swapId) ?? null,
- *     async (swapId, data) => { await db.vtxoSwaps.put({ id: swapId, ...data }); },
- *     async (swapId) => { await db.vtxoSwaps.delete(swapId); },
- *     async () => await db.vtxoSwaps.toCollection().primaryKeys(),
- *     async () => await db.vtxoSwaps.toArray()
- * );
- * ```
- */
-export class JsVtxoSwapStorageProvider {
-  free(): void;
-  [Symbol.dispose](): void;
-  /**
-   * Create a new JsVtxoSwapStorageProvider from JavaScript callbacks.
-   *
-   * # Arguments
-   * * `get_fn` - Function: `(swapId: string) => Promise<ExtendedVtxoSwapStorageData | null>`
-   * * `store_fn` - Function: `(swapId: string, data: ExtendedVtxoSwapStorageData) => Promise<void>`
-   * * `delete_fn` - Function: `(swapId: string) => Promise<void>`
-   * * `list_fn` - Function: `() => Promise<string[]>`
-   * * `get_all_fn` - Function: `() => Promise<ExtendedVtxoSwapStorageData[]>`
-   */
-  constructor(get_fn: Function, store_fn: Function, delete_fn: Function, list_fn: Function, get_all_fn: Function);
-}
-/**
- * JavaScript wallet storage provider passed from TypeScript.
- *
- * This struct wraps JavaScript callback functions that implement
- * the typed wallet storage operations. Each function should return a Promise.
- *
- * # Example (TypeScript)
- *
- * ```typescript
- * const provider = new JsWalletStorageProvider(
- *     async () => localStorage.getItem('mnemonic'),           // get_mnemonic
- *     async (mnemonic) => localStorage.setItem('mnemonic', mnemonic), // set_mnemonic
- *     async () => parseInt(localStorage.getItem('key_index') ?? '0'), // get_key_index
- *     async (index) => localStorage.setItem('key_index', index.toString()), // set_key_index
- * );
- * ```
- */
-export class JsWalletStorageProvider {
-  free(): void;
-  [Symbol.dispose](): void;
-  /**
-   * Create a new JsWalletStorageProvider from JavaScript callbacks.
-   *
-   * # Arguments
-   * * `get_mnemonic_fn` - Function: `() => Promise<string | null>`
-   * * `set_mnemonic_fn` - Function: `(mnemonic: string) => Promise<void>`
-   * * `get_key_index_fn` - Function: `() => Promise<number>`
-   * * `set_key_index_fn` - Function: `(index: number) => Promise<void>`
-   */
-  constructor(get_mnemonic_fn: Function, set_mnemonic_fn: Function, get_key_index_fn: Function, set_key_index_fn: Function);
-}
 /**
  * Quote response from the API.
  */