@unicitylabs/sphere-sdk 0.4.6 → 0.4.8

package/dist/impl/nodejs/index.d.cts

@@ -373,6 +373,14 @@ interface TransportProvider extends BaseProvider {
      * @returns PeerInfo or null if no binding found
      */
     resolveTransportPubkeyInfo?(transportPubkey: string): Promise<PeerInfo | null>;
+    /**
+     * Batch-resolve multiple transport pubkeys to peer info.
+     * Used for HD address discovery: derives transport pubkeys for indices 0..N
+     * and queries binding events in a single batch.
+     * @param transportPubkeys - Array of transport-specific pubkeys to look up
+     * @returns Array of PeerInfo for pubkeys that have binding events (may be shorter than input)
+     */
+    discoverAddresses?(transportPubkeys: string[]): Promise<PeerInfo[]>;
     /**
      * Recover nametag for current identity by decrypting stored encrypted nametag
      * Used after wallet import to recover associated nametag
@@ -861,6 +869,11 @@ declare class NostrTransportProvider implements TransportProvider {
      * Queries binding events authored by the given pubkey.
      */
     resolveTransportPubkeyInfo(transportPubkey: string): Promise<PeerInfo | null>;
+    /**
+     * Batch-resolve multiple transport pubkeys to peer info.
+     * Used for HD address discovery — single relay query with multi-author filter.
+     */
+    discoverAddresses(transportPubkeys: string[]): Promise<PeerInfo[]>;
     /**
      * Recover nametag for the current identity by searching for encrypted nametag events
      * Used after wallet import to recover associated nametag
@@ -1186,7 +1199,7 @@ declare const NETWORKS: {
         readonly aggregatorUrl: "https://aggregator.unicity.network/rpc";
         readonly nostrRelays: readonly ["wss://relay.unicity.network", "wss://relay.damus.io", "wss://nos.lol", "wss://relay.nostr.band"];
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
-        readonly electrumUrl: "wss://fulcrum.alpha.unicity.network:50004";
+        readonly electrumUrl: "wss://fulcrum.unicity.network:50004";
         readonly groupRelays: readonly ["wss://sphere-relay.unicity.network"];
         readonly tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
     };
@@ -1195,7 +1208,7 @@ declare const NETWORKS: {
         readonly aggregatorUrl: "https://goggregator-test.unicity.network";
         readonly nostrRelays: readonly ["wss://nostr-relay.testnet.unicity.network"];
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
-        readonly electrumUrl: "wss://fulcrum.alpha.testnet.unicity.network:50004";
+        readonly electrumUrl: "wss://fulcrum.unicity.network:50004";
         readonly groupRelays: readonly ["wss://sphere-relay.unicity.network"];
         readonly tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
     };
@@ -1204,7 +1217,7 @@ declare const NETWORKS: {
         readonly aggregatorUrl: "https://dev-aggregator.dyndns.org/rpc";
         readonly nostrRelays: readonly ["wss://nostr-relay.testnet.unicity.network"];
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
-        readonly electrumUrl: "wss://fulcrum.alpha.testnet.unicity.network:50004";
+        readonly electrumUrl: "wss://fulcrum.unicity.network:50004";
         readonly groupRelays: readonly ["wss://sphere-relay.unicity.network"];
         readonly tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
     };

package/dist/impl/nodejs/index.d.ts

@@ -373,6 +373,14 @@ interface TransportProvider extends BaseProvider {
      * @returns PeerInfo or null if no binding found
      */
     resolveTransportPubkeyInfo?(transportPubkey: string): Promise<PeerInfo | null>;
+    /**
+     * Batch-resolve multiple transport pubkeys to peer info.
+     * Used for HD address discovery: derives transport pubkeys for indices 0..N
+     * and queries binding events in a single batch.
+     * @param transportPubkeys - Array of transport-specific pubkeys to look up
+     * @returns Array of PeerInfo for pubkeys that have binding events (may be shorter than input)
+     */
+    discoverAddresses?(transportPubkeys: string[]): Promise<PeerInfo[]>;
     /**
      * Recover nametag for current identity by decrypting stored encrypted nametag
      * Used after wallet import to recover associated nametag
@@ -861,6 +869,11 @@ declare class NostrTransportProvider implements TransportProvider {
      * Queries binding events authored by the given pubkey.
      */
     resolveTransportPubkeyInfo(transportPubkey: string): Promise<PeerInfo | null>;
+    /**
+     * Batch-resolve multiple transport pubkeys to peer info.
+     * Used for HD address discovery — single relay query with multi-author filter.
+     */
+    discoverAddresses(transportPubkeys: string[]): Promise<PeerInfo[]>;
     /**
      * Recover nametag for the current identity by searching for encrypted nametag events
      * Used after wallet import to recover associated nametag
@@ -1186,7 +1199,7 @@ declare const NETWORKS: {
         readonly aggregatorUrl: "https://aggregator.unicity.network/rpc";
         readonly nostrRelays: readonly ["wss://relay.unicity.network", "wss://relay.damus.io", "wss://nos.lol", "wss://relay.nostr.band"];
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
-        readonly electrumUrl: "wss://fulcrum.alpha.unicity.network:50004";
+        readonly electrumUrl: "wss://fulcrum.unicity.network:50004";
         readonly groupRelays: readonly ["wss://sphere-relay.unicity.network"];
         readonly tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
     };
@@ -1195,7 +1208,7 @@ declare const NETWORKS: {
         readonly aggregatorUrl: "https://goggregator-test.unicity.network";
         readonly nostrRelays: readonly ["wss://nostr-relay.testnet.unicity.network"];
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
-        readonly electrumUrl: "wss://fulcrum.alpha.testnet.unicity.network:50004";
+        readonly electrumUrl: "wss://fulcrum.unicity.network:50004";
         readonly groupRelays: readonly ["wss://sphere-relay.unicity.network"];
         readonly tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
     };
@@ -1204,7 +1217,7 @@ declare const NETWORKS: {
         readonly aggregatorUrl: "https://dev-aggregator.dyndns.org/rpc";
         readonly nostrRelays: readonly ["wss://nostr-relay.testnet.unicity.network"];
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
-        readonly electrumUrl: "wss://fulcrum.alpha.testnet.unicity.network:50004";
+        readonly electrumUrl: "wss://fulcrum.unicity.network:50004";
         readonly groupRelays: readonly ["wss://sphere-relay.unicity.network"];
         readonly tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
     };

package/dist/impl/nodejs/index.js

@@ -119,8 +119,8 @@ function getIpfsGatewayUrls(isSecure) {
 }
 var DEFAULT_BASE_PATH = "m/44'/0'/0'";
 var DEFAULT_DERIVATION_PATH = `${DEFAULT_BASE_PATH}/0/0`;
-var DEFAULT_ELECTRUM_URL = "wss://fulcrum.alpha.unicity.network:50004";
-var TEST_ELECTRUM_URL = "wss://fulcrum.alpha.testnet.unicity.network:50004";
+var DEFAULT_ELECTRUM_URL = "wss://fulcrum.unicity.network:50004";
+var TEST_ELECTRUM_URL = "wss://fulcrum.unicity.network:50004";
 var TOKEN_REGISTRY_URL = "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
 var TOKEN_REGISTRY_REFRESH_INTERVAL = 36e5;
 var TEST_NOSTR_RELAYS = [
@@ -1820,6 +1820,44 @@ var NostrTransportProvider = class {
       };
     }
   }
+  /**
+   * Batch-resolve multiple transport pubkeys to peer info.
+   * Used for HD address discovery — single relay query with multi-author filter.
+   */
+  async discoverAddresses(transportPubkeys) {
+    this.ensureConnected();
+    if (transportPubkeys.length === 0) return [];
+    const events = await this.queryEvents({
+      kinds: [EVENT_KINDS.NAMETAG_BINDING],
+      authors: transportPubkeys,
+      limit: transportPubkeys.length * 2
+    });
+    if (events.length === 0) return [];
+    const byAuthor = /* @__PURE__ */ new Map();
+    for (const event of events) {
+      const existing = byAuthor.get(event.pubkey);
+      if (!existing || event.created_at > existing.created_at) {
+        byAuthor.set(event.pubkey, event);
+      }
+    }
+    const results = [];
+    for (const [pubkey, event] of byAuthor) {
+      try {
+        const content = JSON.parse(event.content);
+        results.push({
+          nametag: content.nametag || void 0,
+          transportPubkey: pubkey,
+          chainPubkey: content.public_key || "",
+          l1Address: content.l1_address || "",
+          directAddress: content.direct_address || "",
+          proxyAddress: content.proxy_address || void 0,
+          timestamp: event.created_at * 1e3
+        });
+      } catch {
+      }
+    }
+    return results;
+  }
   /**
    * Recover nametag for the current identity by searching for encrypted nametag events
    * Used after wallet import to recover associated nametag