@breeztech/breez-sdk-spark 0.13.8-debug → 0.13.10-dev

package/deno/breez_sdk_spark_wasm.d.ts

@@ -1,34 +1,11 @@
 /* tslint:disable */
 /* eslint-disable */
-/**
- * Creates a default PostgreSQL storage configuration with sensible defaults.
- *
- * Default values (from pg.Pool):
- * - `maxPoolSize`: 10
- * - `createTimeoutSecs`: 0 (no timeout)
- * - `recycleTimeoutSecs`: 10 (10 seconds idle before disconnect)
- */
-export function defaultPostgresStorageConfig(connection_string: string): PostgresStorageConfig;
-export function defaultConfig(network: Network): Config;
-export function connect(request: ConnectRequest): Promise<BreezSdk>;
-export function defaultExternalSigner(mnemonic: string, passphrase: string | null | undefined, network: Network, key_set_config?: KeySetConfig | null): DefaultSigner;
-export function initLogging(logger: Logger, filter?: string | null): Promise<void>;
-/**
- * Creates a default external signer from a mnemonic phrase.
- *
- * This creates a signer that can be used with `connectWithSigner` or `SdkBuilder.newWithSigner`.
- */
-export function getSparkStatus(): Promise<SparkStatus>;
-export function connectWithSigner(config: Config, signer: ExternalSigner, storage_dir: string): Promise<BreezSdk>;
-/**
- * Entry point invoked by JavaScript in a worker.
- */
-export function task_worker_entry_point(ptr: number): void;
 /**
  * The `ReadableStreamType` enum.
  *
  * *This API requires the following crate features to be activated: `ReadableStreamType`*
  */
+
 type ReadableStreamType = "bytes";
 
 /** Serialized tree node. Key fields used by store implementations: id, status, value. */
@@ -54,18 +31,18 @@ interface LeavesReservation {
 }
 
 type TargetAmounts =
-    | { type: 'amountAndFee'; amountSats: number; feeSats: number | null }
-    | { type: 'exactDenominations'; denominations: number[] };
+| { type: 'amountAndFee'; amountSats: number; feeSats: number | null }
+| { type: 'exactDenominations'; denominations: number[] };
 
 type ReserveResult =
-    | { type: 'success'; reservation: LeavesReservation }
-    | { type: 'insufficientFunds' }
-    | { type: 'waitForPending'; needed: number; available: number; pending: number };
+| { type: 'success'; reservation: LeavesReservation }
+| { type: 'insufficientFunds' }
+| { type: 'waitForPending'; needed: number; available: number; pending: number };
 
 export interface TreeStore {
     addLeaves: (leaves: TreeNode[]) => Promise<void>;
     getLeaves: () => Promise<Leaves>;
-    getAvailableBalance: () => Promise<bigint | number>;
+    getAvailableBalance: () => Promise<bigint>;
     setLeaves: (leaves: TreeNode[], missingLeaves: TreeNode[], refreshStartedAtMs: number) => Promise<void>;
     cancelReservation: (id: string, leavesToKeep: TreeNode[]) => Promise<void>;
     finalizeReservation: (id: string, newLeaves: TreeNode[] | null) => Promise<void>;
@@ -74,28 +51,6 @@ export interface TreeStore {
     updateReservation: (reservationId: string, reservedLeaves: TreeNode[], changeLeaves: TreeNode[]) => Promise<LeavesReservation>;
 }
 
-/**
- * Configuration for PostgreSQL storage connection pool.
- */
-export interface PostgresStorageConfig {
-    /**
-     * PostgreSQL connection string (URI format).
-     */
-    connectionString: string;
-    /**
-     * Maximum number of connections in the pool.
-     */
-    maxPoolSize: number;
-    /**
-     * Timeout in seconds for establishing a new connection (0 = no timeout).
-     */
-    createTimeoutSecs: number;
-    /**
-     * Timeout in seconds before recycling an idle connection.
-     */
-    recycleTimeoutSecs: number;
-}
-
 
 interface WasmTokenMetadata {
     identifier: string;
@@ -142,13 +97,18 @@ interface WasmTokenOutputsReservation {
     tokenOutputs: WasmTokenOutputs;
 }
 
+interface WasmTokenBalance {
+    metadata: WasmTokenMetadata;
+    balance: string;
+}
+
 type WasmGetTokenOutputsFilter =
-    | { type: 'identifier'; identifier: string }
-    | { type: 'issuerPublicKey'; issuerPublicKey: string };
+| { type: 'identifier'; identifier: string }
+| { type: 'issuerPublicKey'; issuerPublicKey: string };
 
 type WasmReservationTarget =
-    | { type: 'minTotalValue'; value: string }
-    | { type: 'maxOutputCount'; value: number };
+| { type: 'minTotalValue'; value: string }
+| { type: 'maxOutputCount'; value: number };
 
 export interface TokenStore {
     setTokensOutputs: (tokenOutputs: WasmTokenOutputs[], refreshStartedAtMs: number) => Promise<void>;
@@ -157,39 +117,157 @@ export interface TokenStore {
     getTokenOutputs: (filter: WasmGetTokenOutputsFilter) => Promise<WasmTokenOutputsPerStatus>;
     insertTokenOutputs: (tokenOutputs: WasmTokenOutputs) => Promise<void>;
     reserveTokenOutputs: (
-        tokenIdentifier: string,
-        target: WasmReservationTarget,
-        purpose: string,
-        preferredOutputs: WasmTokenOutputWithPrevOut[] | null,
-        selectionStrategy: string | null
+    tokenIdentifier: string,
+    target: WasmReservationTarget,
+    purpose: string,
+    preferredOutputs: WasmTokenOutputWithPrevOut[] | null,
+    selectionStrategy: string | null
     ) => Promise<WasmTokenOutputsReservation>;
     cancelReservation: (id: string) => Promise<void>;
     finalizeReservation: (id: string) => Promise<void>;
     now: () => Promise<number>;
 }
 
-export interface EventListener {
-    onEvent: (e: SdkEvent) => void;
+/**
+ * A wallet derived from a passkey.
+ */
+export interface Wallet {
+    /**
+     * The derived seed.
+     */
+    seed: Seed;
+    /**
+     * The label used for derivation.
+     */
+    label: string;
 }
 
-export interface Logger {
-    log: (l: LogEntry) => void;
+/**
+ * Configuration for PostgreSQL storage connection pool.
+ */
+export interface PostgresStorageConfig {
+    /**
+     * PostgreSQL connection string (URI format).
+     */
+    connectionString: string;
+    /**
+     * Maximum number of connections in the pool.
+     */
+    maxPoolSize: number;
+    /**
+     * Timeout in seconds for establishing a new connection (0 = no timeout).
+     */
+    createTimeoutSecs: number;
+    /**
+     * Timeout in seconds before recycling an idle connection.
+     */
+    recycleTimeoutSecs: number;
 }
 
-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>;
+/**
+ * Interface for passkey PRF (Pseudo-Random Function) operations.
+ *
+ * Implement this interface to provide passkey PRF functionality for seedless wallet restore.
+ *
+ * @example
+ * ```typescript
+ * class BrowserPasskeyPrfProvider implements PasskeyPrfProvider {
+ *     async derivePrfSeed(salt: string): Promise<Uint8Array> {
+ *         const credential = await navigator.credentials.get({
+ *             publicKey: {
+ *                 challenge: new Uint8Array(32),
+ *                 rpId: window.location.hostname,
+ *                 allowCredentials: [], // or specific credential IDs
+ *                 extensions: {
+ *                     prf: { eval: { first: new TextEncoder().encode(salt) } }
+ *                 }
+ *             }
+ *         });
+ *         const results = credential.getClientExtensionResults();
+ *         return new Uint8Array(results.prf.results.first);
+ *     }
+ *
+ *     async isPrfAvailable(): Promise<boolean> {
+ *         return window.PublicKeyCredential?.isUserVerifyingPlatformAuthenticatorAvailable?.() ?? false;
+ *     }
+ * }
+ * ```
+ */
+export interface PasskeyPrfProvider {
+    /**
+     * Derive a 32-byte seed from passkey PRF with the given salt.
+     *
+     * The platform authenticates the user via passkey and evaluates the PRF extension.
+     * The salt is used as input to the PRF to derive a deterministic output.
+     *
+     * @param salt - The salt string to use for PRF evaluation
+     * @returns A Promise resolving to the 32-byte PRF output
+     * @throws If authentication fails or PRF is not supported
+     */
+    derivePrfSeed(salt: string): Promise<Uint8Array>;
+
+    /**
+     * Check if a PRF-capable passkey is available on this device.
+     *
+     * This allows applications to gracefully degrade if passkey PRF is not supported.
+     *
+     * @returns A Promise resolving to true if PRF-capable passkey is available
+     */
+    isPrfAvailable(): Promise<boolean>;
 }
 
-export interface RestResponse {
-    status: number;
-    body: string;
+/**
+ * Nostr relay configuration for passkey label operations.
+ *
+ * Used by `Passkey.listLabels` and `Passkey.storeLabel`.
+ */
+export interface NostrRelayConfig {
+    /**
+     * Optional Breez API key for authenticated access to the Breez relay.
+     * When provided, the Breez relay is added and NIP-42 authentication is enabled.
+     */
+    breezApiKey?: string;
+    /**
+     * Connection timeout in seconds. Defaults to 30 when `None`.
+     */
+    timeoutSecs?: number;
 }
 
-export interface FiatService {
-    fetchFiatCurrencies(): Promise<FiatCurrency[]>;
-    fetchFiatRates(): Promise<Rate[]>;
+export interface AddContactRequest {
+    name: string;
+    paymentIdentifier: string;
+}
+
+export interface AesSuccessActionData {
+    description: string;
+    ciphertext: string;
+    iv: string;
+}
+
+export interface AesSuccessActionDataDecrypted {
+    description: string;
+    plaintext: string;
+}
+
+export interface Bip21Details {
+    amountSat?: number;
+    assetId?: string;
+    uri: string;
+    extras: Bip21Extra[];
+    label?: string;
+    message?: string;
+    paymentMethods: InputType[];
+}
+
+export interface Bip21Extra {
+    key: string;
+    value: string;
+}
+
+export interface BitcoinAddressDetails {
+    address: string;
+    network: BitcoinNetwork;
+    source: PaymentRequestSource;
 }
 
 export interface BitcoinChainService {
@@ -200,209 +278,109 @@ export interface BitcoinChainService {
     recommendedFees(): Promise<RecommendedFees>;
 }
 
-export interface TxStatus {
-    confirmed: boolean;
-    blockHeight?: number;
-    blockTime?: number;
+export interface Bolt11Invoice {
+    bolt11: string;
+    source: PaymentRequestSource;
 }
 
-export type ChainApiType = "esplora" | "mempoolSpace";
+export interface Bolt11InvoiceDetails {
+    amountMsat?: number;
+    description?: string;
+    descriptionHash?: string;
+    expiry: number;
+    invoice: Bolt11Invoice;
+    minFinalCltvExpiryDelta: number;
+    network: BitcoinNetwork;
+    payeePubkey: string;
+    paymentHash: string;
+    paymentSecret: string;
+    routingHints: Bolt11RouteHint[];
+    timestamp: number;
+}
 
-export interface RecommendedFees {
-    fastestFee: number;
-    halfHourFee: number;
-    hourFee: number;
-    economyFee: number;
-    minimumFee: number;
+export interface Bolt11RouteHint {
+    hops: Bolt11RouteHintHop[];
 }
 
-export interface Utxo {
-    txid: string;
-    vout: number;
-    value: number;
-    status: TxStatus;
+export interface Bolt11RouteHintHop {
+    srcNodeId: string;
+    shortChannelId: string;
+    feesBaseMsat: number;
+    feesProportionalMillionths: number;
+    cltvExpiryDelta: number;
+    htlcMinimumMsat?: number;
+    htlcMaximumMsat?: number;
 }
 
-export interface PaymentObserver {
-    beforeSend: (payments: ProvisionalPayment[]) => Promise<void>;
+export interface Bolt12Invoice {
+    invoice: string;
+    source: PaymentRequestSource;
 }
 
-export interface CurrencyInfo {
-    name: string;
-    fractionSize: number;
-    spacing?: number;
-    symbol?: Symbol;
-    uniqSymbol?: Symbol;
-    localizedName: LocalizedName[];
-    localeOverrides: LocaleOverrides[];
+export interface Bolt12InvoiceDetails {
+    amountMsat: number;
+    invoice: Bolt12Invoice;
 }
 
-export interface SignMessageRequest {
-    message: string;
-    compact: boolean;
-}
-
-export interface GetPaymentRequest {
-    paymentId: string;
-}
-
-export interface PaymentMetadata {
-    parentPaymentId?: string;
-    lnurlPayInfo?: LnurlPayInfo;
-    lnurlWithdrawInfo?: LnurlWithdrawInfo;
-    lnurlDescription?: string;
-    conversionInfo?: ConversionInfo;
-    conversionStatus?: ConversionStatus;
-}
-
-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 };
-
-export interface AesSuccessActionDataDecrypted {
-    description: string;
-    plaintext: string;
-}
-
-export type UpdateDepositPayload = { type: "claimError"; error: DepositClaimError } | { type: "refund"; refundTxid: string; refundTx: string };
+export interface Bolt12InvoiceRequestDetails {}
 
-export interface ConversionDetails {
-    status: ConversionStatus;
-    from?: ConversionStep;
-    to?: ConversionStep;
+export interface Bolt12Offer {
+    offer: string;
+    source: PaymentRequestSource;
 }
 
-export interface OutgoingChange {
-    change: RecordChange;
-    parent?: Record;
+export interface Bolt12OfferBlindedPath {
+    blindedHops: string[];
 }
 
-export interface KeySetConfig {
-    keySetType: KeySetType;
-    useAddressIndex: boolean;
-    accountNumber?: number;
+export interface Bolt12OfferDetails {
+    absoluteExpiry?: number;
+    chains: string[];
+    description?: string;
+    issuer?: string;
+    minAmount?: Amount;
+    offer: Bolt12Offer;
+    paths: Bolt12OfferBlindedPath[];
+    signingPubkey?: string;
 }
 
-export interface LnurlInfo {
-    url: string;
-    bech32: string;
+export interface BurnIssuerTokenRequest {
+    amount: bigint;
 }
 
-export interface RegisterWebhookRequest {
+export interface BuyBitcoinResponse {
     url: string;
-    secret: string;
-    eventTypes: WebhookEventType[];
-}
-
-export interface PrepareLnurlPayResponse {
-    amountSats: number;
-    comment?: string;
-    payRequest: LnurlPayRequestDetails;
-    feeSats: number;
-    invoiceDetails: Bolt11InvoiceDetails;
-    successAction?: SuccessAction;
-    conversionEstimate?: ConversionEstimate;
-    feePolicy: FeePolicy;
-}
-
-export interface LightningAddressDetails {
-    address: string;
-    payRequest: LnurlPayRequestDetails;
-}
-
-export interface Payment {
-    id: string;
-    paymentType: PaymentType;
-    status: PaymentStatus;
-    amount: bigint;
-    fees: bigint;
-    timestamp: number;
-    method: PaymentMethod;
-    details?: PaymentDetails;
-    conversionDetails?: ConversionDetails;
 }
 
-export interface RefundDepositRequest {
-    txid: string;
-    vout: number;
-    destinationAddress: string;
-    fee: Fee;
+export interface CheckLightningAddressRequest {
+    username: string;
 }
 
-export interface SignMessageResponse {
+export interface CheckMessageRequest {
+    message: string;
     pubkey: string;
     signature: string;
 }
 
-export interface ListPaymentsRequest {
-    typeFilter?: PaymentType[];
-    statusFilter?: PaymentStatus[];
-    assetFilter?: AssetFilter;
-    paymentDetailsFilter?: PaymentDetailsFilter[];
-    fromTimestamp?: number;
-    toTimestamp?: number;
-    offset?: number;
-    limit?: number;
-    sortAscending?: boolean;
-}
-
-export interface Bolt11Invoice {
-    bolt11: string;
-    source: PaymentRequestSource;
-}
-
-export type SuccessActionProcessed = { type: "aes"; result: AesSuccessActionDataResult } | { type: "message"; data: MessageSuccessActionData } | { type: "url"; data: UrlSuccessActionData };
-
-export interface LightningAddressInfo {
-    description: string;
-    lightningAddress: string;
-    lnurl: LnurlInfo;
-    username: string;
-}
-
-export type Fee = { type: "fixed"; amount: number } | { type: "rate"; satPerVbyte: number };
-
-export interface Bolt11RouteHint {
-    hops: Bolt11RouteHintHop[];
-}
-
-export type ServiceStatus = "operational" | "degraded" | "partial" | "unknown" | "major";
-
-export type SparkHtlcStatus = "waitingForPreimage" | "preimageShared" | "returned";
-
-export interface SendOnchainFeeQuote {
-    id: string;
-    expiresAt: number;
-    speedFast: SendOnchainSpeedFeeQuote;
-    speedMedium: SendOnchainSpeedFeeQuote;
-    speedSlow: SendOnchainSpeedFeeQuote;
-}
-
-export type ConversionStatus = "pending" | "completed" | "failed" | "refundNeeded" | "refunded";
-
-export type OnchainConfirmationSpeed = "fast" | "medium" | "slow";
-
-export type PaymentMethod = "lightning" | "spark" | "token" | "deposit" | "withdraw" | "unknown";
-
-export interface Bip21Extra {
-    key: string;
-    value: string;
+export interface CheckMessageResponse {
+    isValid: boolean;
 }
 
-export interface Credentials {
-    username: string;
-    password: string;
+export interface ClaimDepositRequest {
+    txid: string;
+    vout: number;
+    maxFee?: MaxFee;
 }
 
-export interface FiatCurrency {
-    id: string;
-    info: CurrencyInfo;
+export interface ClaimDepositResponse {
+    payment: Payment;
 }
 
-export interface LocalizedName {
-    locale: string;
-    name: string;
+export interface ClaimHtlcPaymentRequest {
+    preimage: string;
 }
 
-export interface SendPaymentResponse {
+export interface ClaimHtlcPaymentResponse {
     payment: Payment;
 }
 
@@ -430,319 +408,311 @@ export interface Config {
     sparkConfig?: SparkConfig;
 }
 
-export interface Bolt12OfferBlindedPath {
-    blindedHops: string[];
+export interface ConnectRequest {
+    config: Config;
+    seed: Seed;
+    storageDir: string;
 }
 
-export interface ListContactsRequest {
-    offset?: number;
-    limit?: number;
+export interface Contact {
+    id: string;
+    name: string;
+    paymentIdentifier: string;
+    createdAt: number;
+    updatedAt: number;
 }
 
-export interface ReceivePaymentRequest {
-    paymentMethod: ReceivePaymentMethod;
+export interface ConversionDetails {
+    status: ConversionStatus;
+    from?: ConversionStep;
+    to?: ConversionStep;
 }
 
-export interface AesSuccessActionData {
-    description: string;
-    ciphertext: string;
-    iv: string;
+export interface ConversionEstimate {
+    options: ConversionOptions;
+    amountIn: bigint;
+    amountOut: bigint;
+    fee: bigint;
+    amountAdjustment?: AmountAdjustmentReason;
 }
 
-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);
-
-export type BuyBitcoinRequest = { type: "moonpay"; lockedAmountSat?: number; redirectUrl?: string } | { type: "cashApp"; amountSats: number };
-
-export interface SetLnurlMetadataItem {
-    paymentHash: string;
-    senderComment?: string;
-    nostrZapRequest?: string;
-    nostrZapReceipt?: string;
+export interface ConversionInfo {
+    poolId: string;
+    conversionId: string;
+    status: ConversionStatus;
+    fee?: string;
+    purpose?: ConversionPurpose;
+    amountAdjustment?: AmountAdjustmentReason;
 }
 
-export interface Rate {
-    coin: string;
-    value: number;
+export interface ConversionOptions {
+    conversionType: ConversionType;
+    maxSlippageBps?: number;
+    completionTimeoutSecs?: number;
 }
 
-export interface GetTokensMetadataResponse {
-    tokensMetadata: TokenMetadata[];
+export interface ConversionStep {
+    paymentId: string;
+    amount: bigint;
+    fee: bigint;
+    method: PaymentMethod;
+    tokenMetadata?: TokenMetadata;
+    amountAdjustment?: AmountAdjustmentReason;
 }
 
-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 } | { type: "withdraw"; txId: string } | { type: "deposit"; txId: string };
-
-export type KeySetType = "default" | "taproot" | "nativeSegwit" | "wrappedSegwit" | "legacy";
-
-export interface GetInfoRequest {
-    ensureSynced?: boolean;
+export interface CreateIssuerTokenRequest {
+    name: string;
+    ticker: string;
+    decimals: number;
+    isFreezable: boolean;
+    maxSupply: bigint;
 }
 
-export interface UpdateContactRequest {
-    id: string;
-    name: string;
-    paymentIdentifier: string;
+export interface Credentials {
+    username: string;
+    password: string;
 }
 
-export interface TokenBalance {
-    balance: bigint;
-    tokenMetadata: TokenMetadata;
+export interface CurrencyInfo {
+    name: string;
+    fractionSize: number;
+    spacing?: number;
+    symbol?: Symbol;
+    uniqSymbol?: Symbol;
+    localizedName: LocalizedName[];
+    localeOverrides: LocaleOverrides[];
 }
 
-export interface ReceivePaymentResponse {
-    paymentRequest: string;
-    fee: bigint;
+export interface DepositInfo {
+    txid: string;
+    vout: number;
+    amountSats: number;
+    isMature: boolean;
+    refundTx?: string;
+    refundTxId?: string;
+    claimError?: DepositClaimError;
 }
 
-export interface LnurlPayInfo {
-    lnAddress?: string;
-    comment?: string;
-    domain?: string;
-    metadata?: string;
-    processedSuccessAction?: SuccessActionProcessed;
-    rawSuccessAction?: SuccessAction;
+export interface EcdsaSignatureBytes {
+    bytes: number[];
 }
 
-export type MaxFee = { type: "fixed"; amount: number } | { type: "rate"; satPerVbyte: number } | { type: "networkRecommended"; leewaySatPerVbyte: number };
-
-export interface ClaimHtlcPaymentRequest {
-    preimage: string;
+export interface EventListener {
+    onEvent: (e: SdkEvent) => void;
 }
 
-export type StoragePaymentDetailsFilter = { type: "spark"; htlcStatus?: SparkHtlcStatus[]; conversionRefundNeeded?: boolean } | { type: "token"; conversionRefundNeeded?: boolean; txHash?: string; txType?: TokenTransactionType } | { type: "lightning"; htlcStatus?: SparkHtlcStatus[] };
+export interface ExternalAggregateFrostRequest {
+    message: number[];
+    statechainSignatures: IdentifierSignaturePair[];
+    statechainPublicKeys: IdentifierPublicKeyPair[];
+    verifyingKey: number[];
+    statechainCommitments: IdentifierCommitmentPair[];
+    selfCommitment: ExternalSigningCommitments;
+    publicKey: number[];
+    selfSignature: ExternalFrostSignatureShare;
+    adaptorPublicKey?: number[];
+}
 
-export interface UrlSuccessActionData {
-    description: string;
-    url: string;
-    matchesCallbackDomain: boolean;
+export interface ExternalEncryptedSecret {
+    ciphertext: number[];
 }
 
-export type OptimizationEvent = { type: "started"; totalRounds: number } | { type: "roundCompleted"; currentRound: number; totalRounds: number } | { type: "completed" } | { type: "cancelled" } | { type: "failed"; error: string } | { type: "skipped" };
+export interface ExternalFrostCommitments {
+    hidingCommitment: number[];
+    bindingCommitment: number[];
+    noncesCiphertext: number[];
+}
 
-export interface BitcoinAddressDetails {
-    address: string;
-    network: BitcoinNetwork;
-    source: PaymentRequestSource;
+export interface ExternalFrostSignature {
+    bytes: number[];
 }
 
-export interface FetchConversionLimitsResponse {
-    minFromAmount?: bigint;
-    minToAmount?: bigint;
+export interface ExternalFrostSignatureShare {
+    bytes: number[];
 }
 
-export type StableBalanceActiveLabel = { type: "set"; label: string } | { type: "unset" };
+export interface ExternalIdentifier {
+    bytes: number[];
+}
 
-export interface UnregisterWebhookRequest {
-    webhookId: string;
+export interface ExternalInputParser {
+    providerId: string;
+    inputRegex: string;
+    parserUrl: string;
 }
 
-export type SuccessAction = { type: "aes"; data: AesSuccessActionData } | { type: "message"; data: MessageSuccessActionData } | { type: "url"; data: UrlSuccessActionData };
+export interface ExternalScalar {
+    bytes: number[];
+}
 
-export type PaymentDetailsFilter = { type: "spark"; htlcStatus?: SparkHtlcStatus[]; conversionRefundNeeded?: boolean } | { type: "token"; conversionRefundNeeded?: boolean; txHash?: string; txType?: TokenTransactionType } | { type: "lightning"; htlcStatus?: SparkHtlcStatus[] };
+export interface ExternalSecretShare {
+    threshold: number;
+    index: ExternalScalar;
+    share: ExternalScalar;
+}
 
-export interface UnversionedRecordChange {
-    id: RecordId;
-    schemaVersion: string;
-    updatedFields: Map<string, string>;
+export interface ExternalSignFrostRequest {
+    message: number[];
+    publicKey: number[];
+    secret: ExternalSecretSource;
+    verifyingKey: number[];
+    selfNonceCommitment: ExternalFrostCommitments;
+    statechainCommitments: IdentifierCommitmentPair[];
+    adaptorPublicKey?: number[];
 }
 
-export interface AddContactRequest {
-    name: string;
-    paymentIdentifier: string;
+export interface ExternalSigner {
+    identityPublicKey(): PublicKeyBytes;
+    derivePublicKey(path: string): Promise<PublicKeyBytes>;
+    signEcdsa(message: MessageBytes, path: string): Promise<EcdsaSignatureBytes>;
+    signEcdsaRecoverable(message: MessageBytes, path: string): Promise<RecoverableEcdsaSignatureBytes>;
+    encryptEcies(message: Uint8Array, path: string): Promise<Uint8Array>;
+    decryptEcies(message: Uint8Array, path: string): Promise<Uint8Array>;
+    signHashSchnorr(hash: Uint8Array, path: string): Promise<SchnorrSignatureBytes>;
+    generateRandomSigningCommitment(): Promise<ExternalFrostCommitments>;
+    getPublicKeyForNode(id: ExternalTreeNodeId): Promise<PublicKeyBytes>;
+    generateRandomSecret(): Promise<ExternalEncryptedSecret>;
+    staticDepositSecretEncrypted(index: number): Promise<ExternalSecretSource>;
+    staticDepositSecret(index: number): Promise<SecretBytes>;
+    staticDepositSigningKey(index: number): Promise<PublicKeyBytes>;
+    subtractSecrets(signingKey: ExternalSecretSource, newSigningKey: ExternalSecretSource): Promise<ExternalSecretSource>;
+    splitSecretWithProofs(secret: ExternalSecretToSplit, threshold: number, numShares: number): Promise<ExternalVerifiableSecretShare[]>;
+    encryptPrivateKeyForReceiver(privateKey: ExternalEncryptedSecret, receiverPublicKey: PublicKeyBytes): Promise<Uint8Array>;
+    publicKeyFromSecret(privateKey: ExternalSecretSource): Promise<PublicKeyBytes>;
+    signFrost(request: ExternalSignFrostRequest): Promise<ExternalFrostSignatureShare>;
+    aggregateFrost(request: ExternalAggregateFrostRequest): Promise<ExternalFrostSignature>;
+    hmacSha256(message: Uint8Array, path: string): Promise<HashedMessageBytes>;
 }
 
-export type ProvisionalPaymentDetails = { type: "bitcoin"; withdrawalAddress: string } | { type: "lightning"; invoice: string } | { type: "spark"; payRequest: string } | { type: "token"; tokenId: string; payRequest: string };
+export interface ExternalSigningCommitments {
+    hiding: number[];
+    binding: number[];
+}
 
-export interface Bolt11RouteHintHop {
-    srcNodeId: string;
-    shortChannelId: string;
-    feesBaseMsat: number;
-    feesProportionalMillionths: number;
-    cltvExpiryDelta: number;
-    htlcMinimumMsat?: number;
-    htlcMaximumMsat?: number;
+export interface ExternalTreeNodeId {
+    id: string;
 }
 
-export type SendPaymentOptions = { type: "bitcoinAddress"; confirmationSpeed: OnchainConfirmationSpeed } | { type: "bolt11Invoice"; preferSpark: boolean; completionTimeoutSecs?: number } | { type: "sparkAddress"; htlcOptions?: SparkHtlcOptions };
+export interface ExternalVerifiableSecretShare {
+    secretShare: ExternalSecretShare;
+    proofs: number[][];
+}
 
-export interface ClaimHtlcPaymentResponse {
-    payment: Payment;
+export interface FetchConversionLimitsRequest {
+    conversionType: ConversionType;
+    tokenIdentifier?: string;
 }
 
-export interface SparkStatus {
-    status: ServiceStatus;
-    lastUpdated: number;
+export interface FetchConversionLimitsResponse {
+    minFromAmount?: bigint;
+    minToAmount?: bigint;
 }
 
-export interface ConnectRequest {
-    config: Config;
-    seed: Seed;
-    storageDir: string;
+export interface FiatCurrency {
+    id: string;
+    info: CurrencyInfo;
 }
 
-export type AssetFilter = { type: "bitcoin" } | { type: "token"; tokenIdentifier?: string };
+export interface FiatService {
+    fetchFiatCurrencies(): Promise<FiatCurrency[]>;
+    fetchFiatRates(): Promise<Rate[]>;
+}
 
-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 interface FreezeIssuerTokenRequest {
+    address: string;
+}
 
-export interface LogEntry {
-    line: string;
-    level: string;
+export interface FreezeIssuerTokenResponse {
+    impactedOutputIds: string[];
+    impactedTokenAmount: bigint;
 }
 
-export interface UserSettings {
-    sparkPrivateModeEnabled: boolean;
-    stableBalanceActiveLabel?: string;
+export interface GetInfoRequest {
+    ensureSynced?: boolean;
 }
 
-export interface StableBalanceToken {
-    label: string;
-    tokenIdentifier: string;
+export interface GetInfoResponse {
+    identityPubkey: string;
+    balanceSats: number;
+    tokenBalances: Map<string, TokenBalance>;
 }
 
-export interface OptimizationProgress {
-    isRunning: boolean;
-    currentRound: number;
-    totalRounds: number;
+export interface GetPaymentRequest {
+    paymentId: string;
 }
 
-export interface ListUnclaimedDepositsResponse {
-    deposits: DepositInfo[];
+export interface GetPaymentResponse {
+    payment: Payment;
 }
 
-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: "optimization"; optimizationEvent: OptimizationEvent } | { type: "lightningAddressChanged"; lightningAddress?: LightningAddressInfo } | { type: "newDeposits"; newDeposits: DepositInfo[] };
+export interface GetTokensMetadataRequest {
+    tokenIdentifiers: string[];
+}
 
-export interface StableBalanceConfig {
-    tokens: StableBalanceToken[];
-    defaultActiveLabel?: string;
-    thresholdSats?: number;
-    maxSlippageBps?: number;
+export interface GetTokensMetadataResponse {
+    tokensMetadata: TokenMetadata[];
 }
 
-export interface SilentPaymentAddressDetails {
-    address: string;
-    network: BitcoinNetwork;
-    source: PaymentRequestSource;
+export interface HashedMessageBytes {
+    bytes: number[];
 }
 
-export interface LnurlAuthRequestDetails {
-    k1: string;
-    action?: string;
-    domain: string;
-    url: string;
+export interface IdentifierCommitmentPair {
+    identifier: ExternalIdentifier;
+    commitment: ExternalSigningCommitments;
 }
 
-export interface LnurlReceiveMetadata {
-    nostrZapRequest?: string;
-    nostrZapReceipt?: string;
-    senderComment?: string;
+export interface IdentifierPublicKeyPair {
+    identifier: ExternalIdentifier;
+    publicKey: number[];
 }
 
-export type AesSuccessActionDataResult = { type: "decrypted"; data: AesSuccessActionDataDecrypted } | { type: "errorStatus"; reason: string };
+export interface IdentifierSignaturePair {
+    identifier: ExternalIdentifier;
+    signature: ExternalFrostSignatureShare;
+}
 
-export interface ConversionInfo {
-    poolId: string;
-    conversionId: string;
-    status: ConversionStatus;
-    fee?: string;
-    purpose?: ConversionPurpose;
-    amountAdjustment?: AmountAdjustmentReason;
+export interface IncomingChange {
+    newState: Record;
+    oldState?: Record;
 }
 
-export interface LnurlPayRequest {
-    prepareResponse: PrepareLnurlPayResponse;
-    idempotencyKey?: string;
+export interface KeySetConfig {
+    keySetType: KeySetType;
+    useAddressIndex: boolean;
+    accountNumber?: number;
 }
 
-export interface Bolt11InvoiceDetails {
-    amountMsat?: number;
-    description?: string;
-    descriptionHash?: string;
-    expiry: number;
-    invoice: Bolt11Invoice;
-    minFinalCltvExpiryDelta: number;
-    network: BitcoinNetwork;
-    payeePubkey: string;
-    paymentHash: string;
-    paymentSecret: string;
-    routingHints: Bolt11RouteHint[];
-    timestamp: number;
+export interface LightningAddressDetails {
+    address: string;
+    payRequest: LnurlPayRequestDetails;
 }
 
-export interface RefundDepositResponse {
-    txId: string;
-    txHex: string;
+export interface LightningAddressInfo {
+    description: string;
+    lightningAddress: string;
+    lnurl: LnurlInfo;
+    username: string;
 }
 
-export interface Bolt12InvoiceDetails {
-    amountMsat: number;
-    invoice: Bolt12Invoice;
+export interface ListContactsRequest {
+    offset?: number;
+    limit?: number;
 }
 
 export interface ListFiatCurrenciesResponse {
     currencies: FiatCurrency[];
 }
 
-export interface SparkInvoicePaymentDetails {
-    description?: string;
-    invoice: string;
-}
-
-export type PaymentType = "send" | "receive";
-
-export interface LnurlWithdrawInfo {
-    withdrawUrl: string;
-}
-
-export interface FetchConversionLimitsRequest {
-    conversionType: ConversionType;
-    tokenIdentifier?: string;
-}
-
-export interface IncomingChange {
-    newState: Record;
-    oldState?: Record;
-}
-
-export interface LnurlPayRequestDetails {
-    callback: string;
-    minSendable: number;
-    maxSendable: number;
-    metadataStr: string;
-    commentAllowed: number;
-    domain: string;
-    url: string;
-    address?: string;
-    allowsNostr?: boolean;
-    nostrPubkey?: string;
-}
-
-export interface UpdateUserSettingsRequest {
-    sparkPrivateModeEnabled?: boolean;
-    stableBalanceActiveLabel?: StableBalanceActiveLabel;
-}
-
-export interface MessageSuccessActionData {
-    message: string;
-}
-
-export interface ConversionStep {
-    paymentId: string;
-    amount: bigint;
-    fee: bigint;
-    method: PaymentMethod;
-    tokenMetadata?: TokenMetadata;
-    amountAdjustment?: AmountAdjustmentReason;
-}
-
-export interface SendOnchainSpeedFeeQuote {
-    userFeeSat: number;
-    l1BroadcastFeeSat: number;
+export interface ListFiatRatesResponse {
+    rates: Rate[];
 }
 
-export interface StorageListPaymentsRequest {
+export interface ListPaymentsRequest {
     typeFilter?: PaymentType[];
     statusFilter?: PaymentStatus[];
     assetFilter?: AssetFilter;
-    paymentDetailsFilter?: StoragePaymentDetailsFilter[];
+    paymentDetailsFilter?: PaymentDetailsFilter[];
     fromTimestamp?: number;
     toTimestamp?: number;
     offset?: number;
@@ -750,74 +720,78 @@ export interface StorageListPaymentsRequest {
     sortAscending?: boolean;
 }
 
-export interface SparkHtlcDetails {
-    paymentHash: string;
-    preimage?: string;
-    expiryTime: number;
-    status: SparkHtlcStatus;
+export interface ListPaymentsResponse {
+    payments: Payment[];
 }
 
-export interface Contact {
-    id: string;
-    name: string;
-    paymentIdentifier: string;
-    createdAt: number;
-    updatedAt: number;
-}
+export interface ListUnclaimedDepositsRequest {}
 
-export type Amount = { type: "bitcoin"; amountMsat: number } | { type: "currency"; iso4217Code: string; fractionalAmount: number };
+export interface ListUnclaimedDepositsResponse {
+    deposits: DepositInfo[];
+}
 
-export interface BuyBitcoinResponse {
+export interface LnurlAuthRequestDetails {
+    k1: string;
+    action?: string;
+    domain: string;
     url: string;
 }
 
-export interface SparkSigningOperator {
-    id: number;
-    identifier: string;
-    address: string;
-    identityPublicKey: string;
+export interface LnurlErrorDetails {
+    reason: string;
 }
 
-export interface Bolt12OfferDetails {
-    absoluteExpiry?: number;
-    chains: string[];
-    description?: string;
-    issuer?: string;
-    minAmount?: Amount;
-    offer: Bolt12Offer;
-    paths: Bolt12OfferBlindedPath[];
-    signingPubkey?: string;
+export interface LnurlInfo {
+    url: string;
+    bech32: string;
 }
 
-export interface GetInfoResponse {
-    identityPubkey: string;
-    balanceSats: number;
-    tokenBalances: Map<string, TokenBalance>;
+export interface LnurlPayInfo {
+    lnAddress?: string;
+    comment?: string;
+    domain?: string;
+    metadata?: string;
+    processedSuccessAction?: SuccessActionProcessed;
+    rawSuccessAction?: SuccessAction;
 }
 
-export interface SparkAddressDetails {
-    address: string;
-    identityPublicKey: string;
-    network: BitcoinNetwork;
-    source: PaymentRequestSource;
+export interface LnurlPayRequest {
+    prepareResponse: PrepareLnurlPayResponse;
+    idempotencyKey?: string;
 }
 
-export interface LnurlWithdrawResponse {
-    paymentRequest: string;
-    payment?: Payment;
+export interface LnurlPayRequestDetails {
+    callback: string;
+    minSendable: number;
+    maxSendable: number;
+    metadataStr: string;
+    commentAllowed: number;
+    domain: string;
+    url: string;
+    address?: string;
+    allowsNostr?: boolean;
+    nostrPubkey?: string;
 }
 
-export interface GetPaymentResponse {
+export interface LnurlPayResponse {
     payment: Payment;
+    successAction?: SuccessActionProcessed;
 }
 
-export type FeePolicy = "feesExcluded" | "feesIncluded";
+export interface LnurlReceiveMetadata {
+    nostrZapRequest?: string;
+    nostrZapReceipt?: string;
+    senderComment?: string;
+}
 
-export type Seed = { type: "mnemonic"; mnemonic: string; passphrase?: string } | ({ type: "entropy" } & number[]);
+export interface LnurlWithdrawInfo {
+    withdrawUrl: string;
+}
 
-export interface Bolt12Offer {
-    offer: string;
-    source: PaymentRequestSource;
+export interface LnurlWithdrawRequest {
+    amountSats: number;
+    withdrawRequest: LnurlWithdrawRequestDetails;
+    completionTimeoutSecs?: number;
 }
 
 export interface LnurlWithdrawRequestDetails {
@@ -828,137 +802,87 @@ export interface LnurlWithdrawRequestDetails {
     maxWithdrawable: number;
 }
 
-export interface PaymentRequestSource {
-    bip21Uri?: string;
-    bip353Address?: string;
+export interface LnurlWithdrawResponse {
+    paymentRequest: string;
+    payment?: Payment;
 }
 
-export type LnurlCallbackStatus = { type: "ok" } | { type: "errorStatus"; errorDetails: LnurlErrorDetails };
-
-export interface OptimizationConfig {
-    autoEnabled: boolean;
-    multiplicity: number;
+export interface LocaleOverrides {
+    locale: string;
+    spacing?: number;
+    symbol: Symbol;
 }
 
-export interface ClaimDepositRequest {
-    txid: string;
-    vout: number;
-    maxFee?: MaxFee;
+export interface LocalizedName {
+    locale: string;
+    name: string;
 }
 
-export interface CheckMessageResponse {
-    isValid: boolean;
+export interface LogEntry {
+    line: string;
+    level: string;
 }
 
-export interface ListUnclaimedDepositsRequest {}
-
-export interface ClaimDepositResponse {
-    payment: Payment;
+export interface Logger {
+    log: (l: LogEntry) => void;
 }
 
-export type ConversionPurpose = { type: "ongoingPayment"; paymentRequest: string } | { type: "selfTransfer" } | { type: "autoConversion" };
-
-export interface LnurlErrorDetails {
-    reason: string;
+export interface MessageBytes {
+    bytes: number[];
 }
 
-export interface SparkSspConfig {
-    baseUrl: string;
-    identityPublicKey: string;
-    schemaEndpoint?: string;
+export interface MessageSuccessActionData {
+    message: string;
 }
 
-export type Network = "mainnet" | "regtest";
-
-export type ConversionType = { type: "fromBitcoin" } | { type: "toBitcoin"; fromTokenIdentifier: string };
-
-export interface Symbol {
-    grapheme?: string;
-    template?: string;
-    rtl?: boolean;
-    position?: number;
+export interface MintIssuerTokenRequest {
+    amount: bigint;
 }
 
-export interface CheckMessageRequest {
-    message: string;
-    pubkey: string;
-    signature: string;
+export interface OptimizationConfig {
+    autoEnabled: boolean;
+    multiplicity: number;
 }
 
-export interface RecordId {
-    type: string;
-    dataId: string;
+export interface OptimizationProgress {
+    isRunning: boolean;
+    currentRound: number;
+    totalRounds: number;
 }
 
-export interface PrepareSendPaymentResponse {
-    paymentMethod: SendPaymentMethod;
-    amount: bigint;
-    tokenIdentifier?: string;
-    conversionEstimate?: ConversionEstimate;
-    feePolicy: FeePolicy;
-}
-
-export type BitcoinNetwork = "bitcoin" | "testnet3" | "testnet4" | "signet" | "regtest";
-
-export interface CheckLightningAddressRequest {
-    username: string;
-}
-
-export interface Bolt12Invoice {
-    invoice: string;
-    source: PaymentRequestSource;
-}
-
-export interface Bip21Details {
-    amountSat?: number;
-    assetId?: string;
-    uri: string;
-    extras: Bip21Extra[];
-    label?: string;
-    message?: string;
-    paymentMethods: InputType[];
-}
-
-export interface LocaleOverrides {
-    locale: string;
-    spacing?: number;
-    symbol: Symbol;
-}
-
-export interface DepositInfo {
-    txid: string;
-    vout: number;
-    amountSats: number;
-    isMature: boolean;
-    refundTx?: string;
-    refundTxId?: string;
-    claimError?: DepositClaimError;
+export interface OutgoingChange {
+    change: RecordChange;
+    parent?: Record;
 }
 
-export interface SendPaymentRequest {
-    prepareResponse: PrepareSendPaymentResponse;
-    options?: SendPaymentOptions;
-    idempotencyKey?: string;
+export interface Payment {
+    id: string;
+    paymentType: PaymentType;
+    status: PaymentStatus;
+    amount: bigint;
+    fees: bigint;
+    timestamp: number;
+    method: PaymentMethod;
+    details?: PaymentDetails;
+    conversionDetails?: ConversionDetails;
 }
 
-export interface Webhook {
-    id: string;
-    url: string;
-    eventTypes: WebhookEventType[];
+export interface PaymentMetadata {
+    parentPaymentId?: string;
+    lnurlPayInfo?: LnurlPayInfo;
+    lnurlWithdrawInfo?: LnurlWithdrawInfo;
+    lnurlDescription?: string;
+    conversionInfo?: ConversionInfo;
+    conversionStatus?: ConversionStatus;
 }
 
-export interface ListFiatRatesResponse {
-    rates: Rate[];
+export interface PaymentObserver {
+    beforeSend: (payments: ProvisionalPayment[]) => Promise<void>;
 }
 
-export interface TokenMetadata {
-    identifier: string;
-    issuerPublicKey: string;
-    name: string;
-    ticker: string;
-    decimals: number;
-    maxSupply: string;
-    isFreezable: boolean;
+export interface PaymentRequestSource {
+    bip21Uri?: string;
+    bip353Address?: string;
 }
 
 export interface PrepareLnurlPayRequest {
@@ -971,7 +895,32 @@ export interface PrepareLnurlPayRequest {
     feePolicy?: FeePolicy;
 }
 
-export interface SyncWalletRequest {}
+export interface PrepareLnurlPayResponse {
+    amountSats: number;
+    comment?: string;
+    payRequest: LnurlPayRequestDetails;
+    feeSats: number;
+    invoiceDetails: Bolt11InvoiceDetails;
+    successAction?: SuccessAction;
+    conversionEstimate?: ConversionEstimate;
+    feePolicy: FeePolicy;
+}
+
+export interface PrepareSendPaymentRequest {
+    paymentRequest: string;
+    amount?: bigint;
+    tokenIdentifier?: string;
+    conversionOptions?: ConversionOptions;
+    feePolicy?: FeePolicy;
+}
+
+export interface PrepareSendPaymentResponse {
+    paymentMethod: SendPaymentMethod;
+    amount: bigint;
+    tokenIdentifier?: string;
+    conversionEstimate?: ConversionEstimate;
+    feePolicy: FeePolicy;
+}
 
 export interface ProvisionalPayment {
     paymentId: string;
@@ -979,7 +928,38 @@ export interface ProvisionalPayment {
     details: ProvisionalPaymentDetails;
 }
 
-export interface SyncWalletResponse {}
+export interface PublicKeyBytes {
+    bytes: number[];
+}
+
+export interface Rate {
+    coin: string;
+    value: number;
+}
+
+export interface ReceivePaymentRequest {
+    paymentMethod: ReceivePaymentMethod;
+}
+
+export interface ReceivePaymentResponse {
+    paymentRequest: string;
+    fee: bigint;
+}
+
+export interface RecommendedFees {
+    fastestFee: number;
+    halfHourFee: number;
+    hourFee: number;
+    economyFee: number;
+    minimumFee: number;
+}
+
+export interface Record {
+    id: RecordId;
+    revision: number;
+    schemaVersion: string;
+    data: Map<string, string>;
+}
 
 export interface RecordChange {
     id: RecordId;
@@ -988,359 +968,179 @@ export interface RecordChange {
     localRevision: number;
 }
 
-export interface RegisterLightningAddressRequest {
-    username: string;
-    description?: string;
-}
-
-export type TokenTransactionType = "transfer" | "mint" | "burn";
-
-export interface SparkConfig {
-    coordinatorIdentifier: string;
-    threshold: number;
-    signingOperators: SparkSigningOperator[];
-    sspConfig: SparkSspConfig;
-    expectedWithdrawBondSats: number;
-    expectedWithdrawRelativeBlockLocktime: number;
+export interface RecordId {
+    type: string;
+    dataId: string;
 }
 
-export interface LnurlPayResponse {
-    payment: Payment;
-    successAction?: SuccessActionProcessed;
+export interface RecoverableEcdsaSignatureBytes {
+    bytes: number[];
 }
 
-export interface PrepareSendPaymentRequest {
-    paymentRequest: string;
-    amount?: bigint;
-    tokenIdentifier?: string;
-    conversionOptions?: ConversionOptions;
-    feePolicy?: FeePolicy;
+export interface RefundDepositRequest {
+    txid: string;
+    vout: number;
+    destinationAddress: string;
+    fee: Fee;
 }
 
-export interface SparkHtlcOptions {
-    paymentHash: string;
-    expiryDurationSecs: number;
+export interface RefundDepositResponse {
+    txId: string;
+    txHex: string;
 }
 
-export interface SparkInvoiceDetails {
-    invoice: string;
-    identityPublicKey: string;
-    network: BitcoinNetwork;
-    amount?: string;
-    tokenIdentifier?: string;
-    expiryTime?: number;
+export interface RegisterLightningAddressRequest {
+    username: string;
     description?: string;
-    senderPublicKey?: string;
 }
 
-export interface ExternalInputParser {
-    providerId: string;
-    inputRegex: string;
-    parserUrl: string;
+export interface RegisterWebhookRequest {
+    url: string;
+    secret: string;
+    eventTypes: WebhookEventType[];
 }
 
-export interface ConversionOptions {
-    conversionType: ConversionType;
-    maxSlippageBps?: number;
-    completionTimeoutSecs?: number;
+export interface RegisterWebhookResponse {
+    webhookId: string;
 }
 
-export interface LnurlWithdrawRequest {
-    amountSats: number;
-    withdrawRequest: LnurlWithdrawRequestDetails;
-    completionTimeoutSecs?: number;
+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>;
 }
 
-export interface Bolt12InvoiceRequestDetails {}
+export interface RestResponse {
+    status: number;
+    body: string;
+}
 
-export type AmountAdjustmentReason = "flooredToMinLimit" | "increasedToAvoidDust";
+export interface SchnorrSignatureBytes {
+    bytes: number[];
+}
 
-export interface ConversionEstimate {
-    options: ConversionOptions;
-    amountIn: bigint;
-    amountOut: bigint;
-    fee: bigint;
-    amountAdjustment?: AmountAdjustmentReason;
+export interface SecretBytes {
+    bytes: number[];
 }
 
-export interface Record {
-    id: RecordId;
-    revision: number;
-    schemaVersion: string;
-    data: Map<string, string>;
+export interface SendOnchainFeeQuote {
+    id: string;
+    expiresAt: number;
+    speedFast: SendOnchainSpeedFeeQuote;
+    speedMedium: SendOnchainSpeedFeeQuote;
+    speedSlow: SendOnchainSpeedFeeQuote;
 }
 
-export interface GetTokensMetadataRequest {
-    tokenIdentifiers: string[];
+export interface SendOnchainSpeedFeeQuote {
+    userFeeSat: number;
+    l1BroadcastFeeSat: number;
 }
 
-export interface ListPaymentsResponse {
-    payments: Payment[];
+export interface SendPaymentRequest {
+    prepareResponse: PrepareSendPaymentResponse;
+    options?: SendPaymentOptions;
+    idempotencyKey?: string;
 }
 
-export type WebhookEventType = { type: "lightningReceiveFinished" } | { type: "lightningSendFinished" } | { type: "coopExitFinished" } | { type: "staticDepositFinished" } | ({ type: "unknown" } & string);
-
-export type PaymentStatus = "completed" | "pending" | "failed";
-
-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 };
-
-export interface RegisterWebhookResponse {
-    webhookId: string;
-}
-
-/**
- * Interface for passkey PRF (Pseudo-Random Function) operations.
- *
- * Implement this interface to provide passkey PRF functionality for seedless wallet restore.
- *
- * @example
- * ```typescript
- * class BrowserPasskeyPrfProvider implements PasskeyPrfProvider {
- *     async derivePrfSeed(salt: string): Promise<Uint8Array> {
- *         const credential = await navigator.credentials.get({
- *             publicKey: {
- *                 challenge: new Uint8Array(32),
- *                 rpId: window.location.hostname,
- *                 allowCredentials: [], // or specific credential IDs
- *                 extensions: {
- *                     prf: { eval: { first: new TextEncoder().encode(salt) } }
- *                 }
- *             }
- *         });
- *         const results = credential.getClientExtensionResults();
- *         return new Uint8Array(results.prf.results.first);
- *     }
- *
- *     async isPrfAvailable(): Promise<boolean> {
- *         return window.PublicKeyCredential?.isUserVerifyingPlatformAuthenticatorAvailable?.() ?? false;
- *     }
- * }
- * ```
- */
-export interface PasskeyPrfProvider {
-    /**
-     * Derive a 32-byte seed from passkey PRF with the given salt.
-     *
-     * The platform authenticates the user via passkey and evaluates the PRF extension.
-     * The salt is used as input to the PRF to derive a deterministic output.
-     *
-     * @param salt - The salt string to use for PRF evaluation
-     * @returns A Promise resolving to the 32-byte PRF output
-     * @throws If authentication fails or PRF is not supported
-     */
-    derivePrfSeed(salt: string): Promise<Uint8Array>;
-
-    /**
-     * Check if a PRF-capable passkey is available on this device.
-     *
-     * This allows applications to gracefully degrade if passkey PRF is not supported.
-     *
-     * @returns A Promise resolving to true if PRF-capable passkey is available
-     */
-    isPrfAvailable(): Promise<boolean>;
+export interface SendPaymentResponse {
+    payment: Payment;
 }
 
-export interface MintIssuerTokenRequest {
-    amount: bigint;
+export interface SetLnurlMetadataItem {
+    paymentHash: string;
+    senderComment?: string;
+    nostrZapRequest?: string;
+    nostrZapReceipt?: string;
 }
 
-export interface UnfreezeIssuerTokenResponse {
-    impactedOutputIds: string[];
-    impactedTokenAmount: bigint;
+export interface SignMessageRequest {
+    message: string;
+    compact: boolean;
 }
 
-export interface CreateIssuerTokenRequest {
-    name: string;
-    ticker: string;
-    decimals: number;
-    isFreezable: boolean;
-    maxSupply: bigint;
+export interface SignMessageResponse {
+    pubkey: string;
+    signature: string;
 }
 
-export interface FreezeIssuerTokenRequest {
+export interface SilentPaymentAddressDetails {
     address: string;
+    network: BitcoinNetwork;
+    source: PaymentRequestSource;
 }
 
-export interface FreezeIssuerTokenResponse {
-    impactedOutputIds: string[];
-    impactedTokenAmount: bigint;
-}
-
-export interface BurnIssuerTokenRequest {
-    amount: bigint;
-}
-
-export interface UnfreezeIssuerTokenRequest {
+export interface SparkAddressDetails {
     address: string;
+    identityPublicKey: string;
+    network: BitcoinNetwork;
+    source: PaymentRequestSource;
 }
 
-export interface ExternalSigner {
-    identityPublicKey(): PublicKeyBytes;
-    derivePublicKey(path: string): Promise<PublicKeyBytes>;
-    signEcdsa(message: MessageBytes, path: string): Promise<EcdsaSignatureBytes>;
-    signEcdsaRecoverable(message: MessageBytes, path: string): Promise<RecoverableEcdsaSignatureBytes>;
-    encryptEcies(message: Uint8Array, path: string): Promise<Uint8Array>;
-    decryptEcies(message: Uint8Array, path: string): Promise<Uint8Array>;
-    signHashSchnorr(hash: Uint8Array, path: string): Promise<SchnorrSignatureBytes>;
-    generateRandomSigningCommitment(): Promise<ExternalFrostCommitments>;
-    getPublicKeyForNode(id: ExternalTreeNodeId): Promise<PublicKeyBytes>;
-    generateRandomSecret(): Promise<ExternalEncryptedSecret>;
-    staticDepositSecretEncrypted(index: number): Promise<ExternalSecretSource>;
-    staticDepositSecret(index: number): Promise<SecretBytes>;
-    staticDepositSigningKey(index: number): Promise<PublicKeyBytes>;
-    subtractSecrets(signingKey: ExternalSecretSource, newSigningKey: ExternalSecretSource): Promise<ExternalSecretSource>;
-    splitSecretWithProofs(secret: ExternalSecretToSplit, threshold: number, numShares: number): Promise<ExternalVerifiableSecretShare[]>;
-    encryptPrivateKeyForReceiver(privateKey: ExternalEncryptedSecret, receiverPublicKey: PublicKeyBytes): Promise<Uint8Array>;
-    publicKeyFromSecret(privateKey: ExternalSecretSource): Promise<PublicKeyBytes>;
-    signFrost(request: ExternalSignFrostRequest): Promise<ExternalFrostSignatureShare>;
-    aggregateFrost(request: ExternalAggregateFrostRequest): Promise<ExternalFrostSignature>;
-    hmacSha256(message: Uint8Array, path: string): Promise<HashedMessageBytes>;
-}
-
-export interface ExternalScalar {
-    bytes: number[];
-}
-
-export interface RecoverableEcdsaSignatureBytes {
-    bytes: number[];
-}
-
-export type ExternalSecretToSplit = { type: "secretSource"; source: ExternalSecretSource } | { type: "preimage"; data: number[] };
-
-export interface PublicKeyBytes {
-    bytes: number[];
-}
-
-export interface IdentifierCommitmentPair {
-    identifier: ExternalIdentifier;
-    commitment: ExternalSigningCommitments;
-}
-
-export interface ExternalSigningCommitments {
-    hiding: number[];
-    binding: number[];
-}
-
-export interface ExternalTreeNodeId {
-    id: string;
-}
-
-export interface IdentifierSignaturePair {
-    identifier: ExternalIdentifier;
-    signature: ExternalFrostSignatureShare;
-}
-
-export interface ExternalEncryptedSecret {
-    ciphertext: number[];
-}
-
-export interface MessageBytes {
-    bytes: number[];
-}
-
-export type ExternalSecretSource = { type: "derived"; nodeId: ExternalTreeNodeId } | { type: "encrypted"; key: ExternalEncryptedSecret };
-
-export interface ExternalFrostSignature {
-    bytes: number[];
-}
-
-export interface EcdsaSignatureBytes {
-    bytes: number[];
-}
-
-export interface ExternalAggregateFrostRequest {
-    message: number[];
-    statechainSignatures: IdentifierSignaturePair[];
-    statechainPublicKeys: IdentifierPublicKeyPair[];
-    verifyingKey: number[];
-    statechainCommitments: IdentifierCommitmentPair[];
-    selfCommitment: ExternalSigningCommitments;
-    publicKey: number[];
-    selfSignature: ExternalFrostSignatureShare;
-    adaptorPublicKey?: number[];
-}
-
-export interface ExternalSignFrostRequest {
-    message: number[];
-    publicKey: number[];
-    secret: ExternalSecretSource;
-    verifyingKey: number[];
-    selfNonceCommitment: ExternalFrostCommitments;
-    statechainCommitments: IdentifierCommitmentPair[];
-    adaptorPublicKey?: number[];
-}
-
-export interface ExternalFrostCommitments {
-    hidingCommitment: number[];
-    bindingCommitment: number[];
-    noncesCiphertext: number[];
-}
-
-export interface ExternalVerifiableSecretShare {
-    secretShare: ExternalSecretShare;
-    proofs: number[][];
+export interface SparkConfig {
+    coordinatorIdentifier: string;
+    threshold: number;
+    signingOperators: SparkSigningOperator[];
+    sspConfig: SparkSspConfig;
+    expectedWithdrawBondSats: number;
+    expectedWithdrawRelativeBlockLocktime: number;
 }
 
-export interface ExternalIdentifier {
-    bytes: number[];
+export interface SparkHtlcDetails {
+    paymentHash: string;
+    preimage?: string;
+    expiryTime: number;
+    status: SparkHtlcStatus;
 }
 
-export interface HashedMessageBytes {
-    bytes: number[];
+export interface SparkHtlcOptions {
+    paymentHash: string;
+    expiryDurationSecs: number;
 }
 
-export interface ExternalSecretShare {
-    threshold: number;
-    index: ExternalScalar;
-    share: ExternalScalar;
+export interface SparkInvoiceDetails {
+    invoice: string;
+    identityPublicKey: string;
+    network: BitcoinNetwork;
+    amount?: string;
+    tokenIdentifier?: string;
+    expiryTime?: number;
+    description?: string;
+    senderPublicKey?: string;
 }
 
-export interface SecretBytes {
-    bytes: number[];
+export interface SparkInvoicePaymentDetails {
+    description?: string;
+    invoice: string;
 }
 
-export interface ExternalFrostSignatureShare {
-    bytes: number[];
+export interface SparkSigningOperator {
+    id: number;
+    identifier: string;
+    address: string;
+    identityPublicKey: string;
 }
 
-export interface IdentifierPublicKeyPair {
-    identifier: ExternalIdentifier;
-    publicKey: number[];
+export interface SparkSspConfig {
+    baseUrl: string;
+    identityPublicKey: string;
+    schemaEndpoint?: string;
 }
 
-export interface SchnorrSignatureBytes {
-    bytes: number[];
+export interface SparkStatus {
+    status: ServiceStatus;
+    lastUpdated: number;
 }
 
-/**
- * A wallet derived from a passkey.
- */
-export interface Wallet {
-    /**
-     * The derived seed.
-     */
-    seed: Seed;
-    /**
-     * The label used for derivation.
-     */
-    label: string;
+export interface StableBalanceConfig {
+    tokens: StableBalanceToken[];
+    defaultActiveLabel?: string;
+    thresholdSats?: number;
+    maxSlippageBps?: number;
 }
 
-/**
- * Nostr relay configuration for passkey label operations.
- *
- * Used by `Passkey.listLabels` and `Passkey.storeLabel`.
- */
-export interface NostrRelayConfig {
-    /**
-     * Optional Breez API key for authenticated access to the Breez relay.
-     * When provided, the Breez relay is added and NIP-42 authentication is enabled.
-     */
-    breezApiKey?: string;
-    /**
-     * Connection timeout in seconds. Defaults to 30 when `None`.
-     */
-    timeoutSecs?: number;
+export interface StableBalanceToken {
+    label: string;
+    tokenIdentifier: string;
 }
 
 export interface Storage {
@@ -1373,104 +1173,297 @@ export interface Storage {
     syncUpdateRecordFromIncoming: (record: Record) => Promise<void>;
 }
 
+export interface StorageListPaymentsRequest {
+    typeFilter?: PaymentType[];
+    statusFilter?: PaymentStatus[];
+    assetFilter?: AssetFilter;
+    paymentDetailsFilter?: StoragePaymentDetailsFilter[];
+    fromTimestamp?: number;
+    toTimestamp?: number;
+    offset?: number;
+    limit?: number;
+    sortAscending?: boolean;
+}
+
+export interface Symbol {
+    grapheme?: string;
+    template?: string;
+    rtl?: boolean;
+    position?: number;
+}
+
+export interface SyncWalletRequest {}
+
+export interface SyncWalletResponse {}
+
+export interface TokenBalance {
+    balance: bigint;
+    tokenMetadata: TokenMetadata;
+}
+
+export interface TokenMetadata {
+    identifier: string;
+    issuerPublicKey: string;
+    name: string;
+    ticker: string;
+    decimals: number;
+    maxSupply: string;
+    isFreezable: boolean;
+}
+
+export interface TxStatus {
+    confirmed: boolean;
+    blockHeight?: number;
+    blockTime?: number;
+}
+
+export interface UnfreezeIssuerTokenRequest {
+    address: string;
+}
+
+export interface UnfreezeIssuerTokenResponse {
+    impactedOutputIds: string[];
+    impactedTokenAmount: bigint;
+}
+
+export interface UnregisterWebhookRequest {
+    webhookId: string;
+}
+
+export interface UnversionedRecordChange {
+    id: RecordId;
+    schemaVersion: string;
+    updatedFields: Map<string, string>;
+}
+
+export interface UpdateContactRequest {
+    id: string;
+    name: string;
+    paymentIdentifier: string;
+}
+
+export interface UpdateUserSettingsRequest {
+    sparkPrivateModeEnabled?: boolean;
+    stableBalanceActiveLabel?: StableBalanceActiveLabel;
+}
+
+export interface UrlSuccessActionData {
+    description: string;
+    url: string;
+    matchesCallbackDomain: boolean;
+}
+
+export interface UserSettings {
+    sparkPrivateModeEnabled: boolean;
+    stableBalanceActiveLabel?: string;
+}
+
+export interface Utxo {
+    txid: string;
+    vout: number;
+    value: number;
+    status: TxStatus;
+}
+
+export interface Webhook {
+    id: string;
+    url: string;
+    eventTypes: WebhookEventType[];
+}
+
+export type AesSuccessActionDataResult = { type: "decrypted"; data: AesSuccessActionDataDecrypted } | { type: "errorStatus"; reason: string };
+
+export type Amount = { type: "bitcoin"; amountMsat: number } | { type: "currency"; iso4217Code: string; fractionalAmount: number };
+
+export type AmountAdjustmentReason = "flooredToMinLimit" | "increasedToAvoidDust";
+
+export type AssetFilter = { type: "bitcoin" } | { type: "token"; tokenIdentifier?: string };
+
+export type BitcoinNetwork = "bitcoin" | "testnet3" | "testnet4" | "signet" | "regtest";
+
+export type BuyBitcoinRequest = { type: "moonpay"; lockedAmountSat?: number; redirectUrl?: string } | { type: "cashApp"; amountSats: number };
+
+export type ChainApiType = "esplora" | "mempoolSpace";
+
+export type ConversionPurpose = { type: "ongoingPayment"; paymentRequest: string } | { type: "selfTransfer" } | { type: "autoConversion" };
+
+export type ConversionStatus = "pending" | "completed" | "failed" | "refundNeeded" | "refunded";
+
+export type ConversionType = { type: "fromBitcoin" } | { type: "toBitcoin"; fromTokenIdentifier: string };
+
+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 ExternalSecretSource = { type: "derived"; nodeId: ExternalTreeNodeId } | { type: "encrypted"; key: ExternalEncryptedSecret };
+
+export type ExternalSecretToSplit = { type: "secretSource"; source: ExternalSecretSource } | { type: "preimage"; data: number[] };
+
+export type Fee = { type: "fixed"; amount: number } | { type: "rate"; satPerVbyte: number };
+
+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);
+
+export type KeySetType = "default" | "taproot" | "nativeSegwit" | "wrappedSegwit" | "legacy";
+
+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 Network = "mainnet" | "regtest";
+
+export type OnchainConfirmationSpeed = "fast" | "medium" | "slow";
+
+export type OptimizationEvent = { type: "started"; totalRounds: number } | { type: "roundCompleted"; currentRound: number; totalRounds: number } | { type: "completed" } | { type: "cancelled" } | { type: "failed"; error: string } | { type: "skipped" };
+
+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 } | { type: "withdraw"; txId: string } | { type: "deposit"; txId: string };
+
+export type PaymentDetailsFilter = { type: "spark"; htlcStatus?: SparkHtlcStatus[]; conversionRefundNeeded?: boolean } | { type: "token"; conversionRefundNeeded?: boolean; txHash?: string; txType?: TokenTransactionType } | { type: "lightning"; htlcStatus?: SparkHtlcStatus[] };
+
+export type PaymentMethod = "lightning" | "spark" | "token" | "deposit" | "withdraw" | "unknown";
+
+export type PaymentStatus = "completed" | "pending" | "failed";
+
+export type PaymentType = "send" | "receive";
+
+export type ProvisionalPaymentDetails = { type: "bitcoin"; withdrawalAddress: string } | { type: "lightning"; invoice: string } | { type: "spark"; payRequest: string } | { type: "token"; tokenId: string; payRequest: string };
+
+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 };
+
+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: "optimization"; optimizationEvent: OptimizationEvent } | { type: "lightningAddressChanged"; lightningAddress?: LightningAddressInfo } | { type: "newDeposits"; newDeposits: DepositInfo[] };
+
+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 };
+
+export type SendPaymentOptions = { type: "bitcoinAddress"; confirmationSpeed: OnchainConfirmationSpeed } | { type: "bolt11Invoice"; preferSpark: boolean; completionTimeoutSecs?: number } | { type: "sparkAddress"; htlcOptions?: SparkHtlcOptions };
+
+export type ServiceStatus = "operational" | "degraded" | "partial" | "unknown" | "major";
+
+export type SparkHtlcStatus = "waitingForPreimage" | "preimageShared" | "returned";
+
+export type StableBalanceActiveLabel = { type: "set"; label: string } | { type: "unset" };
+
+export type StoragePaymentDetailsFilter = { type: "spark"; htlcStatus?: SparkHtlcStatus[]; conversionRefundNeeded?: boolean } | { type: "token"; conversionRefundNeeded?: boolean; txHash?: string; txType?: TokenTransactionType } | { type: "lightning"; htlcStatus?: SparkHtlcStatus[] };
+
+export type SuccessAction = { type: "aes"; data: AesSuccessActionData } | { type: "message"; data: MessageSuccessActionData } | { type: "url"; data: UrlSuccessActionData };
+
+export type SuccessActionProcessed = { type: "aes"; result: AesSuccessActionDataResult } | { type: "message"; data: MessageSuccessActionData } | { type: "url"; data: UrlSuccessActionData };
+
+export type TokenTransactionType = "transfer" | "mint" | "burn";
+
+export type UpdateDepositPayload = { type: "claimError"; error: DepositClaimError } | { type: "refund"; refundTxid: string; refundTx: string };
+
+export type WebhookEventType = { type: "lightningReceiveFinished" } | { type: "lightningSendFinished" } | { type: "coopExitFinished" } | { type: "staticDepositFinished" } | ({ type: "unknown" } & string);
+
+
 export class BreezSdk {
-  private constructor();
-  free(): void;
-  disconnect(): Promise<void>;
-  lnurlAuth(request_data: LnurlAuthRequestDetails): Promise<LnurlCallbackStatus>;
-  addContact(request: AddContactRequest): Promise<Contact>;
-  buyBitcoin(request: BuyBitcoinRequest): Promise<BuyBitcoinResponse>;
-  getPayment(request: GetPaymentRequest): Promise<GetPaymentResponse>;
-  syncWallet(request: SyncWalletRequest): Promise<SyncWalletResponse>;
-  sendPayment(request: SendPaymentRequest): Promise<SendPaymentResponse>;
-  signMessage(request: SignMessageRequest): Promise<SignMessageResponse>;
-  checkMessage(request: CheckMessageRequest): Promise<CheckMessageResponse>;
-  claimDeposit(request: ClaimDepositRequest): Promise<ClaimDepositResponse>;
-  listContacts(request: ListContactsRequest): Promise<Contact[]>;
-  listPayments(request: ListPaymentsRequest): Promise<ListPaymentsResponse>;
-  listWebhooks(): Promise<Webhook[]>;
-  deleteContact(id: string): Promise<void>;
-  lnurlWithdraw(request: LnurlWithdrawRequest): Promise<LnurlWithdrawResponse>;
-  refundDeposit(request: RefundDepositRequest): Promise<RefundDepositResponse>;
-  updateContact(request: UpdateContactRequest): Promise<Contact>;
-  listFiatRates(): Promise<ListFiatRatesResponse>;
-  receivePayment(request: ReceivePaymentRequest): Promise<ReceivePaymentResponse>;
-  getTokenIssuer(): TokenIssuer;
-  recommendedFees(): Promise<RecommendedFees>;
-  registerWebhook(request: RegisterWebhookRequest): Promise<RegisterWebhookResponse>;
-  getUserSettings(): Promise<UserSettings>;
-  prepareLnurlPay(request: PrepareLnurlPayRequest): Promise<PrepareLnurlPayResponse>;
-  addEventListener(listener: EventListener): Promise<string>;
-  claimHtlcPayment(request: ClaimHtlcPaymentRequest): Promise<ClaimHtlcPaymentResponse>;
-  unregisterWebhook(request: UnregisterWebhookRequest): Promise<void>;
-  getTokensMetadata(request: GetTokensMetadataRequest): Promise<GetTokensMetadataResponse>;
-  listFiatCurrencies(): Promise<ListFiatCurrenciesResponse>;
-  prepareSendPayment(request: PrepareSendPaymentRequest): Promise<PrepareSendPaymentResponse>;
-  updateUserSettings(request: UpdateUserSettingsRequest): Promise<void>;
-  getLightningAddress(): Promise<LightningAddressInfo | undefined>;
-  removeEventListener(id: string): Promise<boolean>;
-  fetchConversionLimits(request: FetchConversionLimitsRequest): Promise<FetchConversionLimitsResponse>;
-  listUnclaimedDeposits(request: ListUnclaimedDepositsRequest): Promise<ListUnclaimedDepositsResponse>;
-  startLeafOptimization(): Promise<void>;
-  cancelLeafOptimization(): Promise<void>;
-  deleteLightningAddress(): Promise<void>;
-  registerLightningAddress(request: RegisterLightningAddressRequest): Promise<LightningAddressInfo>;
-  getLeafOptimizationProgress(): OptimizationProgress;
-  checkLightningAddressAvailable(request: CheckLightningAddressRequest): Promise<boolean>;
-  parse(input: string): Promise<InputType>;
-  getInfo(request: GetInfoRequest): Promise<GetInfoResponse>;
-  lnurlPay(request: LnurlPayRequest): Promise<LnurlPayResponse>;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    addContact(request: AddContactRequest): Promise<Contact>;
+    addEventListener(listener: EventListener): Promise<string>;
+    buyBitcoin(request: BuyBitcoinRequest): Promise<BuyBitcoinResponse>;
+    cancelLeafOptimization(): Promise<void>;
+    checkLightningAddressAvailable(request: CheckLightningAddressRequest): Promise<boolean>;
+    checkMessage(request: CheckMessageRequest): Promise<CheckMessageResponse>;
+    claimDeposit(request: ClaimDepositRequest): Promise<ClaimDepositResponse>;
+    claimHtlcPayment(request: ClaimHtlcPaymentRequest): Promise<ClaimHtlcPaymentResponse>;
+    deleteContact(id: string): Promise<void>;
+    deleteLightningAddress(): Promise<void>;
+    disconnect(): Promise<void>;
+    fetchConversionLimits(request: FetchConversionLimitsRequest): Promise<FetchConversionLimitsResponse>;
+    getInfo(request: GetInfoRequest): Promise<GetInfoResponse>;
+    getLeafOptimizationProgress(): OptimizationProgress;
+    getLightningAddress(): Promise<LightningAddressInfo | undefined>;
+    getPayment(request: GetPaymentRequest): Promise<GetPaymentResponse>;
+    getTokenIssuer(): TokenIssuer;
+    getTokensMetadata(request: GetTokensMetadataRequest): Promise<GetTokensMetadataResponse>;
+    getUserSettings(): Promise<UserSettings>;
+    listContacts(request: ListContactsRequest): Promise<Contact[]>;
+    listFiatCurrencies(): Promise<ListFiatCurrenciesResponse>;
+    listFiatRates(): Promise<ListFiatRatesResponse>;
+    listPayments(request: ListPaymentsRequest): Promise<ListPaymentsResponse>;
+    listUnclaimedDeposits(request: ListUnclaimedDepositsRequest): Promise<ListUnclaimedDepositsResponse>;
+    listWebhooks(): Promise<Webhook[]>;
+    lnurlAuth(request_data: LnurlAuthRequestDetails): Promise<LnurlCallbackStatus>;
+    lnurlPay(request: LnurlPayRequest): Promise<LnurlPayResponse>;
+    lnurlWithdraw(request: LnurlWithdrawRequest): Promise<LnurlWithdrawResponse>;
+    parse(input: string): Promise<InputType>;
+    prepareLnurlPay(request: PrepareLnurlPayRequest): Promise<PrepareLnurlPayResponse>;
+    prepareSendPayment(request: PrepareSendPaymentRequest): Promise<PrepareSendPaymentResponse>;
+    receivePayment(request: ReceivePaymentRequest): Promise<ReceivePaymentResponse>;
+    recommendedFees(): Promise<RecommendedFees>;
+    refundDeposit(request: RefundDepositRequest): Promise<RefundDepositResponse>;
+    registerLightningAddress(request: RegisterLightningAddressRequest): Promise<LightningAddressInfo>;
+    registerWebhook(request: RegisterWebhookRequest): Promise<RegisterWebhookResponse>;
+    removeEventListener(id: string): Promise<boolean>;
+    sendPayment(request: SendPaymentRequest): Promise<SendPaymentResponse>;
+    signMessage(request: SignMessageRequest): Promise<SignMessageResponse>;
+    startLeafOptimization(): Promise<void>;
+    syncWallet(request: SyncWalletRequest): Promise<SyncWalletResponse>;
+    unregisterWebhook(request: UnregisterWebhookRequest): Promise<void>;
+    updateContact(request: UpdateContactRequest): Promise<Contact>;
+    updateUserSettings(request: UpdateUserSettingsRequest): Promise<void>;
 }
+
 /**
  * A default signer implementation that wraps the core SDK's ExternalSigner.
  * This is returned by `defaultExternalSigner` and can be passed to `connectWithSigner`.
  */
 export class DefaultSigner {
-  private constructor();
-  free(): void;
-  signEcdsa(message: MessageBytes, path: string): Promise<EcdsaSignatureBytes>;
-  signFrost(request: ExternalSignFrostRequest): Promise<ExternalFrostSignatureShare>;
-  hmacSha256(message: Uint8Array, path: string): Promise<HashedMessageBytes>;
-  decryptEcies(message: Uint8Array, path: string): Promise<Uint8Array>;
-  encryptEcies(message: Uint8Array, path: string): Promise<Uint8Array>;
-  aggregateFrost(request: ExternalAggregateFrostRequest): Promise<ExternalFrostSignature>;
-  subtractSecrets(signing_key: ExternalSecretSource, new_signing_key: ExternalSecretSource): Promise<ExternalSecretSource>;
-  derivePublicKey(path: string): Promise<PublicKeyBytes>;
-  signHashSchnorr(hash: Uint8Array, path: string): Promise<SchnorrSignatureBytes>;
-  identityPublicKey(): PublicKeyBytes;
-  staticDepositSecret(index: number): Promise<SecretBytes>;
-  generateRandomSecret(): Promise<ExternalEncryptedSecret>;
-  publicKeyFromSecret(private_key: ExternalSecretSource): Promise<PublicKeyBytes>;
-  signEcdsaRecoverable(message: MessageBytes, path: string): Promise<RecoverableEcdsaSignatureBytes>;
-  getPublicKeyForNode(id: ExternalTreeNodeId): Promise<PublicKeyBytes>;
-  splitSecretWithProofs(secret: ExternalSecretToSplit, threshold: number, num_shares: number): Promise<ExternalVerifiableSecretShare[]>;
-  staticDepositSigningKey(index: number): Promise<PublicKeyBytes>;
-  encryptPrivateKeyForReceiver(private_key: ExternalEncryptedSecret, receiver_public_key: PublicKeyBytes): Promise<Uint8Array>;
-  staticDepositSecretEncrypted(index: number): Promise<ExternalSecretSource>;
-  generateRandomSigningCommitment(): Promise<ExternalFrostCommitments>;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    aggregateFrost(request: ExternalAggregateFrostRequest): Promise<ExternalFrostSignature>;
+    decryptEcies(message: Uint8Array, path: string): Promise<Uint8Array>;
+    derivePublicKey(path: string): Promise<PublicKeyBytes>;
+    encryptEcies(message: Uint8Array, path: string): Promise<Uint8Array>;
+    encryptPrivateKeyForReceiver(private_key: ExternalEncryptedSecret, receiver_public_key: PublicKeyBytes): Promise<Uint8Array>;
+    generateRandomSecret(): Promise<ExternalEncryptedSecret>;
+    generateRandomSigningCommitment(): Promise<ExternalFrostCommitments>;
+    getPublicKeyForNode(id: ExternalTreeNodeId): Promise<PublicKeyBytes>;
+    hmacSha256(message: Uint8Array, path: string): Promise<HashedMessageBytes>;
+    identityPublicKey(): PublicKeyBytes;
+    publicKeyFromSecret(private_key: ExternalSecretSource): Promise<PublicKeyBytes>;
+    signEcdsa(message: MessageBytes, path: string): Promise<EcdsaSignatureBytes>;
+    signEcdsaRecoverable(message: MessageBytes, path: string): Promise<RecoverableEcdsaSignatureBytes>;
+    signFrost(request: ExternalSignFrostRequest): Promise<ExternalFrostSignatureShare>;
+    signHashSchnorr(hash: Uint8Array, path: string): Promise<SchnorrSignatureBytes>;
+    splitSecretWithProofs(secret: ExternalSecretToSplit, threshold: number, num_shares: number): Promise<ExternalVerifiableSecretShare[]>;
+    staticDepositSecret(index: number): Promise<SecretBytes>;
+    staticDepositSecretEncrypted(index: number): Promise<ExternalSecretSource>;
+    staticDepositSigningKey(index: number): Promise<PublicKeyBytes>;
+    subtractSecrets(signing_key: ExternalSecretSource, new_signing_key: ExternalSecretSource): Promise<ExternalSecretSource>;
 }
+
 export class IntoUnderlyingByteSource {
-  private constructor();
-  free(): void;
-  pull(controller: ReadableByteStreamController): Promise<any>;
-  start(controller: ReadableByteStreamController): void;
-  cancel(): void;
-  readonly autoAllocateChunkSize: number;
-  readonly type: ReadableStreamType;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    cancel(): void;
+    pull(controller: ReadableByteStreamController): Promise<any>;
+    start(controller: ReadableByteStreamController): void;
+    readonly autoAllocateChunkSize: number;
+    readonly type: ReadableStreamType;
 }
+
 export class IntoUnderlyingSink {
-  private constructor();
-  free(): void;
-  abort(reason: any): Promise<any>;
-  close(): Promise<any>;
-  write(chunk: any): Promise<any>;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    abort(reason: any): Promise<any>;
+    close(): Promise<any>;
+    write(chunk: any): Promise<any>;
 }
+
 export class IntoUnderlyingSource {
-  private constructor();
-  free(): void;
-  pull(controller: ReadableStreamDefaultController): Promise<any>;
-  cancel(): void;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    cancel(): void;
+    pull(controller: ReadableStreamDefaultController): Promise<any>;
 }
+
 /**
  * Passkey-based wallet operations using WebAuthn PRF extension.
  *
@@ -1478,64 +1471,101 @@ export class IntoUnderlyingSource {
  * wallet derivation and label management via Nostr relays.
  */
 export class Passkey {
-  free(): void;
-  /**
-   * Derive a wallet for a given label.
-   *
-   * Uses the passkey PRF to derive a `Wallet` containing the seed and resolved label.
-   *
-   * @param label - Optional label string (defaults to "Default")
-   */
-  getWallet(label?: string | null): Promise<Wallet>;
-  /**
-   * List all labels published to Nostr for this passkey's identity.
-   *
-   * Requires 1 PRF call (for Nostr identity derivation).
-   */
-  listLabels(): Promise<string[]>;
-  /**
-   * Publish a label to Nostr relays for this passkey's identity.
-   *
-   * Idempotent: if the label already exists, it is not published again.
-   * Requires 1 PRF call.
-   */
-  storeLabel(label: string): Promise<void>;
-  /**
-   * Check if passkey PRF is available on this device.
-   */
-  isAvailable(): Promise<boolean>;
-  /**
-   * Create a new `Passkey` instance.
-   *
-   * @param prfProvider - Platform implementation of passkey PRF operations
-   * @param relayConfig - Optional configuration for Nostr relay connections
-   */
-  constructor(prf_provider: PasskeyPrfProvider, relay_config?: NostrRelayConfig | null);
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Derive a wallet for a given label.
+     *
+     * Uses the passkey PRF to derive a `Wallet` containing the seed and resolved label.
+     *
+     * @param label - Optional label string (defaults to "Default")
+     */
+    getWallet(label?: string | null): Promise<Wallet>;
+    /**
+     * Check if passkey PRF is available on this device.
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * List all labels published to Nostr for this passkey's identity.
+     *
+     * Requires 1 PRF call (for Nostr identity derivation).
+     */
+    listLabels(): Promise<string[]>;
+    /**
+     * Create a new `Passkey` instance.
+     *
+     * @param prfProvider - Platform implementation of passkey PRF operations
+     * @param relayConfig - Optional configuration for Nostr relay connections
+     */
+    constructor(prf_provider: PasskeyPrfProvider, relay_config?: NostrRelayConfig | null);
+    /**
+     * Publish a label to Nostr relays for this passkey's identity.
+     *
+     * Idempotent: if the label already exists, it is not published again.
+     * Requires 1 PRF call.
+     */
+    storeLabel(label: string): Promise<void>;
 }
+
 export class SdkBuilder {
-  private constructor();
-  free(): void;
-  withKeySet(config: KeySetConfig): SdkBuilder;
-  withStorage(storage: Storage): SdkBuilder;
-  static newWithSigner(config: Config, signer: ExternalSigner): SdkBuilder;
-  withFiatService(fiat_service: FiatService): SdkBuilder;
-  withLnurlClient(lnurl_client: RestClient): SdkBuilder;
-  withChainService(chain_service: BitcoinChainService): SdkBuilder;
-  withDefaultStorage(storage_dir: string): Promise<SdkBuilder>;
-  withPaymentObserver(payment_observer: PaymentObserver): SdkBuilder;
-  withPostgresBackend(config: PostgresStorageConfig): SdkBuilder;
-  withRestChainService(url: string, api_type: ChainApiType, credentials?: Credentials | null): SdkBuilder;
-  static new(config: Config, seed: Seed): SdkBuilder;
-  build(): Promise<BreezSdk>;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    build(): Promise<BreezSdk>;
+    static new(config: Config, seed: Seed): SdkBuilder;
+    static newWithSigner(config: Config, signer: ExternalSigner): SdkBuilder;
+    withChainService(chain_service: BitcoinChainService): SdkBuilder;
+    withDefaultStorage(storage_dir: string): Promise<SdkBuilder>;
+    withFiatService(fiat_service: FiatService): SdkBuilder;
+    withKeySet(config: KeySetConfig): SdkBuilder;
+    withLnurlClient(lnurl_client: RestClient): SdkBuilder;
+    withPaymentObserver(payment_observer: PaymentObserver): SdkBuilder;
+    withPostgresBackend(config: PostgresStorageConfig): SdkBuilder;
+    withRestChainService(url: string, api_type: ChainApiType, credentials?: Credentials | null): SdkBuilder;
+    withStorage(storage: Storage): SdkBuilder;
 }
+
 export class TokenIssuer {
-  private constructor();
-  free(): void;
-  burnIssuerToken(request: BurnIssuerTokenRequest): Promise<Payment>;
-  mintIssuerToken(request: MintIssuerTokenRequest): Promise<Payment>;
-  createIssuerToken(request: CreateIssuerTokenRequest): Promise<TokenMetadata>;
-  freezeIssuerToken(request: FreezeIssuerTokenRequest): Promise<FreezeIssuerTokenResponse>;
-  unfreezeIssuerToken(request: UnfreezeIssuerTokenRequest): Promise<UnfreezeIssuerTokenResponse>;
-  getIssuerTokenBalance(): Promise<TokenBalance>;
-  getIssuerTokenMetadata(): Promise<TokenMetadata>;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    burnIssuerToken(request: BurnIssuerTokenRequest): Promise<Payment>;
+    createIssuerToken(request: CreateIssuerTokenRequest): Promise<TokenMetadata>;
+    freezeIssuerToken(request: FreezeIssuerTokenRequest): Promise<FreezeIssuerTokenResponse>;
+    getIssuerTokenBalance(): Promise<TokenBalance>;
+    getIssuerTokenMetadata(): Promise<TokenMetadata>;
+    mintIssuerToken(request: MintIssuerTokenRequest): Promise<Payment>;
+    unfreezeIssuerToken(request: UnfreezeIssuerTokenRequest): Promise<UnfreezeIssuerTokenResponse>;
 }
+
+export function connect(request: ConnectRequest): Promise<BreezSdk>;
+
+export function connectWithSigner(config: Config, signer: ExternalSigner, storage_dir: string): Promise<BreezSdk>;
+
+export function defaultConfig(network: Network): Config;
+
+export function defaultExternalSigner(mnemonic: string, passphrase: string | null | undefined, network: Network, key_set_config?: KeySetConfig | null): DefaultSigner;
+
+/**
+ * Creates a default PostgreSQL storage configuration with sensible defaults.
+ *
+ * Default values (from pg.Pool):
+ * - `maxPoolSize`: 10
+ * - `createTimeoutSecs`: 0 (no timeout)
+ * - `recycleTimeoutSecs`: 10 (10 seconds idle before disconnect)
+ */
+export function defaultPostgresStorageConfig(connection_string: string): PostgresStorageConfig;
+
+/**
+ * Creates a default external signer from a mnemonic phrase.
+ *
+ * This creates a signer that can be used with `connectWithSigner` or `SdkBuilder.newWithSigner`.
+ */
+export function getSparkStatus(): Promise<SparkStatus>;
+
+export function initLogging(logger: Logger, filter?: string | null): Promise<void>;
+
+/**
+ * Entry point invoked by JavaScript in a worker.
+ */
+export function task_worker_entry_point(ptr: number): void;