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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -6728,13 +6728,14 @@ type DecryptionProgressCallback = (iteration: number, total: number) => Promise<
6728
6728
  *
6729
6729
  * const storage = createLocalStorageProvider();
6730
6730
  * const transport = createNostrTransportProvider();
6731
- * const oracle = createUnicityAggregatorProvider({ url: '/rpc' });
6731
+ * const oracle = createUnicityAggregatorProvider({ url: '/rpc', network: 'testnet2' });
6732
6732
  *
6733
6733
  * // Option 1: Unified init (recommended)
6734
6734
  * const { sphere, created, generatedMnemonic } = await Sphere.init({
6735
6735
  * storage,
6736
6736
  * transport,
6737
6737
  * oracle,
6738
+ * network: 'testnet2', // required: selects registry/trustbase/aggregator
6738
6739
  * mnemonic: 'your twelve words...', // optional - will load if wallet exists
6739
6740
  * autoGenerate: true, // generate new mnemonic if needed
6740
6741
  * });
@@ -6745,9 +6746,9 @@ type DecryptionProgressCallback = (iteration: number, total: number) => Promise<
6745
6746
  *
6746
6747
  * // Option 2: Manual create/load
6747
6748
  * if (await Sphere.exists(storage)) {
6748
- * const sphere = await Sphere.load({ storage, transport, oracle });
6749
+ * const sphere = await Sphere.load({ storage, transport, oracle, network: 'testnet2' });
6749
6750
  * } else {
6750
- * const sphere = await Sphere.create({ mnemonic, storage, transport, oracle });
6751
+ * const sphere = await Sphere.create({ mnemonic, storage, transport, oracle, network: 'testnet2' });
6751
6752
  * }
6752
6753
  *
6753
6754
  * // Use the wallet
@@ -6728,13 +6728,14 @@ type DecryptionProgressCallback = (iteration: number, total: number) => Promise<
6728
6728
  *
6729
6729
  * const storage = createLocalStorageProvider();
6730
6730
  * const transport = createNostrTransportProvider();
6731
- * const oracle = createUnicityAggregatorProvider({ url: '/rpc' });
6731
+ * const oracle = createUnicityAggregatorProvider({ url: '/rpc', network: 'testnet2' });
6732
6732
  *
6733
6733
  * // Option 1: Unified init (recommended)
6734
6734
  * const { sphere, created, generatedMnemonic } = await Sphere.init({
6735
6735
  * storage,
6736
6736
  * transport,
6737
6737
  * oracle,
6738
+ * network: 'testnet2', // required: selects registry/trustbase/aggregator
6738
6739
  * mnemonic: 'your twelve words...', // optional - will load if wallet exists
6739
6740
  * autoGenerate: true, // generate new mnemonic if needed
6740
6741
  * });
@@ -6745,9 +6746,9 @@ type DecryptionProgressCallback = (iteration: number, total: number) => Promise<
6745
6746
  *
6746
6747
  * // Option 2: Manual create/load
6747
6748
  * if (await Sphere.exists(storage)) {
6748
- * const sphere = await Sphere.load({ storage, transport, oracle });
6749
+ * const sphere = await Sphere.load({ storage, transport, oracle, network: 'testnet2' });
6749
6750
  * } else {
6750
- * const sphere = await Sphere.create({ mnemonic, storage, transport, oracle });
6751
+ * const sphere = await Sphere.create({ mnemonic, storage, transport, oracle, network: 'testnet2' });
6751
6752
  * }
6752
6753
  *
6753
6754
  * // Use the wallet
@@ -28071,13 +28071,14 @@ var Sphere = class _Sphere {
28071
28071
  */
28072
28072
  static resolveGroupChatConfig(config, network) {
28073
28073
  if (!config) return void 0;
28074
+ if (!network) {
28075
+ throw new SphereError("network is required to resolve group chat relays.", "INVALID_CONFIG");
28076
+ }
28074
28077
  if (config === true) {
28075
- const netConfig = network ? NETWORKS[network] : NETWORKS.mainnet;
28076
- return { relays: [...netConfig.groupRelays] };
28078
+ return { relays: [...NETWORKS[network].groupRelays] };
28077
28079
  }
28078
28080
  if (!config.relays || config.relays.length === 0) {
28079
- const netConfig = network ? NETWORKS[network] : NETWORKS.mainnet;
28080
- return { ...config, relays: [...netConfig.groupRelays] };
28081
+ return { ...config, relays: [...NETWORKS[network].groupRelays] };
28081
28082
  }
28082
28083
  return config;
28083
28084
  }
@@ -28125,13 +28126,12 @@ var Sphere = class _Sphere {
28125
28126
  */
28126
28127
  static configureTokenRegistry(storage, network) {
28127
28128
  if (!network) {
28128
- logger.warn(
28129
- "Sphere",
28130
- "configureTokenRegistry: no network provided \u2014 defaulting to testnet. Pass options.network to avoid loading the wrong-network registry."
28129
+ throw new SphereError(
28130
+ "network is required to configure the TokenRegistry. Every Sphere entry point must forward options.network.",
28131
+ "INVALID_CONFIG"
28131
28132
  );
28132
28133
  }
28133
- const netConfig = network ? NETWORKS[network] : NETWORKS.testnet;
28134
- TokenRegistry.configure({ remoteUrl: netConfig.tokenRegistryUrl, storage });
28134
+ TokenRegistry.configure({ remoteUrl: NETWORKS[network].tokenRegistryUrl, storage });
28135
28135
  }
28136
28136
  /**
28137
28137
  * Create new wallet with mnemonic