@massalabs/gossip-sdk 0.0.2-dev.20260223065033 → 0.0.2-dev.20260223101931

package/README.md

@@ -33,6 +33,11 @@ await sdk.init();
 // 2. Open session (login)
 await sdk.openSession({
   mnemonic: 'word1 word2 word3 ... word12',
+  // Optional: for existing session
+  // encryptedSession: savedBlob,
+  // encryptionKey,  // optional - derived from mnemonic if not provided
+  // Optional: for persistence
+  // onPersist: async (blob, key) => { await saveToStorage(blob, key); },
 });
 
 // 3. Use the SDK
@@ -308,12 +313,12 @@ await sdk.init({
 
 ## Session Persistence
 
-For restoring sessions across app restarts:
+For restoring sessions across app restarts, pass `encryptionKey` (optional — derived from mnemonic if omitted) and `onPersist` when opening the session:
 
 ```typescript
 await sdk.openSession({
   mnemonic,
-  encryptionKey,
+  encryptionKey, // optional
   onPersist: async (blob, key) => {
     await storage.save({ session: blob });
   },

package/dist/gossip.d.ts

@@ -1,5 +1,4 @@
 import { type SdkConfig, type DeepPartial } from './config/sdk';
-import { SessionStatus, SessionConfig } from './assets/generated/wasm/gossip_wasm';
 import { EncryptionKey } from './wasm/encryption';
 import { type AnnouncementReceptionResult } from './services/announcement';
 import { DiscussionInitializationResult } from './services/discussion';
@@ -8,7 +7,7 @@ import { AuthService } from './services/auth';
 import type { DeleteContactResult, UpdateContactNameResult } from './utils/contacts';
 import { type ValidationResult } from './utils/validation';
 import { type Contact, type Discussion, type Message } from './db';
-import type { UserPublicKeys } from './wasm/bindings';
+import { type UserPublicKeys, type SessionConfig, SessionStatus } from './wasm/bindings';
 import { SdkEventType, type SdkEventHandlers } from './core/SdkEventEmitter';
 import { AnnouncementPayload } from './utils/announcementPayload';
 import { Result } from './utils/type';
@@ -38,12 +37,10 @@ export interface OpenSessionOptions {
     mnemonic: string;
     /** Existing encrypted session blob (for restoring session) */
     encryptedSession?: Uint8Array;
-    /** Encryption key for decrypting session */
+    /** Encryption key for decrypting session and storage. Will be created if not provided. */
     encryptionKey?: EncryptionKey;
     /** Callback when session state changes (for persistence) */
     onPersist?: (encryptedBlob: Uint8Array, encryptionKey: EncryptionKey) => Promise<void>;
-    /** Encryption key for persisting session (required if onPersist is provided) */
-    persistEncryptionKey?: EncryptionKey;
     /** Custom session configuration (optional, uses defaults if not provided) */
     sessionConfig?: SessionConfig;
 }
@@ -93,15 +90,7 @@ declare class GossipSdk {
      * Get encrypted session blob for persistence.
      * Throws if no session is open.
      */
-    getEncryptedSession(encryptionKey: EncryptionKey): Uint8Array;
-    /**
-     * Configure session persistence after session is opened.
-     * Use this when you need to set up persistence after account creation.
-     *
-     * @param encryptionKey - Key to encrypt session blob
-     * @param onPersist - Callback to save encrypted session blob
-     */
-    configurePersistence(encryptionKey: EncryptionKey, onPersist: (encryptedBlob: Uint8Array, encryptionKey: EncryptionKey) => Promise<void>): void;
+    getEncryptedSession(): Uint8Array;
     /** Auth service (available after init, before session) */
     get auth(): AuthService;
     /** Message service */

package/dist/gossip.js

@@ -46,6 +46,7 @@ import { defaultSdkConfig, mergeConfig, } from './config/sdk';
 import { startWasmInitialization, ensureWasmInitialized } from './wasm/loader';
 import { generateUserKeys } from './wasm/userKeys';
 import { SessionModule } from './wasm/session';
+import { generateEncryptionKeyFromSeed, } from './wasm/encryption';
 import { AnnouncementService, } from './services/announcement';
 import { DiscussionService, } from './services/discussion';
 import { MessageService, rowToMessage, } from './services/message';
@@ -56,6 +57,7 @@ import { QueueManager } from './utils/queue';
 import { encodeUserId, decodeUserId } from './utils/userId';
 import { initDb, getMessageById, getMessagesByOwnerAndContact, getMessagesByStatus, updateMessageById, getDiscussionByOwnerAndContact, getDiscussionsByOwner, getContactsByOwner, getContactByOwnerAndUser, MessageStatus, } from './db';
 import { addContact, updateContactName, deleteContact } from './utils/contacts';
+import { SessionManagerWrapper, } from './wasm/bindings';
 import { SdkEventEmitter, SdkEventType, } from './core/SdkEventEmitter';
 import { SdkPolling } from './core/SdkPolling';
 export { SdkEventType };
@@ -198,23 +200,23 @@ class GossipSdk {
         if (this.state.status === SdkStatus.SESSION_OPEN) {
             throw new Error('Session already open. Call closeSession() first.');
         }
-        // Validate session restore options - must have both or neither
-        if (options.encryptedSession && !options.encryptionKey) {
-            throw new Error('encryptionKey is required when encryptedSession is provided.');
-        }
-        if (options.encryptionKey && !options.encryptedSession) {
-            console.warn('[GossipSdk] encryptionKey provided without encryptedSession - key will be ignored');
-        }
-        // Validate persistence options
-        if (options.onPersist && !options.persistEncryptionKey) {
-            throw new Error('persistEncryptionKey is required when onPersist is provided.');
-        }
-        if (options.persistEncryptionKey && !options.onPersist) {
-            console.warn('[GossipSdk] persistEncryptionKey provided without onPersist callback - key will be unused');
-        }
+        // Derive encryption key from mnemonic when not provided
+        const encryptionKey = options.encryptionKey ??
+            (await generateEncryptionKeyFromSeed(options.mnemonic, new Uint8Array(32).fill(0)));
         const { messageProtocol } = this.state;
         // Ensure WASM is ready
         await ensureWasmInitialized();
+        // Validate that encryptedSession can be decrypted with the provided key
+        if (options.encryptedSession) {
+            try {
+                const sessionManager = SessionManagerWrapper.from_encrypted_blob(options.encryptedSession, encryptionKey);
+                // We only create this wrapper for validation, free it immediately
+                sessionManager.free();
+            }
+            catch {
+                throw new Error('[GossipSdk] Failed to load encrypted session. Please provide a valid encryptedSession and encryptionKey.');
+            }
+        }
         // Generate keys from mnemonic
         const userKeys = await generateUserKeys(options.mnemonic);
         // Create session with persistence callback
@@ -223,8 +225,8 @@ class GossipSdk {
             await this.handleSessionPersist();
         }, options.sessionConfig);
         // Restore existing session state if provided
-        if (options.encryptedSession && options.encryptionKey) {
-            session.load(options.encryptedSession, options.encryptionKey);
+        if (options.encryptedSession) {
+            session.load(options.encryptedSession, encryptionKey);
         }
         // Get config from initialized state
         const { config } = this.state;
@@ -249,7 +251,7 @@ class GossipSdk {
             config,
             session,
             userKeys,
-            persistEncryptionKey: options.persistEncryptionKey,
+            encryptionKey,
             onPersist: options.onPersist,
         };
         // Create cached service API wrappers
@@ -369,28 +371,12 @@ class GossipSdk {
      * Get encrypted session blob for persistence.
      * Throws if no session is open.
      */
-    getEncryptedSession(encryptionKey) {
+    getEncryptedSession() {
         const state = this.requireSession();
-        return state.session.toEncryptedBlob(encryptionKey);
-    }
-    /**
-     * Configure session persistence after session is opened.
-     * Use this when you need to set up persistence after account creation.
-     *
-     * @param encryptionKey - Key to encrypt session blob
-     * @param onPersist - Callback to save encrypted session blob
-     */
-    configurePersistence(encryptionKey, onPersist) {
-        if (this.state.status !== SdkStatus.SESSION_OPEN) {
-            throw new Error('No session open. Call openSession() first.');
+        if (!state.encryptionKey) {
+            throw new Error('No encryption key found. Call openSession() first.');
         }
-        // Update state with persistence config
-        this.state = {
-            ...this.state,
-            persistEncryptionKey: encryptionKey,
-            onPersist,
-        };
-        console.log('[GossipSdk] Session persistence configured');
+        return state.session.toEncryptedBlob(state.encryptionKey);
     }
     // ─────────────────────────────────────────────────────────────────
     // Services (accessible only when session is open)
@@ -524,13 +510,13 @@ class GossipSdk {
     async handleSessionPersist() {
         if (this.state.status !== SdkStatus.SESSION_OPEN)
             return;
-        const { onPersist, persistEncryptionKey, session } = this.state;
-        if (!onPersist || !persistEncryptionKey)
+        const { onPersist, encryptionKey, session } = this.state;
+        if (!onPersist || !encryptionKey)
             return;
         try {
-            const blob = session.toEncryptedBlob(persistEncryptionKey);
+            const blob = session.toEncryptedBlob(encryptionKey);
             console.log(`[SessionPersist] Saving session blob (${blob.length} bytes)`);
-            await onPersist(blob, persistEncryptionKey);
+            await onPersist(blob, encryptionKey);
         }
         catch (error) {
             this.eventEmitter.emit(SdkEventType.ERROR, error instanceof Error ? error : new Error(String(error)), 'session_persist');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@massalabs/gossip-sdk",
-  "version": "0.0.2-dev.20260223065033",
+  "version": "0.0.2-dev.20260223101931",
   "description": "Gossip SDK for automation, chatbot, and integration use cases",
   "type": "module",
   "main": "./dist/index.js",