@breeztech/breez-sdk-spark 0.27.2 → 0.28.0

package/bundler/storage/index.js

@@ -27,7 +27,7 @@ class MigrationManager {
     const transaction = event.target.transaction;
 
     this._log(
-      "info",
+      "INFO",
       `Upgrading IndexedDB from version ${oldVersion} to ${newVersion}`
     );
 
@@ -35,14 +35,14 @@ class MigrationManager {
       for (let i = oldVersion; i < newVersion; i++) {
         const migration = this.migrations[i];
         if (migration) {
-          this._log("debug", `Running migration ${i + 1}: ${migration.name}`);
+          this._log("DEBUG", `Running migration ${i + 1}: ${migration.name}`);
           migration.upgrade(db, transaction);
         }
       }
-      this._log("info", `Database migration completed successfully`);
+      this._log("INFO", `Database migration completed successfully`);
     } catch (error) {
       this._log(
-        "error",
+        "ERROR",
         `Migration failed at version ${oldVersion}: ${error.message}`
       );
       throw new this.StorageError(
@@ -53,14 +53,7 @@ class MigrationManager {
   }
 
   _log(level, message) {
-    if (this.logger && typeof this.logger.log === "function") {
-      this.logger.log({
-        line: message,
-        level: level,
-      });
-    } else if (level === "error") {
-      console.error(`[MigrationManager] ${message}`);
-    }
+    this.logger?.log({ line: message, level });
   }
 
   /**
@@ -149,7 +142,7 @@ class MigrationManager {
               }
             });
 
-            console.log(`Migrated ${updated} payment records to BigInt format`);
+            this._log("INFO", `Migrated ${updated} payment records to BigInt format`);
           };
         },
       },
@@ -653,6 +646,77 @@ class MigrationManager {
           }
         },
       },
+      {
+        // A withdrawal stored before the SDK kept its destination address and
+        // output index loses its details, which the SDK cannot rebuild here.
+        // With the sync offset at 0, the SDK re-fetches every transfer on its
+        // next sync and rewrites past withdrawals with both values.
+        name: "Clear legacy withdrawal details and reset sync offset",
+        upgrade: (db, transaction) => {
+          if (db.objectStoreNames.contains("payments")) {
+            const paymentStore = transaction.objectStore("payments");
+            // The cursor opens from a callback, so it reads the payments after
+            // the earlier steps of this upgrade have written theirs.
+            paymentStore.count().onsuccess = () => {
+              const cursorRequest = paymentStore.openCursor();
+              cursorRequest.onsuccess = (event) => {
+                const cursor = event.target.result;
+                if (!cursor) return;
+                const payment = cursor.value;
+                let details = null;
+                if (payment.details && typeof payment.details === "string") {
+                  try {
+                    details = JSON.parse(payment.details);
+                  } catch (e) {
+                    details = null;
+                  }
+                } else {
+                  details = payment.details;
+                }
+                if (
+                  details &&
+                  details.type === "withdraw" &&
+                  (details.vout == null || details.destinationAddress == null)
+                ) {
+                  payment.details = null;
+                  cursor.update(payment);
+                }
+                cursor.continue();
+              };
+            };
+          }
+          if (!db.objectStoreNames.contains("settings")) {
+            return;
+          }
+          const settingsStore = transaction.objectStore("settings");
+          const getRequest = settingsStore.get("sync_offset");
+          getRequest.onsuccess = () => {
+            const syncCache = getRequest.result;
+            if (!syncCache || !syncCache.value) {
+              return;
+            }
+            try {
+              const syncInfo = JSON.parse(syncCache.value);
+              syncInfo.offset = 0;
+              settingsStore.put({
+                key: "sync_offset",
+                value: toJson(syncInfo),
+              });
+            } catch (e) {
+              // If parsing fails, just continue
+            }
+          };
+        },
+      },
+      {
+        name: "Force lnurl_receive_metadata re-sync for the lightning address",
+        upgrade: (db, transaction) => {
+          if (db.objectStoreNames.contains("settings")) {
+            const settings = transaction.objectStore("settings");
+            settings.delete("lnurl_metadata_updated_after");
+          }
+        },
+      },
     ];
   }
 }
@@ -681,7 +745,7 @@ class IndexedDBStorage {
     // so existing databases depend on indices never shifting. Never insert,
     // reorder, or delete a migration — only append. dbVersion MUST equal the
     // number of migrations (enforced by the guard in initialize()).
-    this.dbVersion = 23; // Current schema version (= migration count)
+    this.dbVersion = 25; // Current schema version (= migration count)
   }
 
   /**
@@ -1071,13 +1135,15 @@ class IndexedDBStorage {
           shouldPersist = true;
           shouldEmit = true;
         } else if (stored === next) {
-          console.debug(
+          this._log(
+            "DEBUG",
             `Skipping redundant payment event: id=${payment.id} status=${next}`
           );
           shouldPersist = true;
           shouldEmit = false;
         } else if (this._isFinalPaymentStatus(stored)) {
-          console.warn(
+          this._log(
+            "WARN",
             `Skipping payment update (would replace terminal status): id=${payment.id} stored=${stored} new=${next}`
           );
           shouldPersist = false;
@@ -1293,7 +1359,7 @@ class IndexedDBStorage {
   /**
    * Gets payments that have any of the specified parent payment IDs.
    * @param {string[]} parentPaymentIds - Array of parent payment IDs
-   * @returns {Promise<Object>} Map of parentPaymentId -> array of RelatedPayment objects
+   * @returns {Promise<Object>} Map of parentPaymentId -> array of Payment objects
    */
   async getPaymentsByParentIds(parentPaymentIds) {
     if (!this.db) {
@@ -2007,6 +2073,7 @@ class IndexedDBStorage {
           nostrZapRequest: item.nostrZapRequest || null,
           nostrZapReceipt: item.nostrZapReceipt || null,
           senderComment: item.senderComment || null,
+          lightningAddress: item.lightningAddress || null,
         });
 
         request.onsuccess = () => {
@@ -2725,6 +2792,10 @@ class IndexedDBStorage {
     };
   }
 
+  _log(level, line) {
+    this.logger?.log({ line, level });
+  }
+
   _normalizePaymentStatus(status) {
     return typeof status === "string" ? status.toLowerCase() : status;
   }
@@ -3040,6 +3111,7 @@ class IndexedDBStorage {
             nostrZapRequest: lnurlReceiveMetadata.nostrZapRequest || null,
             nostrZapReceipt: lnurlReceiveMetadata.nostrZapReceipt || null,
             senderComment: lnurlReceiveMetadata.senderComment || null,
+            lightningAddress: lnurlReceiveMetadata.lightningAddress || null,
           };
         }
         resolve(payment);

package/deno/breez_sdk_spark_wasm.d.ts

@@ -1,3 +1,8 @@
+declare global {
+    interface SymbolConstructor {
+        readonly dispose: unique symbol;
+    }
+}
 /* tslint:disable */
 /* eslint-disable */
 /**
@@ -674,6 +679,21 @@ export interface BridgeFromCashAppResponse {
     expiresAt: number;
 }
 
+export interface BridgeRoutePair {
+    provider: CrossChainProvider;
+    source: BridgeRoutePairSide;
+    destination: BridgeRoutePairSide;
+    limits?: CrossChainRouteLimits;
+}
+
+export interface BridgeRoutePairSide {
+    chain: string;
+    chainId?: string;
+    asset: string;
+    contractAddress?: string;
+    decimals: number;
+}
+
 export interface BridgeToCashAppRequest {
     recipient: string;
     route: CrossChainRoutePair;
@@ -688,6 +708,15 @@ export interface BridgeToCashAppResponse {
     info: CrossChainReceiveInfo;
 }
 
+export interface BridgingConfig {
+    apiKey: string;
+    /**
+     * Not supported on WASM: setting this always fails validation.
+     */
+    proxy?: ProxyConfig;
+    crossChainConfig?: CrossChainConfig;
+}
+
 export interface BuildUnsignedBatchPackageRequest {
     prepareResponse: PrepareSendBatchResponse;
 }
@@ -879,6 +908,22 @@ export interface CpfpSigner {
     signPsbt(psbtBytes: Uint8Array): Promise<Uint8Array>;
 }
 
+export interface CreateBridgeRequest {
+    recipient: string;
+    route: BridgeRoutePair;
+    amount: bigint;
+    refundAddress?: string;
+    feePolicy?: FeePolicy;
+    maxSlippageBps?: number;
+}
+
+export interface CreateBridgeResponse {
+    bridgeId: string;
+    statusToken?: string;
+    paymentRequest: string;
+    info: CrossChainReceiveInfo;
+}
+
 export interface CreateIssuerTokenRequest {
     name: string;
     ticker: string;
@@ -924,6 +969,7 @@ export interface CrossChainConfig {
 }
 
 export interface CrossChainReceiveInfo {
+    quoteId: string;
     depositAddress: string;
     depositAmount: bigint;
     expectedReceivedAmount: bigint;
@@ -1276,6 +1322,31 @@ export interface FreezeIssuerTokenResponse {
     impactedTokenAmount: bigint;
 }
 
+export interface GetBridgeRoutesRequest {
+    recipient: string;
+}
+
+export interface GetBridgeRoutesResponse {
+    routes: BridgeRoutePair[];
+}
+
+export interface GetBridgeStatusRequest {
+    bridgeId: string;
+    statusToken?: string;
+}
+
+export interface GetBridgeStatusResponse {
+    status: BridgeStatus;
+    providerStatus?: string;
+    orderId?: string;
+    amountIn?: bigint;
+    amountOut?: bigint;
+    depositTxHash?: string;
+    deliveryTxHash?: string;
+    refundTxHash?: string;
+    errorCode?: string;
+}
+
 export interface GetInfoRequest {
     ensureSynced?: boolean;
 }
@@ -1285,6 +1356,8 @@ export interface GetInfoResponse {
     balanceSats: number;
     tokenBalances: Map<string, TokenBalance>;
     recoverableFundsSats: number;
+    lastSyncError?: SyncError;
+    lastSyncedAt?: number;
 }
 
 export interface GetPaymentRequest {
@@ -1470,6 +1543,7 @@ export interface LnurlReceiveMetadata {
     nostrZapRequest?: string;
     nostrZapReceipt?: string;
     senderComment?: string;
+    lightningAddress?: string;
 }
 
 export interface LnurlWithdrawInfo {
@@ -1653,6 +1727,7 @@ export interface PreparePullPaymentResponse {
 export interface PrepareRecoverFundsRequest {
     feeRateSatPerVbyte: number;
     fundingKind?: CpfpFundingKind;
+    fundingStrategy?: CpfpFundingStrategy;
     destination: string;
     selection: ExitLeafSelection;
 }
@@ -1818,6 +1893,7 @@ export interface RecoverableEcdsaSignatureBytes {
 export interface RecoveryFunding {
     singleUtxoSats: number;
     perBranch: PerBranchFunding[];
+    strategy?: CpfpFundingStrategy;
 }
 
 export interface RecoveryTransaction {
@@ -1871,9 +1947,9 @@ export interface ResolvedBatchRecipient {
 }
 
 export interface RestClient {
-    getRequest(url: string, headers?: Record<string, string>): Promise<RestResponse>;
-    postRequest(url: string, headers?: Record<string, string>, body?: string): Promise<RestResponse>;
-    deleteRequest(url: string, headers?: Record<string, string>, body?: string): Promise<RestResponse>;
+    getRequest(url: string, headers?: { [key: string]: string }): Promise<RestResponse>;
+    postRequest(url: string, headers?: { [key: string]: string }, body?: string): Promise<RestResponse>;
+    deleteRequest(url: string, headers?: { [key: string]: string }, body?: string): Promise<RestResponse>;
 }
 
 export interface RestResponse {
@@ -1928,6 +2004,8 @@ export interface SendPaymentResponse {
 export interface Session {
     token: string;
     expiration: number;
+    refreshToken?: string;
+    refreshTokenExpiration?: number;
 }
 
 export interface SessionStore {
@@ -1940,6 +2018,7 @@ export interface SetLnurlMetadataItem {
     senderComment?: string;
     nostrZapRequest?: string;
     nostrZapReceipt?: string;
+    lightningAddress?: string;
 }
 
 export interface SignMessageRequest {
@@ -1957,12 +2036,6 @@ export interface SignedTransferPackage {
     signature: TransferSignature;
 }
 
-export interface SilentPaymentAddressDetails {
-    address: string;
-    network: BitcoinNetwork;
-    source: PaymentRequestSource;
-}
-
 export interface SkippedLeaf {
     leafId: string;
     valueSats: number;
@@ -2071,7 +2144,7 @@ export interface Storage {
     listLeafRecoveries: () => Promise<LeafRecovery[]>;
     updateLeafRecovery: (update: UpdateLeafRecovery) => Promise<void>;
     setLnurlMetadata: (metadata: SetLnurlMetadataItem[]) => Promise<void>;
-    getPaymentsByParentIds: (parentPaymentIds: string[]) => Promise<{ [parentId: string]: RelatedPayment[] }>;
+    getPaymentsByParentIds: (parentPaymentIds: string[]) => Promise<{ [parentId: string]: Payment[] }>;
     listContacts: (request: ListContactsRequest) => Promise<Contact[]>;
     getContact: (id: string) => Promise<Contact>;
     insertContact: (contact: Contact) => Promise<void>;
@@ -2128,7 +2201,10 @@ export interface Symbol {
 
 export interface SyncWalletRequest {}
 
-export interface SyncWalletResponse {}
+export interface SyncWalletResponse {
+    lastSyncError?: SyncError;
+    lastSyncedAt?: number;
+}
 
 export interface TokenAllowance {
     id: string;
@@ -2296,6 +2372,8 @@ export type BatchDestination = { type: "sparkAddress"; address: string } | { typ
 
 export type BitcoinNetwork = "bitcoin" | "testnet3" | "testnet4" | "signet" | "regtest";
 
+export type BridgeStatus = "created" | "pending" | "refunding" | "completed" | "refunded" | "failed" | "expired";
+
 export type BuildTransferPackageOptions = { type: "bitcoinAddress"; confirmationSpeed: OnchainConfirmationSpeed } | { type: "bolt11Invoice"; preferSpark: boolean; completionTimeoutSecs?: number };
 
 export type BuyBitcoinRequest = { type: "moonpay"; delivery?: MoonpayDelivery; redirectUrl?: string } | { type: "cashApp"; amountSats: number };
@@ -2324,6 +2402,8 @@ export type CooperativeRecoveryError = { type: "replacementFeeTooLow"; requiredF
 
 export type CpfpFundingKind = { type: "p2wpkh" } | { type: "p2tr" } | { type: "custom"; scriptPubkeyHex: string; signedInputWeight: number };
 
+export type CpfpFundingStrategy = "perBranch" | "perNode";
+
 export type CpfpInput = { type: "p2wpkh"; txid: string; vout: number; valueSats: number; pubkey: string } | { type: "p2tr"; txid: string; vout: number; valueSats: number; pubkey: string } | { type: "custom"; txid: string; vout: number; valueSats: number; scriptPubkeyHex: string; signedInputWeight: number };
 
 export type CrossChainAddressFamily = "evm" | "solana" | "tron";
@@ -2358,7 +2438,7 @@ export type Fee = { type: "fixed"; amount: number } | { type: "rate"; satPerVbyt
 
 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 InputType = ({ type: "bitcoinAddress" } & BitcoinAddressDetails) | ({ type: "bolt11Invoice" } & Bolt11InvoiceDetails) | ({ type: "bolt12Invoice" } & Bolt12InvoiceDetails) | ({ type: "bolt12Offer" } & Bolt12OfferDetails) | ({ type: "lightningAddress" } & LightningAddressDetails) | ({ type: "lnurlPay" } & LnurlPayRequestDetails) | ({ type: "silentPaymentAddress" } & BitcoinAddressDetails) | ({ 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 InstantClaimStatus = { type: "declined"; maxFeeSats?: number; confirmations?: number } | { type: "submitted"; claimId: string } | { type: "claimed" };
 
@@ -2378,7 +2458,7 @@ export type OptimizationOutcome = { type: "completed"; roundsExecuted: number }
 
 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 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; vout: number; destinationAddress: 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[] };
 
@@ -2396,7 +2476,7 @@ export type PublishSignedLnurlPayResponse = { type: "swapCompleted" } | { type:
 
 export type PublishSignedTransferPackageResponse = { type: "swapCompleted" } | { type: "paymentSent"; payment: Payment } | { type: "paymentsSent"; payments: Payment[] };
 
-export type ReceivePaymentMethod = { type: "sparkAddress" } | { type: "sparkInvoice"; amount?: bigint; tokenIdentifier?: string; expiryTime?: number; description?: string; senderPublicKey?: string } | { type: "bitcoinAddress"; newAddress?: boolean } | { type: "bolt11Invoice"; description: string; amountSats?: number; expirySecs?: number; paymentHash?: string; receiverIdentityPublicKey?: string } | { type: "crossChain"; route: CrossChainRoutePair; amount: bigint; destination?: SparkAsset; feeMode?: CrossChainFeeMode; maxSlippageBps?: number; targetOverpayBps?: number };
+export type ReceivePaymentMethod = { type: "sparkAddress" } | { type: "sparkInvoice"; amount?: bigint; tokenIdentifier?: string; expiryTime?: number; description?: string; senderPublicKey?: string } | { type: "bitcoinAddress"; newAddress?: boolean } | { type: "bolt11Invoice"; description: string; amountSats?: number; expirySecs?: number; paymentHash?: string; receiverIdentityPublicKey?: string; preimage?: string } | { type: "crossChain"; route: CrossChainRoutePair; amount: bigint; destination?: SparkAsset; feeMode?: CrossChainFeeMode; maxSlippageBps?: number; targetOverpayBps?: number };
 
 export type RecoveryMethod = "cooperative" | "unilateral";
 
@@ -2420,7 +2500,7 @@ export type ServiceStatus = "operational" | "degraded" | "partial" | "unknown" |
 
 export type SessionStoreError = { type: "notFound" } | ({ type: "generic" } & string);
 
-export type SkippedLeafReason = { type: "feeExceedsValue" } | { type: "fundsNotFound" } | { type: "unverified" } | { type: "notRecoverable"; message: string };
+export type SkippedLeafReason = { type: "feeExceedsValue" } | { type: "fundsNotFound" } | { type: "unverified" } | { type: "operatorsUnavailable" } | { type: "notRecoverable"; message: string };
 
 export type SparkAsset = { type: "bitcoin" } | { type: "token"; tokenIdentifier: string };
 
@@ -2440,6 +2520,8 @@ export type SuccessActionProcessed = { type: "aes"; result: AesSuccessActionData
 
 export type SwapDegradation = "belowMinimum" | "unexpectedAsset" | "missingInfo";
 
+export type SyncError = { type: "network"; message: string } | { type: "generic"; message: string };
+
 export type TokenAllowanceLimit = { type: "unlimited" } | { type: "amount"; amount: bigint };
 
 export type TokenAllowanceRole = "owner" | "spender";
@@ -2490,7 +2572,13 @@ export class BreezSdk {
     addContact(request: AddContactRequest): Promise<Contact>;
     addEventListener(listener: EventListener): Promise<string>;
     authorizeLightningAddressTransfer(request: AuthorizeTransferRequest): Promise<TransferAuthorization>;
+    /**
+     * @deprecated Use `bridgeFromCashApp` on the client from `getBridgingClient`.
+     */
     bridgeFromCashApp(request: BridgeFromCashAppRequest): Promise<BridgeFromCashAppResponse>;
+    /**
+     * @deprecated Use `bridgeToCashApp` on the client from `getBridgingClient`.
+     */
     bridgeToCashApp(request: BridgeToCashAppRequest): Promise<BridgeToCashAppResponse>;
     buildUnsignedBatchPackage(request: BuildUnsignedBatchPackageRequest): Promise<UnsignedTransferPackage>;
     buildUnsignedLnurlPayPackage(request: BuildUnsignedLnurlPayPackageRequest): Promise<UnsignedTransferPackage>;
@@ -2510,6 +2598,7 @@ export class BreezSdk {
     exportUnilateralExitState(): Promise<ExportUnilateralExitStateResponse>;
     fetchClaimDepositQuote(request: FetchClaimDepositQuoteRequest): Promise<FetchClaimDepositQuoteResponse>;
     fetchConversionLimits(request: FetchConversionLimitsRequest): Promise<FetchConversionLimitsResponse>;
+    getBridgingClient(): BridgingClient;
     getCrossChainRoutes(filter: CrossChainRouteFilter): Promise<CrossChainRoutePair[]>;
     getInfo(request: GetInfoRequest): Promise<GetInfoResponse>;
     getLightningAddress(): Promise<LightningAddressInfo | undefined>;
@@ -2532,7 +2621,7 @@ export class BreezSdk {
     parse(input: string): Promise<InputType>;
     prepareLnurlPay(request: PrepareLnurlPayRequest): Promise<PrepareLnurlPayResponse>;
     /**
-     * @deprecated Use `bridgeFromCashApp`.
+     * @deprecated Use `bridgeFromCashApp` on the client from `getBridgingClient`.
      */
     preparePaymentLink(request: PreparePaymentLinkRequest): Promise<PreparePaymentLinkResponse>;
     preparePullPayment(request: PreparePullPaymentRequest): Promise<PreparePullPaymentResponse>;
@@ -2561,6 +2650,32 @@ export class BreezSdk {
     updateUserSettings(request: UpdateUserSettingsRequest): Promise<void>;
 }
 
+/**
+ * Creates bridges: orders that pay a recipient from another chain or over
+ * Lightning, with no funds moving through the SDK. Only available on mainnet.
+ */
+export class BridgingClient {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    bridgeFromCashApp(request: CreateBridgeRequest): Promise<CreateBridgeResponse>;
+    bridgeToCashApp(request: CreateBridgeRequest): Promise<CreateBridgeResponse>;
+    createBridge(request: CreateBridgeRequest): Promise<CreateBridgeResponse>;
+    getBridgeStatus(request: GetBridgeStatusRequest): Promise<GetBridgeStatusResponse>;
+    getRoutes(request: GetBridgeRoutesRequest): Promise<GetBridgeRoutesResponse>;
+}
+
+/**
+ * A logger that prints each log entry to the JavaScript console, with the console method that
+ * matches the entry's level.
+ */
+export class ConsoleLogger {
+    free(): void;
+    [Symbol.dispose](): void;
+    log(entry: LogEntry): void;
+    constructor();
+}
+
 /**
  * A CPFP signer matching the `CpfpSigner` TypeScript interface.
  */
@@ -2917,6 +3032,11 @@ export function createTurnkeySigner(config: TurnkeyConfig): Promise<ExternalSign
  */
 export function createTurnkeySigningOnlySigner(config: TurnkeyConfig): Promise<SigningOnlyExternalSigners>;
 
+/**
+ * Settings for `newBridgingClient` with every optional field unset.
+ */
+export function defaultBridgingConfig(api_key: string): BridgingConfig;
+
 export function defaultConfig(network: Network): Config;
 
 /**
@@ -2973,6 +3093,11 @@ export function initLogging(logger: Logger, filter?: string | null): Promise<voi
  */
 export function mysqlStorage(config: MysqlStorageConfig): WasmStorageConfig;
 
+/**
+ * Builds a `BridgingClient` from an API key, with no seed or storage.
+ */
+export function newBridgingClient(config: BridgingConfig): Promise<BridgingClient>;
+
 /**
  * Constructs a shareable REST-based Bitcoin chain service.
  *