@breeztech/breez-sdk-spark 0.19.2 → 0.21.0

package/nodejs/postgres-tree-store/index.cjs

@@ -40,6 +40,16 @@ const RESERVATION_TIMEOUT_SECS = 300; // 5 minutes
  */
 const SPENT_MARKER_CLEANUP_THRESHOLD_MS = 5 * 60 * 1000; // 5 minutes
 
+/**
+ * Leaves per INSERT when upserting a refreshed leaf set.
+ *
+ * A wallet can hold six figures of leaves, each serializing to a JSON blob
+ * carrying up to five transactions. Building that as a single statement
+ * materializes the whole set at once, which is the largest allocation in a
+ * refresh and lands at its very end.
+ */
+const LEAF_UPSERT_CHUNK_SIZE = 1000;
+
 /**
  * Slim projection: only (id, value) for leaves the selection might use.
  * Includes all leaves with value <= $2 (covers exact-match + the small-leaf
@@ -1019,23 +1029,29 @@ class PostgresTreeStore {
 
     if (filtered.length === 0) return;
 
-    const ids = filtered.map((l) => l.id);
-    const statuses = filtered.map((l) => l.status);
-    const missingFlags = filtered.map(() => isMissingFromOperators);
-    const dataValues = filtered.map((l) => JSON.stringify(l));
-
-    await client.query(
-      `INSERT INTO brz_tree_leaves (user_id, id, status, is_missing_from_operators, data, added_at)
-       SELECT $5, id, status, missing, data::jsonb, NOW()
-       FROM UNNEST($1::text[], $2::text[], $3::bool[], $4::text[])
-           AS t(id, status, missing, data)
-       ON CONFLICT (user_id, id) DO UPDATE SET
-         status = EXCLUDED.status,
-         is_missing_from_operators = EXCLUDED.is_missing_from_operators,
-         data = EXCLUDED.data,
-         added_at = NOW()`,
-      [ids, statuses, missingFlags, dataValues, this.identity]
-    );
+    // All chunks run inside the caller's transaction, and NOW() is the
+    // transaction timestamp, so every row still lands atomically with one
+    // shared added_at.
+    for (let i = 0; i < filtered.length; i += LEAF_UPSERT_CHUNK_SIZE) {
+      const chunk = filtered.slice(i, i + LEAF_UPSERT_CHUNK_SIZE);
+      const ids = chunk.map((l) => l.id);
+      const statuses = chunk.map((l) => l.status);
+      const missingFlags = chunk.map(() => isMissingFromOperators);
+      const dataValues = chunk.map((l) => JSON.stringify(l));
+
+      await client.query(
+        `INSERT INTO brz_tree_leaves (user_id, id, status, is_missing_from_operators, data, added_at)
+         SELECT $5, id, status, missing, data::jsonb, NOW()
+         FROM UNNEST($1::text[], $2::text[], $3::bool[], $4::text[])
+             AS t(id, status, missing, data)
+         ON CONFLICT (user_id, id) DO UPDATE SET
+           status = EXCLUDED.status,
+           is_missing_from_operators = EXCLUDED.is_missing_from_operators,
+           data = EXCLUDED.data,
+           added_at = NOW()`,
+        [ids, statuses, missingFlags, dataValues, this.identity]
+      );
+    }
   }
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@breeztech/breez-sdk-spark",
-    "version": "0.19.2",
+    "version": "0.21.0",
     "description": "Breez Spark SDK",
     "repository": "https://github.com/breez/spark-sdk",
     "author": "Breez <contact@breez.technology> (https://github.com/breez)",

package/ssr/index.js

@@ -113,6 +113,11 @@ export function postgresStorage(...args) {
   return _module.postgresStorage(...args);
 }
 
+export function singleKeyCpfpSigner(...args) {
+  if (!_module) _notInitialized('singleKeyCpfpSigner');
+  return _module.singleKeyCpfpSigner(...args);
+}
+
 export function start(...args) {
   if (!_module) _notInitialized('start');
   return _module.start(...args);
@@ -142,6 +147,13 @@ export class BreezSdk {
   }
 }
 
+export class DefaultCpfpSigner {
+  constructor(...args) {
+    if (!_module) _notInitialized('new DefaultCpfpSigner');
+    return new _module.DefaultCpfpSigner(...args);
+  }
+}
+
 export class DefaultSessionStore {
   constructor(...args) {
     if (!_module) _notInitialized('new DefaultSessionStore');

package/web/breez_sdk_spark_wasm.d.ts

@@ -89,7 +89,7 @@ interface WasmTokenOutputWithPrevOut {
 }
 
 interface WasmTokenOutputs {
-    metadata: WasmTokenMetadata;
+    metadata: WasmTokenMetadata[];
     outputs: WasmTokenOutputWithPrevOut[];
 }
 
@@ -119,26 +119,23 @@ type WasmReservationTarget =
 | { type: 'maxOutputCount'; value: number };
 
 export interface TokenStore {
-    setTokensOutputs: (tokenOutputs: WasmTokenOutputs[], refreshStartedAtMs: number) => Promise<void>;
+    setTokensOutputs: (tokenOutputs: WasmTokenOutputs, refreshStartedAtMs: number) => Promise<void>;
     listTokensOutputs: () => Promise<WasmTokenOutputsPerStatus[]>;
     getTokenBalances: () => Promise<WasmTokenBalance[]>;
     getTokenOutputs: (filter: WasmGetTokenOutputsFilter) => Promise<WasmTokenOutputsPerStatus>;
-    updateTokenOutputs: (outputsToRemove: [string, number][], outputsToAdd: WasmTokenOutputs | null) => Promise<void>;
+    updateTokenOutputs: (outputsToRemove: [string, number][], outputsToAdd: WasmTokenOutputs) => Promise<void>;
     reserveTokenOutputs: (
-    tokenIdentifier: string,
-    target: WasmReservationTarget,
+    targets: [string, WasmReservationTarget][],
     purpose: string,
     preferredOutputs: WasmTokenOutputWithPrevOut[] | null,
     selectionStrategy: string | null
     ) => Promise<WasmTokenOutputsReservation>;
     selectTokenOutputs: (
-    tokenIdentifier: string,
-    target: WasmReservationTarget,
+    targets: [string, WasmReservationTarget][],
     preferredOutputs: WasmTokenOutputWithPrevOut[] | null,
     selectionStrategy: string | null
     ) => Promise<WasmTokenOutputs>;
     reserveTokenOutputsByOutpoints: (
-    tokenIdentifier: string,
     outpoints: { prevTxHash: string; prevTxVout: number }[],
     purpose: string
     ) => Promise<WasmTokenOutputsReservation>;
@@ -147,6 +144,20 @@ export interface TokenStore {
     now: () => Promise<number>;
 }
 
+/**
+ * A created credential, plus the PRF outputs when the browser evaluated
+ * them during the create ceremony. `seeds` is null when it did not, so
+ * the caller derives through `deriveSeeds`.
+ *
+ * Seeds returned here must equal what `deriveSeeds` returns for the same
+ * salts: the wallet is derived from them either way, so a mismatch means
+ * register and sign-in land on different wallets.
+ */
+export interface CreatePasskeyOutput {
+    credential: PasskeyCredential;
+    seeds?: Uint8Array[] | null;
+}
+
 /**
  * A passkey credential from `register` or `signIn`. `credentialId` is
  * always set. The attestation fields (`userId`, `aaguid`,
@@ -297,10 +308,14 @@ export interface PrfProvider {
      * `excludeCredentials` lists already-registered IDs; a match raises
      * `PasskeyAlreadyExistsError`.
      *
+     * Evaluating PRF for `salts` in the same ceremony returns the seeds on
+     * `seeds`, and the caller then needs no assertion. Return `seeds: null`
+     * when the authenticator evaluated none, or fewer than one per salt.
+     *
      * @throws `PasskeyAlreadyExistsError` when an entry in
      *   `excludeCredentials` matches a credential already on the device.
      */
-    createPasskey?(excludeCredentials: Uint8Array[]): Promise<PasskeyCredential>;
+    createPasskey?(excludeCredentials: Uint8Array[], salts: string[]): Promise<CreatePasskeyOutput>;
 
     /**
      * Whether this provider can produce PRF outputs on the current
@@ -488,6 +503,17 @@ export interface AuthorizeTransferRequest {
     transfereePubkey: string;
 }
 
+export interface BatchRecipient {
+    paymentRequest: string;
+    amount?: bigint;
+    tokenIdentifier?: string;
+}
+
+export interface BatchTotal {
+    tokenIdentifier?: string;
+    amount: bigint;
+}
+
 export interface Bip21Details {
     amountSat?: number;
     assetId?: string;
@@ -511,8 +537,10 @@ export interface BitcoinAddressDetails {
 
 export interface BitcoinChainService {
     getAddressUtxos(address: string): Promise<Utxo[]>;
+    getAddressTxos(address: string): Promise<Utxo[]>;
     getTransactionStatus(txid: string): Promise<TxStatus>;
     getTransactionHex(txid: string): Promise<string>;
+    getOutspend(txid: string, vout: number): Promise<Outspend>;
     broadcastTransaction(tx: string): Promise<void>;
     recommendedFees(): Promise<RecommendedFees>;
 }
@@ -583,6 +611,10 @@ export interface Bolt12OfferDetails {
     signingPubkey?: string;
 }
 
+export interface BuildUnsignedBatchPackageRequest {
+    prepareResponse: PrepareSendBatchResponse;
+}
+
 export interface BuildUnsignedLnurlPayPackageRequest {
     prepareResponse: PrepareLnurlPayResponse;
 }
@@ -718,6 +750,10 @@ export interface ConversionSide {
     fee: string;
 }
 
+export interface CpfpSigner {
+    signPsbt(psbtBytes: Uint8Array): Promise<Uint8Array>;
+}
+
 export interface CreateIssuerTokenRequest {
     name: string;
     ticker: string;
@@ -955,6 +991,7 @@ export interface ExternalSparkSigner {
     getStaticDepositPublicKey(index: number): Promise<PublicKeyBytes>;
     signAuthenticationChallenge(challenge: Uint8Array): Promise<EcdsaSignatureBytes>;
     signMessage(message: Uint8Array): Promise<EcdsaSignatureBytes>;
+    signLeafRefundSpend(leafId: ExternalTreeNodeId, sighash: Uint8Array): Promise<SchnorrSignatureBytes>;
     signFrost(jobs: ExternalFrostJob[]): Promise<ExternalFrostShareResult[]>;
     prepareTransfer(request: ExternalPrepareTransferRequest): Promise<ExternalPreparedTransfer>;
     prepareClaim(request: ExternalPrepareClaimRequest): Promise<ExternalPreparedClaim>;
@@ -1282,6 +1319,11 @@ export interface PaymentRequestSource {
     bip353Address?: string;
 }
 
+export interface PerBranchFunding {
+    leafId: string;
+    fundingSat: number;
+}
+
 export interface PrepareLnurlPayRequest {
     amount: bigint;
     comment?: string;
@@ -1303,6 +1345,15 @@ export interface PrepareLnurlPayResponse {
     feePolicy: FeePolicy;
 }
 
+export interface PrepareSendBatchRequest {
+    recipients: BatchRecipient[];
+}
+
+export interface PrepareSendBatchResponse {
+    recipients: ResolvedBatchRecipient[];
+    totals: BatchTotal[];
+}
+
 export interface PrepareSendPaymentRequest {
     paymentRequest: PaymentRequest;
     amount?: bigint;
@@ -1319,6 +1370,24 @@ export interface PrepareSendPaymentResponse {
     feePolicy: FeePolicy;
 }
 
+export interface PrepareUnilateralExitRequest {
+    feeRateSatPerVbyte: number;
+    fundingKind: CpfpFundingKind;
+    destination: string;
+    selection: ExitLeafSelection;
+}
+
+export interface PrepareUnilateralExitResponse {
+    leaves: UnilateralExitLeaf[];
+    recoverableValueSat: number;
+    totalFeeSat: number;
+    fanoutFeeSat: number;
+    singleUtxoFundingSat: number;
+    perBranchFunding: PerBranchFunding[];
+    feeRateSatPerVbyte: number;
+    destination: string;
+}
+
 export interface ProvisionalPayment {
     paymentId: string;
     amount: bigint;
@@ -1394,6 +1463,12 @@ export interface RefundDepositResponse {
     txHex: string;
 }
 
+export interface RefundPendingConversionsResponse {
+    refunded: number;
+    skipped: number;
+    failed: number;
+}
+
 export interface RegisterLightningAddressRequest {
     username: string;
     description?: string;
@@ -1409,6 +1484,12 @@ export interface RegisterWebhookResponse {
     webhookId: string;
 }
 
+export interface ResolvedBatchRecipient {
+    destination: BatchDestination;
+    amount: bigint;
+    tokenIdentifier?: string;
+}
+
 export interface RestClient {
     getRequest(url: string, headers?: Record<string, string>): Promise<RestResponse>;
     postRequest(url: string, headers?: Record<string, string>, body?: string): Promise<RestResponse>;
@@ -1428,6 +1509,14 @@ export interface SecretBytes {
     bytes: number[];
 }
 
+export interface SendBatchRequest {
+    prepareResponse: PrepareSendBatchResponse;
+}
+
+export interface SendBatchResponse {
+    payments: Payment[];
+}
+
 export interface SendOnchainFeeQuote {
     id: string;
     expiresAt: number;
@@ -1701,6 +1790,34 @@ export interface UnfreezeIssuerTokenResponse {
     impactedTokenAmount: bigint;
 }
 
+export interface UnilateralExitLeaf {
+    leafId: string;
+    value: number;
+}
+
+export interface UnilateralExitRequest {
+    prepared: PrepareUnilateralExitResponse;
+    fundingInputs: CpfpInput[];
+}
+
+export interface UnilateralExitResponse {
+    recoverableValueSat: number;
+    totalFeeSat: number;
+    leaves: UnilateralExitLeaf[];
+    transactions: UnilateralExitTransaction[];
+}
+
+export interface UnilateralExitTransaction {
+    kind: UnilateralExitTxKind;
+    nodeId?: string;
+    txid: string;
+    txHex: string;
+    cpfpTxHex?: string;
+    csvTimelockBlocks?: number;
+    dependsOn: string[];
+    status: ConfirmationStatus;
+}
+
 export interface UnregisterWebhookRequest {
     webhookId: string;
 }
@@ -1720,6 +1837,7 @@ export interface UpdateContactRequest {
 export interface UpdateUserSettingsRequest {
     sparkPrivateModeEnabled?: boolean;
     stableBalanceActiveLabel?: StableBalanceActiveLabel;
+    sparkMasterIdentityPublicKey?: SparkMasterIdentityPublicKey;
 }
 
 export interface UrlSuccessActionData {
@@ -1731,6 +1849,7 @@ export interface UrlSuccessActionData {
 export interface UserSettings {
     sparkPrivateModeEnabled: boolean;
     stableBalanceActiveLabel?: string;
+    sparkMasterIdentityPublicKey?: string;
 }
 
 export interface Utxo {
@@ -1756,6 +1875,8 @@ export type AssetFilter = { type: "bitcoin" } | { type: "token"; tokenIdentifier
 
 export type AutoOptimizationEvent = { type: "started"; totalRounds: number } | { type: "roundCompleted"; currentRound: number; totalRounds: number } | { type: "completed" } | { type: "cancelled" } | { type: "failed"; error: string } | { type: "skipped" };
 
+export type BatchDestination = { type: "sparkAddress"; address: string } | { type: "sparkInvoice"; invoiceDetails: SparkInvoiceDetails };
+
 export type BitcoinNetwork = "bitcoin" | "testnet3" | "testnet4" | "signet" | "regtest";
 
 export type BuildTransferPackageOptions = { type: "bitcoinAddress"; confirmationSpeed: OnchainConfirmationSpeed } | { type: "bolt11Invoice"; preferSpark: boolean; completionTimeoutSecs?: number };
@@ -1764,6 +1885,8 @@ export type BuyBitcoinRequest = { type: "moonpay"; lockedAmountSat?: number; red
 
 export type ChainApiType = "esplora" | "mempoolSpace";
 
+export type ConfirmationStatus = "confirmed" | "unconfirmed" | "unverified";
+
 export type ConversionChain = { type: "spark" } | { type: "lightning" } | { type: "external"; name: string; chainId?: string };
 
 export type ConversionFilter = "ammRefundNeeded" | "orchestraPending" | "boltzPending";
@@ -1778,6 +1901,10 @@ export type ConversionStatus = "pending" | "completed" | "failed" | "refundNeede
 
 export type ConversionType = { type: "fromBitcoin" } | { type: "toBitcoin"; fromTokenIdentifier: string };
 
+export type CpfpFundingKind = { type: "p2wpkh" } | { type: "p2tr" } | { type: "custom"; scriptPubkeyHex: string; signedInputWeight: number };
+
+export type CpfpInput = { type: "p2wpkh"; txid: string; vout: number; value: number; pubkey: string } | { type: "p2tr"; txid: string; vout: number; value: number; pubkey: string } | { type: "custom"; txid: string; vout: number; value: number; scriptPubkeyHex: string; signedInputWeight: number };
+
 export type CrossChainAddressFamily = "evm" | "solana" | "tron";
 
 export type CrossChainFeeMode = "feesExcluded" | "feesIncluded";
@@ -1790,6 +1917,8 @@ export type CrossChainRouteFilter = { type: "send"; addressDetails: CrossChainAd
 
 export type DepositClaimError = { type: "maxDepositClaimFeeExceeded"; tx: string; vout: number; maxFee?: Fee; requiredFeeSats: number; requiredFeeRateSatPerVbyte: number } | { type: "missingUtxo"; tx: string; vout: number } | { type: "generic"; message: string };
 
+export type ExitLeafSelection = { type: "auto" } | { type: "specific"; leafIds: string[] };
+
 export type ExternalFrostDerivation = { type: "signingLeaf"; leafId: ExternalTreeNodeId } | { type: "staticDeposit"; index: number } | { type: "htlcPreimage" } | { type: "identity" };
 
 export type ExternalSparkInvoiceKind = "sats" | "tokens";
@@ -1814,6 +1943,8 @@ export type OptimizationMode = "full" | "singleRound";
 
 export type OptimizationOutcome = { type: "completed"; roundsExecuted: number } | { type: "inProgress" };
 
+export type Outspend = { type: "unspent" } | { type: "spent"; txid: string; vin: number; status: TxStatus };
+
 export type PaymentDetails = { type: "spark"; invoiceDetails?: SparkInvoicePaymentDetails; htlcDetails?: SparkHtlcDetails; conversionInfo?: ConversionInfo } | { type: "token"; metadata: TokenMetadata; txHash: string; txType: TokenTransactionType; invoiceDetails?: SparkInvoicePaymentDetails; conversionInfo?: ConversionInfo } | { type: "lightning"; description?: string; invoice: string; destinationPubkey: string; htlcDetails: SparkHtlcDetails; lnurlPayInfo?: LnurlPayInfo; lnurlWithdrawInfo?: LnurlWithdrawInfo; lnurlReceiveMetadata?: LnurlReceiveMetadata; conversionInfo?: ConversionInfo } | { type: "withdraw"; txId: string } | { type: "deposit"; txId: string; vout: number };
 
 export type PaymentDetailsFilter = { type: "spark"; htlcStatus?: SparkHtlcStatus[]; conversionRefundNeeded?: boolean } | { type: "token"; conversionRefundNeeded?: boolean; txHash?: string; txType?: TokenTransactionType } | { type: "lightning"; htlcStatus?: SparkHtlcStatus[] };
@@ -1830,7 +1961,7 @@ export type ProvisionalPaymentDetails = { type: "bitcoin"; withdrawalAddress: st
 
 export type PublishSignedLnurlPayResponse = { type: "swapCompleted" } | { type: "paymentSent"; response: LnurlPayResponse };
 
-export type PublishSignedTransferPackageResponse = { type: "swapCompleted" } | { type: "paymentSent"; payment: Payment };
+export type PublishSignedTransferPackageResponse = { type: "swapCompleted" } | { type: "paymentSent"; payment: Payment } | { type: "paymentsSent"; payments: Payment[] };
 
 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 };
 
@@ -1850,6 +1981,8 @@ export type SourceAsset = { type: "bitcoin" } | { type: "token"; tokenIdentifier
 
 export type SparkHtlcStatus = "waitingForPreimage" | "preimageShared" | "returned";
 
+export type SparkMasterIdentityPublicKey = { type: "set"; publicKey: string } | { type: "unset" };
+
 export type StableBalanceActiveLabel = { type: "set"; label: string } | { type: "unset" };
 
 export type StoragePaymentDetailsFilter = { type: "spark"; htlcStatus?: SparkHtlcStatus[]; conversionFilter?: ConversionFilter } | { type: "token"; conversionFilter?: ConversionFilter; txHash?: string; txType?: TokenTransactionType } | { type: "lightning"; htlcStatus?: SparkHtlcStatus[]; conversionFilter?: ConversionFilter };
@@ -1864,7 +1997,9 @@ export type TransferSignature = { type: "transfer"; signed: ExternalPreparedTran
 
 export type TransferTarget = { type: "spark"; address: string; sparkInvoice?: string } | { type: "lightning"; bolt11: string; lnurlPay?: LnurlPayContext; feePolicy: FeePolicy; completionTimeoutSecs?: number } | { type: "coopExit"; address: string; feeQuote: SendOnchainFeeQuote; confirmationSpeed: OnchainConfirmationSpeed };
 
-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 };
+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 };
 
@@ -1884,7 +2019,9 @@ export class BitcoinChainServiceHandle {
     free(): void;
     [Symbol.dispose](): void;
     broadcastTransaction(tx: string): Promise<void>;
+    getAddressTxos(address: string): Promise<any>;
     getAddressUtxos(address: string): Promise<any>;
+    getOutspend(txid: string, vout: number): Promise<any>;
     getTransactionHex(txid: string): Promise<any>;
     getTransactionStatus(txid: string): Promise<any>;
     recommendedFees(): Promise<any>;
@@ -1897,6 +2034,7 @@ export class BreezSdk {
     addContact(request: AddContactRequest): Promise<Contact>;
     addEventListener(listener: EventListener): Promise<string>;
     authorizeLightningAddressTransfer(request: AuthorizeTransferRequest): Promise<TransferAuthorization>;
+    buildUnsignedBatchPackage(request: BuildUnsignedBatchPackageRequest): Promise<UnsignedTransferPackage>;
     buildUnsignedLnurlPayPackage(request: BuildUnsignedLnurlPayPackageRequest): Promise<UnsignedTransferPackage>;
     buildUnsignedTransferPackage(request: BuildUnsignedTransferPackageRequest): Promise<UnsignedTransferPackage>;
     buyBitcoin(request: BuyBitcoinRequest): Promise<BuyBitcoinResponse>;
@@ -1928,24 +2066,38 @@ export class BreezSdk {
     optimizeLeaves(request: OptimizeLeavesRequest): Promise<OptimizeLeavesResponse>;
     parse(input: string): Promise<InputType>;
     prepareLnurlPay(request: PrepareLnurlPayRequest): Promise<PrepareLnurlPayResponse>;
+    prepareSendBatch(request: PrepareSendBatchRequest): Promise<PrepareSendBatchResponse>;
     prepareSendPayment(request: PrepareSendPaymentRequest): Promise<PrepareSendPaymentResponse>;
+    prepareUnilateralExit(request: PrepareUnilateralExitRequest): Promise<PrepareUnilateralExitResponse>;
     publishSignedLnurlPayPackage(request: PublishSignedLnurlPayPackageRequest): Promise<PublishSignedLnurlPayResponse>;
     publishSignedTransferPackage(request: PublishSignedTransferPackageRequest): Promise<PublishSignedTransferPackageResponse>;
     receivePayment(request: ReceivePaymentRequest): Promise<ReceivePaymentResponse>;
     recommendedFees(): Promise<RecommendedFees>;
     refundDeposit(request: RefundDepositRequest): Promise<RefundDepositResponse>;
-    refundPendingConversions(): Promise<void>;
+    refundPendingConversions(): Promise<RefundPendingConversionsResponse>;
     registerLightningAddress(request: RegisterLightningAddressRequest): Promise<LightningAddressInfo>;
     registerWebhook(request: RegisterWebhookRequest): Promise<RegisterWebhookResponse>;
     removeEventListener(id: string): Promise<boolean>;
+    sendBatch(request: SendBatchRequest): Promise<SendBatchResponse>;
     sendPayment(request: SendPaymentRequest): Promise<SendPaymentResponse>;
     signMessage(request: SignMessageRequest): Promise<SignMessageResponse>;
     syncWallet(request: SyncWalletRequest): Promise<SyncWalletResponse>;
+    unilateralExit(request: UnilateralExitRequest, signer: CpfpSigner): Promise<UnilateralExitResponse>;
     unregisterWebhook(request: UnregisterWebhookRequest): Promise<void>;
     updateContact(request: UpdateContactRequest): Promise<Contact>;
     updateUserSettings(request: UpdateUserSettingsRequest): Promise<void>;
 }
 
+/**
+ * A CPFP signer matching the `CpfpSigner` TypeScript interface.
+ */
+export class DefaultCpfpSigner {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    signPsbt(psbt_bytes: Uint8Array): Promise<Uint8Array>;
+}
+
 /**
  * A JS handle to a backend's own session store (from `defaultSessionStore`),
  * exposing the same `getSession` / `setSession` interface. Wrap it in a JS
@@ -2041,6 +2193,7 @@ export class ExternalSparkSignerHandle {
     prepareTransfer(request: ExternalPrepareTransferRequest): Promise<ExternalPreparedTransfer>;
     signAuthenticationChallenge(challenge: Uint8Array): Promise<EcdsaSignatureBytes>;
     signFrost(jobs: ExternalFrostJob[]): Promise<ExternalFrostShareResult[]>;
+    signLeafRefundSpend(leaf_id: ExternalTreeNodeId, sighash: Uint8Array): Promise<SchnorrSignatureBytes>;
     signMessage(message: Uint8Array): Promise<EcdsaSignatureBytes>;
     signSparkInvoice(request: ExternalSignSparkInvoiceRequest): Promise<ExternalSignedSparkInvoice>;
     signStaticDepositRefund(request: ExternalSignStaticDepositRefundRequest): Promise<ExternalFrostSignature>;
@@ -2365,6 +2518,11 @@ export function newSharedSdkContext(config: WasmSdkContextConfig): Promise<WasmS
  */
 export function postgresStorage(config: PostgresStorageConfig): WasmStorageConfig;
 
+/**
+ * Creates a default CPFP signer backed by a single private key.
+ */
+export function singleKeyCpfpSigner(secret_key_bytes: Uint8Array): DefaultCpfpSigner;
+
 /**
  * Runs automatically when the wasm module is instantiated. Installs the
  * panic hook so Rust panics surface as readable `console.error` output
@@ -2384,6 +2542,7 @@ export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly __wbg_bitcoinchainservicehandle_free: (a: number, b: number) => void;
     readonly __wbg_breezsdk_free: (a: number, b: number) => void;
+    readonly __wbg_defaultcpfpsigner_free: (a: number, b: number) => void;
     readonly __wbg_externalsigners_free: (a: number, b: number) => void;
     readonly __wbg_passkeyclient_free: (a: number, b: number) => void;
     readonly __wbg_passkeylabels_free: (a: number, b: number) => void;
@@ -2392,13 +2551,16 @@ export interface InitOutput {
     readonly __wbg_wasmsdkcontext_free: (a: number, b: number) => void;
     readonly __wbg_wasmstorageconfig_free: (a: number, b: number) => void;
     readonly bitcoinchainservicehandle_broadcastTransaction: (a: number, b: number, c: number) => any;
+    readonly bitcoinchainservicehandle_getAddressTxos: (a: number, b: number, c: number) => any;
     readonly bitcoinchainservicehandle_getAddressUtxos: (a: number, b: number, c: number) => any;
+    readonly bitcoinchainservicehandle_getOutspend: (a: number, b: number, c: number, d: number) => any;
     readonly bitcoinchainservicehandle_getTransactionHex: (a: number, b: number, c: number) => any;
     readonly bitcoinchainservicehandle_getTransactionStatus: (a: number, b: number, c: number) => any;
     readonly bitcoinchainservicehandle_recommendedFees: (a: number) => any;
     readonly breezsdk_addContact: (a: number, b: any) => any;
     readonly breezsdk_addEventListener: (a: number, b: any) => any;
     readonly breezsdk_authorizeLightningAddressTransfer: (a: number, b: any) => any;
+    readonly breezsdk_buildUnsignedBatchPackage: (a: number, b: any) => any;
     readonly breezsdk_buildUnsignedLnurlPayPackage: (a: number, b: any) => any;
     readonly breezsdk_buildUnsignedTransferPackage: (a: number, b: any) => any;
     readonly breezsdk_buyBitcoin: (a: number, b: any) => any;
@@ -2430,7 +2592,9 @@ export interface InitOutput {
     readonly breezsdk_optimizeLeaves: (a: number, b: any) => any;
     readonly breezsdk_parse: (a: number, b: number, c: number) => any;
     readonly breezsdk_prepareLnurlPay: (a: number, b: any) => any;
+    readonly breezsdk_prepareSendBatch: (a: number, b: any) => any;
     readonly breezsdk_prepareSendPayment: (a: number, b: any) => any;
+    readonly breezsdk_prepareUnilateralExit: (a: number, b: any) => any;
     readonly breezsdk_publishSignedLnurlPayPackage: (a: number, b: any) => any;
     readonly breezsdk_publishSignedTransferPackage: (a: number, b: any) => any;
     readonly breezsdk_receivePayment: (a: number, b: any) => any;
@@ -2440,9 +2604,11 @@ export interface InitOutput {
     readonly breezsdk_registerLightningAddress: (a: number, b: any) => any;
     readonly breezsdk_registerWebhook: (a: number, b: any) => any;
     readonly breezsdk_removeEventListener: (a: number, b: number, c: number) => any;
+    readonly breezsdk_sendBatch: (a: number, b: any) => any;
     readonly breezsdk_sendPayment: (a: number, b: any) => any;
     readonly breezsdk_signMessage: (a: number, b: any) => any;
     readonly breezsdk_syncWallet: (a: number, b: any) => any;
+    readonly breezsdk_unilateralExit: (a: number, b: any, c: any) => any;
     readonly breezsdk_unregisterWebhook: (a: number, b: any) => any;
     readonly breezsdk_updateContact: (a: number, b: any) => any;
     readonly breezsdk_updateUserSettings: (a: number, b: any) => any;
@@ -2458,6 +2624,7 @@ export interface InitOutput {
     readonly defaultServerConfig: (a: any) => any;
     readonly defaultSessionStore: (a: number, b: any, c: number, d: number) => any;
     readonly defaultStorage: (a: number, b: number) => number;
+    readonly defaultcpfpsigner_signPsbt: (a: number, b: number, c: number) => any;
     readonly defaultsessionstore_getSession: (a: number, b: number, c: number) => any;
     readonly defaultsessionstore_setSession: (a: number, b: number, c: number, d: any) => any;
     readonly externalbreezsignerhandle_decryptEcies: (a: number, b: number, c: number, d: number, e: number) => any;
@@ -2484,6 +2651,7 @@ export interface InitOutput {
     readonly externalsparksignerhandle_prepareTransfer: (a: number, b: any) => any;
     readonly externalsparksignerhandle_signAuthenticationChallenge: (a: number, b: number, c: number) => any;
     readonly externalsparksignerhandle_signFrost: (a: number, b: number, c: number) => any;
+    readonly externalsparksignerhandle_signLeafRefundSpend: (a: number, b: any, c: number, d: number) => any;
     readonly externalsparksignerhandle_signMessage: (a: number, b: number, c: number) => any;
     readonly externalsparksignerhandle_signSparkInvoice: (a: number, b: any) => any;
     readonly externalsparksignerhandle_signStaticDepositRefund: (a: number, b: any) => any;
@@ -2520,6 +2688,7 @@ export interface InitOutput {
     readonly sdkbuilder_withSharedContext: (a: number, b: number) => number;
     readonly sdkbuilder_withStorage: (a: number, b: any) => number;
     readonly sdkbuilder_withStorageBackend: (a: number, b: number) => number;
+    readonly singleKeyCpfpSigner: (a: number, b: number) => [number, number, number];
     readonly start: () => void;
     readonly tokenissuer_burnIssuerToken: (a: number, b: any) => any;
     readonly tokenissuer_createIssuerToken: (a: number, b: any) => any;