@unicitylabs/sphere-sdk 0.15.0-dev.1 → 0.16.0-dev.1

package/dist/connect/index.d.cts

@@ -15,6 +15,10 @@ interface NetworkInfo {
  * the legacy `testnet` alias is intentionally not surfaced.
  */
 declare const SPHERE_NETWORKS: {
+    readonly mainnet: {
+        readonly id: number;
+        readonly name: "mainnet";
+    };
     readonly testnet2: {
         readonly id: number;
         readonly name: "testnet2";

package/dist/connect/index.d.ts

@@ -15,6 +15,10 @@ interface NetworkInfo {
  * the legacy `testnet` alias is intentionally not surfaced.
  */
 declare const SPHERE_NETWORKS: {
+    readonly mainnet: {
+        readonly id: number;
+        readonly name: "mainnet";
+    };
     readonly testnet2: {
         readonly id: number;
         readonly name: "testnet2";

package/dist/connect/index.js

@@ -181,17 +181,8 @@ var NETWORK_SCOPED_ADDRESS_PREFIXES = [
   "inv_ledger:"
   // AccountingModule INV_LEDGER_PREFIX
 ];
-var DEFAULT_NOSTR_RELAYS = [
-  "wss://relay.unicity.network",
-  "wss://relay.damus.io",
-  "wss://nos.lol",
-  "wss://relay.nostr.band"
-];
-var DEFAULT_AGGREGATOR_URL = "https://aggregator.unicity.network/rpc";
-var DEV_AGGREGATOR_URL = "https://dev-aggregator.dyndns.org/rpc";
 var DEFAULT_BASE_PATH = "m/44'/0'/0'";
 var DEFAULT_DERIVATION_PATH = `${DEFAULT_BASE_PATH}/0/0`;
-var TOKEN_REGISTRY_URL = "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
 var TEST_NOSTR_RELAYS = [
   "wss://nostr-relay.testnet.unicity.network"
 ];
@@ -201,10 +192,19 @@ var DEFAULT_GROUP_RELAYS = [
 var NETWORKS = {
   mainnet: {
     name: "Mainnet",
-    aggregatorUrl: DEFAULT_AGGREGATOR_URL,
-    nostrRelays: DEFAULT_NOSTR_RELAYS,
+    networkId: 1,
+    // v3 state-transition gateway (networkId 1 comes from the trust base). apiKey is env-injected;
+    // unlike testnet2's, a mainnet gateway key is a SECRET — never commit one.
+    aggregatorUrl: "https://gateway.mainnet.unicity.network",
+    // Mainnet has no relay of its own yet — it shares the testnet relay until one is stood up.
+    // Consequence while shared: nametag bindings for both networks live in ONE namespace, and
+    // since bindings carry no network the cross-network recipient guard can only signal (#734).
+    nostrRelays: TEST_NOSTR_RELAYS,
     groupRelays: DEFAULT_GROUP_RELAYS,
-    tokenRegistryUrl: TOKEN_REGISTRY_URL
+    // Published, but currently only the non-fungible base token type — no fungible
+    // coins yet, so those still miss the registry (decimals 0, symbol falls back to
+    // six hex chars). Presentation only: the money path treats coinId as opaque bytes.
+    tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.mainnet.json"
   },
   // v1 cutover: 'testnet' now POINTS AT TESTNET2 (the v2 gateway network). The
   // old goggregator testnet spoke the removed v1 protocol — a v2 engine cannot
@@ -228,19 +228,10 @@ var NETWORKS = {
     // reuse testnet infra (shared relays/ipfs)
     groupRelays: DEFAULT_GROUP_RELAYS,
     tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet2.json"
-  },
-  // NOTE: mainnet/dev still point at v1-era aggregators. The v2 engine cannot
-  // operate against them until their gateways are cut over to the v2 protocol —
-  // wallet operations on these networks fail loudly (AGGREGATOR_ERROR) until then.
-  dev: {
-    name: "Development",
-    aggregatorUrl: DEV_AGGREGATOR_URL,
-    nostrRelays: TEST_NOSTR_RELAYS,
-    groupRelays: DEFAULT_GROUP_RELAYS,
-    tokenRegistryUrl: TOKEN_REGISTRY_URL
   }
 };
 var SPHERE_NETWORKS = {
+  mainnet: { id: NETWORKS.mainnet.networkId, name: "mainnet" },
   testnet2: { id: NETWORKS.testnet2.networkId, name: "testnet2" }
 };
 var HOST_READY_TYPE = "sphere-connect:host-ready";
@@ -406,7 +397,7 @@ function checkCompatibility(input) {
 }
 
 // connect/version.ts
-var SDK_VERSION = "0.15.0-dev.1";
+var SDK_VERSION = "0.16.0-dev.1";
 
 // connect/permissions.ts
 var PERMISSION_SCOPES = {
@@ -491,8 +482,15 @@ var REALTIME_STATUS = {
 function toLegacyRequest(view, status) {
   return { ...view, symbol: view.symbol ?? "", status };
 }
+function paymentsOrNull(sphere) {
+  try {
+    return sphere.payments;
+  } catch {
+    return null;
+  }
+}
 function legacyRequestPayload(sphere, update) {
-  const view = sphere.payments.requests.list().find((request) => request.id === update.id);
+  const view = paymentsOrNull(sphere)?.requests.list().find((request) => request.id === update.id);
   if (!view) {
     return {
       id: update.id,
@@ -571,7 +569,7 @@ var COMPAT_ATTACHERS = /* @__PURE__ */ new Map([
     forward({ providerId: "wallet-api", error: "wallet-api connection degraded" });
   })],
   ["sync:completed", (sphere, forward) => sphere.on("inventory:updated", () => {
-    forward({ source: "payments", count: sphere.payments.tokens().length });
+    forward({ source: "payments", count: paymentsOrNull(sphere)?.tokens().length ?? 0 });
   })],
   ["sync:remote-update", remoteUpdateAttacher]
 ]);