summaryrefslogtreecommitdiffstats
path: root/packages/meshbay-node/src/meshbay_node/chat
diff options
context:
space:
mode:
authorChristophe Besson <cbesson@gmail.com>2026-08-10 03:07:56 +0200
committerChristophe Besson <cbesson@gmail.com>2026-08-10 03:07:56 +0200
commit4b3e8c3b8b9d10c8ac333dd8db614a7569052472 (patch)
tree8828d7d549adc8bb21d8a7f6533c8e9db9c298b9 /packages/meshbay-node/src/meshbay_node/chat
parent8ccbe262ecf4a8f7545cbf1e9f1cc5a485acae67 (diff)
downloadmeshbay-4b3e8c3b8b9d10c8ac333dd8db614a7569052472.tar.gz
feat: Phase 7 — Node v2 (multi-group, Sender Keys, 0-RTT, chat, denylist)
Implements all 8 milestones (7.0-7.7): - 7.0: JWT carries `groups` claim; node verifies group membership at MNP handshake (QUIC + TCP+TLS). Resolves security review C2. - 7.1: QUIC 0-RTT session resumption via stored session tickets (17-21ms reconnect vs 47ms cold). - 7.2: Hub→node WebSocket signaling for NAT punch coordination (`client_incoming`/`punch_ready`) + jti denylist push. Denylist class blocks revoked users/jtis at handshake. - 7.3: Multi-group daemon — one QUIC port serves N groups with per-group GEK, shared_root, and index routing. - 7.4: HLS streaming via QUIC (STREAM_SEGMENT message type, ffmpeg segment extraction). - 7.5: Sender Keys protocol for group chat (Signal Groups approach). Each member has own sending chain key, HKDF chain ratchet, AES-256-GCM encryption, Ed25519 signing. Resolves security review C1. - 7.6: Chat store (SQLite via aiosqlite), CHAT_MESSAGE MNP wire type with peer broadcast, web UI with WebSocket push. - 7.7: Argon2id calibration CLI. First security review included (first-review.md). 109 tests, demo-v3 validated against meshbay.org production hub. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Diffstat (limited to 'packages/meshbay-node/src/meshbay_node/chat')
-rw-r--r--packages/meshbay-node/src/meshbay_node/chat/__init__.py4
-rw-r--r--packages/meshbay-node/src/meshbay_node/chat/store.py119
2 files changed, 123 insertions, 0 deletions
diff --git a/packages/meshbay-node/src/meshbay_node/chat/__init__.py b/packages/meshbay-node/src/meshbay_node/chat/__init__.py
new file mode 100644
index 0000000..f647e19
--- /dev/null
+++ b/packages/meshbay-node/src/meshbay_node/chat/__init__.py
@@ -0,0 +1,4 @@
+"""MeshBay Node — chat module (Sender Keys encrypted group messaging)."""
+from .store import ChatStore
+
+__all__ = ["ChatStore"]
diff --git a/packages/meshbay-node/src/meshbay_node/chat/store.py b/packages/meshbay-node/src/meshbay_node/chat/store.py
new file mode 100644
index 0000000..1dbcc2b
--- /dev/null
+++ b/packages/meshbay-node/src/meshbay_node/chat/store.py
@@ -0,0 +1,119 @@
+"""
+MeshBay Node — SQLite-backed chat message store.
+
+One database per group. Stores encrypted Sender Keys messages for offline
+retrieval and history. Messages are stored as received (ciphertext) —
+decryption happens on the client side.
+"""
+
+import logging
+import time
+from dataclasses import dataclass
+from pathlib import Path
+
+import aiosqlite
+
+log = logging.getLogger(__name__)
+
+_SCHEMA = """
+CREATE TABLE IF NOT EXISTS messages (
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
+ sender_id TEXT NOT NULL,
+ iteration INTEGER NOT NULL,
+ payload BLOB NOT NULL,
+ timestamp REAL NOT NULL,
+ thread_id TEXT DEFAULT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_messages_ts ON messages(timestamp);
+CREATE INDEX IF NOT EXISTS idx_messages_thread ON messages(thread_id);
+"""
+
+
+@dataclass
+class StoredMessage:
+ id: int
+ sender_id: str
+ iteration: int
+ payload: bytes
+ timestamp: float
+ thread_id: str | None
+
+
+class ChatStore:
+ """Async SQLite chat store for one group."""
+
+ def __init__(self, db_path: Path):
+ self._db_path = db_path
+ self._db: aiosqlite.Connection | None = None
+
+ async def open(self) -> None:
+ self._db_path.parent.mkdir(parents=True, exist_ok=True)
+ self._db = await aiosqlite.connect(str(self._db_path))
+ await self._db.executescript(_SCHEMA)
+ await self._db.commit()
+
+ async def close(self) -> None:
+ if self._db:
+ await self._db.close()
+ self._db = None
+
+ async def __aenter__(self):
+ await self.open()
+ return self
+
+ async def __aexit__(self, *_):
+ await self.close()
+
+ async def save_message(
+ self,
+ sender_id: str,
+ iteration: int,
+ payload: bytes,
+ thread_id: str | None = None,
+ ) -> int:
+ """Store a message. Returns the row id."""
+ ts = time.time()
+ cursor = await self._db.execute(
+ "INSERT INTO messages (sender_id, iteration, payload, timestamp, thread_id) "
+ "VALUES (?, ?, ?, ?, ?)",
+ (sender_id, iteration, payload, ts, thread_id),
+ )
+ await self._db.commit()
+ return cursor.lastrowid
+
+ async def get_messages(
+ self,
+ since: float = 0,
+ limit: int = 100,
+ ) -> list[StoredMessage]:
+ """Get messages after a timestamp, most recent last."""
+ cursor = await self._db.execute(
+ "SELECT id, sender_id, iteration, payload, timestamp, thread_id "
+ "FROM messages WHERE timestamp > ? ORDER BY timestamp ASC LIMIT ?",
+ (since, limit),
+ )
+ rows = await cursor.fetchall()
+ return [
+ StoredMessage(id=r[0], sender_id=r[1], iteration=r[2],
+ payload=r[3], timestamp=r[4], thread_id=r[5])
+ for r in rows
+ ]
+
+ async def get_thread(self, thread_id: str, limit: int = 100) -> list[StoredMessage]:
+ """Get messages in a thread."""
+ cursor = await self._db.execute(
+ "SELECT id, sender_id, iteration, payload, timestamp, thread_id "
+ "FROM messages WHERE thread_id = ? ORDER BY timestamp ASC LIMIT ?",
+ (thread_id, limit),
+ )
+ rows = await cursor.fetchall()
+ return [
+ StoredMessage(id=r[0], sender_id=r[1], iteration=r[2],
+ payload=r[3], timestamp=r[4], thread_id=r[5])
+ for r in rows
+ ]
+
+ async def message_count(self) -> int:
+ cursor = await self._db.execute("SELECT COUNT(*) FROM messages")
+ row = await cursor.fetchone()
+ return row[0]