@unicitylabs/sphere-sdk 0.8.0-dev.3 → 0.8.0-dev.5

package/dist/impl/browser/index.cjs

@@ -3878,7 +3878,7 @@ function getEmbeddedTrustBase(network) {
     case "dev":
       return TRUSTBASE_DEV;
     default:
-      return TRUSTBASE_TESTNET;
+      throw new SphereError(`getEmbeddedTrustBase: unknown network "${network}"`, "INVALID_CONFIG");
   }
 }
 var BaseTrustBaseLoader = class {
@@ -3898,9 +3898,24 @@ var BaseTrustBaseLoader = class {
 // impl/browser/oracle/index.ts
 var BrowserTrustBaseLoader = class extends BaseTrustBaseLoader {
   url;
-  constructor(networkOrUrl = "testnet") {
+  /**
+   * @param networkOrUrl - a NetworkType, or a URL to fetch the trust base from
+   * @param fallbackNetwork - network used for the embedded fallback when a URL is
+   *   supplied (and the fetch fails). Required when networkOrUrl is a URL — we must
+   *   never silently fall back to testnet on a different network.
+   */
+  constructor(networkOrUrl, fallbackNetwork) {
+    if (!networkOrUrl) {
+      throw new SphereError("BrowserTrustBaseLoader: network or trustBaseUrl is required.", "INVALID_CONFIG");
+    }
     if (networkOrUrl.startsWith("/") || networkOrUrl.startsWith("http")) {
-      super("testnet");
+      if (!fallbackNetwork) {
+        throw new SphereError(
+          "BrowserTrustBaseLoader: fallbackNetwork is required when a trustBaseUrl is supplied.",
+          "INVALID_CONFIG"
+        );
+      }
+      super(fallbackNetwork);
       this.url = networkOrUrl;
     } else {
       super(networkOrUrl);
@@ -3918,14 +3933,21 @@ var BrowserTrustBaseLoader = class extends BaseTrustBaseLoader {
     return null;
   }
 };
-function createBrowserTrustBaseLoader(networkOrUrl) {
-  return new BrowserTrustBaseLoader(networkOrUrl);
+function createBrowserTrustBaseLoader(networkOrUrl, fallbackNetwork) {
+  return new BrowserTrustBaseLoader(networkOrUrl, fallbackNetwork);
 }
 function createUnicityAggregatorProvider(config) {
   const { trustBaseUrl, network, ...restConfig } = config;
+  if (!trustBaseUrl && !network) {
+    throw new SphereError(
+      "createUnicityAggregatorProvider: network or trustBaseUrl required.",
+      "INVALID_CONFIG"
+    );
+  }
   return new UnicityAggregatorProvider({
     ...restConfig,
-    trustBaseLoader: createBrowserTrustBaseLoader(trustBaseUrl ?? network ?? "testnet")
+    // When a URL is supplied, `network` (if any) is the embedded-fallback network.
+    trustBaseLoader: createBrowserTrustBaseLoader(trustBaseUrl ?? network, network)
   });
 }
 var createUnicityOracleProvider = createUnicityAggregatorProvider;
@@ -6367,6 +6389,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).
@@ -6374,9 +6409,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);
@@ -6399,9 +6435,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 {
     }
@@ -6786,7 +6823,10 @@ function resolveTokenSyncConfig(network, config) {
   return Object.keys(result).length > 0 ? result : void 0;
 }
 function createBrowserProviders(config) {
-  const network = config?.network ?? "mainnet";
+  if (!config?.network) {
+    throw new SphereError("createBrowserProviders: config.network is required.", "INVALID_CONFIG");
+  }
+  const network = config.network;
   if (config?.debug !== void 0) {
     logger.configure({ debug: config.debug });
   }