@unicitylabs/sphere-sdk 0.1.4 → 0.1.6

package/dist/core/index.d.cts

@@ -308,6 +308,8 @@ interface Token {
     readonly coinId: string;
     readonly symbol: string;
     readonly name: string;
+    readonly decimals: number;
+    readonly iconUrl?: string;
     readonly amount: string;
     status: TokenStatus;
     readonly createdAt: number;
@@ -1366,6 +1368,14 @@ declare class PaymentsModule {
      * Get coin name from coinId
      */
     private getCoinName;
+    /**
+     * Get coin decimals from coinId
+     */
+    private getCoinDecimals;
+    /**
+     * Get coin icon URL from coinId
+     */
+    private getCoinIconUrl;
     /**
      * Send a payment request to someone
      * @param recipientPubkeyOrNametag - Recipient's pubkey or @nametag
@@ -1912,6 +1922,7 @@ declare class Sphere {
     private _derivationMode;
     private _basePath;
     private _currentAddressIndex;
+    /** Map of addressId -> (nametagIndex -> nametag). Supports multiple nametags per address (e.g., from Nostr recovery) */
     private _addressNametags;
     private _storage;
     private _tokenStorageProviders;
@@ -1965,6 +1976,7 @@ declare class Sphere {
     static import(options: SphereImportOptions): Promise<Sphere>;
     /**
      * Clear wallet data from storage
+     * Note: Token data is cleared via TokenStorageProvider, not here
      */
     static clear(storage: StorageProvider): Promise<void>;
     /**
@@ -2183,18 +2195,29 @@ declare class Sphere {
      */
     getCurrentAddressIndex(): number;
     /**
-     * Get nametag for a specific address index
+     * Get primary nametag for a specific address
      *
-     * @param index - Address index (default: current address)
-     * @returns Nametag or undefined if not registered
+     * @param addressId - Address identifier (DIRECT://xxx), defaults to current address
+     * @returns Primary nametag (index 0) or undefined if not registered
      */
-    getNametagForAddress(index?: number): string | undefined;
+    getNametagForAddress(addressId?: string): string | undefined;
+    /**
+     * Get all nametags for a specific address
+     *
+     * @param addressId - Address identifier (DIRECT://xxx), defaults to current address
+     * @returns Map of nametagIndex to nametag, or undefined if no nametags
+     */
+    getNametagsForAddress(addressId?: string): Map<number, string> | undefined;
     /**
      * Get all registered address nametags
      *
-     * @returns Map of address index to nametag
+     * @returns Map of addressId to (nametagIndex -> nametag)
+     */
+    getAllAddressNametags(): Map<string, Map<number, string>>;
+    /**
+     * Get current address identifier (DIRECT://xxx format)
      */
-    getAllAddressNametags(): Map<number, string>;
+    private getCurrentAddressId;
     /**
      * Switch to a different address by index
      * This changes the active identity to the derived address at the specified index.
@@ -2320,6 +2343,7 @@ declare class Sphere {
     registerNametag(nametag: string): Promise<void>;
     /**
      * Persist address nametags to storage
+     * Format: { "DIRECT://abc...xyz": { "0": "alice", "1": "alice2" }, ... }
      */
     private persistAddressNametags;
     /**
@@ -2349,6 +2373,8 @@ declare class Sphere {
     isNametagAvailable(nametag: string): Promise<boolean>;
     /**
      * Load address nametags from storage
+     * Supports new format: { "DIRECT://abc...xyz": { "0": "alice" } }
+     * And legacy format: { "0": "alice" } (migrates to new format on save)
      */
     private loadAddressNametags;
     /**

package/dist/core/index.d.ts

@@ -308,6 +308,8 @@ interface Token {
     readonly coinId: string;
     readonly symbol: string;
     readonly name: string;
+    readonly decimals: number;
+    readonly iconUrl?: string;
     readonly amount: string;
     status: TokenStatus;
     readonly createdAt: number;
@@ -1366,6 +1368,14 @@ declare class PaymentsModule {
      * Get coin name from coinId
      */
     private getCoinName;
+    /**
+     * Get coin decimals from coinId
+     */
+    private getCoinDecimals;
+    /**
+     * Get coin icon URL from coinId
+     */
+    private getCoinIconUrl;
     /**
      * Send a payment request to someone
      * @param recipientPubkeyOrNametag - Recipient's pubkey or @nametag
@@ -1912,6 +1922,7 @@ declare class Sphere {
     private _derivationMode;
     private _basePath;
     private _currentAddressIndex;
+    /** Map of addressId -> (nametagIndex -> nametag). Supports multiple nametags per address (e.g., from Nostr recovery) */
     private _addressNametags;
     private _storage;
     private _tokenStorageProviders;
@@ -1965,6 +1976,7 @@ declare class Sphere {
     static import(options: SphereImportOptions): Promise<Sphere>;
     /**
      * Clear wallet data from storage
+     * Note: Token data is cleared via TokenStorageProvider, not here
      */
     static clear(storage: StorageProvider): Promise<void>;
     /**
@@ -2183,18 +2195,29 @@ declare class Sphere {
      */
     getCurrentAddressIndex(): number;
     /**
-     * Get nametag for a specific address index
+     * Get primary nametag for a specific address
      *
-     * @param index - Address index (default: current address)
-     * @returns Nametag or undefined if not registered
+     * @param addressId - Address identifier (DIRECT://xxx), defaults to current address
+     * @returns Primary nametag (index 0) or undefined if not registered
      */
-    getNametagForAddress(index?: number): string | undefined;
+    getNametagForAddress(addressId?: string): string | undefined;
+    /**
+     * Get all nametags for a specific address
+     *
+     * @param addressId - Address identifier (DIRECT://xxx), defaults to current address
+     * @returns Map of nametagIndex to nametag, or undefined if no nametags
+     */
+    getNametagsForAddress(addressId?: string): Map<number, string> | undefined;
     /**
      * Get all registered address nametags
      *
-     * @returns Map of address index to nametag
+     * @returns Map of addressId to (nametagIndex -> nametag)
+     */
+    getAllAddressNametags(): Map<string, Map<number, string>>;
+    /**
+     * Get current address identifier (DIRECT://xxx format)
      */
-    getAllAddressNametags(): Map<number, string>;
+    private getCurrentAddressId;
     /**
      * Switch to a different address by index
      * This changes the active identity to the derived address at the specified index.
@@ -2320,6 +2343,7 @@ declare class Sphere {
     registerNametag(nametag: string): Promise<void>;
     /**
      * Persist address nametags to storage
+     * Format: { "DIRECT://abc...xyz": { "0": "alice", "1": "alice2" }, ... }
      */
     private persistAddressNametags;
     /**
@@ -2349,6 +2373,8 @@ declare class Sphere {
     isNametagAvailable(nametag: string): Promise<boolean>;
     /**
      * Load address nametags from storage
+     * Supports new format: { "DIRECT://abc...xyz": { "0": "alice" } }
+     * And legacy format: { "0": "alice" } (migrates to new format on save)
      */
     private loadAddressNametags;
     /**