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.

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

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
• Message forwarding deduplication to avoid forwarding loops

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.

License

This project is licensed under the Mozilla Public License Version 2.0 - see the LICENSE file for details.