solana-messenger-sdk 0.7.0 → 0.7.1

package/README.md

@@ -92,12 +92,25 @@ await messenger.send(recipient, "hello from a custodial wallet");
 
 ### Methods
 
+#### Messaging
 | Method | Description |
 |--------|-------------|
 | `init()` | Generate encryption key, register on-chain. Call once. Returns `{ encryptionAddress, status }` where status is `"registered"`, `"already_registered"`, or `"updated"`. |
-| `send(recipient, message, encryptionPubkey?)` | Send encrypted message. Recipient must be registered. Auto-chunks if needed. Fees auto-deducted. |
-| `read({ since?, limit? })` | Read messages sent to you. `since` is a unix timestamp (seconds). Decrypts automatically. |
-| `listen(callback)` | Real-time WebSocket listener. Returns unsubscribe function. |
+| `send(recipient, message, encryptionPubkey?)` | Send encrypted DM. Recipient must be registered. Auto-chunks if needed. Fees auto-deducted. |
+| `read({ since?, limit? })` | Read DMs sent to you. `since` is a unix timestamp (seconds). Decrypts automatically. |
+| `listen(callback)` | Real-time WebSocket listener for DMs. Returns unsubscribe function. |
+
+#### Groups
+| Method | Description |
+|--------|-------------|
+| `createGroup(members)` | Create a group chat (max 10 members). You're auto-added. Returns `{ groupId, groupPda, signature }`. |
+| `sendGroup(groupPda, message)` | Send E2E encrypted message to a group. Uses symmetric key + per-member key wraps. |
+| `updateGroup(groupPda, members)` | Update group members (creator only). Creator must stay in list. |
+| `closeGroup(groupPda)` | Close group and reclaim rent (creator only). |
+
+#### Registry
+| Method | Description |
+|--------|-------------|
 | `register(encryptionPubkey)` | Register encryption key (called by init). |
 | `updateEncryptionKey(newPubkey)` | Rotate encryption key. |
 | `setMinFee(lamports)` | Set minimum fee to receive messages. Senders pay this to you. |
@@ -106,6 +119,26 @@ await messenger.send(recipient, "hello from a custodial wallet");
 | `getAddress()` | Get your wallet address. |
 | `getEncryptionPublicKey()` | Get your encryption public key (after init). |
 
+### Group Messaging Example
+
+```typescript
+// Create a group
+const { groupPda } = await messenger.createGroup([
+  myAddress, "Member1Address...", "Member2Address...",
+]);
+
+// Send to group — encrypted with symmetric key, wrapped per member
+await messenger.sendGroup(groupPda, "Hello team!");
+
+// Update members (creator only)
+await messenger.updateGroup(groupPda, [myAddress, "Member1Address...", "NewMember..."]);
+
+// Close group (creator only)
+await messenger.closeGroup(groupPda);
+```
+
+Group messages use a **symmetric key wrap** model: the message is encrypted once with a random symmetric key (NaCl secretbox), then the symmetric key is individually wrapped (NaCl box) for each recipient. This keeps the ciphertext size constant regardless of group size.
+
 ### Low-Level Exports
 
 For custom transaction composition:
@@ -116,7 +149,13 @@ import {
   buildRegisterInstruction,
   buildUpdateEncryptionKeyInstruction,
   buildDeregisterInstruction,
+  buildSetMinFeeInstruction,
+  buildCreateGroupInstruction,
+  buildUpdateGroupInstruction,
+  buildSendGroupMessageInstruction,
+  buildCloseGroupInstruction,
   deriveRegistryPda,
+  deriveGroupPda,
   lookupEncryptionKey,
   encrypt,
   decrypt,
@@ -128,11 +167,13 @@ import {
 
 ## How It Works
 
-- **Encryption:** NaCl box (XSalsa20-Poly1305) via Diffie-Hellman shared secret
+- **Encryption (DMs):** NaCl box (XSalsa20-Poly1305) via Diffie-Hellman shared secret
+- **Encryption (Groups):** NaCl secretbox (symmetric) + per-recipient key wraps via NaCl box
 - **Key conversion:** ed25519 → x25519 via ed2curve
 - **Messages:** Emitted as program events — no on-chain storage
 - **Chunking:** Messages > 661 bytes are automatically split and reassembled
 - **Registry:** On-chain PDA at `["messenger", wallet]` maps identity → encryption pubkey
+- **Groups:** On-chain PDA at `["group", group_id]` stores membership (max 10)
 
 ## Cost
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solana-messenger-sdk",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "TypeScript SDK for Solana Messenger — encrypted agent-to-agent messaging",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",