@unicitylabs/sphere-sdk 0.1.7 → 0.1.9

package/dist/core/index.d.cts

@@ -324,6 +324,15 @@ interface TokenBalance {
     readonly tokenCount: number;
     readonly decimals: number;
 }
+interface Asset {
+    readonly coinId: string;
+    readonly symbol: string;
+    readonly name: string;
+    readonly decimals: number;
+    readonly iconUrl?: string;
+    readonly totalAmount: string;
+    readonly tokenCount: number;
+}
 type TransferStatus = 'pending' | 'submitted' | 'confirmed' | 'delivered' | 'completed' | 'failed';
 interface TransferRequest {
     readonly coinId: string;
@@ -1468,6 +1477,11 @@ declare class PaymentsModule {
      * Get balance for coin type
      */
     getBalance(coinId?: string): TokenBalance[];
+    /**
+     * Get aggregated assets (tokens grouped by coinId)
+     * Only includes confirmed tokens
+     */
+    getAssets(coinId?: string): Asset[];
     /**
      * Get all tokens
      */
@@ -1924,6 +1938,8 @@ declare class Sphere {
     private _currentAddressIndex;
     /** Map of addressId -> (nametagIndex -> nametag). Supports multiple nametags per address (e.g., from Nostr recovery) */
     private _addressNametags;
+    /** Cached PROXY address (computed once when nametag is set) */
+    private _cachedProxyAddress;
     private _storage;
     private _tokenStorageProviders;
     private _transport;
@@ -1975,10 +1991,28 @@ declare class Sphere {
      */
     static import(options: SphereImportOptions): Promise<Sphere>;
     /**
-     * Clear wallet data from storage
-     * Note: Token data is cleared via TokenStorageProvider, not here
+     * Clear all SDK-owned wallet data from storage.
+     *
+     * Removes wallet keys, per-address data, and optionally token storage.
+     * Does NOT affect application-level data stored outside the SDK.
+     *
+     * @param storageOrOptions - StorageProvider (backward compatible) or options object
+     *
+     * @example
+     * // New usage (recommended) - clears wallet keys AND token data
+     * await Sphere.clear({
+     *   storage: providers.storage,
+     *   tokenStorage: providers.tokenStorage,
+     * });
+     *
+     * @example
+     * // Legacy usage - clears only wallet keys
+     * await Sphere.clear(storage);
      */
-    static clear(storage: StorageProvider): Promise<void>;
+    static clear(storageOrOptions: StorageProvider | {
+        storage: StorageProvider;
+        tokenStorage?: TokenStorageProvider<TxfStorageDataBase>;
+    }): Promise<void>;
     /**
      * Get current instance
      */
@@ -2322,6 +2356,8 @@ declare class Sphere {
      * @returns PROXY address string or undefined if no nametag
      */
     getProxyAddress(): string | undefined;
+    /** Compute and cache the PROXY address from the current nametag */
+    private _updateCachedProxyAddress;
     /**
      * Register a nametag for the current active address
      * Each address can have its own independent nametag

package/dist/core/index.d.ts

@@ -324,6 +324,15 @@ interface TokenBalance {
     readonly tokenCount: number;
     readonly decimals: number;
 }
+interface Asset {
+    readonly coinId: string;
+    readonly symbol: string;
+    readonly name: string;
+    readonly decimals: number;
+    readonly iconUrl?: string;
+    readonly totalAmount: string;
+    readonly tokenCount: number;
+}
 type TransferStatus = 'pending' | 'submitted' | 'confirmed' | 'delivered' | 'completed' | 'failed';
 interface TransferRequest {
     readonly coinId: string;
@@ -1468,6 +1477,11 @@ declare class PaymentsModule {
      * Get balance for coin type
      */
     getBalance(coinId?: string): TokenBalance[];
+    /**
+     * Get aggregated assets (tokens grouped by coinId)
+     * Only includes confirmed tokens
+     */
+    getAssets(coinId?: string): Asset[];
     /**
      * Get all tokens
      */
@@ -1924,6 +1938,8 @@ declare class Sphere {
     private _currentAddressIndex;
     /** Map of addressId -> (nametagIndex -> nametag). Supports multiple nametags per address (e.g., from Nostr recovery) */
     private _addressNametags;
+    /** Cached PROXY address (computed once when nametag is set) */
+    private _cachedProxyAddress;
     private _storage;
     private _tokenStorageProviders;
     private _transport;
@@ -1975,10 +1991,28 @@ declare class Sphere {
      */
     static import(options: SphereImportOptions): Promise<Sphere>;
     /**
-     * Clear wallet data from storage
-     * Note: Token data is cleared via TokenStorageProvider, not here
+     * Clear all SDK-owned wallet data from storage.
+     *
+     * Removes wallet keys, per-address data, and optionally token storage.
+     * Does NOT affect application-level data stored outside the SDK.
+     *
+     * @param storageOrOptions - StorageProvider (backward compatible) or options object
+     *
+     * @example
+     * // New usage (recommended) - clears wallet keys AND token data
+     * await Sphere.clear({
+     *   storage: providers.storage,
+     *   tokenStorage: providers.tokenStorage,
+     * });
+     *
+     * @example
+     * // Legacy usage - clears only wallet keys
+     * await Sphere.clear(storage);
      */
-    static clear(storage: StorageProvider): Promise<void>;
+    static clear(storageOrOptions: StorageProvider | {
+        storage: StorageProvider;
+        tokenStorage?: TokenStorageProvider<TxfStorageDataBase>;
+    }): Promise<void>;
     /**
      * Get current instance
      */
@@ -2322,6 +2356,8 @@ declare class Sphere {
      * @returns PROXY address string or undefined if no nametag
      */
     getProxyAddress(): string | undefined;
+    /** Compute and cache the PROXY address from the current nametag */
+    private _updateCachedProxyAddress;
     /**
      * Register a nametag for the current active address
      * Each address can have its own independent nametag

package/dist/core/index.js

@@ -3718,6 +3718,34 @@ var PaymentsModule = class {
     }
     return Array.from(balances.values());
   }
+  /**
+   * Get aggregated assets (tokens grouped by coinId)
+   * Only includes confirmed tokens
+   */
+  getAssets(coinId) {
+    const assets = /* @__PURE__ */ new Map();
+    for (const token of this.tokens.values()) {
+      if (token.status !== "confirmed") continue;
+      if (coinId && token.coinId !== coinId) continue;
+      const key = token.coinId;
+      const existing = assets.get(key);
+      if (existing) {
+        existing.totalAmount = (BigInt(existing.totalAmount) + BigInt(token.amount)).toString();
+        existing.tokenCount++;
+      } else {
+        assets.set(key, {
+          coinId: token.coinId,
+          symbol: token.symbol,
+          name: token.name,
+          decimals: token.decimals,
+          iconUrl: token.iconUrl,
+          totalAmount: token.amount,
+          tokenCount: 1
+        });
+      }
+    }
+    return Array.from(assets.values());
+  }
   /**
    * Get all tokens
    */
@@ -5819,7 +5847,6 @@ import { SigningService as SigningService2 } from "@unicitylabs/state-transition
 import { TokenType as TokenType2 } from "@unicitylabs/state-transition-sdk/lib/token/TokenType";
 import { HashAlgorithm as HashAlgorithm4 } from "@unicitylabs/state-transition-sdk/lib/hash/HashAlgorithm";
 import { UnmaskedPredicateReference as UnmaskedPredicateReference2 } from "@unicitylabs/state-transition-sdk/lib/predicate/embedded/UnmaskedPredicateReference";
-import { hashNametag } from "@unicitylabs/nostr-js-sdk";
 var UNICITY_TOKEN_TYPE_HEX2 = "f8aa13834268d29355ff12183066f0cb902003629bbc5eb9ef0efbe397867509";
 async function deriveL3PredicateAddress(privateKey) {
   const secret = Buffer.from(privateKey, "hex");
@@ -5848,6 +5875,8 @@ var Sphere = class _Sphere {
   _currentAddressIndex = 0;
   /** Map of addressId -> (nametagIndex -> nametag). Supports multiple nametags per address (e.g., from Nostr recovery) */
   _addressNametags = /* @__PURE__ */ new Map();
+  /** Cached PROXY address (computed once when nametag is set) */
+  _cachedProxyAddress = void 0;
   // Providers
   _storage;
   _tokenStorageProviders = /* @__PURE__ */ new Map();
@@ -6012,7 +6041,7 @@ var Sphere = class _Sphere {
     if (!options.mnemonic && !options.masterKey) {
       throw new Error("Either mnemonic or masterKey is required");
     }
-    await _Sphere.clear(options.storage);
+    await _Sphere.clear({ storage: options.storage, tokenStorage: options.tokenStorage });
     const sphere = new _Sphere(
       options.storage,
       options.transport,
@@ -6054,10 +6083,27 @@ var Sphere = class _Sphere {
     return sphere;
   }
   /**
-   * Clear wallet data from storage
-   * Note: Token data is cleared via TokenStorageProvider, not here
+   * Clear all SDK-owned wallet data from storage.
+   *
+   * Removes wallet keys, per-address data, and optionally token storage.
+   * Does NOT affect application-level data stored outside the SDK.
+   *
+   * @param storageOrOptions - StorageProvider (backward compatible) or options object
+   *
+   * @example
+   * // New usage (recommended) - clears wallet keys AND token data
+   * await Sphere.clear({
+   *   storage: providers.storage,
+   *   tokenStorage: providers.tokenStorage,
+   * });
+   *
+   * @example
+   * // Legacy usage - clears only wallet keys
+   * await Sphere.clear(storage);
    */
-  static async clear(storage) {
+  static async clear(storageOrOptions) {
+    const storage = "get" in storageOrOptions ? storageOrOptions : storageOrOptions.storage;
+    const tokenStorage = "get" in storageOrOptions ? void 0 : storageOrOptions.tokenStorage;
     await storage.remove(STORAGE_KEYS_GLOBAL.MNEMONIC);
     await storage.remove(STORAGE_KEYS_GLOBAL.MASTER_KEY);
     await storage.remove(STORAGE_KEYS_GLOBAL.CHAIN_CODE);
@@ -6069,6 +6115,9 @@ var Sphere = class _Sphere {
     await storage.remove(STORAGE_KEYS_GLOBAL.ADDRESS_NAMETAGS);
     await storage.remove(STORAGE_KEYS_ADDRESS.PENDING_TRANSFERS);
     await storage.remove(STORAGE_KEYS_ADDRESS.OUTBOX);
+    if (tokenStorage?.clear) {
+      await tokenStorage.clear();
+    }
     if (_Sphere.instance) {
       await _Sphere.instance.destroy();
     }
@@ -6752,6 +6801,7 @@ var Sphere = class _Sphere {
       nametag
     };
     this._currentAddressIndex = index;
+    await this._updateCachedProxyAddress();
     await this._storage.set(STORAGE_KEYS_GLOBAL.CURRENT_ADDRESS_INDEX, index.toString());
     this._storage.setIdentity(this._identity);
     this._transport.setIdentity(this._identity);
@@ -6949,9 +6999,18 @@ var Sphere = class _Sphere {
    * @returns PROXY address string or undefined if no nametag
    */
   getProxyAddress() {
+    return this._cachedProxyAddress;
+  }
+  /** Compute and cache the PROXY address from the current nametag */
+  async _updateCachedProxyAddress() {
     const nametag = this._identity?.nametag;
-    if (!nametag) return void 0;
-    return `PROXY:${hashNametag(nametag)}`;
+    if (!nametag) {
+      this._cachedProxyAddress = void 0;
+      return;
+    }
+    const { ProxyAddress } = await import("@unicitylabs/state-transition-sdk/lib/address/ProxyAddress");
+    const proxyAddr = await ProxyAddress.fromNameTag(nametag);
+    this._cachedProxyAddress = proxyAddr.toString();
   }
   /**
    * Register a nametag for the current active address
@@ -6991,6 +7050,7 @@ var Sphere = class _Sphere {
       }
     }
     this._identity.nametag = cleanNametag;
+    await this._updateCachedProxyAddress();
     const addressId = this.getCurrentAddressId();
     if (addressId) {
       let nametagsMap = this._addressNametags.get(addressId);
@@ -7131,6 +7191,7 @@ var Sphere = class _Sphere {
       if (recoveredNametag) {
         if (this._identity) {
           this._identity.nametag = recoveredNametag;
+          await this._updateCachedProxyAddress();
         }
         const addressId = this.getCurrentAddressId();
         if (addressId) {
@@ -7298,6 +7359,7 @@ var Sphere = class _Sphere {
         this._identity.nametag = nametag;
       }
     }
+    await this._updateCachedProxyAddress();
   }
   async initializeIdentityFromMnemonic(mnemonic, derivationPath) {
     const basePath = derivationPath ?? DEFAULT_BASE_PATH;