@breeztech/breez-sdk-spark 0.27.0-dev1 → 0.27.0

package/bundler/breez_sdk_spark_wasm.d.ts

@@ -57,6 +57,7 @@ export interface TreeStore {
     storeAncestors: (pedigrees: LeafPedigree[]) => Promise<void>;
     leavesMissingExitChains: () => Promise<string[]>;
     getLeaves: () => Promise<Leaves>;
+    getLeavesWithStatus: (statuses: string[]) => Promise<TreeNode[]>;
     getExitChains: (leafIds: string[]) => Promise<LeafPedigree[]>;
     getAvailableBalance: () => Promise<bigint>;
     getVerifiedLeafKeys: () => Promise<[string, string, string][]>;
@@ -517,6 +518,14 @@ export interface WasmSdkContextConfig {
     proxy?: ProxyConfig;
 }
 
+/**
+ * The error SDK methods throw. `docsUrl` links to the guide section that
+ * explains the error, when it has one.
+ */
+export interface SdkError extends Error {
+    docsUrl?: string;
+}
+
 export interface AddContactRequest {
     name: string;
     paymentIdentifier: string;
@@ -545,7 +554,7 @@ export interface BatchRecipient {
 
 export interface BatchTotal {
     tokenIdentifier?: string;
-    amount: string;
+    amount: bigint;
 }
 
 export interface Bip21Details {
@@ -646,6 +655,39 @@ export interface Bolt12OfferDetails {
     signingPubkey?: string;
 }
 
+export interface BridgeFromCashAppRequest {
+    address: string;
+    route: CrossChainRoutePair;
+    amount: bigint;
+    feePolicy?: FeePolicy;
+    maxSlippageBps?: number;
+}
+
+export interface BridgeFromCashAppResponse {
+    url: string;
+    amountSats: number;
+    estimatedOut: bigint;
+    asset: string;
+    serviceFeeAmount: bigint;
+    serviceFeeAsset?: string;
+    serviceFeeAssetDecimals?: number;
+    expiresAt: number;
+}
+
+export interface BridgeToCashAppRequest {
+    recipient: string;
+    route: CrossChainRoutePair;
+    amount: bigint;
+    feePolicy?: FeePolicy;
+    refundAddress: string;
+    maxSlippageBps?: number;
+}
+
+export interface BridgeToCashAppResponse {
+    paymentRequest: string;
+    info: CrossChainReceiveInfo;
+}
+
 export interface BuildUnsignedBatchPackageRequest {
     prepareResponse: PrepareSendBatchResponse;
 }
@@ -654,6 +696,10 @@ export interface BuildUnsignedLnurlPayPackageRequest {
     prepareResponse: PrepareLnurlPayResponse;
 }
 
+export interface BuildUnsignedPullPackageRequest {
+    prepareResponse: PreparePullPaymentResponse;
+}
+
 export interface BuildUnsignedTransferPackageRequest {
     prepareResponse: PrepareSendPaymentResponse;
     options?: BuildTransferPackageOptions;
@@ -665,6 +711,12 @@ export interface BurnIssuerTokenRequest {
 
 export interface BuyBitcoinResponse {
     url: string;
+    crossChainInfo?: CrossChainReceiveInfo;
+}
+
+export interface ChainTransaction {
+    txid: string;
+    blockHeight: number;
 }
 
 export interface CheckLightningAddressRequest {
@@ -681,20 +733,20 @@ export interface CheckMessageResponse {
     isValid: boolean;
 }
 
-export interface CheckUnilateralExitRequest {
-    exit: UnilateralExitResponse;
+export interface CheckRecoverFundsRequest {
+    recovery: RecoverFundsResponse;
 }
 
-export interface CheckUnilateralExitResponse {
-    exit: UnilateralExitResponse;
-    verdict: UnilateralExitVerdict;
+export interface CheckRecoverFundsResponse {
+    recovery: RecoverFundsResponse;
+    verdict: RecoveryVerdict;
 }
 
 export interface ClaimDepositQuote {
     confirmationsRequired: number;
     creditAmountSats: number;
     feeSats: number;
-    feeRateSatPerVbyte: number;
+    maxFeeSats?: number;
     isEstimate: boolean;
 }
 
@@ -729,6 +781,7 @@ export interface Config {
     lnurlDomain?: string;
     preferSparkOverLightning: boolean;
     exitChainAutoFetchEnabled: boolean;
+    watchtowerFeeLadderEnabled?: boolean;
     externalInputParsers?: ExternalInputParser[];
     useDefaultExternalInputParsers: boolean;
     realTimeSyncServerUrl?: string;
@@ -811,8 +864,15 @@ export interface ConversionOptions {
 export interface ConversionSide {
     chain: ConversionChain;
     asset: ConversionAsset;
-    amount: string;
-    fee: string;
+    amount: bigint;
+    fee: bigint;
+}
+
+export interface CooperativeRecoveryFailure {
+    leafId: string;
+    outputTxid: string;
+    outputVout: number;
+    error: CooperativeRecoveryError;
 }
 
 export interface CpfpSigner {
@@ -827,6 +887,19 @@ export interface CreateIssuerTokenRequest {
     maxSupply: bigint;
 }
 
+export interface CreateTokenAllowanceRequest {
+    spenderAddress: string;
+    tokenIdentifier: string;
+    maxPerPayment: TokenAllowanceLimit;
+    maxTotal: TokenAllowanceLimit;
+    expiryTime: number;
+    allowedRecipients: string[];
+}
+
+export interface CreateTokenAllowanceResponse {
+    allowance: TokenAllowance;
+}
+
 export interface Credentials {
     username: string;
     password: string;
@@ -842,7 +915,7 @@ export interface CrossChainAddressDetails {
     addressFamily: CrossChainAddressFamily;
     contractAddress?: string;
     chainId?: number;
-    amount?: string;
+    amount?: bigint;
 }
 
 export interface CrossChainConfig {
@@ -852,19 +925,19 @@ export interface CrossChainConfig {
 
 export interface CrossChainReceiveInfo {
     depositAddress: string;
-    depositAmount: string;
-    expectedReceivedAmount: string;
+    depositAmount: bigint;
+    expectedReceivedAmount: bigint;
     destinationAsset: string;
     tokenIdentifier?: string;
-    serviceFeeAmount: string;
+    serviceFeeAmount: bigint;
     serviceFeeAsset?: string;
     serviceFeeAssetDecimals?: number;
     expiresAt: number;
 }
 
 export interface CrossChainRouteLimits {
-    minAmount?: string;
-    maxAmount?: string;
+    minAmount?: bigint;
+    maxAmount?: bigint;
     minUsdCents?: number;
     maxUsdCents?: number;
 }
@@ -948,7 +1021,6 @@ export interface ExternalClaimLeafInput {
 export interface ExternalFrostCommitments {
     hidingCommitment: number[];
     bindingCommitment: number[];
-    noncesCiphertext: number[];
 }
 
 export interface ExternalFrostJob {
@@ -1083,6 +1155,16 @@ export interface ExternalSignStaticDepositRefundRequest {
     statechainPublicKeys: IdentifierPublicKeyPair[];
 }
 
+export interface ExternalSignWatchtowerExitRecoveryRequest {
+    leafId: ExternalTreeNodeId;
+    sighash: number[];
+    verifyingKey: number[];
+    nonceCommitment: ExternalFrostCommitments;
+    statechainCommitments: IdentifierCommitmentPair[];
+    statechainSignatures: IdentifierSignaturePair[];
+    statechainPublicKeys: IdentifierPublicKeyPair[];
+}
+
 export interface ExternalSignedSparkInvoice {
     signature: SchnorrSignatureBytes;
 }
@@ -1103,6 +1185,7 @@ export interface ExternalSparkSigner {
     getIdentityPublicKey(): Promise<PublicKeyBytes>;
     getPublicKeyForLeaf(leafId: ExternalTreeNodeId): Promise<PublicKeyBytes>;
     getStaticDepositPublicKey(index: number): Promise<PublicKeyBytes>;
+    isRemote?(): boolean;
     signAuthenticationChallenge(challenge: Uint8Array): Promise<EcdsaSignatureBytes>;
     signMessage(message: Uint8Array): Promise<EcdsaSignatureBytes>;
     signLeafRefundSpend(leafId: ExternalTreeNodeId, sighash: Uint8Array): Promise<SchnorrSignatureBytes>;
@@ -1113,6 +1196,8 @@ export interface ExternalSparkSigner {
     prepareStaticDeposit(request: ExternalPrepareStaticDepositRequest): Promise<ExternalPreparedStaticDeposit>;
     startStaticDepositRefund(request: ExternalStartStaticDepositRefundRequest): Promise<ExternalStartedStaticDepositRefund>;
     signStaticDepositRefund(request: ExternalSignStaticDepositRefundRequest): Promise<ExternalFrostSignature>;
+    startWatchtowerExitRecovery(request: ExternalStartWatchtowerExitRecoveryRequest): Promise<ExternalStartedWatchtowerExitRecovery>;
+    signWatchtowerExitRecovery(request: ExternalSignWatchtowerExitRecoveryRequest): Promise<ExternalFrostSignature>;
     signSparkInvoice(request: ExternalSignSparkInvoiceRequest): Promise<ExternalSignedSparkInvoice>;
     prepareTokenTransaction(request: ExternalPrepareTokenTransactionRequest): Promise<ExternalPreparedTokenTransaction>;
     prepareStaticDepositClaim(request: ExternalPrepareStaticDepositClaimRequest): Promise<ExternalPreparedStaticDepositClaim>;
@@ -1123,12 +1208,23 @@ export interface ExternalStartStaticDepositRefundRequest {
     userStatement: number[];
 }
 
+export interface ExternalStartWatchtowerExitRecoveryRequest {
+    leafId: ExternalTreeNodeId;
+    userStatement: number[];
+}
+
 export interface ExternalStartedStaticDepositRefund {
     signingPublicKey: number[];
     nonceCommitment: ExternalFrostCommitments;
     userSignature: EcdsaSignatureBytes;
 }
 
+export interface ExternalStartedWatchtowerExitRecovery {
+    signingPublicKey: number[];
+    nonceCommitment: ExternalFrostCommitments;
+    userSignature: EcdsaSignatureBytes;
+}
+
 export interface ExternalTransferLeafInput {
     nodeId: ExternalTreeNodeId;
     newLeafId: ExternalTreeNodeId;
@@ -1188,6 +1284,7 @@ export interface GetInfoResponse {
     identityPubkey: string;
     balanceSats: number;
     tokenBalances: Map<string, TokenBalance>;
+    recoverableFundsSats: number;
 }
 
 export interface GetPaymentRequest {
@@ -1246,6 +1343,15 @@ export interface LeafOptimizationConfig {
     multiplicity: number;
 }
 
+export interface LeafRecovery {
+    leafId: string;
+    chainCheckedAt?: number;
+    watchtowerExitOutput?: StoredWatchtowerExitOutput;
+    watchtowerExitRecoveries: WatchtowerExitRecovery[];
+    watchtowerExitSpend?: ChainTransaction;
+    unilateralExitSweep?: ChainTransaction;
+}
+
 export interface LightningAddressDetails {
     address: string;
     payRequest: LnurlPayRequestDetails;
@@ -1287,6 +1393,19 @@ export interface ListPaymentsResponse {
     payments: Payment[];
 }
 
+export interface ListTokenAllowancesRequest {
+    role: TokenAllowanceRole;
+    counterpartyAddress?: string;
+    tokenIdentifier?: string;
+    includeInactive?: boolean;
+    offset?: number;
+    limit?: number;
+}
+
+export interface ListTokenAllowancesResponse {
+    allowances: TokenAllowance[];
+}
+
 export interface ListUnclaimedDepositsRequest {}
 
 export interface ListUnclaimedDepositsResponse {
@@ -1397,12 +1516,18 @@ export interface LocalizedName {
 export interface LogEntry {
     line: string;
     level: string;
+    instanceId?: string;
 }
 
 export interface Logger {
     log: (l: LogEntry) => void;
 }
 
+export interface MaxFee {
+    onchain: MaxOnchainFee;
+    proportionalPpm?: number;
+}
+
 export interface MessageBytes {
     bytes: number[];
 }
@@ -1466,7 +1591,7 @@ export interface PaymentRequestSource {
 
 export interface PerBranchFunding {
     leafId: string;
-    fundingSat: number;
+    fundingSats: number;
 }
 
 export interface PrepareLnurlPayRequest {
@@ -1509,6 +1634,45 @@ export interface PreparePaymentLinkResponse {
     expiresAt: string;
 }
 
+export interface PreparePullPaymentRequest {
+    payerAddress: string;
+    tokenIdentifier: string;
+    receivers: PullReceiver[];
+}
+
+export interface PreparePullPaymentResponse {
+    payerAddress: string;
+    tokenIdentifier: string;
+    receivers: PullReceiver[];
+    amount: bigint;
+    allowanceId: string;
+    expiryTime: number;
+    pullContext: number[];
+}
+
+export interface PrepareRecoverFundsRequest {
+    feeRateSatPerVbyte: number;
+    fundingKind?: CpfpFundingKind;
+    destination: string;
+    selection: ExitLeafSelection;
+}
+
+export interface PrepareRecoverFundsResponse {
+    leaves: RecoverFundsLeaf[];
+    skipped: SkippedLeaf[];
+    recoverableValueSats: number;
+    totalFeeSats: number;
+    cooperativeFeeSats: number;
+    cpfpFeeSats: number;
+    fanoutFeeSats: number;
+    refundFeeSats: number;
+    sweepFeeSats: number;
+    funding?: RecoveryFunding;
+    feeRateSatPerVbyte: number;
+    destination: string;
+    exitChainState: ExitChainState;
+}
+
 export interface PrepareSendBatchRequest {
     recipients: BatchRecipient[];
 }
@@ -1534,27 +1698,6 @@ 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;
-    cpfpFeeSat: number;
-    fanoutFeeSat: number;
-    sweepFeeSat: number;
-    singleUtxoFundingSat: number;
-    perBranchFunding: PerBranchFunding[];
-    feeRateSatPerVbyte: number;
-    destination: string;
-    exitChainState: ExitChainState;
-}
-
 export interface ProvisionalPayment {
     paymentId: string;
     amount: bigint;
@@ -1576,10 +1719,29 @@ export interface PublishSignedLnurlPayPackageRequest {
     signedPackage: SignedTransferPackage;
 }
 
+export interface PublishSignedPullPackageRequest {
+    signedPackage: SignedTransferPackage;
+}
+
 export interface PublishSignedTransferPackageRequest {
     signedPackage: SignedTransferPackage;
 }
 
+export interface PullPaymentRequest {
+    prepareResponse: PreparePullPaymentResponse;
+}
+
+export interface PullPaymentResponse {
+    txHash: string;
+    status: PaymentStatus;
+    payment?: Payment;
+}
+
+export interface PullReceiver {
+    amount: bigint;
+    receiverAddress?: string;
+}
+
 export interface Rate {
     coin: string;
     value: number;
@@ -1622,10 +1784,53 @@ export interface RecordId {
     dataId: string;
 }
 
+export interface RecoverFundsLeaf {
+    leafId: string;
+    valueSats: number;
+    method: RecoveryMethod;
+}
+
+export interface RecoverFundsRequest {
+    prepared: PrepareRecoverFundsResponse;
+    fundingInputs?: CpfpInput[];
+}
+
+export interface RecoverFundsResponse {
+    recoverableValueSats: number;
+    totalFeeSats: number;
+    cooperativeFeeSats: number;
+    cpfpFeeSats: number;
+    fanoutFeeSats: number;
+    refundFeeSats: number;
+    sweepFeeSats: number;
+    leaves: RecoverFundsLeaf[];
+    failed: CooperativeRecoveryFailure[];
+    transactions: RecoveryTransaction[];
+    fundingInputs: CpfpInput[];
+    feeRateSatPerVbyte: number;
+    destination: string;
+}
+
 export interface RecoverableEcdsaSignatureBytes {
     bytes: number[];
 }
 
+export interface RecoveryFunding {
+    singleUtxoSats: number;
+    perBranch: PerBranchFunding[];
+}
+
+export interface RecoveryTransaction {
+    kind: RecoveryTxKind;
+    nodeId?: string;
+    txid: string;
+    txHex: string;
+    cpfpTxHex?: string;
+    csvTimelockBlocks?: number;
+    dependsOn: string[];
+    status: ExitTransactionStatus;
+}
+
 export interface RefundDepositRequest {
     txid: string;
     vout: number;
@@ -1676,6 +1881,10 @@ export interface RestResponse {
     body: string;
 }
 
+export interface RevokeTokenAllowanceRequest {
+    allowanceId: string;
+}
+
 export interface SchnorrSignatureBytes {
     bytes: number[];
 }
@@ -1754,6 +1963,12 @@ export interface SilentPaymentAddressDetails {
     source: PaymentRequestSource;
 }
 
+export interface SkippedLeaf {
+    leafId: string;
+    valueSats: number;
+    reason: SkippedLeafReason;
+}
+
 export interface SparkAddressDetails {
     address: string;
     identityPublicKey: string;
@@ -1787,7 +2002,7 @@ export interface SparkInvoiceDetails {
     invoice: string;
     identityPublicKey: string;
     network: BitcoinNetwork;
-    amount?: string;
+    amount?: bigint;
     tokenIdentifier?: string;
     expiryTime?: number;
     description?: string;
@@ -1853,6 +2068,8 @@ export interface Storage {
     updateDeposit: (txid: string, vout: number, payload: UpdateDepositPayload) => Promise<void>;
     listWatchedDepositAddresses: () => Promise<WatchedDepositAddress[]>;
     updateWatchedDepositAddress: (address: string, payload: UpdateWatchedAddressPayload) => Promise<void>;
+    listLeafRecoveries: () => Promise<LeafRecovery[]>;
+    updateLeafRecovery: (update: UpdateLeafRecovery) => Promise<void>;
     setLnurlMetadata: (metadata: SetLnurlMetadataItem[]) => Promise<void>;
     getPaymentsByParentIds: (parentPaymentIds: string[]) => Promise<{ [parentId: string]: RelatedPayment[] }>;
     listContacts: (request: ListContactsRequest) => Promise<Contact[]>;
@@ -1894,6 +2111,14 @@ export interface StoredCrossChainSwap {
     secrets: string;
 }
 
+export interface StoredWatchtowerExitOutput {
+    txid: string;
+    vout: number;
+    amountSats: number;
+    scriptPubkey: string;
+    blockHeight: number;
+}
+
 export interface Symbol {
     grapheme?: string;
     template?: string;
@@ -1905,6 +2130,21 @@ export interface SyncWalletRequest {}
 
 export interface SyncWalletResponse {}
 
+export interface TokenAllowance {
+    id: string;
+    ownerAddress: string;
+    spenderAddress: string;
+    tokenIdentifier: string;
+    maxPerPayment: TokenAllowanceLimit;
+    maxTotal: TokenAllowanceLimit;
+    spentAmount: bigint;
+    allowedRecipients: string[];
+    expiryTime: number;
+    createdAt: number;
+    revokedAt?: number;
+    status: TokenAllowanceStatus;
+}
+
 export interface TokenBalance {
     balance: bigint;
     tokenMetadata: TokenMetadata;
@@ -1916,7 +2156,7 @@ export interface TokenMetadata {
     name: string;
     ticker: string;
     decimals: number;
-    maxSupply: string;
+    maxSupply: bigint;
     isFreezable: boolean;
 }
 
@@ -1974,38 +2214,6 @@ 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;
-    cpfpFeeSat: number;
-    fanoutFeeSat: number;
-    sweepFeeSat: number;
-    leaves: UnilateralExitLeaf[];
-    transactions: UnilateralExitTransaction[];
-    fundingInputs: CpfpInput[];
-}
-
-export interface UnilateralExitTransaction {
-    kind: UnilateralExitTxKind;
-    nodeId?: string;
-    txid: string;
-    txHex: string;
-    cpfpTxHex?: string;
-    csvTimelockBlocks?: number;
-    dependsOn: string[];
-    status: ExitTransactionStatus;
-}
-
 export interface UnregisterWebhookRequest {
     webhookId: string;
 }
@@ -2022,6 +2230,15 @@ export interface UpdateContactRequest {
     paymentIdentifier: string;
 }
 
+export interface UpdateLeafRecovery {
+    leafId: string;
+    chainCheckedAt?: number;
+    watchtowerExitOutput?: StoredWatchtowerExitOutput;
+    watchtowerExitRecovery?: WatchtowerExitRecovery;
+    watchtowerExitSpend?: ChainTransaction;
+    unilateralExitSweep?: ChainTransaction;
+}
+
 export interface UpdateUserSettingsRequest {
     sparkPrivateModeEnabled?: boolean;
     stableBalanceActiveLabel?: StableBalanceActiveLabel;
@@ -2053,6 +2270,12 @@ export interface WatchedDepositAddress {
     seen: boolean;
 }
 
+export interface WatchtowerExitRecovery {
+    txid: string;
+    transactionHex: string;
+    outputAmountSats: number;
+}
+
 export interface Webhook {
     id: string;
     url: string;
@@ -2075,7 +2298,7 @@ export type BitcoinNetwork = "bitcoin" | "testnet3" | "testnet4" | "signet" | "r
 
 export type BuildTransferPackageOptions = { type: "bitcoinAddress"; confirmationSpeed: OnchainConfirmationSpeed } | { type: "bolt11Invoice"; preferSpark: boolean; completionTimeoutSecs?: number };
 
-export type BuyBitcoinRequest = { type: "moonpay"; lockedAmountSat?: number; redirectUrl?: string } | { type: "cashApp"; amountSats: number };
+export type BuyBitcoinRequest = { type: "moonpay"; delivery?: MoonpayDelivery; redirectUrl?: string } | { type: "cashApp"; amountSats: number };
 
 export type ChainApiType = "esplora" | "mempoolSpace";
 
@@ -2087,7 +2310,7 @@ export type ConversionChain = { type: "spark" } | { type: "lightning" } | { type
 
 export type ConversionFilter = "ammRefundNeeded" | "orchestraPending" | "boltzPending";
 
-export type ConversionInfo = { type: "amm"; poolId: string; conversionId: string; status: ConversionStatus; fee?: string; purpose?: ConversionPurpose; amountAdjustment?: AmountAdjustmentReason; degradation?: SwapDegradation } | { type: "orchestra"; chain: string; chainId?: string; asset?: string; assetContract?: string; recipientAddress: string; assetAmountIn?: string; estimatedOut: string; deliveredAmount?: string; externalTxHash?: string; status: ConversionStatus; feeAmount?: string; serviceFeeAmount?: string; serviceFeeAsset?: string; serviceFeeAssetDecimals?: number; assetDecimals: number; orderId: string; quoteId: string; readToken?: string } | { type: "boltz"; chain: string; chainId?: string; asset?: string; assetContract?: string; recipientAddress: string; assetAmountIn?: string; estimatedOut: string; deliveredAmount?: string; status: ConversionStatus; feeAmount?: string; serviceFeeAmount?: string; serviceFeeAsset?: string; assetDecimals: number; swapId: string; invoice: string; invoiceAmountSats: number; bridgeRef?: string; maxSlippageBps: number; quoteDegraded?: boolean };
+export type ConversionInfo = { type: "amm"; poolId: string; conversionId: string; status: ConversionStatus; fee?: bigint; purpose?: ConversionPurpose; amountAdjustment?: AmountAdjustmentReason; degradation?: SwapDegradation } | { type: "orchestra"; chain: string; chainId?: string; asset?: string; assetContract?: string; recipientAddress: string; assetAmountIn?: bigint; estimatedOut: bigint; deliveredAmount?: bigint; externalTxHash?: string; status: ConversionStatus; feeAmount?: bigint; serviceFeeAmount?: bigint; serviceFeeAsset?: string; serviceFeeAssetDecimals?: number; assetDecimals: number; orderId: string; quoteId: string; readToken?: string } | { type: "boltz"; chain: string; chainId?: string; asset?: string; assetContract?: string; recipientAddress: string; assetAmountIn?: bigint; estimatedOut: bigint; deliveredAmount?: bigint; status: ConversionStatus; feeAmount?: bigint; serviceFeeAmount?: bigint; serviceFeeAsset?: string; assetDecimals: number; swapId: string; invoice: string; invoiceAmountSats: number; bridgeRef?: string; maxSlippageBps: number; quoteDegraded?: boolean };
 
 export type ConversionProvider = "amm" | "orchestra" | "boltz";
 
@@ -2097,9 +2320,11 @@ export type ConversionStatus = "pending" | "completed" | "failed" | "refundNeede
 
 export type ConversionType = { type: "fromBitcoin" } | { type: "toBitcoin"; fromTokenIdentifier: string };
 
+export type CooperativeRecoveryError = { type: "replacementFeeTooLow"; requiredFeeSats: number; requiredFeeRateSatPerVbyte: number } | { type: "operatorsUnavailable"; message: string } | { type: "generic"; message: 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 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";
 
@@ -2107,19 +2332,19 @@ export type CrossChainFeeMode = "feesExcluded" | "feesIncluded";
 
 export type CrossChainProvider = "orchestra" | "boltz";
 
-export type CrossChainProviderContext = { type: "orchestra"; quoteId: string; depositAddress: string; depositAmount?: string } | { type: "boltz"; swapId: string; invoice: string; invoiceAmountSats?: number; maxSlippageBps: number };
+export type CrossChainProviderContext = { type: "orchestra"; quoteId: string; depositAddress: string; depositAmount?: bigint } | { type: "boltz"; swapId: string; invoice: string; invoiceAmountSats?: number; maxSlippageBps: number };
 
-export type CrossChainRouteFilter = { type: "send"; addressDetails: CrossChainAddressDetails } | { type: "receive"; contractAddress?: string } | { type: "paymentLink"; addressDetails: CrossChainAddressDetails };
+export type CrossChainRouteFilter = { type: "send"; addressDetails: CrossChainAddressDetails; deliveryMethod?: DeliveryMethod } | { type: "receive"; contractAddress?: string; deliveryMethod?: DeliveryMethod } | { type: "paymentLink"; addressDetails: CrossChainAddressDetails };
 
 export type DeliveryMethod = "spark" | "lightning" | "bitcoin";
 
-export type DepositClaimError = { type: "maxDepositClaimFeeExceeded"; tx: string; vout: number; maxFee?: Fee; requiredFeeSats: number; requiredFeeRateSatPerVbyte: number } | { type: "missingUtxo"; tx: string; vout: number } | { type: "depositTooSmall"; tx: string; vout: number } | { type: "generic"; message: string };
+export type DepositClaimError = { type: "maxDepositClaimFeeExceeded"; tx: string; vout: number; maxFeeSats?: number; requiredFeeSats: number } | { type: "missingUtxo"; tx: string; vout: number } | { type: "depositTooSmall"; tx: string; vout: number } | { type: "generic"; message: string };
 
-export type ExitLeafSelection = { type: "auto" } | { type: "specific"; leafIds: string[] };
+export type ExitLeafSelection = { type: "all" } | { type: "recoverableOnly" } | { type: "specific"; leafIds: string[] };
 
 export type ExitNodeConfirmation = "cpfp" | "direct";
 
-export type ExitRefundState = { type: "onChain"; txHex: string; vout: number; valueSat: number; blockHeight?: number } | { type: "swept" };
+export type ExitRefundState = { type: "onChain"; txHex: string; vout: number; valueSats: number; blockHeight?: number } | { type: "swept" };
 
 export type ExitTransactionStatus = { type: "confirmed"; blockHeight?: number } | { type: "ready" } | { type: "waitingForDependencies" } | { type: "waitingForTimelock"; spendableAtHeight?: number } | { type: "unverified" };
 
@@ -2127,7 +2352,7 @@ export type ExternalFrostDerivation = { type: "signingLeaf"; leafId: ExternalTre
 
 export type ExternalSparkInvoiceKind = "sats" | "tokens";
 
-export type ExternalTokenTransactionKind = "freeze" | "partial" | "final";
+export type ExternalTokenTransactionKind = "freeze" | "partial" | "final" | "allowanceGrant" | "allowanceRevoke" | "allowanceSpend";
 
 export type Fee = { type: "fixed"; amount: number } | { type: "rate"; satPerVbyte: number };
 
@@ -2139,7 +2364,9 @@ export type InstantClaimStatus = { type: "declined"; maxFeeSats?: number; confir
 
 export type LnurlCallbackStatus = { type: "ok" } | { type: "errorStatus"; errorDetails: LnurlErrorDetails };
 
-export type MaxFee = { type: "fixed"; amount: number } | { type: "rate"; satPerVbyte: number } | { type: "networkRecommended"; leewaySatPerVbyte: number };
+export type MaxOnchainFee = { type: "fixed"; amount: number } | { type: "rate"; satPerVbyte: number } | { type: "networkRecommended"; leewaySatPerVbyte: number };
+
+export type MoonpayDelivery = { type: "bitcoin"; amountSat?: number } | { type: "crossChain"; amount: bigint; feeMode?: CrossChainFeeMode };
 
 export type Network = "mainnet" | "regtest" | "signet";
 
@@ -2169,15 +2396,23 @@ 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?: 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 } | { type: "crossChain"; route: CrossChainRoutePair; amount: string; 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 } | { type: "crossChain"; route: CrossChainRoutePair; amount: bigint; destination?: SparkAsset; feeMode?: CrossChainFeeMode; maxSlippageBps?: number; targetOverpayBps?: number };
+
+export type RecoveryMethod = "cooperative" | "unilateral";
+
+export type RecoveryRedoReason = "onChainStateDiverged";
+
+export type RecoveryTxKind = "cooperative" | "fanOut" | "node" | "refund" | "sweep";
+
+export type RecoveryVerdict = { type: "valid" } | { type: "done" } | { type: "redo"; reason: RecoveryRedoReason };
 
 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: "paymentMetadataUpdated"; payment: Payment } | { type: "autoOptimization"; optimizationEvent: AutoOptimizationEvent } | { type: "lightningAddressChanged"; lightningAddress?: LightningAddressInfo } | { type: "newDeposits"; newDeposits: DepositInfo[] } | { type: "unilateralExitStateChanged" } | { type: "stableBalanceConversionFailed"; conversion: StableBalanceConversionKind; error: string; retryInSecs?: number };
+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: "paymentMetadataUpdated"; payment: Payment } | { type: "autoOptimization"; optimizationEvent: AutoOptimizationEvent } | { type: "lightningAddressChanged"; lightningAddress?: LightningAddressInfo } | { type: "newDeposits"; newDeposits: DepositInfo[] } | { type: "unilateralExitStateChanged" } | { type: "stableBalanceConversionFailed"; conversion: StableBalanceConversionKind; error: string; retryInSecs?: number } | { type: "recoverableFunds"; recoverableFundsSats: number };
 
 export type Seed = { type: "mnemonic"; mnemonic: string; passphrase?: string } | ({ type: "entropy" } & number[]);
 
-export type SendPaymentMethod = { type: "bitcoinAddress"; address: BitcoinAddressDetails; feeQuote: SendOnchainFeeQuote } | { type: "bolt11Invoice"; invoiceDetails: Bolt11InvoiceDetails; sparkTransferFeeSats?: number; lightningFeeSats: number } | { type: "sparkAddress"; address: string; fee: string; tokenIdentifier?: string } | { type: "sparkInvoice"; sparkInvoiceDetails: SparkInvoiceDetails; fee: string; tokenIdentifier?: string } | { type: "crossChainAddress"; route: CrossChainRoutePair; recipientAddress: string; amountIn: string; assetAmountIn: string; estimatedOut: string; feeAmount: string; serviceFeeAmount: string; serviceFeeAsset?: string; serviceFeeAssetDecimals?: number; sourceTransferFeeSats: number; feeMode: CrossChainFeeMode; expiresAt: string; providerContext: CrossChainProviderContext };
+export type SendPaymentMethod = { type: "bitcoinAddress"; address: BitcoinAddressDetails; feeQuote: SendOnchainFeeQuote } | { type: "bolt11Invoice"; invoiceDetails: Bolt11InvoiceDetails; sparkTransferFeeSats?: number; lightningFeeSats: number } | { type: "sparkAddress"; address: string; fee: bigint; tokenIdentifier?: string } | { type: "sparkInvoice"; sparkInvoiceDetails: SparkInvoiceDetails; fee: bigint; tokenIdentifier?: string } | { type: "crossChainAddress"; route: CrossChainRoutePair; recipientAddress: string; amountIn: bigint; assetAmountIn: bigint; estimatedOut: bigint; feeAmount: bigint; serviceFeeAmount: bigint; serviceFeeAsset?: string; serviceFeeAssetDecimals?: number; sourceTransferFeeSats: number; feeMode: CrossChainFeeMode; expiresAt: string; providerContext: CrossChainProviderContext };
 
 export type SendPaymentOptions = { type: "bitcoinAddress"; confirmationSpeed: OnchainConfirmationSpeed } | { type: "bolt11Invoice"; preferSpark: boolean; completionTimeoutSecs?: number } | { type: "sparkAddress"; htlcOptions?: SparkHtlcOptions };
 
@@ -2185,6 +2420,8 @@ 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 SparkAsset = { type: "bitcoin" } | { type: "token"; tokenIdentifier: string };
 
 export type SparkHtlcStatus = "waitingForPreimage" | "preimageShared" | "returned";
@@ -2203,19 +2440,19 @@ export type SuccessActionProcessed = { type: "aes"; result: AesSuccessActionData
 
 export type SwapDegradation = "belowMinimum" | "unexpectedAsset" | "missingInfo";
 
-export type TokenTransactionType = "transfer" | "mint" | "burn";
+export type TokenAllowanceLimit = { type: "unlimited" } | { type: "amount"; amount: bigint };
 
-export type TransferSignature = { type: "transfer"; signed: ExternalPreparedTransfer } | { type: "token"; signed: ExternalPreparedTokenTransaction };
+export type TokenAllowanceRole = "owner" | "spender";
 
-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 TokenAllowanceStatus = "active" | "exhausted" | "expired" | "revoked";
 
-export type UnilateralExitRedoReason = "onChainStateDiverged";
+export type TokenTransactionType = "transfer" | "mint" | "burn";
 
-export type UnilateralExitTxKind = "fanOut" | "node" | "refund" | "sweep";
+export type TransferSignature = { type: "transfer"; signed: ExternalPreparedTransfer } | { type: "token"; signed: ExternalPreparedTokenTransaction };
 
-export type UnilateralExitVerdict = { type: "valid" } | { type: "done" } | { type: "redo"; reason: UnilateralExitRedoReason };
+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 } | { type: "tokenBatch"; prepareTokenTransaction: ExternalPrepareTokenTransactionRequest; tokenContext: number[]; totals: BatchTotal[]; isSwap: boolean };
+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: bigint; fee: bigint; isSwap: boolean } | { type: "tokenBatch"; prepareTokenTransaction: ExternalPrepareTokenTransactionRequest; tokenContext: number[]; totals: BatchTotal[]; isSwap: boolean } | { type: "tokenPull"; prepareTokenTransaction: ExternalPrepareTokenTransactionRequest; pullContext: number[]; payerAddress: string; tokenIdentifier: string; receivers: PullReceiver[]; amount: bigint; expiryTime: number };
 
 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 } | { type: "maxClaimFee"; maxFee?: MaxFee };
 
@@ -2253,16 +2490,20 @@ export class BreezSdk {
     addContact(request: AddContactRequest): Promise<Contact>;
     addEventListener(listener: EventListener): Promise<string>;
     authorizeLightningAddressTransfer(request: AuthorizeTransferRequest): Promise<TransferAuthorization>;
+    bridgeFromCashApp(request: BridgeFromCashAppRequest): Promise<BridgeFromCashAppResponse>;
+    bridgeToCashApp(request: BridgeToCashAppRequest): Promise<BridgeToCashAppResponse>;
     buildUnsignedBatchPackage(request: BuildUnsignedBatchPackageRequest): Promise<UnsignedTransferPackage>;
     buildUnsignedLnurlPayPackage(request: BuildUnsignedLnurlPayPackageRequest): Promise<UnsignedTransferPackage>;
+    buildUnsignedPullPackage(request: BuildUnsignedPullPackageRequest): Promise<UnsignedTransferPackage>;
     buildUnsignedTransferPackage(request: BuildUnsignedTransferPackageRequest): Promise<UnsignedTransferPackage>;
     buyBitcoin(request: BuyBitcoinRequest): Promise<BuyBitcoinResponse>;
     checkLightningAddressAvailable(request: CheckLightningAddressRequest): Promise<boolean>;
     checkMessage(request: CheckMessageRequest): Promise<CheckMessageResponse>;
-    checkUnilateralExit(request: CheckUnilateralExitRequest): Promise<CheckUnilateralExitResponse>;
+    checkRecoverFunds(request: CheckRecoverFundsRequest): Promise<CheckRecoverFundsResponse>;
     claimDeposit(request: ClaimDepositRequest): Promise<ClaimDepositResponse>;
     claimHtlcPayment(request: ClaimHtlcPaymentRequest): Promise<ClaimHtlcPaymentResponse>;
     claimLightningAddressTransfer(request: ClaimTransferRequest): Promise<LightningAddressInfo>;
+    createTokenAllowance(request: CreateTokenAllowanceRequest): Promise<CreateTokenAllowanceResponse>;
     deleteContact(id: string): Promise<void>;
     deleteLightningAddress(): Promise<void>;
     disconnect(): Promise<void>;
@@ -2281,6 +2522,7 @@ export class BreezSdk {
     listFiatCurrencies(): Promise<ListFiatCurrenciesResponse>;
     listFiatRates(): Promise<ListFiatRatesResponse>;
     listPayments(request: ListPaymentsRequest): Promise<ListPaymentsResponse>;
+    listTokenAllowances(request: ListTokenAllowancesRequest): Promise<ListTokenAllowancesResponse>;
     listUnclaimedDeposits(request: ListUnclaimedDepositsRequest): Promise<ListUnclaimedDepositsResponse>;
     listWebhooks(): Promise<Webhook[]>;
     lnurlAuth(request_data: LnurlAuthRequestDetails): Promise<LnurlCallbackStatus>;
@@ -2289,24 +2531,31 @@ export class BreezSdk {
     optimizeLeaves(request: OptimizeLeavesRequest): Promise<OptimizeLeavesResponse>;
     parse(input: string): Promise<InputType>;
     prepareLnurlPay(request: PrepareLnurlPayRequest): Promise<PrepareLnurlPayResponse>;
+    /**
+     * @deprecated Use `bridgeFromCashApp`.
+     */
     preparePaymentLink(request: PreparePaymentLinkRequest): Promise<PreparePaymentLinkResponse>;
+    preparePullPayment(request: PreparePullPaymentRequest): Promise<PreparePullPaymentResponse>;
+    prepareRecoverFunds(request: PrepareRecoverFundsRequest): Promise<PrepareRecoverFundsResponse>;
     prepareSendBatch(request: PrepareSendBatchRequest): Promise<PrepareSendBatchResponse>;
     prepareSendPayment(request: PrepareSendPaymentRequest): Promise<PrepareSendPaymentResponse>;
-    prepareUnilateralExit(request: PrepareUnilateralExitRequest): Promise<PrepareUnilateralExitResponse>;
     publishSignedLnurlPayPackage(request: PublishSignedLnurlPayPackageRequest): Promise<PublishSignedLnurlPayResponse>;
+    publishSignedPullPackage(request: PublishSignedPullPackageRequest): Promise<PullPaymentResponse>;
     publishSignedTransferPackage(request: PublishSignedTransferPackageRequest): Promise<PublishSignedTransferPackageResponse>;
+    pullPayment(request: PullPaymentRequest): Promise<PullPaymentResponse>;
     receivePayment(request: ReceivePaymentRequest): Promise<ReceivePaymentResponse>;
     recommendedFees(): Promise<RecommendedFees>;
+    recoverFunds(request: RecoverFundsRequest, signer?: CpfpSigner | null): Promise<RecoverFundsResponse>;
     refundDeposit(request: RefundDepositRequest): Promise<RefundDepositResponse>;
     refundPendingConversions(): Promise<RefundPendingConversionsResponse>;
     registerLightningAddress(request: RegisterLightningAddressRequest): Promise<LightningAddressInfo>;
     registerWebhook(request: RegisterWebhookRequest): Promise<RegisterWebhookResponse>;
     removeEventListener(id: string): Promise<boolean>;
+    revokeTokenAllowance(request: RevokeTokenAllowanceRequest): Promise<void>;
     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>;
@@ -2409,6 +2658,7 @@ export class ExternalSparkSignerHandle {
     getIdentityPublicKey(): Promise<PublicKeyBytes>;
     getPublicKeyForLeaf(leaf_id: ExternalTreeNodeId): Promise<PublicKeyBytes>;
     getStaticDepositPublicKey(index: number): Promise<PublicKeyBytes>;
+    isRemote(): boolean;
     prepareClaim(request: ExternalPrepareClaimRequest): Promise<ExternalPreparedClaim>;
     prepareLightningReceive(request: ExternalPrepareLightningReceiveRequest): Promise<ExternalPreparedLightningReceive>;
     prepareStaticDeposit(request: ExternalPrepareStaticDepositRequest): Promise<ExternalPreparedStaticDeposit>;
@@ -2421,7 +2671,9 @@ export class ExternalSparkSignerHandle {
     signMessage(message: Uint8Array): Promise<EcdsaSignatureBytes>;
     signSparkInvoice(request: ExternalSignSparkInvoiceRequest): Promise<ExternalSignedSparkInvoice>;
     signStaticDepositRefund(request: ExternalSignStaticDepositRefundRequest): Promise<ExternalFrostSignature>;
+    signWatchtowerExitRecovery(request: ExternalSignWatchtowerExitRecoveryRequest): Promise<ExternalFrostSignature>;
     startStaticDepositRefund(request: ExternalStartStaticDepositRefundRequest): Promise<ExternalStartedStaticDepositRefund>;
+    startWatchtowerExitRecovery(request: ExternalStartWatchtowerExitRecoveryRequest): Promise<ExternalStartedWatchtowerExitRecovery>;
 }
 
 export class IntoUnderlyingByteSource {