@breeztech/breez-sdk-spark-react-native 0.9.1 → 0.11.0-dev2

package/lib/typescript/module/src/generated/breez_sdk_spark.d.ts

@@ -73,6 +73,35 @@ export interface EventListener {
 export interface Logger {
     log(l: LogEntry): void;
 }
+/**
+ * Request to add a new contact.
+ */
+export type AddContactRequest = {
+    name: string;
+    /**
+     * A Lightning address (user@domain).
+     */
+    paymentIdentifier: string;
+};
+/**
+ * Generated factory for {@link AddContactRequest} record objects.
+ */
+export declare const AddContactRequest: Readonly<{
+    /**
+     * Create a frozen instance of {@link AddContactRequest}, with defaults specified
+     * in Rust, in the {@link breez_sdk_spark} crate.
+     */
+    create: (partial: Partial<AddContactRequest> & Required<Omit<AddContactRequest, never>>) => AddContactRequest;
+    /**
+     * Create a frozen instance of {@link AddContactRequest}, with defaults specified
+     * in Rust, in the {@link breez_sdk_spark} crate.
+     */
+    new: (partial: Partial<AddContactRequest> & Required<Omit<AddContactRequest, never>>) => AddContactRequest;
+    /**
+     * Defaults specified in the {@link breez_sdk_spark} crate.
+     */
+    defaults: () => Partial<AddContactRequest>;
+}>;
 /**
  * Payload of the AES success action, as received from the LNURL endpoint
  *
@@ -791,6 +820,11 @@ export type Config = {
      * Default is 4. Increase for server environments with high incoming payment volume.
      */
     maxConcurrentClaims: number;
+    /**
+     * When true, enables LNURL verify support (LUD-21) and zap receipts (NIP-57).
+     * When false (default), these features are disabled for privacy.
+     */
+    supportLnurlVerify: boolean;
 };
 /**
  * Generated factory for {@link Config} record objects.
@@ -864,6 +898,38 @@ export declare const ConnectWithSignerRequest: Readonly<{
      */
     defaults: () => Partial<ConnectWithSignerRequest>;
 }>;
+/**
+ * A contact entry containing a name and payment identifier.
+ */
+export type Contact = {
+    id: string;
+    name: string;
+    /**
+     * A Lightning address (user@domain).
+     */
+    paymentIdentifier: string;
+    createdAt: bigint;
+    updatedAt: bigint;
+};
+/**
+ * Generated factory for {@link Contact} record objects.
+ */
+export declare const Contact: Readonly<{
+    /**
+     * Create a frozen instance of {@link Contact}, with defaults specified
+     * in Rust, in the {@link breez_sdk_spark} crate.
+     */
+    create: (partial: Partial<Contact> & Required<Omit<Contact, never>>) => Contact;
+    /**
+     * Create a frozen instance of {@link Contact}, with defaults specified
+     * in Rust, in the {@link breez_sdk_spark} crate.
+     */
+    new: (partial: Partial<Contact> & Required<Omit<Contact, never>>) => Contact;
+    /**
+     * Defaults specified in the {@link breez_sdk_spark} crate.
+     */
+    defaults: () => Partial<Contact>;
+}>;
 /**
  * Outlines the steps involved in a conversion
  */
@@ -2139,6 +2205,32 @@ export declare const LightningAddressInfo: Readonly<{
      */
     defaults: () => Partial<LightningAddressInfo>;
 }>;
+/**
+ * Request to list contacts with optional pagination.
+ */
+export type ListContactsRequest = {
+    offset: /*u32*/ number | undefined;
+    limit: /*u32*/ number | undefined;
+};
+/**
+ * Generated factory for {@link ListContactsRequest} record objects.
+ */
+export declare const ListContactsRequest: Readonly<{
+    /**
+     * Create a frozen instance of {@link ListContactsRequest}, with defaults specified
+     * in Rust, in the {@link breez_sdk_spark} crate.
+     */
+    create: (partial: Partial<ListContactsRequest> & Required<Omit<ListContactsRequest, "offset" | "limit">>) => ListContactsRequest;
+    /**
+     * Create a frozen instance of {@link ListContactsRequest}, with defaults specified
+     * in Rust, in the {@link breez_sdk_spark} crate.
+     */
+    new: (partial: Partial<ListContactsRequest> & Required<Omit<ListContactsRequest, "offset" | "limit">>) => ListContactsRequest;
+    /**
+     * Defaults specified in the {@link breez_sdk_spark} crate.
+     */
+    defaults: () => Partial<ListContactsRequest>;
+}>;
 /**
  * Response from listing fiat currencies
  */
@@ -2232,12 +2324,12 @@ export declare const ListPaymentsRequest: Readonly<{
      * Create a frozen instance of {@link ListPaymentsRequest}, with defaults specified
      * in Rust, in the {@link breez_sdk_spark} crate.
      */
-    create: (partial: Partial<ListPaymentsRequest> & Required<Omit<ListPaymentsRequest, "typeFilter" | "statusFilter" | "assetFilter" | "paymentDetailsFilter" | "fromTimestamp" | "toTimestamp" | "offset" | "limit" | "sortAscending">>) => ListPaymentsRequest;
+    create: (partial: Partial<ListPaymentsRequest> & Required<Omit<ListPaymentsRequest, "offset" | "limit" | "typeFilter" | "statusFilter" | "assetFilter" | "paymentDetailsFilter" | "fromTimestamp" | "toTimestamp" | "sortAscending">>) => ListPaymentsRequest;
     /**
      * Create a frozen instance of {@link ListPaymentsRequest}, with defaults specified
      * in Rust, in the {@link breez_sdk_spark} crate.
      */
-    new: (partial: Partial<ListPaymentsRequest> & Required<Omit<ListPaymentsRequest, "typeFilter" | "statusFilter" | "assetFilter" | "paymentDetailsFilter" | "fromTimestamp" | "toTimestamp" | "offset" | "limit" | "sortAscending">>) => ListPaymentsRequest;
+    new: (partial: Partial<ListPaymentsRequest> & Required<Omit<ListPaymentsRequest, "offset" | "limit" | "typeFilter" | "statusFilter" | "assetFilter" | "paymentDetailsFilter" | "fromTimestamp" | "toTimestamp" | "sortAscending">>) => ListPaymentsRequest;
     /**
      * Defaults specified in the {@link breez_sdk_spark} crate.
      */
@@ -3711,6 +3803,7 @@ export type SetLnurlMetadataItem = {
     senderComment: string | undefined;
     nostrZapRequest: string | undefined;
     nostrZapReceipt: string | undefined;
+    preimage: string | undefined;
 };
 /**
  * Generated factory for {@link SetLnurlMetadataItem} record objects.
@@ -4074,6 +4167,40 @@ export declare const StableBalanceConfig: Readonly<{
      */
     defaults: () => Partial<StableBalanceConfig>;
 }>;
+/**
+ * Storage-internal variant of [`ListPaymentsRequest`] that uses
+ * [`StoragePaymentDetailsFilter`] instead of the public [`PaymentDetailsFilter`].
+ */
+export type StorageListPaymentsRequest = {
+    typeFilter: Array<PaymentType> | undefined;
+    statusFilter: Array<PaymentStatus> | undefined;
+    assetFilter: AssetFilter | undefined;
+    paymentDetailsFilter: Array<StoragePaymentDetailsFilter> | undefined;
+    fromTimestamp: /*u64*/ bigint | undefined;
+    toTimestamp: /*u64*/ bigint | undefined;
+    offset: /*u32*/ number | undefined;
+    limit: /*u32*/ number | undefined;
+    sortAscending: boolean | undefined;
+};
+/**
+ * Generated factory for {@link StorageListPaymentsRequest} record objects.
+ */
+export declare const StorageListPaymentsRequest: Readonly<{
+    /**
+     * Create a frozen instance of {@link StorageListPaymentsRequest}, with defaults specified
+     * in Rust, in the {@link breez_sdk_spark} crate.
+     */
+    create: (partial: Partial<StorageListPaymentsRequest> & Required<Omit<StorageListPaymentsRequest, "offset" | "limit" | "typeFilter" | "statusFilter" | "assetFilter" | "paymentDetailsFilter" | "fromTimestamp" | "toTimestamp" | "sortAscending">>) => StorageListPaymentsRequest;
+    /**
+     * Create a frozen instance of {@link StorageListPaymentsRequest}, with defaults specified
+     * in Rust, in the {@link breez_sdk_spark} crate.
+     */
+    new: (partial: Partial<StorageListPaymentsRequest> & Required<Omit<StorageListPaymentsRequest, "offset" | "limit" | "typeFilter" | "statusFilter" | "assetFilter" | "paymentDetailsFilter" | "fromTimestamp" | "toTimestamp" | "sortAscending">>) => StorageListPaymentsRequest;
+    /**
+     * Defaults specified in the {@link breez_sdk_spark} crate.
+     */
+    defaults: () => Partial<StorageListPaymentsRequest>;
+}>;
 /**
  * Settings for the symbol representation of a currency
  */
@@ -4298,6 +4425,36 @@ export declare const UnversionedRecordChange: Readonly<{
      */
     defaults: () => Partial<UnversionedRecordChange>;
 }>;
+/**
+ * Request to update an existing contact.
+ */
+export type UpdateContactRequest = {
+    id: string;
+    name: string;
+    /**
+     * A Lightning address (user@domain).
+     */
+    paymentIdentifier: string;
+};
+/**
+ * Generated factory for {@link UpdateContactRequest} record objects.
+ */
+export declare const UpdateContactRequest: Readonly<{
+    /**
+     * Create a frozen instance of {@link UpdateContactRequest}, with defaults specified
+     * in Rust, in the {@link breez_sdk_spark} crate.
+     */
+    create: (partial: Partial<UpdateContactRequest> & Required<Omit<UpdateContactRequest, never>>) => UpdateContactRequest;
+    /**
+     * Create a frozen instance of {@link UpdateContactRequest}, with defaults specified
+     * in Rust, in the {@link breez_sdk_spark} crate.
+     */
+    new: (partial: Partial<UpdateContactRequest> & Required<Omit<UpdateContactRequest, never>>) => UpdateContactRequest;
+    /**
+     * Defaults specified in the {@link breez_sdk_spark} crate.
+     */
+    defaults: () => Partial<UpdateContactRequest>;
+}>;
 export type UpdateUserSettingsRequest = {
     sparkPrivateModeEnabled: boolean | undefined;
 };
@@ -10474,7 +10631,8 @@ export declare enum StorageError_Tags {
     Connection = "Connection",
     Implementation = "Implementation",
     InitializationError = "InitializationError",
-    Serialization = "Serialization"
+    Serialization = "Serialization",
+    NotFound = "NotFound"
 }
 /**
  * Errors that can occur during storage operations
@@ -10765,11 +10923,221 @@ export declare const StorageError: Readonly<{
         prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
         stackTraceLimit: number;
     };
+    NotFound: {
+        new (): {
+            readonly tag: StorageError_Tags.NotFound;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "StorageError";
+            name: string;
+            message: string;
+            stack?: string;
+            cause?: unknown;
+        };
+        "new"(): {
+            readonly tag: StorageError_Tags.NotFound;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "StorageError";
+            name: string;
+            message: string;
+            stack?: string;
+            cause?: unknown;
+        };
+        instanceOf(obj: any): obj is {
+            readonly tag: StorageError_Tags.NotFound;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "StorageError";
+            name: string;
+            message: string;
+            stack?: string;
+            cause?: unknown;
+        };
+        hasInner(obj: any): obj is {
+            readonly tag: StorageError_Tags.NotFound;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "StorageError";
+            name: string;
+            message: string;
+            stack?: string;
+            cause?: unknown;
+        };
+        isError(error: unknown): error is Error;
+        captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+        prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+        stackTraceLimit: number;
+    };
 }>;
 /**
  * Errors that can occur during storage operations
  */
 export type StorageError = InstanceType<(typeof StorageError)[keyof Omit<typeof StorageError, 'instanceOf'>]>;
+export declare enum StoragePaymentDetailsFilter_Tags {
+    Spark = "Spark",
+    Token = "Token",
+    Lightning = "Lightning"
+}
+/**
+ * Storage-internal variant of [`PaymentDetailsFilter`] that includes the
+ * `has_lnurl_preimage` field on the `Lightning` variant, which is not exposed
+ * in the public API.
+ */
+export declare const StoragePaymentDetailsFilter: Readonly<{
+    instanceOf: (obj: any) => obj is StoragePaymentDetailsFilter;
+    Spark: {
+        new (inner: {
+            htlcStatus: Array<SparkHtlcStatus> | undefined;
+            conversionRefundNeeded: boolean | undefined;
+        }): {
+            readonly tag: StoragePaymentDetailsFilter_Tags.Spark;
+            readonly inner: Readonly<{
+                htlcStatus: Array<SparkHtlcStatus> | undefined;
+                conversionRefundNeeded: boolean | undefined;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "StoragePaymentDetailsFilter";
+        };
+        "new"(inner: {
+            htlcStatus: Array<SparkHtlcStatus> | undefined;
+            conversionRefundNeeded: boolean | undefined;
+        }): {
+            readonly tag: StoragePaymentDetailsFilter_Tags.Spark;
+            readonly inner: Readonly<{
+                htlcStatus: Array<SparkHtlcStatus> | undefined;
+                conversionRefundNeeded: boolean | undefined;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "StoragePaymentDetailsFilter";
+        };
+        instanceOf(obj: any): obj is {
+            readonly tag: StoragePaymentDetailsFilter_Tags.Spark;
+            readonly inner: Readonly<{
+                htlcStatus: Array<SparkHtlcStatus> | undefined;
+                conversionRefundNeeded: boolean | undefined;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "StoragePaymentDetailsFilter";
+        };
+    };
+    Token: {
+        new (inner: {
+            conversionRefundNeeded: boolean | undefined;
+            txHash: string | undefined;
+            txType: TokenTransactionType | undefined;
+        }): {
+            readonly tag: StoragePaymentDetailsFilter_Tags.Token;
+            readonly inner: Readonly<{
+                conversionRefundNeeded: boolean | undefined;
+                txHash: string | undefined;
+                txType: TokenTransactionType | undefined;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "StoragePaymentDetailsFilter";
+        };
+        "new"(inner: {
+            conversionRefundNeeded: boolean | undefined;
+            txHash: string | undefined;
+            txType: TokenTransactionType | undefined;
+        }): {
+            readonly tag: StoragePaymentDetailsFilter_Tags.Token;
+            readonly inner: Readonly<{
+                conversionRefundNeeded: boolean | undefined;
+                txHash: string | undefined;
+                txType: TokenTransactionType | undefined;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "StoragePaymentDetailsFilter";
+        };
+        instanceOf(obj: any): obj is {
+            readonly tag: StoragePaymentDetailsFilter_Tags.Token;
+            readonly inner: Readonly<{
+                conversionRefundNeeded: boolean | undefined;
+                txHash: string | undefined;
+                txType: TokenTransactionType | undefined;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "StoragePaymentDetailsFilter";
+        };
+    };
+    Lightning: {
+        new (inner: {
+            htlcStatus: Array<SparkHtlcStatus> | undefined;
+            hasLnurlPreimage: boolean | undefined;
+        }): {
+            readonly tag: StoragePaymentDetailsFilter_Tags.Lightning;
+            readonly inner: Readonly<{
+                htlcStatus: Array<SparkHtlcStatus> | undefined;
+                hasLnurlPreimage: boolean | undefined;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "StoragePaymentDetailsFilter";
+        };
+        "new"(inner: {
+            htlcStatus: Array<SparkHtlcStatus> | undefined;
+            hasLnurlPreimage: boolean | undefined;
+        }): {
+            readonly tag: StoragePaymentDetailsFilter_Tags.Lightning;
+            readonly inner: Readonly<{
+                htlcStatus: Array<SparkHtlcStatus> | undefined;
+                hasLnurlPreimage: boolean | undefined;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "StoragePaymentDetailsFilter";
+        };
+        instanceOf(obj: any): obj is {
+            readonly tag: StoragePaymentDetailsFilter_Tags.Lightning;
+            readonly inner: Readonly<{
+                htlcStatus: Array<SparkHtlcStatus> | undefined;
+                hasLnurlPreimage: boolean | undefined;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "StoragePaymentDetailsFilter";
+        };
+    };
+}>;
+/**
+ * Storage-internal variant of [`PaymentDetailsFilter`] that includes the
+ * `has_lnurl_preimage` field on the `Lightning` variant, which is not exposed
+ * in the public API.
+ */
+export type StoragePaymentDetailsFilter = InstanceType<(typeof StoragePaymentDetailsFilter)[keyof Omit<typeof StoragePaymentDetailsFilter, 'instanceOf'>]>;
 export declare enum SuccessAction_Tags {
     Aes = "Aes",
     Message = "Message",
@@ -11188,6 +11556,20 @@ export declare class BitcoinChainServiceImpl extends UniffiAbstractObject implem
  * with request/response objects and comprehensive error handling.
  */
 export interface BreezSdkInterface {
+    /**
+     * Adds a new contact.
+     *
+     * # Arguments
+     *
+     * * `request` - The request containing the contact details
+     *
+     * # Returns
+     *
+     * The created contact or an error
+     */
+    addContact(request: AddContactRequest, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<Contact>;
     /**
      * Registers a listener to receive SDK events
      *
@@ -11250,6 +11632,20 @@ export interface BreezSdkInterface {
     claimHtlcPayment(request: ClaimHtlcPaymentRequest, asyncOpts_?: {
         signal: AbortSignal;
     }): Promise<ClaimHtlcPaymentResponse>;
+    /**
+     * Deletes a contact by its ID.
+     *
+     * # Arguments
+     *
+     * * `id` - The ID of the contact to delete
+     *
+     * # Returns
+     *
+     * Success or an error
+     */
+    deleteContact(id: string, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<void>;
     deleteLightningAddress(asyncOpts_?: {
         signal: AbortSignal;
     }): Promise<void>;
@@ -11308,6 +11704,20 @@ export interface BreezSdkInterface {
     getUserSettings(asyncOpts_?: {
         signal: AbortSignal;
     }): Promise<UserSettings>;
+    /**
+     * Lists contacts with optional pagination.
+     *
+     * # Arguments
+     *
+     * * `request` - The request containing optional pagination parameters
+     *
+     * # Returns
+     *
+     * A list of contacts or an error
+     */
+    listContacts(request: ListContactsRequest, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<Array<Contact>>;
     /**
      * List fiat currencies for which there is a known exchange rate,
      * sorted by the canonical name of the currency.
@@ -11448,6 +11858,20 @@ export interface BreezSdkInterface {
     syncWallet(request: SyncWalletRequest, asyncOpts_?: {
         signal: AbortSignal;
     }): Promise<SyncWalletResponse>;
+    /**
+     * Updates an existing contact.
+     *
+     * # Arguments
+     *
+     * * `request` - The request containing the updated contact details
+     *
+     * # Returns
+     *
+     * The updated contact or an error
+     */
+    updateContact(request: UpdateContactRequest, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<Contact>;
     /**
      * Updates the user settings for the wallet.
      *
@@ -11466,6 +11890,20 @@ export declare class BreezSdk extends UniffiAbstractObject implements BreezSdkIn
     readonly [destructorGuardSymbol]: UniffiRustArcPtr;
     readonly [pointerLiteralSymbol]: UnsafeMutableRawPointer;
     private constructor();
+    /**
+     * Adds a new contact.
+     *
+     * # Arguments
+     *
+     * * `request` - The request containing the contact details
+     *
+     * # Returns
+     *
+     * The created contact or an error
+     */
+    addContact(request: AddContactRequest, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<Contact>;
     /**
      * Registers a listener to receive SDK events
      *
@@ -11528,6 +11966,20 @@ export declare class BreezSdk extends UniffiAbstractObject implements BreezSdkIn
     claimHtlcPayment(request: ClaimHtlcPaymentRequest, asyncOpts_?: {
         signal: AbortSignal;
     }): Promise<ClaimHtlcPaymentResponse>;
+    /**
+     * Deletes a contact by its ID.
+     *
+     * # Arguments
+     *
+     * * `id` - The ID of the contact to delete
+     *
+     * # Returns
+     *
+     * Success or an error
+     */
+    deleteContact(id: string, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<void>;
     deleteLightningAddress(asyncOpts_?: {
         signal: AbortSignal;
     }): Promise<void>;
@@ -11586,6 +12038,20 @@ export declare class BreezSdk extends UniffiAbstractObject implements BreezSdkIn
     getUserSettings(asyncOpts_?: {
         signal: AbortSignal;
     }): Promise<UserSettings>;
+    /**
+     * Lists contacts with optional pagination.
+     *
+     * # Arguments
+     *
+     * * `request` - The request containing optional pagination parameters
+     *
+     * # Returns
+     *
+     * A list of contacts or an error
+     */
+    listContacts(request: ListContactsRequest, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<Array<Contact>>;
     /**
      * List fiat currencies for which there is a known exchange rate,
      * sorted by the canonical name of the currency.
@@ -11726,6 +12192,20 @@ export declare class BreezSdk extends UniffiAbstractObject implements BreezSdkIn
     syncWallet(request: SyncWalletRequest, asyncOpts_?: {
         signal: AbortSignal;
     }): Promise<SyncWalletResponse>;
+    /**
+     * Updates an existing contact.
+     *
+     * # Arguments
+     *
+     * * `request` - The request containing the updated contact details
+     *
+     * # Returns
+     *
+     * The updated contact or an error
+     */
+    updateContact(request: UpdateContactRequest, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<Contact>;
     /**
      * Updates the user settings for the wallet.
      *
@@ -12691,7 +13171,7 @@ export interface Storage {
      *
      * A vector of payments or a `StorageError`
      */
-    listPayments(request: ListPaymentsRequest, asyncOpts_?: {
+    listPayments(request: StorageListPaymentsRequest, asyncOpts_?: {
         signal: AbortSignal;
     }): Promise<Array<Payment>>;
     /**
@@ -12819,6 +13299,31 @@ export interface Storage {
     setLnurlMetadata(metadata: Array<SetLnurlMetadataItem>, asyncOpts_?: {
         signal: AbortSignal;
     }): Promise<void>;
+    /**
+     * Lists contacts from storage with optional pagination
+     */
+    listContacts(request: ListContactsRequest, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<Array<Contact>>;
+    /**
+     * Gets a single contact by its ID
+     */
+    getContact(id: string, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<Contact>;
+    /**
+     * Inserts or updates a contact in storage (upsert by id).
+     * Preserves `created_at` on update.
+     */
+    insertContact(contact: Contact, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<void>;
+    /**
+     * Deletes a contact by its ID
+     */
+    deleteContact(id: string, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<void>;
     addOutgoingChange(record: UnversionedRecordChange, asyncOpts_?: {
         signal: AbortSignal;
     }): Promise</*u64*/ bigint>;
@@ -12898,7 +13403,7 @@ export declare class StorageImpl extends UniffiAbstractObject implements Storage
      *
      * A vector of payments or a `StorageError`
      */
-    listPayments(request: ListPaymentsRequest, asyncOpts_?: {
+    listPayments(request: StorageListPaymentsRequest, asyncOpts_?: {
         signal: AbortSignal;
     }): Promise<Array<Payment>>;
     /**
@@ -13026,6 +13531,31 @@ export declare class StorageImpl extends UniffiAbstractObject implements Storage
     setLnurlMetadata(metadata: Array<SetLnurlMetadataItem>, asyncOpts_?: {
         signal: AbortSignal;
     }): Promise<void>;
+    /**
+     * Lists contacts from storage with optional pagination
+     */
+    listContacts(request: ListContactsRequest, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<Array<Contact>>;
+    /**
+     * Gets a single contact by its ID
+     */
+    getContact(id: string, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<Contact>;
+    /**
+     * Inserts or updates a contact in storage (upsert by id).
+     * Preserves `created_at` on update.
+     */
+    insertContact(contact: Contact, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<void>;
+    /**
+     * Deletes a contact by its ID
+     */
+    deleteContact(id: string, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<void>;
     addOutgoingChange(record: UnversionedRecordChange, asyncOpts_?: {
         signal: AbortSignal;
     }): Promise</*u64*/ bigint>;
@@ -13317,6 +13847,13 @@ declare function uniffiEnsureInitialized(): void;
 declare const _default: Readonly<{
     initialize: typeof uniffiEnsureInitialized;
     converters: {
+        FfiConverterTypeAddContactRequest: {
+            read(from: RustBuffer): AddContactRequest;
+            write(value: AddContactRequest, into: RustBuffer): void;
+            allocationSize(value: AddContactRequest): number;
+            lift(value: UniffiByteArray): AddContactRequest;
+            lower(value: AddContactRequest): UniffiByteArray;
+        };
         FfiConverterTypeAesSuccessActionData: {
             read(from: RustBuffer): AesSuccessActionData;
             write(value: AesSuccessActionData, into: RustBuffer): void;
@@ -13480,6 +14017,13 @@ declare const _default: Readonly<{
             lift(value: UniffiByteArray): ChainApiType;
             lower(value: ChainApiType): UniffiByteArray;
         };
+        FfiConverterTypeChainServiceError: {
+            read(from: RustBuffer): ChainServiceError;
+            write(value: ChainServiceError, into: RustBuffer): void;
+            allocationSize(value: ChainServiceError): number;
+            lift(value: UniffiByteArray): ChainServiceError;
+            lower(value: ChainServiceError): UniffiByteArray;
+        };
         FfiConverterTypeCheckLightningAddressRequest: {
             read(from: RustBuffer): CheckLightningAddressRequest;
             write(value: CheckLightningAddressRequest, into: RustBuffer): void;
@@ -13550,6 +14094,13 @@ declare const _default: Readonly<{
             lift(value: UniffiByteArray): ConnectWithSignerRequest;
             lower(value: ConnectWithSignerRequest): UniffiByteArray;
         };
+        FfiConverterTypeContact: {
+            read(from: RustBuffer): Contact;
+            write(value: Contact, into: RustBuffer): void;
+            allocationSize(value: Contact): number;
+            lift(value: UniffiByteArray): Contact;
+            lower(value: Contact): UniffiByteArray;
+        };
         FfiConverterTypeConversionDetails: {
             read(from: RustBuffer): ConversionDetails;
             write(value: ConversionDetails, into: RustBuffer): void;
@@ -13916,6 +14467,13 @@ declare const _default: Readonly<{
             lift(value: UniffiByteArray): LightningAddressInfo;
             lower(value: LightningAddressInfo): UniffiByteArray;
         };
+        FfiConverterTypeListContactsRequest: {
+            read(from: RustBuffer): ListContactsRequest;
+            write(value: ListContactsRequest, into: RustBuffer): void;
+            allocationSize(value: ListContactsRequest): number;
+            lift(value: UniffiByteArray): ListContactsRequest;
+            lower(value: ListContactsRequest): UniffiByteArray;
+        };
         FfiConverterTypeListFiatCurrenciesResponse: {
             read(from: RustBuffer): ListFiatCurrenciesResponse;
             write(value: ListFiatCurrenciesResponse, into: RustBuffer): void;
@@ -14176,6 +14734,13 @@ declare const _default: Readonly<{
             lower(value: PaymentMethod): UniffiByteArray;
         };
         FfiConverterTypePaymentObserver: FfiConverterObjectWithCallbacks<PaymentObserver>;
+        FfiConverterTypePaymentObserverError: {
+            read(from: RustBuffer): PaymentObserverError;
+            write(value: PaymentObserverError, into: RustBuffer): void;
+            allocationSize(value: PaymentObserverError): number;
+            lift(value: UniffiByteArray): PaymentObserverError;
+            lower(value: PaymentObserverError): UniffiByteArray;
+        };
         FfiConverterTypePaymentRequestSource: {
             read(from: RustBuffer): PaymentRequestSource;
             write(value: PaymentRequestSource, into: RustBuffer): void;
@@ -14346,6 +14911,13 @@ declare const _default: Readonly<{
             lower(value: SchnorrSignatureBytes): UniffiByteArray;
         };
         FfiConverterTypeSdkBuilder: FfiConverterObject<SdkBuilderInterface>;
+        FfiConverterTypeSdkError: {
+            read(from: RustBuffer): SdkError;
+            write(value: SdkError, into: RustBuffer): void;
+            allocationSize(value: SdkError): number;
+            lift(value: UniffiByteArray): SdkError;
+            lower(value: SdkError): UniffiByteArray;
+        };
         FfiConverterTypeSdkEvent: {
             read(from: RustBuffer): SdkEvent;
             write(value: SdkEvent, into: RustBuffer): void;
@@ -14409,6 +14981,13 @@ declare const _default: Readonly<{
             lift(value: UniffiByteArray): SendPaymentResponse;
             lower(value: SendPaymentResponse): UniffiByteArray;
         };
+        FfiConverterTypeServiceConnectivityError: {
+            read(from: RustBuffer): ServiceConnectivityError;
+            write(value: ServiceConnectivityError, into: RustBuffer): void;
+            allocationSize(value: ServiceConnectivityError): number;
+            lift(value: UniffiByteArray): ServiceConnectivityError;
+            lower(value: ServiceConnectivityError): UniffiByteArray;
+        };
         FfiConverterTypeServiceStatus: {
             read(from: RustBuffer): ServiceStatus;
             write(value: ServiceStatus, into: RustBuffer): void;
@@ -14437,6 +15016,13 @@ declare const _default: Readonly<{
             lift(value: UniffiByteArray): SignMessageResponse;
             lower(value: SignMessageResponse): UniffiByteArray;
         };
+        FfiConverterTypeSignerError: {
+            read(from: RustBuffer): SignerError;
+            write(value: SignerError, into: RustBuffer): void;
+            allocationSize(value: SignerError): number;
+            lift(value: UniffiByteArray): SignerError;
+            lower(value: SignerError): UniffiByteArray;
+        };
         FfiConverterTypeSilentPaymentAddressDetails: {
             read(from: RustBuffer): SilentPaymentAddressDetails;
             write(value: SilentPaymentAddressDetails, into: RustBuffer): void;
@@ -14501,6 +15087,27 @@ declare const _default: Readonly<{
             lower(value: StableBalanceConfig): UniffiByteArray;
         };
         FfiConverterTypeStorage: FfiConverterObjectWithCallbacks<Storage>;
+        FfiConverterTypeStorageError: {
+            read(from: RustBuffer): StorageError;
+            write(value: StorageError, into: RustBuffer): void;
+            allocationSize(value: StorageError): number;
+            lift(value: UniffiByteArray): StorageError;
+            lower(value: StorageError): UniffiByteArray;
+        };
+        FfiConverterTypeStorageListPaymentsRequest: {
+            read(from: RustBuffer): StorageListPaymentsRequest;
+            write(value: StorageListPaymentsRequest, into: RustBuffer): void;
+            allocationSize(value: StorageListPaymentsRequest): number;
+            lift(value: UniffiByteArray): StorageListPaymentsRequest;
+            lower(value: StorageListPaymentsRequest): UniffiByteArray;
+        };
+        FfiConverterTypeStoragePaymentDetailsFilter: {
+            read(from: RustBuffer): StoragePaymentDetailsFilter;
+            write(value: StoragePaymentDetailsFilter, into: RustBuffer): void;
+            allocationSize(value: StoragePaymentDetailsFilter): number;
+            lift(value: UniffiByteArray): StoragePaymentDetailsFilter;
+            lower(value: StoragePaymentDetailsFilter): UniffiByteArray;
+        };
         FfiConverterTypeSuccessAction: {
             read(from: RustBuffer): SuccessAction;
             write(value: SuccessAction, into: RustBuffer): void;
@@ -14586,6 +15193,13 @@ declare const _default: Readonly<{
             lift(value: UniffiByteArray): UnversionedRecordChange;
             lower(value: UnversionedRecordChange): UniffiByteArray;
         };
+        FfiConverterTypeUpdateContactRequest: {
+            read(from: RustBuffer): UpdateContactRequest;
+            write(value: UpdateContactRequest, into: RustBuffer): void;
+            allocationSize(value: UpdateContactRequest): number;
+            lift(value: UniffiByteArray): UpdateContactRequest;
+            lower(value: UpdateContactRequest): UniffiByteArray;
+        };
         FfiConverterTypeUpdateDepositPayload: {
             read(from: RustBuffer): UpdateDepositPayload;
             write(value: UpdateDepositPayload, into: RustBuffer): void;