mirror of
https://github.com/lux-tel/session-desktop.git
synced 2026-10-30 20:33:24 +00:00
zeekay
fdb3dd5d18
- Add environment variable support for custom network endpoints (LUX_FILE_SERVER, LUX_NETWORK_SERVER, LUX_PRO_SERVER) - Create .env.lux example configuration file - Update README with Lux Messenger branding and configuration docs - Document how to connect to custom SessionVM
Lux Messenger Desktop
Private messaging on the Lux Network - A fork of Session Desktop
Summary
Lux Messenger is a privacy-focused messaging application built on the Lux Network, leveraging post-quantum cryptography and decentralized storage nodes. This fork connects to the Lux SessionVM instead of the Oxen network.
Architecture
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ Lux Messenger │ │ luxfi/session │ │ luxcpp/session │
│ (Desktop) │────>│ Go VM + API │────>│ C++ Storage │
│ TypeScript/ │ │ │ │ (GPU-accel) │
│ Electron │ │ Post-Quantum │ │ │
└──────────────────┘ │ Crypto (FIPS) │ │ ML-KEM-768 │
└──────────────────┘ │ ML-DSA-65 │
└──────────────────┘
Quick Start
1. Configure for Lux Network
Copy the example configuration:
cp .env.lux .env
Or set environment variables directly:
# Point to your Lux seed node
export LOCAL_DEVNET_SEED_URL=http://localhost:22023/
# Optional: custom file server
export LUX_FILE_SERVER=files.lux.network
2. Install Dependencies
npm install
3. Run Development Server
npm run dev
4. Build for Production
npm run build
Configuration
Environment Variables
| Variable | Description | Default |
|---|---|---|
LOCAL_DEVNET_SEED_URL |
Seed node URL for custom network | (none - uses Session mainnet) |
LUX_FILE_SERVER |
File server hostname | filev2.getsession.org |
LUX_NETWORK_SERVER |
Network status server | networkv1.getsession.org |
NODE_APP_INSTANCE |
testnet for testnet mode |
(production) |
SESSION_DEBUG |
Enable debug logging | (disabled) |
Running Against Local SessionVM
- Start the Lux SessionVM node:
cd ~/work/lux/session
go run ./cmd/node
- Configure desktop to connect:
export LOCAL_DEVNET_SEED_URL=http://localhost:22023/
npm run dev
Related Repositories
| Repository | Description |
|---|---|
| luxfi/session | Go implementation - VM + API layer |
| luxcpp/session | C++ storage server (GPU-accelerated) |
| luxfi/crypto | Post-quantum cryptography (ML-KEM, ML-DSA) |
| lux-tel/session-ios | iOS mobile client |
| lux-tel/session-android | Android mobile client |
| lux-tel/libsession-util | Shared native library |
Cryptography
Lux Messenger uses FIPS-compliant post-quantum cryptography:
- ML-KEM-768 (FIPS 203) - Key encapsulation mechanism
- ML-DSA-65 (FIPS 204) - Digital signatures
- XChaCha20-Poly1305 - Symmetric encryption (AEAD)
- Blake2b-256 - Session ID derivation
Session ID format: 07 + hex(Blake2b-256(KEM_pk || DSA_pk)) = 66 characters
Key Differences from Session
| Feature | Session | Lux Messenger |
|---|---|---|
| Network | Oxen Service Nodes | Lux SessionVM |
| Cryptography | X25519/Ed25519 | ML-KEM-768/ML-DSA-65 (post-quantum) |
| Storage | Oxen snodes | Lux storage nodes (GPU-accelerated) |
| Configuration | Hardcoded | Environment-configurable |
Development
Project Structure
ts/
├── session/
│ ├── apis/
│ │ ├── seed_node_api/ # Seed node discovery
│ │ ├── snode_api/ # Storage node API
│ │ └── file_server_api/ # File uploads
│ ├── crypto/ # Cryptographic operations
│ └── onions/ # Onion routing
├── state/
│ └── ducks/types/ # Feature flags
└── preload.js # Network configuration
Debug Logging
Enable verbose logging for troubleshooting:
export SESSION_DEBUG=1
export SESSION_DEBUG_SWARM_POLLING=1
export SESSION_DEBUG_SNODE_POOL=1
npm run dev
Contributing
- Fork this repository
- Create a feature branch
- Make your changes
- Submit a pull request
License
GPL-3.0 - Same as upstream Session Desktop
Upstream
This project is a fork of Session Desktop by the Session Technology Foundation.