@secondts/bark 0.10.0 → 0.11.0

package/bundler/bark_ffi_wasm_bg.wasm.d.ts

@@ -15,11 +15,10 @@ export const onchainwallet_balance: (a: number) => number;
 export const onchainwallet_newAddress: (a: number) => number;
 export const onchainwallet_send: (a: number, b: number, c: number, d: number, e: number) => number;
 export const __wbg_wallet_free: (a: number, b: number) => void;
-export const wallet_create: (a: number) => number;
-export const wallet_open: (a: number) => number;
-export const wallet_createWithOnchain: (a: number, b: number) => number;
-export const wallet_openWithOnchain: (a: number, b: number) => number;
+export const wallet_open: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+export const wallet_create: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
 export const wallet_sync: (a: number) => number;
+export const wallet_syncForceExitedVtxos: (a: number) => number;
 export const wallet_maintenance: (a: number) => number;
 export const wallet_maintenanceWithOnchain: (a: number, b: number) => number;
 export const wallet_maintenanceDelegated: (a: number) => number;
@@ -92,7 +91,6 @@ export const wallet_progressPendingRounds: (a: number) => number;
 export const wallet_refreshServer: (a: number) => number;
 export const wallet_getFirstExpiringVtxoBlockheight: (a: number) => number;
 export const wallet_getNextRequiredRefreshBlockheight: (a: number) => number;
-export const wallet_maybeScheduleMaintenanceRefresh: (a: number) => number;
 export const wallet_broadcastTx: (a: number, b: number, c: number) => number;
 export const wallet_mailboxIdentifier: (a: number, b: number) => void;
 export const wallet_mailboxAuthorization: (a: number, b: number) => void;
@@ -127,16 +125,16 @@ export const rustsecp256k1_v0_10_0_context_create: (a: number) => number;
 export const rustsecp256k1_v0_10_0_context_destroy: (a: number) => void;
 export const rustsecp256k1_v0_10_0_default_illegal_callback_fn: (a: number, b: number) => void;
 export const rustsecp256k1_v0_10_0_default_error_callback_fn: (a: number, b: number) => void;
-export const __wasm_bindgen_func_elem_728: (a: number, b: number, c: number, d: number) => void;
-export const __wasm_bindgen_func_elem_15275: (a: number, b: number, c: number, d: number) => void;
-export const __wasm_bindgen_func_elem_738: (a: number, b: number, c: number, d: number) => void;
-export const __wasm_bindgen_func_elem_15278: (a: number, b: number, c: number) => number;
-export const __wasm_bindgen_func_elem_13590: (a: number, b: number, c: number) => void;
-export const __wasm_bindgen_func_elem_13288: (a: number, b: number, c: number) => void;
-export const __wasm_bindgen_func_elem_15277: (a: number, b: number, c: number) => void;
-export const __wasm_bindgen_func_elem_12867: (a: number, b: number) => void;
-export const __wasm_bindgen_func_elem_13744: (a: number, b: number) => void;
-export const __wasm_bindgen_func_elem_19152: (a: number, b: number) => void;
+export const __wasm_bindgen_func_elem_732: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_15631: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_740: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_15633: (a: number, b: number, c: number) => number;
+export const __wasm_bindgen_func_elem_13669: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_13382: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_15634: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_12963: (a: number, b: number) => void;
+export const __wasm_bindgen_func_elem_13822: (a: number, b: number) => void;
+export const __wasm_bindgen_func_elem_19550: (a: number, b: number) => void;
 export const __wbindgen_export: (a: number, b: number) => number;
 export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_export3: (a: number) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@secondts/bark",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Bark FFI bindings for the browser via WebAssembly (IndexedDB persister)",
   "license": "MIT",
   "author": {
@@ -58,5 +58,5 @@
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
-  "releaseTag": "v0.10.0+bark.0.2.5"
+  "releaseTag": "v0.11.0+bark-0.3.0"
 }

package/web/bark_ffi_wasm.d.ts

@@ -67,6 +67,40 @@ export interface ExitTransactionStatus {
     transactionCount: number;
 }
 
+/**
+ * Optional arguments for [`Wallet::open`]
+ *
+ * Every field has a default, so callers only set what they need.
+ */
+export interface OpenWalletArgs {
+    /**
+     * Whether to run the background daemon
+     *
+     * When disabled, you must manually call `Wallet::sync` to sync the wallet.
+     *
+     * Default: true
+     */
+    runDaemon?: boolean;
+    /**
+     * Optional name for IndexedDb
+     *
+     * Default: name based on wallet fingerprint
+     */
+    indexedDbName?: string;
+    /**
+     * Whether to create a new wallet if no wallet exists
+     *
+     *  Default: true
+     */
+    createIfNotExists?: boolean;
+    /**
+     * Whether to create a new wallet even if the Ark server cannot be reached
+     *
+     * Default: false
+     */
+    createWithoutServer?: boolean;
+}
+
 /**
  * Parameters for creating a CPFP (Child Pays For Parent) transaction
  */
@@ -149,7 +183,7 @@ export interface Bolt11InvoiceArgs {
 
 export interface CheckLightningPaymentArgs {
     paymentHash: string;
-    wait: boolean;
+    wait?: boolean;
 }
 
 export interface Config {
@@ -160,7 +194,6 @@ export interface Config {
     bitcoindCookiefile?: string;
     bitcoindUser?: string;
     bitcoindPass?: string;
-    network: Network;
     vtxoRefreshExpiryThreshold?: number;
     vtxoExitMargin?: number;
     htlcRecvClaimDelta?: number;
@@ -170,6 +203,7 @@ export interface Config {
     offboardRequiredConfirmations?: number;
     daemonManualSync?: boolean;
     lightningReceiveClaimRetries?: number;
+    userAgent?: string;
 }
 
 export interface DrainExitsArgs {
@@ -260,6 +294,7 @@ export interface OnchainBalance {
 }
 
 export interface OnchainWalletDefaultArgs {
+    network: Network;
     mnemonic: string;
     config: Config;
     dbName: string;
@@ -268,13 +303,13 @@ export interface OnchainWalletDefaultArgs {
 export interface PayLightningInvoiceArgs {
     invoice: string;
     amountSats?: number;
-    wait: boolean;
+    wait?: boolean;
 }
 
 export interface PayLightningOfferArgs {
     offer: string;
     amountSats?: number;
-    wait: boolean;
+    wait?: boolean;
 }
 
 export interface PendingBoard {
@@ -288,12 +323,12 @@ export interface ProgressExitsArgs {
 }
 
 export interface TryClaimAllLightningReceivesArgs {
-    wait: boolean;
+    wait?: boolean;
 }
 
 export interface TryClaimLightningReceiveArgs {
     paymentHash: string;
-    wait: boolean;
+    wait?: boolean;
 }
 
 export interface Vtxo {
@@ -314,19 +349,6 @@ export interface Vtxo {
     exitTxWeightWu: number;
 }
 
-export interface WalletCreateArgs {
-    mnemonic: string;
-    config: Config;
-    dbName: string;
-    forceRescan: boolean;
-}
-
-export interface WalletOpenArgs {
-    mnemonic: string;
-    config: Config;
-    dbName: string;
-}
-
 export interface WalletProperties {
     network: Network;
     fingerprint: string;
@@ -427,9 +449,13 @@ export class Wallet {
     cancelPendingRound(roundId: number): Promise<void>;
     checkLightningPayment(args: CheckLightningPaymentArgs): Promise<LightningSendStatus>;
     claimableLightningReceiveBalanceSats(): Promise<number>;
-    config(): Promise<Config>;
-    static create(args: WalletCreateArgs): Promise<Wallet>;
-    static createWithOnchain(onchainWallet: OnchainWallet, args: WalletCreateArgs): Promise<Wallet>;
+    config(): Config;
+    /**
+     * Low-level function to initialize a wallet
+     *
+     * You probably want to use [`Wallet::open`] instead.
+     */
+    static create(network: Network, mnemonic_or_seed: string, config: Config, indexedDbName: string | null | undefined, createWithoutServer: boolean): Promise<void>;
     drainExits(args: DrainExitsArgs): Promise<ExitClaimTransaction>;
     estimateArkoorPaymentFee(amountSats: number): Promise<FeeEstimate>;
     estimateBoardFee(amountSats: number): Promise<FeeEstimate>;
@@ -462,7 +488,6 @@ export class Wallet {
     maintenanceRefresh(): Promise<string | undefined>;
     maintenanceWithOnchain(onchainWallet: OnchainWallet): Promise<void>;
     maintenanceWithOnchainDelegated(onchainWallet: OnchainWallet): Promise<void>;
-    maybeScheduleMaintenanceRefresh(): Promise<number | undefined>;
     network(): Promise<Network>;
     newAddress(): Promise<string>;
     newAddressWithIndex(): Promise<AddressWithIndex>;
@@ -470,8 +495,17 @@ export class Wallet {
     notifications(): NotificationHolder;
     offboardAll(bitcoinAddress: string): Promise<OffboardResult>;
     offboardVtxos(vtxoIds: string[], bitcoinAddress: string): Promise<string>;
-    static open(args: WalletOpenArgs): Promise<Wallet>;
-    static openWithOnchain(onchainWallet: OnchainWallet, args: WalletOpenArgs): Promise<Wallet>;
+    /**
+     * Open a wallet, mirroring [`bark::Wallet::open`]: a single entry point
+     * with everything optional. Set `createIfNotExists` to create the wallet
+     * if it doesn't exist yet (replacing the old `create` constructor).
+     *
+     * There is no separate `withOnchain` variant: onchain operations
+     * (boarding, exits, ...) take the onchain wallet per-call, and the web
+     * build has no background daemon, so the onchain wallet is never needed
+     * at open time.
+     */
+    static open(network: Network, mnemonic_or_seed: string, config: Config, onchain: OnchainWallet | null | undefined, args: OpenWalletArgs): Promise<Wallet>;
     payLightningInvoice(args: PayLightningInvoiceArgs): Promise<LightningSendStatus>;
     payLightningOffer(args: PayLightningOfferArgs): Promise<LightningSendStatus>;
     peekAddress(index: number): Promise<string>;
@@ -489,7 +523,7 @@ export class Wallet {
     refreshServer(): Promise<void>;
     refreshVtxos(vtxoIds: string[]): Promise<string | undefined>;
     refreshVtxosDelegated(vtxoIds: string[]): Promise<RoundState | undefined>;
-    sendArkoorPayment(arkAddress: string, amountSats: number): Promise<string>;
+    sendArkoorPayment(arkAddress: string, amountSats: number): Promise<void>;
     sendOnchain(address: string, amountSats: number): Promise<string>;
     signExitClaimInputs(psbtBase64: string): Promise<string>;
     spendableVtxos(): Promise<Vtxo[]>;
@@ -498,6 +532,12 @@ export class Wallet {
     stuckFailedLightningSends(): Promise<LightningSend[]>;
     sync(): Promise<void>;
     syncExits(onchainWallet: OnchainWallet): Promise<void>;
+    /**
+     * Scan for VTXOs that were force-exited on-chain without the user asking
+     * and route them into the unilateral-exit flow so the funds can be claimed.
+     * This already runs automatically as part of `sync`.
+     */
+    syncForceExitedVtxos(): Promise<void>;
     syncPendingBoards(): Promise<void>;
     tryClaimAllLightningReceives(args: TryClaimAllLightningReceivesArgs): Promise<LightningReceive[]>;
     tryClaimLightningReceive(args: TryClaimLightningReceiveArgs): Promise<void>;
@@ -531,11 +571,10 @@ export interface InitOutput {
     readonly onchainwallet_newAddress: (a: number) => number;
     readonly onchainwallet_send: (a: number, b: number, c: number, d: number, e: number) => number;
     readonly __wbg_wallet_free: (a: number, b: number) => void;
-    readonly wallet_create: (a: number) => number;
-    readonly wallet_open: (a: number) => number;
-    readonly wallet_createWithOnchain: (a: number, b: number) => number;
-    readonly wallet_openWithOnchain: (a: number, b: number) => number;
+    readonly wallet_open: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+    readonly wallet_create: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
     readonly wallet_sync: (a: number) => number;
+    readonly wallet_syncForceExitedVtxos: (a: number) => number;
     readonly wallet_maintenance: (a: number) => number;
     readonly wallet_maintenanceWithOnchain: (a: number, b: number) => number;
     readonly wallet_maintenanceDelegated: (a: number) => number;
@@ -608,7 +647,6 @@ export interface InitOutput {
     readonly wallet_refreshServer: (a: number) => number;
     readonly wallet_getFirstExpiringVtxoBlockheight: (a: number) => number;
     readonly wallet_getNextRequiredRefreshBlockheight: (a: number) => number;
-    readonly wallet_maybeScheduleMaintenanceRefresh: (a: number) => number;
     readonly wallet_broadcastTx: (a: number, b: number, c: number) => number;
     readonly wallet_mailboxIdentifier: (a: number, b: number) => void;
     readonly wallet_mailboxAuthorization: (a: number, b: number) => void;
@@ -643,16 +681,16 @@ export interface InitOutput {
     readonly rustsecp256k1_v0_10_0_context_destroy: (a: number) => void;
     readonly rustsecp256k1_v0_10_0_default_illegal_callback_fn: (a: number, b: number) => void;
     readonly rustsecp256k1_v0_10_0_default_error_callback_fn: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_728: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_15275: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_738: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_15278: (a: number, b: number, c: number) => number;
-    readonly __wasm_bindgen_func_elem_13590: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_13288: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_15277: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_12867: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_13744: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_19152: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_732: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_15631: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_740: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_15633: (a: number, b: number, c: number) => number;
+    readonly __wasm_bindgen_func_elem_13669: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_13382: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_15634: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_12963: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_13822: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_19550: (a: number, b: number) => void;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_export3: (a: number) => void;