62 releases (16 stable)
Uses new Rust 2024
new 2.1.1 | Mar 31, 2025 |
---|---|
1.1.7 | Nov 26, 2023 |
1.1.6 | Mar 12, 2021 |
1.1.5 | Sep 16, 2020 |
0.5.0 | Mar 25, 2017 |
#281 in Network programming
302 downloads per month
39KB
726 lines
mles-client
A prototype implementation of the Mles v2 protocol. This client serves as an example implementation and proof-of-concept for the protocol, demonstrating WebSocket-based messaging with end-to-end encryption using XChaCha20-Poly1305.
⚠️ Important Note: This is a prototype implementation intended for demonstration and learning purposes. It should not be used in production environments or for any critical applications.
About Mles Protocol
This client implements the Mles v2 protocol (Modern Lightweight channEl Service), a client-server data distribution protocol designed for lightweight and reliable distributed publish-subscribe data service. For production implementations and more detailed protocol specifications, please visit https://mles.io.
Client Features
- End-to-end encryption using XChaCha20-Poly1305
- Real-time messaging with colorized usernames
- Message deduplication
- Proxy mode for connecting two Mles servers
- MQTT proxy mode for bridging Mles with MQTT brokers
- Local timestamp conversion
- Secure key derivation using Scrypt and Blake2b
- Support for shared keys via environment variables
Usage
Direct Mode
# Connect to default server (wss://mles.io)
mles-client
# Connect to specific server
mles-client -s wss://example.com
# Connect with predefined channel and user ID
mles-client -c mychannel -u myuser
Proxy Mode
# Connect two servers
mles-client -s wss://server1.com --proxy-server wss://server2.com -c channel -u proxy-user
MQTT Proxy Mode
# Connect Mles server to MQTT broker
mles-client -s wss://mles.io --mqtt-broker mqtt://test.mosquitto.org:1883 -c channel -u mqttproxy
This mode allows bidirectional message forwarding between a Mles server and an MQTT broker. Messages sent to the Mles channel will be published to the MQTT topic and vice versa. The MQTT topic name matches the Mles channel name.
Command Line Arguments
-s, --server
: WebSocket server URL (default: wss://mles.io)-c, --channel
: Channel name-u, --uid
: User ID--proxy-server
: Second server URL for proxy mode--mqtt-broker
: MQTT broker URL for MQTT proxy mode
Environment Variables
MLES_KEY
: Optional shared key for authentication
Implementation Notes
This implementation includes:
- Basic protocol compliance with Mles v2
- Example encryption using XChaCha20-Poly1305
- Prototype proxy functionality
- Simple terminal-based UI
- MQTT bridge functionality
While functional, this implementation prioritizes demonstrating protocol concepts over production-ready features and security hardening.
Features in Detail
Security
- Secure message encryption using XChaCha20-Poly1305
- Key derivation using Scrypt with Blake2b hash
- Authentication using SipHash
UI Features
- Colorized usernames for better readability
- Local time conversion for timestamps
- Dynamic terminal resizing support
- Message deduplication to prevent doubles
Proxy Mode
- Bidirectional message forwarding between servers
- MQTT proxy support for integration with MQTT brokers
- Live statistics showing message counts
- Auto-reconnect capabilities
- Clean shutdown handling
Building
cargo build --release
Dependencies
- tokio: Async runtime
- tokio-tungstenite: WebSocket implementation
- chacha20poly1305: Encryption
- blake2: Hashing
- scrypt: Key derivation
- clap: Command line argument parsing
- crossterm: Terminal UI
- serde_json: JSON handling
- rumqttc: MQTT client implementation
Acknowledgments
- Zed - An outstanding text processor that greatly facilitated the development of this project
- Claude 3.5 Sonnet - AI assistant that provided valuable help with code suggestions and documentation
License
This project is licensed under the Mozilla Public License Version 2.0 - see the LICENSE file for details.
Dependencies
~11–24MB
~352K SLoC