@unicitylabs/sphere-sdk 0.8.0-dev.2 → 0.8.0-dev.4

package/dist/index.d.cts

@@ -7664,6 +7664,10 @@ interface SphereImportOptions {
     derivationMode?: DerivationMode;
     /** Optional nametag to register for this wallet (e.g., 'alice' for @alice). Token is auto-minted. */
     nametag?: string;
+    /** Network this wallet runs on — drives TokenRegistry config. Without it, import
+     *  falls back to NETWORKS.testnet and a non-testnet wallet loads the wrong registry
+     *  (symbols resolve via baked values but icons/metadata don't) until a reload. */
+    network?: NetworkType;
     /** Storage provider instance */
     storage: StorageProvider;
     /** Optional token storage provider */
@@ -10024,6 +10028,14 @@ declare class TokenRegistry {
      * After initial data is available, start periodic auto-refresh if configured.
      */
     private performInitialLoad;
+    /**
+     * Per-network cache keys. The registry cache MUST be namespaced by remoteUrl:
+     * testnet and testnet2 ship DIFFERENT coinIds for the same symbol, so a single
+     * global key let a stale testnet snapshot be served for a testnet2 request —
+     * wrong/missing icons AND self-mint resolving the wrong-network coinId. Keying
+     * by remoteUrl isolates the snapshots so a network can never read another's.
+     */
+    private cacheKeys;
     /**
      * Load definitions from StorageProvider cache.
      * Only applies if cache exists and is fresh (within refreshIntervalMs).

package/dist/index.d.ts

@@ -7664,6 +7664,10 @@ interface SphereImportOptions {
     derivationMode?: DerivationMode;
     /** Optional nametag to register for this wallet (e.g., 'alice' for @alice). Token is auto-minted. */
     nametag?: string;
+    /** Network this wallet runs on — drives TokenRegistry config. Without it, import
+     *  falls back to NETWORKS.testnet and a non-testnet wallet loads the wrong registry
+     *  (symbols resolve via baked values but icons/metadata don't) until a reload. */
+    network?: NetworkType;
     /** Storage provider instance */
     storage: StorageProvider;
     /** Optional token storage provider */
@@ -10024,6 +10028,14 @@ declare class TokenRegistry {
      * After initial data is available, start periodic auto-refresh if configured.
      */
     private performInitialLoad;
+    /**
+     * Per-network cache keys. The registry cache MUST be namespaced by remoteUrl:
+     * testnet and testnet2 ship DIFFERENT coinIds for the same symbol, so a single
+     * global key let a stale testnet snapshot be served for a testnet2 request —
+     * wrong/missing icons AND self-mint resolving the wrong-network coinId. Keying
+     * by remoteUrl isolates the snapshots so a network can never read another's.
+     */
+    private cacheKeys;
     /**
      * Load definitions from StorageProvider cache.
      * Only applies if cache exists and is fresh (within refreshIntervalMs).

package/dist/index.js

@@ -7380,6 +7380,19 @@ var TokenRegistry = class _TokenRegistry {
   // ===========================================================================
   // Cache (StorageProvider)
   // ===========================================================================
+  /**
+   * Per-network cache keys. The registry cache MUST be namespaced by remoteUrl:
+   * testnet and testnet2 ship DIFFERENT coinIds for the same symbol, so a single
+   * global key let a stale testnet snapshot be served for a testnet2 request —
+   * wrong/missing icons AND self-mint resolving the wrong-network coinId. Keying
+   * by remoteUrl isolates the snapshots so a network can never read another's.
+   */
+  cacheKeys() {
+    const base = STORAGE_KEYS_GLOBAL.TOKEN_REGISTRY_CACHE;
+    const baseTs = STORAGE_KEYS_GLOBAL.TOKEN_REGISTRY_CACHE_TS;
+    if (!this.remoteUrl) return { data: base, ts: baseTs };
+    return { data: `${base}:${this.remoteUrl}`, ts: `${baseTs}:${this.remoteUrl}` };
+  }
   /**
    * Load definitions from StorageProvider cache.
    * Only applies if cache exists and is fresh (within refreshIntervalMs).
@@ -7387,9 +7400,10 @@ var TokenRegistry = class _TokenRegistry {
   async loadFromCache() {
     if (!this.storage) return false;
     try {
+      const { data: dataKey, ts: tsKey } = this.cacheKeys();
       const [cached, cachedTs] = await Promise.all([
-        this.storage.get(STORAGE_KEYS_GLOBAL.TOKEN_REGISTRY_CACHE),
-        this.storage.get(STORAGE_KEYS_GLOBAL.TOKEN_REGISTRY_CACHE_TS)
+        this.storage.get(dataKey),
+        this.storage.get(tsKey)
       ]);
       if (!cached || !cachedTs) return false;
       const ts = parseInt(cachedTs, 10);
@@ -7412,9 +7426,10 @@ var TokenRegistry = class _TokenRegistry {
   async saveToCache(definitions) {
     if (!this.storage) return;
     try {
+      const { data: dataKey, ts: tsKey } = this.cacheKeys();
       await Promise.all([
-        this.storage.set(STORAGE_KEYS_GLOBAL.TOKEN_REGISTRY_CACHE, JSON.stringify(definitions)),
-        this.storage.set(STORAGE_KEYS_GLOBAL.TOKEN_REGISTRY_CACHE_TS, String(Date.now()))
+        this.storage.set(dataKey, JSON.stringify(definitions)),
+        this.storage.set(tsKey, String(Date.now()))
       ]);
     } catch {
     }
@@ -9657,7 +9672,8 @@ var PaymentsModule = class _PaymentsModule {
     try {
       const peerInfo = await this.deps.transport.resolve?.(request.recipient) ?? null;
       const recipientPubkey = this.resolveTransportPubkey(request.recipient, peerInfo);
-      const recipientAddress = await this.resolveRecipientAddress(request.recipient, request.addressMode, peerInfo);
+      const willUseEngine = !!(this.deps?.tokenEngine && peerInfo?.chainPubkey);
+      const recipientAddress = willUseEngine ? null : await this.resolveRecipientAddress(request.recipient, request.addressMode, peerInfo);
       const signingService = await this.createSigningService();
       const stClient = this.deps.oracle.getStateTransitionClient?.();
       if (!stClient) {
@@ -9781,6 +9797,7 @@ var PaymentsModule = class _PaymentsModule {
             splitPlan.remainderAmount,
             splitPlan.coinId,
             recipientAddress,
+            // v1 path only — non-null (would have thrown in resolve otherwise)
             onChainMessage
           );
           committedOnChainTokenIds.add(splitPlan.tokenToSplit.uiToken.id);
@@ -9861,6 +9878,7 @@ var PaymentsModule = class _PaymentsModule {
             splitPlan.remainderAmount,
             splitPlan.coinId,
             recipientAddress,
+            // v1 path only — non-null (would have thrown in resolve otherwise)
             {
               memo: request.memo,
               message: onChainMessage,
@@ -12857,7 +12875,7 @@ var PaymentsModule = class _PaymentsModule {
     const nametag = recipient.startsWith("@") ? recipient.slice(1) : info.nametag || recipient;
     if (!info.directAddress) {
       throw new SphereError(
-        `"${nametag}" has no DirectAddress \u2014 the recipient must publish a key-based identity binding.`,
+        `"${nametag}" has no published identity \u2014 the recipient must register a Unicity ID (publish a key-based identity binding) before they can receive payments.`,
         "INVALID_RECIPIENT"
       );
     }
@@ -28239,6 +28257,8 @@ var Sphere = class _Sphere {
     const walletExists = await _Sphere.exists(options.storage);
     if (walletExists) {
       const sphere2 = await _Sphere.load({
+        network: options.network,
+        // forward network so load's configureTokenRegistry uses it (not the testnet default)
         storage: options.storage,
         transport: options.transport,
         oracle: options.oracle,
@@ -28273,6 +28293,8 @@ var Sphere = class _Sphere {
     }
     const sphere = await _Sphere.create({
       mnemonic,
+      network: options.network,
+      // forward network so create's configureTokenRegistry uses it (not the testnet default)
       storage: options.storage,
       transport: options.transport,
       oracle: options.oracle,
@@ -28360,6 +28382,12 @@ var Sphere = class _Sphere {
    * This method ensures the main bundle's TokenRegistry is properly configured.
    */
   static configureTokenRegistry(storage, network) {
+    if (!network) {
+      logger.warn(
+        "Sphere",
+        "configureTokenRegistry: no network provided \u2014 defaulting to testnet. Pass options.network to avoid loading the wrong-network registry."
+      );
+    }
     const netConfig = network ? NETWORKS[network] : NETWORKS.testnet;
     TokenRegistry.configure({ remoteUrl: netConfig.tokenRegistryUrl, storage });
   }
@@ -28511,7 +28539,8 @@ var Sphere = class _Sphere {
       await options.storage.connect();
       logger.debug("Sphere", "Storage reconnected");
     }
-    const groupChatConfig = _Sphere.resolveGroupChatConfig(options.groupChat);
+    _Sphere.configureTokenRegistry(options.storage, options.network);
+    const groupChatConfig = _Sphere.resolveGroupChatConfig(options.groupChat, options.network);
     const marketConfig = _Sphere.resolveMarketConfig(options.market);
     const accountingConfig = _Sphere.resolveAccountingConfig(options.accounting);
     const swapConfig = _Sphere.resolveSwapConfig(options.swap);