@breeztech/breez-sdk-spark 0.6.5 → 0.7.0-dev1

package/deno/breez_sdk_spark_wasm.d.ts

@@ -1,8 +1,15 @@
 /* tslint:disable */
 /* eslint-disable */
-export function defaultConfig(network: Network): Config;
-export function initLogging(logger: Logger, filter?: string | null): Promise<void>;
 export function connect(request: ConnectRequest): Promise<BreezSdk>;
+export function initLogging(logger: Logger, filter?: string | null): Promise<void>;
+export function connectWithSigner(config: Config, signer: ExternalSigner, storage_dir: string): Promise<BreezSdk>;
+export function defaultConfig(network: Network): Config;
+/**
+ * Creates a default external signer from a mnemonic phrase.
+ *
+ * This creates a signer that can be used with `connectWithSigner` or `SdkBuilder.newWithSigner`.
+ */
+export function defaultExternalSigner(mnemonic: string, passphrase: string | null | undefined, network: Network, key_set_config?: KeySetConfig | null): DefaultSigner;
 /**
  * Entry point invoked by JavaScript in a worker.
  */
@@ -45,12 +52,11 @@ export interface BitcoinChainService {
     recommendedFees(): Promise<RecommendedFees>;
 }
 
-export interface RecommendedFees {
-    fastestFee: number;
-    halfHourFee: number;
-    hourFee: number;
-    economyFee: number;
-    minimumFee: number;
+export interface Utxo {
+    txid: string;
+    vout: number;
+    value: number;
+    status: TxStatus;
 }
 
 export type ChainApiType = "esplora" | "mempoolSpace";
@@ -61,22 +67,59 @@ export interface TxStatus {
     blockTime?: number;
 }
 
-export interface Utxo {
-    txid: string;
-    vout: number;
-    value: number;
-    status: TxStatus;
+export interface RecommendedFees {
+    fastestFee: number;
+    halfHourFee: number;
+    hourFee: number;
+    economyFee: number;
+    minimumFee: number;
 }
 
 export interface PaymentObserver {
     beforeSend: (payments: ProvisionalPayment[]) => Promise<void>;
 }
 
-export interface RecordChange {
-    id: RecordId;
-    schemaVersion: string;
-    updatedFields: Map<string, string>;
-    revision: number;
+export interface GetTokensMetadataRequest {
+    tokenIdentifiers: string[];
+}
+
+export interface ListUnclaimedDepositsResponse {
+    deposits: DepositInfo[];
+}
+
+export type ReceivePaymentMethod = { type: "sparkAddress" } | { type: "sparkInvoice"; amount?: bigint; tokenIdentifier?: string; expiryTime?: number; description?: string; senderPublicKey?: string } | { type: "bitcoinAddress" } | { type: "bolt11Invoice"; description: string; amountSats?: number; expirySecs?: number };
+
+export interface SparkHtlcDetails {
+    paymentHash: string;
+    preimage?: string;
+    expiryTime: number;
+    status: SparkHtlcStatus;
+}
+
+export type AssetFilter = { type: "bitcoin" } | { type: "token"; tokenIdentifier?: string };
+
+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 interface LocaleOverrides {
+    locale: string;
+    spacing?: number;
+    symbol: Symbol;
+}
+
+export interface PrepareLnurlPayResponse {
+    amountSats: number;
+    comment?: string;
+    payRequest: LnurlPayRequestDetails;
+    feeSats: number;
+    invoiceDetails: Bolt11InvoiceDetails;
+    successAction?: SuccessAction;
+}
+
+export interface PrepareSendPaymentRequest {
+    paymentRequest: string;
+    amount?: bigint;
+    tokenIdentifier?: string;
+    tokenConversionOptions?: TokenConversionOptions;
 }
 
 export interface CurrencyInfo {
@@ -89,81 +132,116 @@ export interface CurrencyInfo {
     localeOverrides: LocaleOverrides[];
 }
 
-export interface LnurlWithdrawRequestDetails {
-    callback: string;
-    k1: string;
-    defaultDescription: string;
-    minWithdrawable: number;
-    maxWithdrawable: number;
+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 };
+
+export interface CheckLightningAddressRequest {
+    username: string;
 }
 
-export interface UserSettings {
-    sparkPrivateModeEnabled: boolean;
+export interface UnversionedRecordChange {
+    id: RecordId;
+    schemaVersion: string;
+    updatedFields: Map<string, string>;
 }
 
-export interface ListFiatCurrenciesResponse {
-    currencies: FiatCurrency[];
+export type SendPaymentOptions = { type: "bitcoinAddress"; confirmationSpeed: OnchainConfirmationSpeed } | { type: "bolt11Invoice"; preferSpark: boolean; completionTimeoutSecs?: number } | { type: "sparkAddress"; htlcOptions?: SparkHtlcOptions };
+
+export interface Bolt12Offer {
+    offer: string;
+    source: PaymentRequestSource;
 }
 
-export interface Bolt12OfferDetails {
-    absoluteExpiry?: number;
-    chains: string[];
-    description?: string;
-    issuer?: string;
-    minAmount?: Amount;
-    offer: Bolt12Offer;
-    paths: Bolt12OfferBlindedPath[];
-    signingPubkey?: string;
+export interface AesSuccessActionData {
+    description: string;
+    ciphertext: string;
+    iv: string;
 }
 
-export interface PrepareLnurlPayRequest {
-    amountSats: number;
-    comment?: string;
-    payRequest: LnurlPayRequestDetails;
-    validateSuccessActionUrl?: boolean;
+export interface TokenMetadata {
+    identifier: string;
+    issuerPublicKey: string;
+    name: string;
+    ticker: string;
+    decimals: number;
+    maxSupply: bigint;
+    isFreezable: boolean;
 }
 
-export interface GetTokensMetadataResponse {
-    tokensMetadata: TokenMetadata[];
+export interface BitcoinAddressDetails {
+    address: string;
+    network: BitcoinNetwork;
+    source: PaymentRequestSource;
 }
 
-export interface Bolt11RouteHint {
-    hops: Bolt11RouteHintHop[];
+export interface SetLnurlMetadataItem {
+    paymentHash: string;
+    senderComment?: string;
+    nostrZapRequest?: string;
+    nostrZapReceipt?: string;
 }
 
-export interface LnurlPayInfo {
-    lnAddress?: string;
-    comment?: string;
-    domain?: string;
-    metadata?: string;
-    processedSuccessAction?: SuccessActionProcessed;
-    rawSuccessAction?: SuccessAction;
+export type PaymentDetailsFilter = { type: "spark"; htlcStatus?: SparkHtlcStatus[]; conversionRefundNeeded?: boolean } | { type: "token"; conversionRefundNeeded?: boolean; txHash?: string };
+
+export interface LogEntry {
+    line: string;
+    level: string;
 }
 
-export interface TokenBalance {
-    balance: bigint;
-    tokenMetadata: TokenMetadata;
+export interface Bip21Details {
+    amountSat?: number;
+    assetId?: string;
+    uri: string;
+    extras: Bip21Extra[];
+    label?: string;
+    message?: string;
+    paymentMethods: InputType[];
 }
 
-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 SuccessActionProcessed = { type: "aes"; result: AesSuccessActionDataResult } | { type: "message"; data: MessageSuccessActionData } | { type: "url"; data: UrlSuccessActionData };
 
-export interface PaymentMetadata {
-    lnurlPayInfo?: LnurlPayInfo;
-    lnurlWithdrawInfo?: LnurlWithdrawInfo;
-    lnurlDescription?: 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 interface RefundDepositRequest {
+    txid: string;
+    vout: number;
+    destinationAddress: string;
+    fee: Fee;
 }
 
-export interface ConnectRequest {
-    config: Config;
-    seed: Seed;
-    storageDir: string;
+export interface SendOnchainFeeQuote {
+    id: string;
+    expiresAt: number;
+    speedFast: SendOnchainSpeedFeeQuote;
+    speedMedium: SendOnchainSpeedFeeQuote;
+    speedSlow: SendOnchainSpeedFeeQuote;
 }
 
-export interface Bolt12InvoiceRequestDetails {}
+export interface ListPaymentsRequest {
+    typeFilter?: PaymentType[];
+    statusFilter?: PaymentStatus[];
+    assetFilter?: AssetFilter;
+    paymentDetailsFilter?: PaymentDetailsFilter[];
+    fromTimestamp?: number;
+    toTimestamp?: number;
+    offset?: number;
+    limit?: number;
+    sortAscending?: boolean;
+}
 
-export interface Bolt12Invoice {
-    invoice: string;
-    source: PaymentRequestSource;
+export interface SignMessageRequest {
+    message: string;
+    compact: boolean;
+}
+
+export interface LnurlPayRequest {
+    prepareResponse: PrepareLnurlPayResponse;
+    idempotencyKey?: string;
+}
+
+export interface ExternalInputParser {
+    providerId: string;
+    inputRegex: string;
+    parserUrl: string;
 }
 
 export interface SilentPaymentAddressDetails {
@@ -172,18 +250,34 @@ export interface SilentPaymentAddressDetails {
     source: PaymentRequestSource;
 }
 
-export interface LnurlWithdrawRequest {
-    amountSats: number;
-    withdrawRequest: LnurlWithdrawRequestDetails;
-    completionTimeoutSecs?: number;
+export interface LnurlWithdrawInfo {
+    withdrawUrl: string;
 }
 
-export interface ListUnclaimedDepositsResponse {
-    deposits: DepositInfo[];
+export interface GetInfoRequest {
+    ensureSynced?: boolean;
 }
 
-export interface Bolt12Offer {
-    offer: string;
+export interface SignMessageResponse {
+    pubkey: string;
+    signature: string;
+}
+
+export interface CheckMessageResponse {
+    isValid: boolean;
+}
+
+export interface GetPaymentRequest {
+    paymentId: string;
+}
+
+export interface AesSuccessActionDataDecrypted {
+    description: string;
+    plaintext: string;
+}
+
+export interface Bolt11Invoice {
+    bolt11: string;
     source: PaymentRequestSource;
 }
 
@@ -194,17 +288,6 @@ export interface SparkAddressDetails {
     source: PaymentRequestSource;
 }
 
-export interface LnurlPayResponse {
-    payment: Payment;
-    successAction?: SuccessActionProcessed;
-}
-
-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 };
-
-export interface UpdateUserSettingsRequest {
-    sparkPrivateModeEnabled?: boolean;
-}
-
 export interface LnurlPayRequestDetails {
     callback: string;
     minSendable: number;
@@ -218,94 +301,130 @@ export interface LnurlPayRequestDetails {
     nostrPubkey?: string;
 }
 
-export interface UnversionedRecordChange {
-    id: RecordId;
-    schemaVersion: string;
-    updatedFields: Map<string, string>;
+export interface Bolt12InvoiceDetails {
+    amountMsat: number;
+    invoice: Bolt12Invoice;
 }
 
-export type OnchainConfirmationSpeed = "fast" | "medium" | "slow";
-
-export interface SignMessageResponse {
-    pubkey: string;
-    signature: string;
+export interface PaymentRequestSource {
+    bip21Uri?: string;
+    bip353Address?: string;
 }
 
-export interface CheckLightningAddressRequest {
-    username: string;
+export interface Payment {
+    id: string;
+    paymentType: PaymentType;
+    status: PaymentStatus;
+    amount: bigint;
+    fees: bigint;
+    timestamp: number;
+    method: PaymentMethod;
+    details?: PaymentDetails;
 }
 
-export interface RecordId {
-    type: string;
-    dataId: string;
+export type MaxFee = { type: "fixed"; amount: number } | { type: "rate"; satPerVbyte: number } | { type: "networkRecommended"; leewaySatPerVbyte: number };
+
+export type ProvisionalPaymentDetails = { type: "bitcoin"; withdrawalAddress: string } | { type: "lightning"; invoice: string } | { type: "spark"; payRequest: string } | { type: "token"; tokenId: string; payRequest: string };
+
+export interface OptimizationConfig {
+    autoEnabled: boolean;
+    multiplicity: number;
 }
 
-export interface Bolt12OfferBlindedPath {
-    blindedHops: string[];
+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 type KeySetType = "default" | "taproot" | "nativeSegwit" | "wrappedSegwit" | "legacy";
+export type Fee = { type: "fixed"; amount: number } | { type: "rate"; satPerVbyte: number };
 
-export interface SendPaymentRequest {
-    prepareResponse: PrepareSendPaymentResponse;
-    options?: SendPaymentOptions;
-    idempotencyKey?: string;
+export interface MessageSuccessActionData {
+    message: string;
 }
 
-export type PaymentDetails = { type: "spark"; invoiceDetails?: SparkInvoicePaymentDetails; htlcDetails?: SparkHtlcDetails } | { type: "token"; metadata: TokenMetadata; txHash: string; invoiceDetails?: SparkInvoicePaymentDetails } | { type: "lightning"; description?: string; preimage?: string; invoice: string; paymentHash: string; destinationPubkey: string; lnurlPayInfo?: LnurlPayInfo; lnurlWithdrawInfo?: LnurlWithdrawInfo; lnurlReceiveMetadata?: LnurlReceiveMetadata } | { type: "withdraw"; txId: string } | { type: "deposit"; txId: string };
+export interface TokenConversionOptions {
+    conversionType: TokenConversionType;
+    maxSlippageBps?: number;
+    completionTimeoutSecs?: number;
+}
 
-export type Network = "mainnet" | "regtest";
+export type PaymentType = "send" | "receive";
 
-export interface LocaleOverrides {
-    locale: string;
-    spacing?: number;
-    symbol: Symbol;
+export interface Record {
+    id: RecordId;
+    revision: number;
+    schemaVersion: string;
+    data: Map<string, string>;
 }
 
-export interface ClaimDepositResponse {
-    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 };
+
+export interface LightningAddressInfo {
+    description: string;
+    lightningAddress: string;
+    lnurl: string;
+    username: string;
 }
 
-export interface SparkHtlcOptions {
-    paymentHash: string;
-    expiryDurationSecs: number;
+export interface LightningAddressDetails {
+    address: string;
+    payRequest: LnurlPayRequestDetails;
 }
 
-export interface ListPaymentsResponse {
-    payments: Payment[];
+export interface UpdateUserSettingsRequest {
+    sparkPrivateModeEnabled?: boolean;
 }
 
-export interface RefundDepositRequest {
-    txid: string;
-    vout: number;
-    destinationAddress: string;
-    fee: Fee;
+export interface RecordChange {
+    id: RecordId;
+    schemaVersion: string;
+    updatedFields: Map<string, string>;
+    revision: number;
 }
 
-export interface PaymentRequestSource {
-    bip21Uri?: string;
-    bip353Address?: string;
+export interface TokenConversionInfo {
+    poolId: string;
+    paymentId?: string;
+    fee?: bigint;
+    refundIdentifier?: string;
 }
 
-export interface Payment {
-    id: string;
-    paymentType: PaymentType;
-    status: PaymentStatus;
-    amount: bigint;
-    fees: bigint;
-    timestamp: number;
-    method: PaymentMethod;
-    details?: PaymentDetails;
+export interface LnurlWithdrawRequestDetails {
+    callback: string;
+    k1: string;
+    defaultDescription: string;
+    minWithdrawable: number;
+    maxWithdrawable: number;
 }
 
-export interface GetTokensMetadataRequest {
-    tokenIdentifiers: string[];
+export interface KeySetConfig {
+    keySetType: KeySetType;
+    useAddressIndex: boolean;
+    accountNumber?: number;
 }
 
-export interface ClaimDepositRequest {
-    txid: string;
-    vout: number;
-    maxFee?: MaxFee;
+export interface Config {
+    apiKey?: string;
+    network: Network;
+    syncIntervalSecs: number;
+    maxDepositClaimFee?: MaxFee;
+    lnurlDomain?: string;
+    preferSparkOverLightning: boolean;
+    externalInputParsers?: ExternalInputParser[];
+    useDefaultExternalInputParsers: boolean;
+    realTimeSyncServerUrl?: string;
+    privateEnabledDefault: boolean;
+    optimizationConfig: OptimizationConfig;
 }
 
 export interface LnurlReceiveMetadata {
@@ -314,88 +433,97 @@ export interface LnurlReceiveMetadata {
     senderComment?: string;
 }
 
-export interface OptimizationProgress {
-    isRunning: boolean;
-    currentRound: number;
-    totalRounds: number;
+export interface Symbol {
+    grapheme?: string;
+    template?: string;
+    rtl?: boolean;
+    position?: number;
 }
 
-export interface LnurlWithdrawInfo {
-    withdrawUrl: string;
+export interface ListFiatCurrenciesResponse {
+    currencies: FiatCurrency[];
 }
 
-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 SparkInvoicePaymentDetails {
+    description?: string;
+    invoice: string;
+}
 
-export interface ListPaymentsRequest {
-    typeFilter?: PaymentType[];
-    statusFilter?: PaymentStatus[];
-    assetFilter?: AssetFilter;
-    sparkHtlcStatusFilter?: SparkHtlcStatus[];
-    fromTimestamp?: number;
-    toTimestamp?: number;
-    offset?: number;
-    limit?: number;
-    sortAscending?: boolean;
+export interface SendPaymentRequest {
+    prepareResponse: PrepareSendPaymentResponse;
+    options?: SendPaymentOptions;
+    idempotencyKey?: string;
 }
 
-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 };
+export interface ListPaymentsResponse {
+    payments: Payment[];
+}
 
-export interface GetInfoRequest {
-    ensureSynced?: boolean;
+export interface FetchTokenConversionLimitsResponse {
+    minFromAmount?: bigint;
+    minToAmount?: bigint;
 }
 
-export type SendPaymentOptions = { type: "bitcoinAddress"; confirmationSpeed: OnchainConfirmationSpeed } | { type: "bolt11Invoice"; preferSpark: boolean; completionTimeoutSecs?: number } | { type: "sparkAddress"; htlcOptions?: SparkHtlcOptions };
+export interface SyncWalletResponse {}
 
-export interface PrepareSendPaymentRequest {
-    paymentRequest: string;
-    amount?: bigint;
+export interface LnurlWithdrawRequest {
+    amountSats: number;
+    withdrawRequest: LnurlWithdrawRequestDetails;
+    completionTimeoutSecs?: number;
+}
+
+export type Amount = { type: "bitcoin"; amountMsat: number } | { type: "currency"; iso4217Code: string; fractionalAmount: number };
+
+export interface FetchTokenConversionLimitsRequest {
+    conversionType: TokenConversionType;
     tokenIdentifier?: string;
 }
 
-export interface Record {
-    id: RecordId;
-    revision: number;
-    schemaVersion: string;
-    data: Map<string, string>;
+export interface SendOnchainSpeedFeeQuote {
+    userFeeSat: number;
+    l1BroadcastFeeSat: number;
 }
 
-export interface PrepareLnurlPayResponse {
+export interface DepositInfo {
+    txid: string;
+    vout: number;
+    amountSats: number;
+    refundTx?: string;
+    refundTxId?: string;
+    claimError?: DepositClaimError;
+}
+
+export interface ProvisionalPayment {
+    paymentId: string;
+    amount: bigint;
+    details: ProvisionalPaymentDetails;
+}
+
+export interface Bolt12OfferBlindedPath {
+    blindedHops: string[];
+}
+
+export interface PrepareLnurlPayRequest {
     amountSats: number;
     comment?: string;
     payRequest: LnurlPayRequestDetails;
-    feeSats: number;
-    invoiceDetails: Bolt11InvoiceDetails;
-    successAction?: SuccessAction;
+    validateSuccessActionUrl?: boolean;
 }
 
-export interface BitcoinAddressDetails {
-    address: string;
-    network: BitcoinNetwork;
-    source: PaymentRequestSource;
+export interface GetInfoResponse {
+    balanceSats: number;
+    tokenBalances: Map<string, TokenBalance>;
 }
 
 export type Seed = { type: "mnemonic"; mnemonic: string; passphrase?: string } | ({ type: "entropy" } & number[]);
 
-export interface Symbol {
-    grapheme?: string;
-    template?: string;
-    rtl?: boolean;
-    position?: number;
-}
-
-export interface LogEntry {
-    line: string;
-    level: string;
+export interface LnurlPayResponse {
+    payment: Payment;
+    successAction?: SuccessActionProcessed;
 }
 
-export interface Bip21Details {
-    amountSat?: number;
-    assetId?: string;
-    uri: string;
-    extras: Bip21Extra[];
-    label?: string;
-    message?: string;
-    paymentMethods: InputType[];
+export interface SendPaymentResponse {
+    payment: Payment;
 }
 
 export interface RegisterLightningAddressRequest {
@@ -403,21 +531,20 @@ export interface RegisterLightningAddressRequest {
     description?: string;
 }
 
-export interface PrepareSendPaymentResponse {
-    paymentMethod: SendPaymentMethod;
-    amount: bigint;
-    tokenIdentifier?: string;
+export interface LnurlPayInfo {
+    lnAddress?: string;
+    comment?: string;
+    domain?: string;
+    metadata?: string;
+    processedSuccessAction?: SuccessActionProcessed;
+    rawSuccessAction?: SuccessAction;
 }
 
-export interface ProvisionalPayment {
-    paymentId: string;
-    amount: bigint;
-    details: ProvisionalPaymentDetails;
-}
+export type PaymentMethod = "lightning" | "spark" | "token" | "deposit" | "withdraw" | "unknown";
 
-export interface IncomingChange {
-    newState: Record;
-    oldState?: Record;
+export interface TokenBalance {
+    balance: bigint;
+    tokenMetadata: TokenMetadata;
 }
 
 export interface CheckMessageRequest {
@@ -426,8 +553,47 @@ export interface CheckMessageRequest {
     signature: string;
 }
 
-export interface ListFiatRatesResponse {
-    rates: Rate[];
+export interface Bolt12OfferDetails {
+    absoluteExpiry?: number;
+    chains: string[];
+    description?: string;
+    issuer?: string;
+    minAmount?: Amount;
+    offer: Bolt12Offer;
+    paths: Bolt12OfferBlindedPath[];
+    signingPubkey?: string;
+}
+
+export type Network = "mainnet" | "regtest";
+
+export interface RefundDepositResponse {
+    txId: string;
+    txHex: string;
+}
+
+export type PaymentDetails = { type: "spark"; invoiceDetails?: SparkInvoicePaymentDetails; htlcDetails?: SparkHtlcDetails; tokenConversionInfo?: TokenConversionInfo } | { type: "token"; metadata: TokenMetadata; txHash: string; invoiceDetails?: SparkInvoicePaymentDetails; tokenConversionInfo?: TokenConversionInfo } | { type: "lightning"; description?: string; preimage?: string; invoice: string; paymentHash: string; destinationPubkey: string; lnurlPayInfo?: LnurlPayInfo; lnurlWithdrawInfo?: LnurlWithdrawInfo; lnurlReceiveMetadata?: LnurlReceiveMetadata } | { type: "withdraw"; txId: string } | { type: "deposit"; txId: string };
+
+export interface RecordId {
+    type: string;
+    dataId: string;
+}
+
+export interface FiatCurrency {
+    id: string;
+    info: CurrencyInfo;
+}
+
+export type SuccessAction = { type: "aes"; data: AesSuccessActionData } | { type: "message"; data: MessageSuccessActionData } | { type: "url"; data: UrlSuccessActionData };
+
+export interface LocalizedName {
+    locale: string;
+    name: string;
+}
+
+export interface OptimizationProgress {
+    isRunning: boolean;
+    currentRound: number;
+    totalRounds: number;
 }
 
 export interface LnurlAuthRequestDetails {
@@ -437,6 +603,14 @@ export interface LnurlAuthRequestDetails {
     url: string;
 }
 
+export interface SyncWalletRequest {}
+
+export interface ListUnclaimedDepositsRequest {}
+
+export interface UserSettings {
+    sparkPrivateModeEnabled: boolean;
+}
+
 export interface Bolt11RouteHintHop {
     srcNodeId: string;
     shortChannelId: string;
@@ -447,120 +621,125 @@ export interface Bolt11RouteHintHop {
     htlcMaximumMsat?: number;
 }
 
-export interface SyncWalletResponse {}
-
-export interface SparkInvoiceDetails {
-    invoice: string;
-    identityPublicKey: string;
-    network: BitcoinNetwork;
-    amount?: bigint;
-    tokenIdentifier?: string;
-    expiryTime?: number;
-    description?: string;
-    senderPublicKey?: string;
+export interface Bip21Extra {
+    key: string;
+    value: string;
 }
 
-export interface TokenMetadata {
-    identifier: string;
-    issuerPublicKey: string;
-    name: string;
-    ticker: string;
-    decimals: number;
-    maxSupply: bigint;
-    isFreezable: boolean;
+export interface ListFiatRatesResponse {
+    rates: Rate[];
 }
 
-export type SuccessActionProcessed = { type: "aes"; result: AesSuccessActionDataResult } | { type: "message"; data: MessageSuccessActionData } | { type: "url"; data: UrlSuccessActionData };
+export interface ClaimHtlcPaymentResponse {
+    payment: Payment;
+}
 
-export interface LightningAddressDetails {
-    address: string;
-    payRequest: LnurlPayRequestDetails;
+export interface SparkHtlcOptions {
+    paymentHash: string;
+    expiryDurationSecs: number;
 }
 
-export interface GetInfoResponse {
-    balanceSats: number;
-    tokenBalances: Map<string, TokenBalance>;
+export interface PaymentMetadata {
+    parentPaymentId?: string;
+    lnurlPayInfo?: LnurlPayInfo;
+    lnurlWithdrawInfo?: LnurlWithdrawInfo;
+    lnurlDescription?: string;
+    tokenConversionInfo?: TokenConversionInfo;
 }
 
-export interface SparkInvoicePaymentDetails {
-    description?: string;
-    invoice: string;
+export interface ClaimDepositResponse {
+    payment: Payment;
 }
 
-export type UpdateDepositPayload = { type: "claimError"; error: DepositClaimError } | { type: "refund"; refundTxid: string; refundTx: string };
+export interface Rate {
+    coin: string;
+    value: number;
+}
 
-export interface ClaimHtlcPaymentResponse {
-    payment: Payment;
+export interface ClaimHtlcPaymentRequest {
+    preimage: string;
 }
 
-export interface Config {
-    apiKey?: string;
-    network: Network;
-    syncIntervalSecs: number;
-    maxDepositClaimFee?: MaxFee;
-    lnurlDomain?: string;
-    preferSparkOverLightning: boolean;
-    externalInputParsers?: ExternalInputParser[];
-    useDefaultExternalInputParsers: boolean;
-    realTimeSyncServerUrl?: string;
-    privateEnabledDefault: boolean;
-    optimizationConfig: OptimizationConfig;
+export interface ConnectRequest {
+    config: Config;
+    seed: Seed;
+    storageDir: string;
 }
 
-export interface LightningAddressInfo {
-    description: string;
-    lightningAddress: string;
-    lnurl: string;
-    username: string;
+export interface Bolt12InvoiceRequestDetails {}
+
+export type SparkHtlcStatus = "waitingForPreimage" | "preimageShared" | "returned";
+
+export interface Bolt12Invoice {
+    invoice: string;
+    source: PaymentRequestSource;
 }
 
-export interface AesSuccessActionData {
-    description: string;
-    ciphertext: string;
-    iv: string;
+export interface LnurlWithdrawResponse {
+    paymentRequest: string;
+    payment?: Payment;
 }
 
-export type AssetFilter = { type: "bitcoin" } | { type: "token"; tokenIdentifier?: string };
+export type UpdateDepositPayload = { type: "claimError"; error: DepositClaimError } | { type: "refund"; refundTxid: string; refundTx: string };
 
 export type BitcoinNetwork = "bitcoin" | "testnet3" | "testnet4" | "signet" | "regtest";
 
-export interface Bolt11Invoice {
-    bolt11: string;
-    source: PaymentRequestSource;
+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 Bolt11RouteHint {
+    hops: Bolt11RouteHintHop[];
 }
 
-export type PaymentMethod = "lightning" | "spark" | "token" | "deposit" | "withdraw" | "unknown";
+export type OnchainConfirmationSpeed = "fast" | "medium" | "slow";
 
-export type ProvisionalPaymentDetails = { type: "bitcoin"; withdrawalAddress: string } | { type: "lightning"; invoice: string } | { type: "spark"; payRequest: string } | { type: "token"; tokenId: string; payRequest: string };
+export interface ReceivePaymentRequest {
+    paymentMethod: ReceivePaymentMethod;
+}
 
-export interface SendOnchainSpeedFeeQuote {
-    userFeeSat: number;
-    l1BroadcastFeeSat: number;
+export type PaymentStatus = "completed" | "pending" | "failed";
+
+export type AesSuccessActionDataResult = { type: "decrypted"; data: AesSuccessActionDataDecrypted } | { type: "errorStatus"; reason: string };
+
+export interface Credentials {
+    username: string;
+    password: string;
 }
 
-export interface SendPaymentResponse {
+export type TokenConversionType = { type: "fromBitcoin" } | { type: "toBitcoin"; fromTokenIdentifier: string };
+
+export interface GetPaymentResponse {
     payment: Payment;
 }
 
-export interface UrlSuccessActionData {
-    description: string;
-    url: string;
-    matchesCallbackDomain: boolean;
+export interface SparkInvoiceDetails {
+    invoice: string;
+    identityPublicKey: string;
+    network: BitcoinNetwork;
+    amount?: bigint;
+    tokenIdentifier?: string;
+    expiryTime?: number;
+    description?: string;
+    senderPublicKey?: string;
 }
 
-export type Fee = { type: "fixed"; amount: number } | { type: "rate"; satPerVbyte: number };
-
-export interface ReceivePaymentRequest {
-    paymentMethod: ReceivePaymentMethod;
+export interface GetTokensMetadataResponse {
+    tokensMetadata: TokenMetadata[];
 }
 
-export interface DepositInfo {
+export interface ClaimDepositRequest {
     txid: string;
     vout: number;
-    amountSats: number;
-    refundTx?: string;
-    refundTxId?: string;
-    claimError?: DepositClaimError;
+    maxFee?: MaxFee;
+}
+
+export type KeySetType = "default" | "taproot" | "nativeSegwit" | "wrappedSegwit" | "legacy";
+
+export interface PrepareSendPaymentResponse {
+    paymentMethod: SendPaymentMethod;
+    amount: bigint;
+    tokenIdentifier?: string;
+    tokenConversionOptions?: TokenConversionOptions;
+    tokenConversionFee?: bigint;
 }
 
 export interface OutgoingChange {
@@ -568,188 +747,183 @@ export interface OutgoingChange {
     parent?: Record;
 }
 
-export type SparkHtlcStatus = "waitingForPreimage" | "preimageShared" | "returned";
-
-export interface Bip21Extra {
-    key: string;
-    value: string;
-}
-
-export type AesSuccessActionDataResult = { type: "decrypted"; data: AesSuccessActionDataDecrypted } | { type: "errorStatus"; reason: string };
-
-export interface LocalizedName {
-    locale: string;
-    name: string;
+export interface UrlSuccessActionData {
+    description: string;
+    url: string;
+    matchesCallbackDomain: boolean;
 }
 
-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 ReceivePaymentResponse {
     paymentRequest: string;
     fee: bigint;
 }
 
-export interface AesSuccessActionDataDecrypted {
-    description: string;
-    plaintext: string;
+export interface IncomingChange {
+    newState: Record;
+    oldState?: Record;
 }
 
-export interface ClaimHtlcPaymentRequest {
-    preimage: string;
+export interface MintIssuerTokenRequest {
+    amount: bigint;
 }
 
-export interface ExternalInputParser {
-    providerId: string;
-    inputRegex: string;
-    parserUrl: string;
+export interface UnfreezeIssuerTokenResponse {
+    impactedOutputIds: string[];
+    impactedTokenAmount: bigint;
 }
 
-export interface LnurlPayRequest {
-    prepareResponse: PrepareLnurlPayResponse;
-    idempotencyKey?: string;
+export interface FreezeIssuerTokenRequest {
+    address: string;
 }
 
-export interface Credentials {
-    username: string;
-    password: string;
+export interface CreateIssuerTokenRequest {
+    name: string;
+    ticker: string;
+    decimals: number;
+    isFreezable: boolean;
+    maxSupply: bigint;
 }
 
-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 BurnIssuerTokenRequest {
+    amount: bigint;
 }
 
-export interface MessageSuccessActionData {
-    message: string;
+export interface FreezeIssuerTokenResponse {
+    impactedOutputIds: string[];
+    impactedTokenAmount: bigint;
 }
 
-export interface SparkHtlcDetails {
-    paymentHash: string;
-    preimage?: string;
-    expiryTime: number;
-    status: SparkHtlcStatus;
+export interface UnfreezeIssuerTokenRequest {
+    address: string;
 }
 
-export type MaxFee = { type: "fixed"; amount: number } | { type: "rate"; satPerVbyte: number } | { type: "networkRecommended"; leewaySatPerVbyte: number };
-
-export type PaymentStatus = "completed" | "pending" | "failed";
-
-export interface RefundDepositResponse {
-    txId: string;
-    txHex: string;
+export interface ExternalSigner {
+    identityPublicKey(): PublicKeyBytes;
+    derivePublicKey(path: string): Promise<PublicKeyBytes>;
+    signEcdsa(message: Uint8Array, path: string): Promise<EcdsaSignatureBytes>;
+    signEcdsaRecoverable(message: Uint8Array, path: string): Promise<RecoverableEcdsaSignatureBytes>;
+    eciesEncrypt(message: Uint8Array, path: string): Promise<Uint8Array>;
+    eciesDecrypt(message: Uint8Array, path: string): Promise<Uint8Array>;
+    signHashSchnorr(hash: Uint8Array, path: string): Promise<SchnorrSignatureBytes>;
+    generateFrostSigningCommitments(): Promise<ExternalFrostCommitments>;
+    getPublicKeyForNode(id: ExternalTreeNodeId): Promise<PublicKeyBytes>;
+    generateRandomKey(): Promise<ExternalPrivateKeySource>;
+    getStaticDepositPrivateKeySource(index: number): Promise<ExternalPrivateKeySource>;
+    getStaticDepositPrivateKey(index: number): Promise<PrivateKeyBytes>;
+    getStaticDepositPublicKey(index: number): Promise<PublicKeyBytes>;
+    subtractPrivateKeys(signingKey: ExternalPrivateKeySource, newSigningKey: ExternalPrivateKeySource): Promise<ExternalPrivateKeySource>;
+    splitSecretWithProofs(secret: ExternalSecretToSplit, threshold: number, numShares: number): Promise<ExternalVerifiableSecretShare[]>;
+    encryptPrivateKeyForReceiver(privateKey: ExternalEncryptedPrivateKey, receiverPublicKey: PublicKeyBytes): Promise<Uint8Array>;
+    getPublicKeyFromPrivateKeySource(privateKey: ExternalPrivateKeySource): Promise<PublicKeyBytes>;
+    signFrost(request: ExternalSignFrostRequest): Promise<ExternalFrostSignatureShare>;
+    aggregateFrost(request: ExternalAggregateFrostRequest): Promise<ExternalFrostSignature>;
 }
 
-export type ReceivePaymentMethod = { type: "sparkAddress" } | { type: "sparkInvoice"; amount?: bigint; tokenIdentifier?: string; expiryTime?: number; description?: string; senderPublicKey?: string } | { type: "bitcoinAddress" } | { type: "bolt11Invoice"; description: string; amountSats?: number; expirySecs?: number };
-
-export interface LnurlWithdrawResponse {
-    paymentRequest: string;
-    payment?: Payment;
+export interface ExternalSignFrostRequest {
+    message: number[];
+    publicKey: number[];
+    privateKey: ExternalPrivateKeySource;
+    verifyingKey: number[];
+    selfNonceCommitment: ExternalFrostCommitments;
+    statechainCommitments: IdentifierCommitmentPair[];
+    adaptorPublicKey?: number[];
 }
 
-export interface GetPaymentRequest {
-    paymentId: string;
+export interface PrivateKeyBytes {
+    bytes: number[];
 }
 
-export interface Rate {
-    coin: string;
-    value: number;
+export interface ExternalFrostSignature {
+    bytes: number[];
 }
 
-export interface ListUnclaimedDepositsRequest {}
-
-export interface SyncWalletRequest {}
-
-export interface SetLnurlMetadataItem {
-    paymentHash: string;
-    senderComment?: string;
-    nostrZapRequest?: string;
-    nostrZapReceipt?: string;
+export interface RecoverableEcdsaSignatureBytes {
+    bytes: number[];
 }
 
-export type SuccessAction = { type: "aes"; data: AesSuccessActionData } | { type: "message"; data: MessageSuccessActionData } | { type: "url"; data: UrlSuccessActionData };
-
-export type PaymentType = "send" | "receive";
+export interface SchnorrSignatureBytes {
+    bytes: number[];
+}
 
-export interface SignMessageRequest {
-    message: string;
-    compact: boolean;
+export interface EcdsaSignatureBytes {
+    bytes: number[];
 }
 
-export type Amount = { type: "bitcoin"; amountMsat: number } | { type: "currency"; iso4217Code: string; fractionalAmount: number };
+export interface ExternalFrostCommitments {
+    hidingCommitment: number[];
+    bindingCommitment: number[];
+    noncesCiphertext: number[];
+}
 
-export interface SendOnchainFeeQuote {
-    id: string;
-    expiresAt: number;
-    speedFast: SendOnchainSpeedFeeQuote;
-    speedMedium: SendOnchainSpeedFeeQuote;
-    speedSlow: SendOnchainSpeedFeeQuote;
+export interface IdentifierSignaturePair {
+    identifier: ExternalIdentifier;
+    signature: ExternalFrostSignatureShare;
 }
 
-export interface OptimizationConfig {
-    autoEnabled: boolean;
-    multiplicity: number;
+export interface ExternalSigningCommitments {
+    hiding: number[];
+    binding: number[];
 }
 
-export interface CheckMessageResponse {
-    isValid: boolean;
+export interface ExternalIdentifier {
+    bytes: number[];
 }
 
-export interface GetPaymentResponse {
-    payment: Payment;
+export type ExternalSecretToSplit = { type: "privateKey"; source: ExternalPrivateKeySource } | { type: "preimage"; data: number[] };
+
+export interface ExternalFrostSignatureShare {
+    bytes: number[];
 }
 
-export interface Bolt12InvoiceDetails {
-    amountMsat: number;
-    invoice: Bolt12Invoice;
+export type ExternalPrivateKeySource = { type: "derived"; nodeId: ExternalTreeNodeId } | { type: "encrypted"; key: ExternalEncryptedPrivateKey };
+
+export interface ExternalAggregateFrostRequest {
+    message: number[];
+    statechainSignatures: IdentifierSignaturePair[];
+    statechainPublicKeys: IdentifierPublicKeyPair[];
+    verifyingKey: number[];
+    statechainCommitments: IdentifierCommitmentPair[];
+    selfCommitment: ExternalSigningCommitments;
+    publicKey: number[];
+    selfSignature: ExternalFrostSignatureShare;
+    adaptorPublicKey?: number[];
 }
 
-export interface FiatCurrency {
-    id: string;
-    info: CurrencyInfo;
+export interface ExternalEncryptedPrivateKey {
+    ciphertext: number[];
 }
 
-export interface UnfreezeIssuerTokenResponse {
-    impactedOutputIds: string[];
-    impactedTokenAmount: bigint;
+export interface IdentifierPublicKeyPair {
+    identifier: ExternalIdentifier;
+    publicKey: number[];
 }
 
-export interface MintIssuerTokenRequest {
-    amount: bigint;
+export interface ExternalScalar {
+    bytes: number[];
 }
 
-export interface BurnIssuerTokenRequest {
-    amount: bigint;
+export interface ExternalSecretShare {
+    threshold: number;
+    index: ExternalScalar;
+    share: ExternalScalar;
 }
 
-export interface UnfreezeIssuerTokenRequest {
-    address: string;
+export interface PublicKeyBytes {
+    bytes: number[];
 }
 
-export interface FreezeIssuerTokenRequest {
-    address: string;
+export interface IdentifierCommitmentPair {
+    identifier: ExternalIdentifier;
+    commitment: ExternalSigningCommitments;
 }
 
-export interface FreezeIssuerTokenResponse {
-    impactedOutputIds: string[];
-    impactedTokenAmount: bigint;
+export interface ExternalVerifiableSecretShare {
+    secretShare: ExternalSecretShare;
+    proofs: number[][];
 }
 
-export interface CreateIssuerTokenRequest {
-    name: string;
-    ticker: string;
-    decimals: number;
-    isFreezable: boolean;
-    maxSupply: bigint;
+export interface ExternalTreeNodeId {
+    id: string;
 }
 
 export interface Storage {
@@ -810,12 +984,40 @@ export class BreezSdk {
   cancelLeafOptimization(): Promise<void>;
   deleteLightningAddress(): Promise<void>;
   registerLightningAddress(request: RegisterLightningAddressRequest): Promise<LightningAddressInfo>;
+  fetchTokenConversionLimits(request: FetchTokenConversionLimitsRequest): Promise<FetchTokenConversionLimitsResponse>;
   getLeafOptimizationProgress(): OptimizationProgress;
   checkLightningAddressAvailable(request: CheckLightningAddressRequest): Promise<boolean>;
   parse(input: string): Promise<InputType>;
   getInfo(request: GetInfoRequest): Promise<GetInfoResponse>;
   lnurlPay(request: LnurlPayRequest): Promise<LnurlPayResponse>;
 }
+/**
+ * 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: Uint8Array, path: string): Promise<EcdsaSignatureBytes>;
+  signFrost(request: ExternalSignFrostRequest): Promise<ExternalFrostSignatureShare>;
+  eciesDecrypt(message: Uint8Array, path: string): Promise<Uint8Array>;
+  eciesEncrypt(message: Uint8Array, path: string): Promise<Uint8Array>;
+  aggregateFrost(request: ExternalAggregateFrostRequest): Promise<ExternalFrostSignature>;
+  derivePublicKey(path: string): Promise<PublicKeyBytes>;
+  signHashSchnorr(hash: Uint8Array, path: string): Promise<SchnorrSignatureBytes>;
+  generateRandomKey(): Promise<ExternalPrivateKeySource>;
+  identityPublicKey(): PublicKeyBytes;
+  subtractPrivateKeys(signing_key: ExternalPrivateKeySource, new_signing_key: ExternalPrivateKeySource): Promise<ExternalPrivateKeySource>;
+  signEcdsaRecoverable(message: Uint8Array, path: string): Promise<RecoverableEcdsaSignatureBytes>;
+  getPublicKeyForNode(id: ExternalTreeNodeId): Promise<PublicKeyBytes>;
+  splitSecretWithProofs(secret: ExternalSecretToSplit, threshold: number, num_shares: number): Promise<ExternalVerifiableSecretShare[]>;
+  getStaticDepositPublicKey(index: number): Promise<PublicKeyBytes>;
+  getStaticDepositPrivateKey(index: number): Promise<PrivateKeyBytes>;
+  encryptPrivateKeyForReceiver(private_key: ExternalEncryptedPrivateKey, receiver_public_key: PublicKeyBytes): Promise<Uint8Array>;
+  generateFrostSigningCommitments(): Promise<ExternalFrostCommitments>;
+  getStaticDepositPrivateKeySource(index: number): Promise<ExternalPrivateKeySource>;
+  getPublicKeyFromPrivateKeySource(private_key: ExternalPrivateKeySource): Promise<PublicKeyBytes>;
+}
 export class IntoUnderlyingByteSource {
   private constructor();
   free(): void;
@@ -841,8 +1043,9 @@ export class IntoUnderlyingSource {
 export class SdkBuilder {
   private constructor();
   free(): void;
-  withKeySet(key_set_type: KeySetType, use_address_index: boolean, account_number?: number | null): SdkBuilder;
+  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;