@breeztech/breez-sdk-spark 0.23.1 → 0.24.1

package/deno/breez_sdk_spark_wasm.d.ts

@@ -203,6 +203,12 @@ export interface Wallet {
 export interface MysqlStorageConfig {
     /**
      * MySQL connection URL (e.g. `mysql://user:pass@host:3306/dbname`).
+     *
+     * TLS is controlled by the `ssl-mode` query parameter: `required` and
+     * `verify_identity` verify the server certificate chain and hostname,
+     * `verify_ca` verifies the chain only, `no-verify` encrypts without
+     * verification, and absent or `disabled` means no TLS. An unrecognized
+     * value fails instead of silently downgrading.
      */
     connectionString: string;
     /**
@@ -239,6 +245,13 @@ export interface MysqlStorageConfig {
 export interface PostgresStorageConfig {
     /**
      * PostgreSQL connection string (URI format).
+     *
+     * TLS is controlled by the `sslmode` query parameter: `prefer`,
+     * `require`, and `verify-full` require TLS and verify the server
+     * certificate chain and hostname; `verify-ca` verifies the chain only;
+     * `no-verify` encrypts without verification; absent or `disable` means
+     * no TLS. An unrecognized value fails instead of silently changing the
+     * TLS level.
      */
     connectionString: string;
     /**
@@ -275,6 +288,10 @@ export interface PasskeyConfig {
      * zero-config path.
      */
     providerOptions?: PasskeyProviderOptions;
+    /**
+     * Always rejected here: a SOCKS5 proxy cannot be honoured on WASM.
+     */
+    proxy?: ProxyConfig;
 }
 
 /**
@@ -492,6 +509,12 @@ export interface WasmSdkContextConfig {
      * context store their data in MySQL via the shared pool.
      */
     mysqlConfig?: MysqlStorageConfig;
+    /**
+     * Routes every connection opened by this context\'s shared clients
+     * through a SOCKS5 proxy. Not supported on WASM: setting this always
+     * fails validation.
+     */
+    proxy?: ProxyConfig;
 }
 
 export interface AddContactRequest {
@@ -550,6 +573,7 @@ export interface BitcoinChainService {
     getAddressUtxos(address: string): Promise<Utxo[]>;
     getAddressTxos(address: string): Promise<Utxo[]>;
     getTransactionStatus(txid: string): Promise<TxStatus>;
+    tipHeight(): Promise<number>;
     getTransactionHex(txid: string): Promise<string>;
     getOutspend(txid: string, vout: number): Promise<Outspend>;
     broadcastTransaction(tx: string): Promise<void>;
@@ -657,11 +681,18 @@ export interface CheckMessageResponse {
     isValid: boolean;
 }
 
+export interface ClaimDepositQuote {
+    confirmationsRequired: number;
+    creditAmountSats: number;
+    feeSats: number;
+    feeRateSatPerVbyte: number;
+    isEstimate: boolean;
+}
+
 export interface ClaimDepositRequest {
     txid: string;
     vout: number;
     maxFee?: MaxFee;
-    maxInstantFeeBps?: number;
 }
 
 export interface ClaimDepositResponse {
@@ -686,7 +717,6 @@ export interface Config {
     network: Network;
     syncIntervalSecs: number;
     maxDepositClaimFee?: MaxFee;
-    maxInstantDepositClaimFeeBps?: number;
     lnurlDomain?: string;
     preferSparkOverLightning: boolean;
     exitChainAutoFetchEnabled: boolean;
@@ -707,6 +737,12 @@ export interface Config {
     maxConcurrentClaims: number;
     sparkConfig?: SparkConfig;
     backgroundTasksEnabled: boolean;
+    /**
+     * Routes the connections the SDK opens through a SOCKS5 proxy. Not
+     * supported on WASM: setting this always fails validation, since the
+     * browser owns connection setup and exposes no proxy control.
+     */
+    proxy?: ProxyConfig;
     crossChainConfig?: CrossChainConfig;
 }
 
@@ -825,6 +861,7 @@ export interface DepositInfo {
     refundTxId?: string;
     claimError?: DepositClaimError;
     instantClaimStatus?: InstantClaimStatus;
+    refundState?: RefundState;
 }
 
 export interface EcdsaSignatureBytes {
@@ -1044,6 +1081,18 @@ export interface ExternalTreeNodeId {
     id: string;
 }
 
+export interface FetchClaimDepositQuoteRequest {
+    txid: string;
+    vout: number;
+}
+
+export interface FetchClaimDepositQuoteResponse {
+    amountSats: number;
+    confirmations: number;
+    instant?: ClaimDepositQuote;
+    mature: ClaimDepositQuote;
+}
+
 export interface FetchConversionLimitsRequest {
     conversionType: ConversionType;
     tokenIdentifier?: string;
@@ -1262,6 +1311,13 @@ export interface LnurlWithdrawRequestDetails {
     defaultDescription: string;
     minWithdrawable: number;
     maxWithdrawable: number;
+    /**
+     * The URL of the LNURL-withdraw endpoint these details were fetched from.
+     * Set when the details come from parsing an input; determines how far the
+     * withdraw flow trusts the endpoint-chosen `callback`. Absent or empty
+     * means no exemption: the callback is held to the public-host rules.
+     */
+    url?: string;
 }
 
 export interface LnurlWithdrawResponse {
@@ -1443,6 +1499,13 @@ export interface ProvisionalPayment {
     details: ProvisionalPaymentDetails;
 }
 
+export interface ProxyConfig {
+    host: string;
+    port: number;
+    username?: string;
+    password?: string;
+}
+
 export interface PublicKeyBytes {
     bytes: number[];
 }
@@ -1816,6 +1879,10 @@ export interface TurnkeyConfig {
     identityPublicKey?: string;
     retry?: TurnkeyRetryConfig;
     maxRps?: number;
+    /**
+     * Always rejected here: a SOCKS5 proxy cannot be honoured on WASM.
+     */
+    proxy?: ProxyConfig;
 }
 
 export interface TurnkeyRetryConfig {
@@ -1982,9 +2049,7 @@ export type FeePolicy = "feesExcluded" | "feesIncluded";
 
 export type InputType = ({ type: "bitcoinAddress" } & BitcoinAddressDetails) | ({ type: "bolt11Invoice" } & Bolt11InvoiceDetails) | ({ type: "bolt12Invoice" } & Bolt12InvoiceDetails) | ({ type: "bolt12Offer" } & Bolt12OfferDetails) | ({ type: "lightningAddress" } & LightningAddressDetails) | ({ type: "lnurlPay" } & LnurlPayRequestDetails) | ({ type: "silentPaymentAddress" } & SilentPaymentAddressDetails) | ({ type: "lnurlAuth" } & LnurlAuthRequestDetails) | ({ type: "url" } & string) | ({ type: "bip21" } & Bip21Details) | ({ type: "bolt12InvoiceRequest" } & Bolt12InvoiceRequestDetails) | ({ type: "lnurlWithdraw" } & LnurlWithdrawRequestDetails) | ({ type: "sparkAddress" } & SparkAddressDetails) | ({ type: "sparkInvoice" } & SparkInvoiceDetails) | ({ type: "crossChainAddress" } & CrossChainAddressDetails);
 
-export type InstantClaimDeclineReason = { type: "noPlan" } | { type: "feeExceeded"; maxBps: number; quotedBps: number; quotedSats: number } | { type: "submissionFailed" };
-
-export type InstantClaimStatus = { type: "declined"; reason: InstantClaimDeclineReason } | { type: "submitted"; claimId: string };
+export type InstantClaimStatus = { type: "declined"; maxFeeSats?: number; confirmations?: number } | { type: "submitted"; claimId: string };
 
 export type LnurlCallbackStatus = { type: "ok" } | { type: "errorStatus"; errorDetails: LnurlErrorDetails };
 
@@ -2020,6 +2085,8 @@ export type PublishSignedTransferPackageResponse = { type: "swapCompleted" } | {
 
 export type ReceivePaymentMethod = { type: "sparkAddress" } | { type: "sparkInvoice"; amount?: string; tokenIdentifier?: string; expiryTime?: number; description?: string; senderPublicKey?: string } | { type: "bitcoinAddress"; newAddress?: boolean } | { type: "bolt11Invoice"; description: string; amountSats?: number; expirySecs?: number; paymentHash?: string; receiverIdentityPublicKey?: string };
 
+export type RefundState = { type: "broadcastPending"; lastError?: string } | { type: "broadcast" };
+
 export type SdkEvent = { type: "synced" } | { type: "unclaimedDeposits"; unclaimedDeposits: DepositInfo[] } | { type: "claimedDeposits"; claimedDeposits: DepositInfo[] } | { type: "paymentSucceeded"; payment: Payment } | { type: "paymentPending"; payment: Payment } | { type: "paymentFailed"; payment: Payment } | { type: "autoOptimization"; optimizationEvent: AutoOptimizationEvent } | { type: "lightningAddressChanged"; lightningAddress?: LightningAddressInfo } | { type: "newDeposits"; newDeposits: DepositInfo[] } | { type: "unilateralExitStateChanged" };
 
 export type Seed = { type: "mnemonic"; mnemonic: string; passphrase?: string } | ({ type: "entropy" } & number[]);
@@ -2060,7 +2127,7 @@ export type UnilateralExitTxKind = "fanOut" | "node" | "refund" | "sweep";
 
 export type UnsignedTransferPackage = { type: "swap"; prepareTransfer: ExternalPrepareTransferRequest; targetAmounts: number[]; amountSat: number; feeSat: number } | { type: "transfer"; prepareTransfer: ExternalPrepareTransferRequest; amountSat: number; feeSat: number; target: TransferTarget } | { type: "token"; prepareTokenTransaction: ExternalPrepareTokenTransactionRequest; tokenContext: number[]; tokenIdentifier: string; amount: string; fee: string; isSwap: boolean } | { type: "tokenBatch"; prepareTokenTransaction: ExternalPrepareTokenTransactionRequest; tokenContext: number[]; totals: BatchTotal[]; isSwap: boolean };
 
-export type UpdateDepositPayload = { type: "claimError"; error: DepositClaimError } | { type: "refund"; refundTxid: string; refundTx: string } | { type: "instantClaim"; status: InstantClaimStatus };
+export type UpdateDepositPayload = { type: "claimError"; error: DepositClaimError } | { type: "refund"; refundTxid: string; refundTx: string; state: RefundState } | { type: "instantClaim"; status: InstantClaimStatus } | { type: "refundBroadcastState"; refundTxid: string; state: RefundState };
 
 export type WebhookEventType = { type: "lightningReceiveFinished" } | { type: "lightningSendFinished" } | { type: "coopExitFinished" } | { type: "staticDepositFinished" } | ({ type: "unknown" } & string);
 
@@ -2084,6 +2151,7 @@ export class BitcoinChainServiceHandle {
     getTransactionHex(txid: string): Promise<any>;
     getTransactionStatus(txid: string): Promise<any>;
     recommendedFees(): Promise<any>;
+    tipHeight(): Promise<any>;
 }
 
 export class BreezSdk {
@@ -2106,6 +2174,7 @@ export class BreezSdk {
     deleteLightningAddress(): Promise<void>;
     disconnect(): Promise<void>;
     exportUnilateralExitState(): Promise<ExportUnilateralExitStateResponse>;
+    fetchClaimDepositQuote(request: FetchClaimDepositQuoteRequest): Promise<FetchClaimDepositQuoteResponse>;
     fetchConversionLimits(request: FetchConversionLimitsRequest): Promise<FetchConversionLimitsResponse>;
     getCrossChainRoutes(filter: CrossChainRouteFilter): Promise<CrossChainRoutePair[]>;
     getInfo(request: GetInfoRequest): Promise<GetInfoResponse>;

package/deno/breez_sdk_spark_wasm.js

@@ -93,6 +93,13 @@ export class BitcoinChainServiceHandle {
         const ret = wasm.bitcoinchainservicehandle_recommendedFees(this.__wbg_ptr);
         return ret;
     }
+    /**
+     * @returns {Promise<any>}
+     */
+    tipHeight() {
+        const ret = wasm.bitcoinchainservicehandle_tipHeight(this.__wbg_ptr);
+        return ret;
+    }
 }
 if (Symbol.dispose) BitcoinChainServiceHandle.prototype[Symbol.dispose] = BitcoinChainServiceHandle.prototype.free;
 
@@ -240,6 +247,14 @@ export class BreezSdk {
         const ret = wasm.breezsdk_exportUnilateralExitState(this.__wbg_ptr);
         return ret;
     }
+    /**
+     * @param {FetchClaimDepositQuoteRequest} request
+     * @returns {Promise<FetchClaimDepositQuoteResponse>}
+     */
+    fetchClaimDepositQuote(request) {
+        const ret = wasm.breezsdk_fetchClaimDepositQuote(this.__wbg_ptr, request);
+        return ret;
+    }
     /**
      * @param {FetchConversionLimitsRequest} request
      * @returns {Promise<FetchConversionLimitsResponse>}
@@ -1220,7 +1235,10 @@ export class PasskeyClient {
         var ptr0 = isLikeNone(breez_api_key) ? 0 : passStringToWasm0(breez_api_key, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         var len0 = WASM_VECTOR_LEN;
         const ret = wasm.passkeyclient_new(prf_provider, ptr0, len0, isLikeNone(config) ? 0 : addToExternrefTable0(config));
-        this.__wbg_ptr = ret;
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        this.__wbg_ptr = ret[0];
         PasskeyClientFinalization.register(this, this.__wbg_ptr, this);
         return this;
     }
@@ -2102,10 +2120,6 @@ function __wbg_get_imports() {
             const ret = arg0.applyPaymentUpdate(arg1);
             return ret;
         }, arguments); },
-        __wbg_arrayBuffer_87e3ac06d961f7a0: function() { return handleError(function (arg0) {
-            const ret = arg0.arrayBuffer();
-            return ret;
-        }, arguments); },
         __wbg_beforeSend_e8a50acd6afd73ed: function() { return handleError(function (arg0, arg1, arg2) {
             var v0 = getArrayJsValueFromWasm0(arg1, arg2).slice();
             wasm.__wbindgen_free(arg1, arg2 * 4, 4);
@@ -3504,10 +3518,6 @@ function __wbg_get_imports() {
             const ret = arg0.syncUpdateRecordFromIncoming(arg1);
             return ret;
         }, arguments); },
-        __wbg_text_de416916b5c06490: function() { return handleError(function (arg0) {
-            const ret = arg0.text();
-            return ret;
-        }, arguments); },
         __wbg_then_20a157d939b514f5: function(arg0, arg1) {
             const ret = arg0.then(arg1);
             return ret;
@@ -3516,6 +3526,10 @@ function __wbg_get_imports() {
             const ret = arg0.then(arg1, arg2);
             return ret;
         },
+        __wbg_tipHeight_e14ddf8ed9a68d5a: function() { return handleError(function (arg0) {
+            const ret = arg0.tipHeight();
+            return ret;
+        }, arguments); },
         __wbg_toString_15656af8d8e71f16: function(arg0, arg1, arg2) {
             const ret = arg1.toString(arg2);
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -3623,27 +3637,27 @@ function __wbg_get_imports() {
             return ret;
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 395, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 400, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h3120db8c4a8a92b2);
             return ret;
         },
         __wbindgen_cast_0000000000000003: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("CloseEvent")], shim_idx: 395, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("CloseEvent")], shim_idx: 400, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h3120db8c4a8a92b2_2);
             return ret;
         },
         __wbindgen_cast_0000000000000004: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("ErrorEvent")], shim_idx: 395, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("ErrorEvent")], shim_idx: 400, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h3120db8c4a8a92b2_3);
             return ret;
         },
         __wbindgen_cast_0000000000000005: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("Event")], shim_idx: 395, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("Event")], shim_idx: 400, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h3120db8c4a8a92b2_4);
             return ret;
         },
         __wbindgen_cast_0000000000000006: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("MessageEvent")], shim_idx: 395, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("MessageEvent")], shim_idx: 400, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h3120db8c4a8a92b2_5);
             return ret;
         },
@@ -3668,12 +3682,12 @@ function __wbg_get_imports() {
             return ret;
         },
         __wbindgen_cast_000000000000000b: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 400, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h1d6669a7b693932a);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 405, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h484cd36e13f37bd7);
             return ret;
         },
         __wbindgen_cast_000000000000000c: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 429, ret: Unit, inner_ret: Some(Unit) }, mutable: false }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 434, ret: Unit, inner_ret: Some(Unit) }, mutable: false }) -> Externref`.
             const ret = makeClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h0fa3f876e31d2a3e);
             return ret;
         },
@@ -3765,8 +3779,8 @@ function __wbg_get_imports() {
     };
 }
 
-function wasm_bindgen__convert__closures_____invoke__h1d6669a7b693932a(arg0, arg1) {
-    wasm.wasm_bindgen__convert__closures_____invoke__h1d6669a7b693932a(arg0, arg1);
+function wasm_bindgen__convert__closures_____invoke__h484cd36e13f37bd7(arg0, arg1) {
+    wasm.wasm_bindgen__convert__closures_____invoke__h484cd36e13f37bd7(arg0, arg1);
 }
 
 function wasm_bindgen__convert__closures_____invoke__h0fa3f876e31d2a3e(arg0, arg1) {

package/deno/breez_sdk_spark_wasm_bg.wasm.d.ts

@@ -18,6 +18,7 @@ export const bitcoinchainservicehandle_getOutspend: (a: number, b: number, c: nu
 export const bitcoinchainservicehandle_getTransactionHex: (a: number, b: number, c: number) => any;
 export const bitcoinchainservicehandle_getTransactionStatus: (a: number, b: number, c: number) => any;
 export const bitcoinchainservicehandle_recommendedFees: (a: number) => any;
+export const bitcoinchainservicehandle_tipHeight: (a: number) => any;
 export const breezsdk_addContact: (a: number, b: any) => any;
 export const breezsdk_addEventListener: (a: number, b: any) => any;
 export const breezsdk_authorizeLightningAddressTransfer: (a: number, b: any) => any;
@@ -34,6 +35,7 @@ export const breezsdk_deleteContact: (a: number, b: number, c: number) => any;
 export const breezsdk_deleteLightningAddress: (a: number) => any;
 export const breezsdk_disconnect: (a: number) => any;
 export const breezsdk_exportUnilateralExitState: (a: number) => any;
+export const breezsdk_fetchClaimDepositQuote: (a: number, b: any) => any;
 export const breezsdk_fetchConversionLimits: (a: number, b: any) => any;
 export const breezsdk_getCrossChainRoutes: (a: number, b: any) => any;
 export const breezsdk_getInfo: (a: number, b: any) => any;
@@ -128,7 +130,7 @@ export const newSharedSdkContext: (a: any) => any;
 export const passkeyclient_checkAvailability: (a: number) => any;
 export const passkeyclient_connectWithPasskey: (a: number, b: any) => any;
 export const passkeyclient_labels: (a: number) => number;
-export const passkeyclient_new: (a: any, b: number, c: number, d: number) => number;
+export const passkeyclient_new: (a: any, b: number, c: number, d: number) => [number, number, number];
 export const passkeyclient_register: (a: number, b: any) => any;
 export const passkeyclient_signIn: (a: number, b: any) => any;
 export const passkeyclient_supportsImmediateMediation: (a: number) => any;
@@ -181,8 +183,8 @@ export const intounderlyingsource_cancel: (a: number) => void;
 export const intounderlyingsource_pull: (a: number, b: any) => any;
 export const __wbg_externalbreezsignerhandle_free: (a: number, b: number) => void;
 export const __wbg_defaultsessionstore_free: (a: number, b: number) => void;
-export const __wbg_externalsparksignerhandle_free: (a: number, b: number) => void;
 export const __wbg_externalsigningsignerhandle_free: (a: number, b: number) => void;
+export const __wbg_externalsparksignerhandle_free: (a: number, b: number) => void;
 export const __wbg_signingonlyexternalsigners_free: (a: number, b: number) => void;
 export const signingonlyexternalsigners_breezSigner: (a: number) => number;
 export const signingonlyexternalsigners_sparkSigner: (a: number) => number;
@@ -197,7 +199,7 @@ export const wasm_bindgen__convert__closures_____invoke__h3120db8c4a8a92b2_2: (a
 export const wasm_bindgen__convert__closures_____invoke__h3120db8c4a8a92b2_3: (a: number, b: number, c: any) => void;
 export const wasm_bindgen__convert__closures_____invoke__h3120db8c4a8a92b2_4: (a: number, b: number, c: any) => void;
 export const wasm_bindgen__convert__closures_____invoke__h3120db8c4a8a92b2_5: (a: number, b: number, c: any) => void;
-export const wasm_bindgen__convert__closures_____invoke__h1d6669a7b693932a: (a: number, b: number) => void;
+export const wasm_bindgen__convert__closures_____invoke__h484cd36e13f37bd7: (a: number, b: number) => void;
 export const wasm_bindgen__convert__closures_____invoke__h0fa3f876e31d2a3e: (a: number, b: number) => void;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;

package/nodejs/breez_sdk_spark_wasm.d.ts

@@ -203,6 +203,12 @@ export interface Wallet {
 export interface MysqlStorageConfig {
     /**
      * MySQL connection URL (e.g. `mysql://user:pass@host:3306/dbname`).
+     *
+     * TLS is controlled by the `ssl-mode` query parameter: `required` and
+     * `verify_identity` verify the server certificate chain and hostname,
+     * `verify_ca` verifies the chain only, `no-verify` encrypts without
+     * verification, and absent or `disabled` means no TLS. An unrecognized
+     * value fails instead of silently downgrading.
      */
     connectionString: string;
     /**
@@ -239,6 +245,13 @@ export interface MysqlStorageConfig {
 export interface PostgresStorageConfig {
     /**
      * PostgreSQL connection string (URI format).
+     *
+     * TLS is controlled by the `sslmode` query parameter: `prefer`,
+     * `require`, and `verify-full` require TLS and verify the server
+     * certificate chain and hostname; `verify-ca` verifies the chain only;
+     * `no-verify` encrypts without verification; absent or `disable` means
+     * no TLS. An unrecognized value fails instead of silently changing the
+     * TLS level.
      */
     connectionString: string;
     /**
@@ -275,6 +288,10 @@ export interface PasskeyConfig {
      * zero-config path.
      */
     providerOptions?: PasskeyProviderOptions;
+    /**
+     * Always rejected here: a SOCKS5 proxy cannot be honoured on WASM.
+     */
+    proxy?: ProxyConfig;
 }
 
 /**
@@ -492,6 +509,12 @@ export interface WasmSdkContextConfig {
      * context store their data in MySQL via the shared pool.
      */
     mysqlConfig?: MysqlStorageConfig;
+    /**
+     * Routes every connection opened by this context\'s shared clients
+     * through a SOCKS5 proxy. Not supported on WASM: setting this always
+     * fails validation.
+     */
+    proxy?: ProxyConfig;
 }
 
 export interface AddContactRequest {
@@ -550,6 +573,7 @@ export interface BitcoinChainService {
     getAddressUtxos(address: string): Promise<Utxo[]>;
     getAddressTxos(address: string): Promise<Utxo[]>;
     getTransactionStatus(txid: string): Promise<TxStatus>;
+    tipHeight(): Promise<number>;
     getTransactionHex(txid: string): Promise<string>;
     getOutspend(txid: string, vout: number): Promise<Outspend>;
     broadcastTransaction(tx: string): Promise<void>;
@@ -657,11 +681,18 @@ export interface CheckMessageResponse {
     isValid: boolean;
 }
 
+export interface ClaimDepositQuote {
+    confirmationsRequired: number;
+    creditAmountSats: number;
+    feeSats: number;
+    feeRateSatPerVbyte: number;
+    isEstimate: boolean;
+}
+
 export interface ClaimDepositRequest {
     txid: string;
     vout: number;
     maxFee?: MaxFee;
-    maxInstantFeeBps?: number;
 }
 
 export interface ClaimDepositResponse {
@@ -686,7 +717,6 @@ export interface Config {
     network: Network;
     syncIntervalSecs: number;
     maxDepositClaimFee?: MaxFee;
-    maxInstantDepositClaimFeeBps?: number;
     lnurlDomain?: string;
     preferSparkOverLightning: boolean;
     exitChainAutoFetchEnabled: boolean;
@@ -707,6 +737,12 @@ export interface Config {
     maxConcurrentClaims: number;
     sparkConfig?: SparkConfig;
     backgroundTasksEnabled: boolean;
+    /**
+     * Routes the connections the SDK opens through a SOCKS5 proxy. Not
+     * supported on WASM: setting this always fails validation, since the
+     * browser owns connection setup and exposes no proxy control.
+     */
+    proxy?: ProxyConfig;
     crossChainConfig?: CrossChainConfig;
 }
 
@@ -825,6 +861,7 @@ export interface DepositInfo {
     refundTxId?: string;
     claimError?: DepositClaimError;
     instantClaimStatus?: InstantClaimStatus;
+    refundState?: RefundState;
 }
 
 export interface EcdsaSignatureBytes {
@@ -1044,6 +1081,18 @@ export interface ExternalTreeNodeId {
     id: string;
 }
 
+export interface FetchClaimDepositQuoteRequest {
+    txid: string;
+    vout: number;
+}
+
+export interface FetchClaimDepositQuoteResponse {
+    amountSats: number;
+    confirmations: number;
+    instant?: ClaimDepositQuote;
+    mature: ClaimDepositQuote;
+}
+
 export interface FetchConversionLimitsRequest {
     conversionType: ConversionType;
     tokenIdentifier?: string;
@@ -1262,6 +1311,13 @@ export interface LnurlWithdrawRequestDetails {
     defaultDescription: string;
     minWithdrawable: number;
     maxWithdrawable: number;
+    /**
+     * The URL of the LNURL-withdraw endpoint these details were fetched from.
+     * Set when the details come from parsing an input; determines how far the
+     * withdraw flow trusts the endpoint-chosen `callback`. Absent or empty
+     * means no exemption: the callback is held to the public-host rules.
+     */
+    url?: string;
 }
 
 export interface LnurlWithdrawResponse {
@@ -1443,6 +1499,13 @@ export interface ProvisionalPayment {
     details: ProvisionalPaymentDetails;
 }
 
+export interface ProxyConfig {
+    host: string;
+    port: number;
+    username?: string;
+    password?: string;
+}
+
 export interface PublicKeyBytes {
     bytes: number[];
 }
@@ -1816,6 +1879,10 @@ export interface TurnkeyConfig {
     identityPublicKey?: string;
     retry?: TurnkeyRetryConfig;
     maxRps?: number;
+    /**
+     * Always rejected here: a SOCKS5 proxy cannot be honoured on WASM.
+     */
+    proxy?: ProxyConfig;
 }
 
 export interface TurnkeyRetryConfig {
@@ -1982,9 +2049,7 @@ export type FeePolicy = "feesExcluded" | "feesIncluded";
 
 export type InputType = ({ type: "bitcoinAddress" } & BitcoinAddressDetails) | ({ type: "bolt11Invoice" } & Bolt11InvoiceDetails) | ({ type: "bolt12Invoice" } & Bolt12InvoiceDetails) | ({ type: "bolt12Offer" } & Bolt12OfferDetails) | ({ type: "lightningAddress" } & LightningAddressDetails) | ({ type: "lnurlPay" } & LnurlPayRequestDetails) | ({ type: "silentPaymentAddress" } & SilentPaymentAddressDetails) | ({ type: "lnurlAuth" } & LnurlAuthRequestDetails) | ({ type: "url" } & string) | ({ type: "bip21" } & Bip21Details) | ({ type: "bolt12InvoiceRequest" } & Bolt12InvoiceRequestDetails) | ({ type: "lnurlWithdraw" } & LnurlWithdrawRequestDetails) | ({ type: "sparkAddress" } & SparkAddressDetails) | ({ type: "sparkInvoice" } & SparkInvoiceDetails) | ({ type: "crossChainAddress" } & CrossChainAddressDetails);
 
-export type InstantClaimDeclineReason = { type: "noPlan" } | { type: "feeExceeded"; maxBps: number; quotedBps: number; quotedSats: number } | { type: "submissionFailed" };
-
-export type InstantClaimStatus = { type: "declined"; reason: InstantClaimDeclineReason } | { type: "submitted"; claimId: string };
+export type InstantClaimStatus = { type: "declined"; maxFeeSats?: number; confirmations?: number } | { type: "submitted"; claimId: string };
 
 export type LnurlCallbackStatus = { type: "ok" } | { type: "errorStatus"; errorDetails: LnurlErrorDetails };
 
@@ -2020,6 +2085,8 @@ export type PublishSignedTransferPackageResponse = { type: "swapCompleted" } | {
 
 export type ReceivePaymentMethod = { type: "sparkAddress" } | { type: "sparkInvoice"; amount?: string; tokenIdentifier?: string; expiryTime?: number; description?: string; senderPublicKey?: string } | { type: "bitcoinAddress"; newAddress?: boolean } | { type: "bolt11Invoice"; description: string; amountSats?: number; expirySecs?: number; paymentHash?: string; receiverIdentityPublicKey?: string };
 
+export type RefundState = { type: "broadcastPending"; lastError?: string } | { type: "broadcast" };
+
 export type SdkEvent = { type: "synced" } | { type: "unclaimedDeposits"; unclaimedDeposits: DepositInfo[] } | { type: "claimedDeposits"; claimedDeposits: DepositInfo[] } | { type: "paymentSucceeded"; payment: Payment } | { type: "paymentPending"; payment: Payment } | { type: "paymentFailed"; payment: Payment } | { type: "autoOptimization"; optimizationEvent: AutoOptimizationEvent } | { type: "lightningAddressChanged"; lightningAddress?: LightningAddressInfo } | { type: "newDeposits"; newDeposits: DepositInfo[] } | { type: "unilateralExitStateChanged" };
 
 export type Seed = { type: "mnemonic"; mnemonic: string; passphrase?: string } | ({ type: "entropy" } & number[]);
@@ -2060,7 +2127,7 @@ export type UnilateralExitTxKind = "fanOut" | "node" | "refund" | "sweep";
 
 export type UnsignedTransferPackage = { type: "swap"; prepareTransfer: ExternalPrepareTransferRequest; targetAmounts: number[]; amountSat: number; feeSat: number } | { type: "transfer"; prepareTransfer: ExternalPrepareTransferRequest; amountSat: number; feeSat: number; target: TransferTarget } | { type: "token"; prepareTokenTransaction: ExternalPrepareTokenTransactionRequest; tokenContext: number[]; tokenIdentifier: string; amount: string; fee: string; isSwap: boolean } | { type: "tokenBatch"; prepareTokenTransaction: ExternalPrepareTokenTransactionRequest; tokenContext: number[]; totals: BatchTotal[]; isSwap: boolean };
 
-export type UpdateDepositPayload = { type: "claimError"; error: DepositClaimError } | { type: "refund"; refundTxid: string; refundTx: string } | { type: "instantClaim"; status: InstantClaimStatus };
+export type UpdateDepositPayload = { type: "claimError"; error: DepositClaimError } | { type: "refund"; refundTxid: string; refundTx: string; state: RefundState } | { type: "instantClaim"; status: InstantClaimStatus } | { type: "refundBroadcastState"; refundTxid: string; state: RefundState };
 
 export type WebhookEventType = { type: "lightningReceiveFinished" } | { type: "lightningSendFinished" } | { type: "coopExitFinished" } | { type: "staticDepositFinished" } | ({ type: "unknown" } & string);
 
@@ -2084,6 +2151,7 @@ export class BitcoinChainServiceHandle {
     getTransactionHex(txid: string): Promise<any>;
     getTransactionStatus(txid: string): Promise<any>;
     recommendedFees(): Promise<any>;
+    tipHeight(): Promise<any>;
 }
 
 export class BreezSdk {
@@ -2106,6 +2174,7 @@ export class BreezSdk {
     deleteLightningAddress(): Promise<void>;
     disconnect(): Promise<void>;
     exportUnilateralExitState(): Promise<ExportUnilateralExitStateResponse>;
+    fetchClaimDepositQuote(request: FetchClaimDepositQuoteRequest): Promise<FetchClaimDepositQuoteResponse>;
     fetchConversionLimits(request: FetchConversionLimitsRequest): Promise<FetchConversionLimitsResponse>;
     getCrossChainRoutes(filter: CrossChainRouteFilter): Promise<CrossChainRoutePair[]>;
     getInfo(request: GetInfoRequest): Promise<GetInfoResponse>;