@unicitylabs/sphere-sdk 0.6.3 → 0.6.4

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

@@ -1,3 +1,4 @@
+import { NostrKeyManager, Event } from '@unicitylabs/nostr-js-sdk';
 import { StateTransitionClient } from '@unicitylabs/state-transition-sdk/lib/StateTransitionClient';
 import { AggregatorClient } from '@unicitylabs/state-transition-sdk/lib/api/AggregatorClient';
 import { RootTrustBase } from '@unicitylabs/state-transition-sdk/lib/bft/RootTrustBase';
@@ -656,6 +657,12 @@ declare class NostrTransportProvider implements TransportProvider {
      */
     private stripContentPrefix;
     private ensureConnected;
+    /**
+     * Async version of ensureConnected — reconnects if the original transport
+     * lost its WebSocket while subscriptions are suppressed (mux handles events).
+     * Used by resolve methods which are always async.
+     */
+    private ensureConnectedForResolve;
     private ensureReady;
     private emitEvent;
     /**
@@ -664,6 +671,11 @@ declare class NostrTransportProvider implements TransportProvider {
      * because NIP17.createGiftWrap hardcodes kind 14 for the inner rumor.
      */
     private createCustomKindGiftWrap;
+    /**
+     * Create a NIP-17 gift wrap with a custom rumor kind.
+     * Shared between NostrTransportProvider and MultiAddressTransportMux.
+     */
+    static createCustomKindGiftWrap(keyManager: NostrKeyManager, recipientPubkeyHex: string, content: string, rumorKind: number): Event;
 }
 
 /**

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

@@ -1,3 +1,4 @@
+import { NostrKeyManager, Event } from '@unicitylabs/nostr-js-sdk';
 import { StateTransitionClient } from '@unicitylabs/state-transition-sdk/lib/StateTransitionClient';
 import { AggregatorClient } from '@unicitylabs/state-transition-sdk/lib/api/AggregatorClient';
 import { RootTrustBase } from '@unicitylabs/state-transition-sdk/lib/bft/RootTrustBase';
@@ -656,6 +657,12 @@ declare class NostrTransportProvider implements TransportProvider {
      */
     private stripContentPrefix;
     private ensureConnected;
+    /**
+     * Async version of ensureConnected — reconnects if the original transport
+     * lost its WebSocket while subscriptions are suppressed (mux handles events).
+     * Used by resolve methods which are always async.
+     */
+    private ensureConnectedForResolve;
     private ensureReady;
     private emitEvent;
     /**
@@ -664,6 +671,11 @@ declare class NostrTransportProvider implements TransportProvider {
      * because NIP17.createGiftWrap hardcodes kind 14 for the inner rumor.
      */
     private createCustomKindGiftWrap;
+    /**
+     * Create a NIP-17 gift wrap with a custom rumor kind.
+     * Shared between NostrTransportProvider and MultiAddressTransportMux.
+     */
+    static createCustomKindGiftWrap(keyManager: NostrKeyManager, recipientPubkeyHex: string, content: string, rumorKind: number): Event;
 }
 
 /**

package/dist/impl/nodejs/index.js

@@ -1078,7 +1078,7 @@ function defaultUUIDGenerator() {
 var COMPOSING_INDICATOR_KIND = 25050;
 var TIMESTAMP_RANDOMIZATION = 2 * 24 * 60 * 60;
 var EVENT_KINDS = NOSTR_EVENT_KINDS;
-var NostrTransportProvider = class {
+var NostrTransportProvider = class _NostrTransportProvider {
   id = "nostr";
   name = "Nostr Transport";
   type = "p2p";
@@ -1609,11 +1609,11 @@ var NostrTransportProvider = class {
     return this.resolveNametagInfo(identifier);
   }
   async resolveNametag(nametag) {
-    this.ensureConnected();
+    await this.ensureConnectedForResolve();
     return this.nostrClient.queryPubkeyByNametag(nametag);
   }
   async resolveNametagInfo(nametag) {
-    this.ensureConnected();
+    await this.ensureConnectedForResolve();
     const binding = await this.nostrClient.queryBindingByNametag(nametag);
     if (!binding) {
       logger.debug("Nostr", `resolveNametagInfo: no binding events found for Unicity ID "${nametag}"`);
@@ -1626,7 +1626,7 @@ var NostrTransportProvider = class {
    * Performs reverse lookup via nostr-js-sdk with first-seen-wins anti-hijacking.
    */
   async resolveAddressInfo(address) {
-    this.ensureConnected();
+    await this.ensureConnectedForResolve();
     const binding = await this.nostrClient.queryBindingByAddress(address);
     if (!binding) return null;
     return this.bindingInfoToPeerInfo(binding);
@@ -1661,7 +1661,7 @@ var NostrTransportProvider = class {
    * Queries binding events authored by the given pubkey.
    */
   async resolveTransportPubkeyInfo(transportPubkey) {
-    this.ensureConnected();
+    await this.ensureConnectedForResolve();
     const events = await this.queryEvents({
       kinds: [EVENT_KINDS.NAMETAG_BINDING],
       authors: [transportPubkey],
@@ -1696,7 +1696,7 @@ var NostrTransportProvider = class {
    * Used for HD address discovery — single relay query with multi-author filter.
    */
   async discoverAddresses(transportPubkeys) {
-    this.ensureConnected();
+    await this.ensureConnectedForResolve();
     if (transportPubkeys.length === 0) return [];
     const events = await this.queryEvents({
       kinds: [EVENT_KINDS.NAMETAG_BINDING],
@@ -1735,7 +1735,10 @@ var NostrTransportProvider = class {
    * @returns Decrypted nametag or null if none found
    */
   async recoverNametag() {
-    this.ensureReady();
+    await this.ensureConnectedForResolve();
+    if (!this.identity) {
+      throw new SphereError("Identity not set", "NOT_INITIALIZED");
+    }
     if (!this.identity || !this.keyManager) {
       throw new SphereError("Identity not set", "NOT_INITIALIZED");
     }
@@ -2471,6 +2474,31 @@ var NostrTransportProvider = class {
       throw new SphereError("NostrTransportProvider not connected", "TRANSPORT_ERROR");
     }
   }
+  /**
+   * Async version of ensureConnected — reconnects if the original transport
+   * lost its WebSocket while subscriptions are suppressed (mux handles events).
+   * Used by resolve methods which are always async.
+   */
+  async ensureConnectedForResolve() {
+    if (this.isConnected()) return;
+    if (this._subscriptionsSuppressed && this.nostrClient) {
+      logger.debug("Nostr", "Suppressed transport disconnected \u2014 reconnecting for resolve");
+      try {
+        await Promise.race([
+          this.nostrClient.connect(...this.config.relays),
+          new Promise(
+            (_, reject) => setTimeout(() => reject(new Error("reconnect timeout")), 5e3)
+          )
+        ]);
+        if (this.nostrClient.isConnected()) {
+          this.status = "connected";
+          return;
+        }
+      } catch {
+      }
+    }
+    throw new SphereError("NostrTransportProvider not connected", "TRANSPORT_ERROR");
+  }
   ensureReady() {
     this.ensureConnected();
     if (!this.identity) {
@@ -2492,16 +2520,23 @@ var NostrTransportProvider = class {
    * because NIP17.createGiftWrap hardcodes kind 14 for the inner rumor.
    */
   createCustomKindGiftWrap(recipientPubkeyHex, content, rumorKind) {
-    const senderPubkey = this.keyManager.getPublicKeyHex();
+    return _NostrTransportProvider.createCustomKindGiftWrap(this.keyManager, recipientPubkeyHex, content, rumorKind);
+  }
+  /**
+   * Create a NIP-17 gift wrap with a custom rumor kind.
+   * Shared between NostrTransportProvider and MultiAddressTransportMux.
+   */
+  static createCustomKindGiftWrap(keyManager, recipientPubkeyHex, content, rumorKind) {
+    const senderPubkey = keyManager.getPublicKeyHex();
     const now = Math.floor(Date.now() / 1e3);
     const rumorTags = [["p", recipientPubkeyHex]];
     const rumorSerialized = JSON.stringify([0, senderPubkey, now, rumorKind, rumorTags, content]);
     const rumorId = bytesToHex(sha256(new TextEncoder().encode(rumorSerialized)));
     const rumor = { id: rumorId, pubkey: senderPubkey, created_at: now, kind: rumorKind, tags: rumorTags, content };
     const recipientPubkeyBytes = hexToBytes(recipientPubkeyHex);
-    const encryptedRumor = NIP44.encrypt(JSON.stringify(rumor), this.keyManager.getPrivateKey(), recipientPubkeyBytes);
+    const encryptedRumor = NIP44.encrypt(JSON.stringify(rumor), keyManager.getPrivateKey(), recipientPubkeyBytes);
     const sealTimestamp = now + Math.floor(Math.random() * 2 * TIMESTAMP_RANDOMIZATION) - TIMESTAMP_RANDOMIZATION;
-    const seal = NostrEventClass.create(this.keyManager, {
+    const seal = NostrEventClass.create(keyManager, {
       kind: EventKinds.SEAL,
       tags: [],
       content: encryptedRumor,