@unicitylabs/sphere-sdk 0.4.5 → 0.4.7

package/dist/index.d.cts

@@ -3345,6 +3345,12 @@ declare class CommunicationsModule {
      * Subscribe to incoming broadcasts
      */
     onBroadcast(handler: (message: BroadcastMessage) => void): () => void;
+    /**
+     * Resolve a peer's nametag by their transport pubkey.
+     * Uses transport.resolveTransportPubkeyInfo() for live lookup from relay binding events.
+     * Returns undefined if transport doesn't support resolution or peer has no nametag.
+     */
+    resolvePeerNametag(peerPubkey: string): Promise<string | undefined>;
     private handleIncomingMessage;
     private handleComposingIndicator;
     private handleIncomingBroadcast;
@@ -3440,6 +3446,12 @@ declare class GroupChatModule {
     onMessage(handler: (message: GroupMessageData) => void): () => void;
     getRelayUrls(): string[];
     getMyPublicKey(): string | null;
+    /**
+     * Returns the latest message timestamp (in Nostr seconds) across the given groups,
+     * or 0 if no messages exist.  Used to set `since` on subscriptions so the relay
+     * only sends events we don't already have.
+     */
+    private getLatestMessageTimestamp;
     private fetchRelayAdmins;
     private doFetchRelayAdmins;
     private fetchGroupMetadataInternal;
@@ -4460,14 +4472,9 @@ declare class Sphere {
      * });
      * ```
      */
-    static importFromJSON(options: {
+    static importFromJSON(options: Omit<SphereImportOptions, 'mnemonic' | 'masterKey' | 'chainCode' | 'derivationPath' | 'basePath' | 'derivationMode'> & {
         jsonContent: string;
         password?: string;
-        storage: StorageProvider;
-        transport: TransportProvider;
-        oracle: OracleProvider;
-        tokenStorage?: TokenStorageProvider<TxfStorageDataBase>;
-        l1?: L1Config;
     }): Promise<{
         success: boolean;
         mnemonic?: string;
@@ -4503,7 +4510,7 @@ declare class Sphere {
      * });
      * ```
      */
-    static importFromLegacyFile(options: {
+    static importFromLegacyFile(options: Omit<SphereImportOptions, 'mnemonic' | 'masterKey' | 'chainCode' | 'derivationPath' | 'basePath' | 'derivationMode'> & {
         /** File content - Uint8Array for .dat, string for .txt */
         fileContent: string | Uint8Array;
         /** File name (used for type detection) */
@@ -4512,18 +4519,6 @@ declare class Sphere {
         password?: string;
         /** Progress callback for long decryption operations */
         onDecryptProgress?: DecryptionProgressCallback;
-        /** Storage provider instance */
-        storage: StorageProvider;
-        /** Transport provider instance */
-        transport: TransportProvider;
-        /** Oracle provider instance */
-        oracle: OracleProvider;
-        /** Optional token storage provider */
-        tokenStorage?: TokenStorageProvider<TxfStorageDataBase>;
-        /** Optional nametag to register */
-        nametag?: string;
-        /** L1 (ALPHA blockchain) configuration */
-        l1?: L1Config;
     }): Promise<{
         success: boolean;
         sphere?: Sphere;

package/dist/index.d.ts

@@ -3345,6 +3345,12 @@ declare class CommunicationsModule {
      * Subscribe to incoming broadcasts
      */
     onBroadcast(handler: (message: BroadcastMessage) => void): () => void;
+    /**
+     * Resolve a peer's nametag by their transport pubkey.
+     * Uses transport.resolveTransportPubkeyInfo() for live lookup from relay binding events.
+     * Returns undefined if transport doesn't support resolution or peer has no nametag.
+     */
+    resolvePeerNametag(peerPubkey: string): Promise<string | undefined>;
     private handleIncomingMessage;
     private handleComposingIndicator;
     private handleIncomingBroadcast;
@@ -3440,6 +3446,12 @@ declare class GroupChatModule {
     onMessage(handler: (message: GroupMessageData) => void): () => void;
     getRelayUrls(): string[];
     getMyPublicKey(): string | null;
+    /**
+     * Returns the latest message timestamp (in Nostr seconds) across the given groups,
+     * or 0 if no messages exist.  Used to set `since` on subscriptions so the relay
+     * only sends events we don't already have.
+     */
+    private getLatestMessageTimestamp;
     private fetchRelayAdmins;
     private doFetchRelayAdmins;
     private fetchGroupMetadataInternal;
@@ -4460,14 +4472,9 @@ declare class Sphere {
      * });
      * ```
      */
-    static importFromJSON(options: {
+    static importFromJSON(options: Omit<SphereImportOptions, 'mnemonic' | 'masterKey' | 'chainCode' | 'derivationPath' | 'basePath' | 'derivationMode'> & {
         jsonContent: string;
         password?: string;
-        storage: StorageProvider;
-        transport: TransportProvider;
-        oracle: OracleProvider;
-        tokenStorage?: TokenStorageProvider<TxfStorageDataBase>;
-        l1?: L1Config;
     }): Promise<{
         success: boolean;
         mnemonic?: string;
@@ -4503,7 +4510,7 @@ declare class Sphere {
      * });
      * ```
      */
-    static importFromLegacyFile(options: {
+    static importFromLegacyFile(options: Omit<SphereImportOptions, 'mnemonic' | 'masterKey' | 'chainCode' | 'derivationPath' | 'basePath' | 'derivationMode'> & {
         /** File content - Uint8Array for .dat, string for .txt */
         fileContent: string | Uint8Array;
         /** File name (used for type detection) */
@@ -4512,18 +4519,6 @@ declare class Sphere {
         password?: string;
         /** Progress callback for long decryption operations */
         onDecryptProgress?: DecryptionProgressCallback;
-        /** Storage provider instance */
-        storage: StorageProvider;
-        /** Transport provider instance */
-        transport: TransportProvider;
-        /** Oracle provider instance */
-        oracle: OracleProvider;
-        /** Optional token storage provider */
-        tokenStorage?: TokenStorageProvider<TxfStorageDataBase>;
-        /** Optional nametag to register */
-        nametag?: string;
-        /** L1 (ALPHA blockchain) configuration */
-        l1?: L1Config;
     }): Promise<{
         success: boolean;
         sphere?: Sphere;

package/dist/index.js

@@ -7954,6 +7954,23 @@ var CommunicationsModule = class {
     return () => this.broadcastHandlers.delete(handler);
   }
   // ===========================================================================
+  // Public API - Peer Resolution
+  // ===========================================================================
+  /**
+   * Resolve a peer's nametag by their transport pubkey.
+   * Uses transport.resolveTransportPubkeyInfo() for live lookup from relay binding events.
+   * Returns undefined if transport doesn't support resolution or peer has no nametag.
+   */
+  async resolvePeerNametag(peerPubkey) {
+    if (!this.deps?.transport.resolveTransportPubkeyInfo) return void 0;
+    try {
+      const info = await this.deps.transport.resolveTransportPubkeyInfo(peerPubkey);
+      return info?.nametag;
+    } catch {
+      return void 0;
+    }
+  }
+  // ===========================================================================
   // Private: Message Handling
   // ===========================================================================
   handleIncomingMessage(msg) {
@@ -8343,10 +8360,12 @@ var GroupChatModule = class {
     if (!this.client) return;
     const groupIds = Array.from(this.groups.keys());
     if (groupIds.length === 0) return;
+    const latestTimestamp = this.getLatestMessageTimestamp(groupIds);
     this.trackSubscription(
       createNip29Filter({
         kinds: [NIP29_KINDS.CHAT_MESSAGE, NIP29_KINDS.THREAD_ROOT, NIP29_KINDS.THREAD_REPLY],
-        "#h": groupIds
+        "#h": groupIds,
+        ...latestTimestamp ? { since: latestTimestamp } : {}
       }),
       { onEvent: (event) => this.handleGroupEvent(event) }
     );
@@ -8367,10 +8386,12 @@ var GroupChatModule = class {
   }
   subscribeToGroup(groupId) {
     if (!this.client) return;
+    const latestTimestamp = this.getLatestMessageTimestamp([groupId]);
     this.trackSubscription(
       createNip29Filter({
         kinds: [NIP29_KINDS.CHAT_MESSAGE, NIP29_KINDS.THREAD_ROOT, NIP29_KINDS.THREAD_REPLY],
-        "#h": [groupId]
+        "#h": [groupId],
+        ...latestTimestamp ? { since: latestTimestamp } : {}
       }),
       { onEvent: (event) => this.handleGroupEvent(event) }
     );
@@ -9062,6 +9083,23 @@ var GroupChatModule = class {
   getMyPublicKey() {
     return this.keyManager?.getPublicKeyHex() || null;
   }
+  /**
+   * Returns the latest message timestamp (in Nostr seconds) across the given groups,
+   * or 0 if no messages exist.  Used to set `since` on subscriptions so the relay
+   * only sends events we don't already have.
+   */
+  getLatestMessageTimestamp(groupIds) {
+    let latest = 0;
+    for (const gid of groupIds) {
+      const msgs = this.messages.get(gid);
+      if (!msgs) continue;
+      for (const m of msgs) {
+        const ts = Math.floor(m.timestamp / 1e3);
+        if (ts > latest) latest = ts;
+      }
+    }
+    return latest;
+  }
   // ===========================================================================
   // Private — Relay Admin
   // ===========================================================================
@@ -13508,55 +13546,44 @@ var Sphere = class _Sphere {
    * ```
    */
   static async importFromJSON(options) {
+    const { jsonContent, password, ...baseOptions } = options;
     try {
-      const data = JSON.parse(options.jsonContent);
+      const data = JSON.parse(jsonContent);
       if (data.version !== "1.0" || data.type !== "sphere-wallet") {
         return { success: false, error: "Invalid wallet format" };
       }
       let mnemonic = data.mnemonic;
       let masterKey = data.wallet.masterPrivateKey;
-      if (data.encrypted && options.password) {
+      if (data.encrypted && password) {
         if (mnemonic) {
-          const decrypted = decryptSimple(mnemonic, options.password);
+          const decrypted = decryptSimple(mnemonic, password);
           if (!decrypted) {
             return { success: false, error: "Failed to decrypt mnemonic - wrong password?" };
           }
           mnemonic = decrypted;
         }
         if (masterKey) {
-          const decrypted = decryptSimple(masterKey, options.password);
+          const decrypted = decryptSimple(masterKey, password);
           if (!decrypted) {
             return { success: false, error: "Failed to decrypt master key - wrong password?" };
           }
           masterKey = decrypted;
         }
-      } else if (data.encrypted && !options.password) {
+      } else if (data.encrypted && !password) {
         return { success: false, error: "Password required for encrypted wallet" };
       }
       const basePath = data.wallet.descriptorPath ? `m/${data.wallet.descriptorPath}` : DEFAULT_BASE_PATH;
       if (mnemonic) {
-        await _Sphere.import({
-          mnemonic,
-          basePath,
-          storage: options.storage,
-          transport: options.transport,
-          oracle: options.oracle,
-          tokenStorage: options.tokenStorage,
-          l1: options.l1
-        });
+        await _Sphere.import({ ...baseOptions, mnemonic, basePath });
         return { success: true, mnemonic };
       }
       if (masterKey) {
         await _Sphere.import({
+          ...baseOptions,
           masterKey,
           chainCode: data.wallet.chainCode,
           basePath,
-          derivationMode: data.derivationMode || (data.wallet.isBIP32 ? "bip32" : "wif_hmac"),
-          storage: options.storage,
-          transport: options.transport,
-          oracle: options.oracle,
-          tokenStorage: options.tokenStorage,
-          l1: options.l1
+          derivationMode: data.derivationMode || (data.wallet.isBIP32 ? "bip32" : "wif_hmac")
         });
         return { success: true };
       }
@@ -13599,7 +13626,7 @@ var Sphere = class _Sphere {
    * ```
    */
   static async importFromLegacyFile(options) {
-    const { fileContent, fileName, password, onDecryptProgress } = options;
+    const { fileContent, fileName, password, onDecryptProgress, ...baseOptions } = options;
     const fileType = _Sphere.detectLegacyFileType(fileName, fileContent);
     if (fileType === "unknown") {
       return { success: false, error: "Unknown file format" };
@@ -13609,15 +13636,7 @@ var Sphere = class _Sphere {
       if (!_Sphere.validateMnemonic(mnemonic)) {
         return { success: false, error: "Invalid mnemonic phrase" };
       }
-      const sphere = await _Sphere.import({
-        mnemonic,
-        storage: options.storage,
-        transport: options.transport,
-        oracle: options.oracle,
-        tokenStorage: options.tokenStorage,
-        nametag: options.nametag,
-        l1: options.l1
-      });
+      const sphere = await _Sphere.import({ ...baseOptions, mnemonic });
       return { success: true, sphere, mnemonic };
     }
     if (fileType === "dat") {
@@ -13637,16 +13656,11 @@ var Sphere = class _Sphere {
       const { masterKey, chainCode, descriptorPath, derivationMode } = parseResult.data;
       const basePath = descriptorPath ? `m/${descriptorPath}` : DEFAULT_BASE_PATH;
       const sphere = await _Sphere.import({
+        ...baseOptions,
         masterKey,
         chainCode,
         basePath,
-        derivationMode: derivationMode || (chainCode ? "bip32" : "wif_hmac"),
-        storage: options.storage,
-        transport: options.transport,
-        oracle: options.oracle,
-        tokenStorage: options.tokenStorage,
-        nametag: options.nametag,
-        l1: options.l1
+        derivationMode: derivationMode || (chainCode ? "bip32" : "wif_hmac")
       });
       return { success: true, sphere };
     }
@@ -13669,16 +13683,11 @@ var Sphere = class _Sphere {
       const { masterKey, chainCode, descriptorPath, derivationMode } = parseResult.data;
       const basePath = descriptorPath ? `m/${descriptorPath}` : DEFAULT_BASE_PATH;
       const sphere = await _Sphere.import({
+        ...baseOptions,
         masterKey,
         chainCode,
         basePath,
-        derivationMode: derivationMode || (chainCode ? "bip32" : "wif_hmac"),
-        storage: options.storage,
-        transport: options.transport,
-        oracle: options.oracle,
-        tokenStorage: options.tokenStorage,
-        nametag: options.nametag,
-        l1: options.l1
+        derivationMode: derivationMode || (chainCode ? "bip32" : "wif_hmac")
       });
       return { success: true, sphere };
     }
@@ -13692,13 +13701,9 @@ var Sphere = class _Sphere {
       }
       if (parsed.type === "sphere-wallet") {
         const result = await _Sphere.importFromJSON({
+          ...baseOptions,
           jsonContent: content,
-          password,
-          storage: options.storage,
-          transport: options.transport,
-          oracle: options.oracle,
-          tokenStorage: options.tokenStorage,
-          l1: options.l1
+          password
         });
         if (result.success) {
           const sphere2 = _Sphere.getInstance();
@@ -13740,29 +13745,15 @@ var Sphere = class _Sphere {
       const isBIP32 = derivationMode === "bip32" || !!chainCode;
       const basePath = descriptorPath ? `m/${descriptorPath}` : isBIP32 ? "m/84'/1'/0'" : DEFAULT_BASE_PATH;
       if (mnemonic) {
-        const sphere2 = await _Sphere.import({
-          mnemonic,
-          basePath,
-          storage: options.storage,
-          transport: options.transport,
-          oracle: options.oracle,
-          tokenStorage: options.tokenStorage,
-          nametag: options.nametag,
-          l1: options.l1
-        });
+        const sphere2 = await _Sphere.import({ ...baseOptions, mnemonic, basePath });
         return { success: true, sphere: sphere2, mnemonic };
       }
       const sphere = await _Sphere.import({
+        ...baseOptions,
         masterKey,
         chainCode,
         basePath,
-        derivationMode: derivationMode || (chainCode ? "bip32" : "wif_hmac"),
-        storage: options.storage,
-        transport: options.transport,
-        oracle: options.oracle,
-        tokenStorage: options.tokenStorage,
-        nametag: options.nametag,
-        l1: options.l1
+        derivationMode: derivationMode || (chainCode ? "bip32" : "wif_hmac")
       });
       return { success: true, sphere };
     }