How portfoliobts/masages works
Nyxo is an anonymous, browser-based messenger with end-to-end encrypted group messaging, temporary accounts, invitations, file sharing, and disappearing messages. Users enter through a proof-of-work-protected account flow, then use the browser client over HTTP and Socket.IO to manage chats and exchange messages or files; server-side services persist and deliver data while the client handles group encryption. The README also documents key transparency and client-code verification. The excerpts show selected server wiring and module references, but not most route-to-service or client-to-server calls, so those links are omitted or marked unverified.
Main entry points: 18-init.js Messenger interface · index.js API routes · app.js HTTP application · accounts.js Anonymous accounts
Components 26
Browser client
- Messenger interface
public/js/18-init.js - Client encryption
public/js/03-e2ee-client.js - Room membership
public/js/04-e2ee-rooms.js - File handling
public/js/05-attachments.js - Local search
public/lib/text-search.js - Transparency checks
public/lib/kt-client.js
HTTP and realtime
- HTTP application
src/http/app.js - API routes
src/http/routes/index.js - Socket handlers
src/realtime/socket-handlers.js - Optional Tor ingress
lib/tor-support.js
Messaging services
- Anonymous accounts
src/services/accounts.js - Rooms and membership
src/services/rooms.js - Message service
src/services/messages.js - Upload service
src/services/uploads.js - Expiry service
src/services/expiry.js
Security and trust
- Identity keys
lib/key-store.js - Key transparency
lib/kt-service.js - Transparency log
lib/kt-log.js - Client manifest
lib/client-manifest.js - Client verification
public/lib/client-verify.js
Persistence and jobs
- PostgreSQL
src/db/pool.js - Session storage
lib/session-store.js - Background jobs
src/jobs/index.js - Job scheduler
lib/jobs/index.js
Other components
- Messenger user
- Tor Browser user
Connections 30
- Messenger user → Messenger interface: uses
- Messenger interface → Client encryption: encrypts with
- Messenger interface → Room membership: manages rooms
- Messenger interface → File handling: handles files
- Messenger interface → Local search: searches locally
- Messenger interface → HTTP application: uses API
- Messenger interface → Socket handlers: connects by socket
- HTTP application → API routes: registers routes
src/http/app.js - HTTP application → Session storage: loads sessions
src/http/app.js - HTTP application → Client manifest: registers manifest route
- API routes → Anonymous accounts: routes account flow
- API routes → Rooms and membership: routes room actions
- API routes → Message service: routes messages
- API routes → Upload service: routes uploads
- Anonymous accounts → Rooms and membership: calls
src/services/accounts.js - Anonymous accounts → Message service: calls
src/services/accounts.js - Anonymous accounts → Identity keys: uses keys
src/services/accounts.js - Message service → PostgreSQL: writes and reads
- Client encryption → Transparency checks: checks log
- Transparency checks → Key transparency: requests proofs
- Key transparency → Transparency log: builds log indexes
lib/kt-service.js - Key transparency → Identity keys: reads keys
lib/kt-service.js - Key transparency → PostgreSQL: queries
lib/kt-service.js - Client manifest → Client verification: describes client files
lib/client-manifest.js - Client verification → Messenger interface: verifies assets
- Session storage → PostgreSQL: stores sessions
- Background jobs → Job scheduler: registers jobs
src/jobs/index.js - Job scheduler → Anonymous accounts: purges expired accounts
- Tor Browser user → Optional Tor ingress: connects through Tor
- Optional Tor ingress → HTTP application: forwards ingress
lib/tor-support.js