Skip to main content

Using Rogue Messaging in the Desktop Client

The Messaging tab (located directly below Dashboard in the left sidebar of rogue-desktop-client) connects to the centralized rogue-nats-server from the Rust backend using your active unlocked wallet.

1. Connecting & Authentication​

  1. Unlock your wallet in rogue-desktop-client.
  2. Open Messaging in the left sidebar.
  3. Verify or edit the server URL in the top bar (default dev: nats://127.0.0.1:4222, production: tls://nats.roguechain.org:4222) and click Connect.
  4. The Rust backend signs the EIP-191 challenge automatically—your private key never leaves Rust or touches the WebView.
  5. Switching your active wallet automatically disconnects the previous NATS session and reconnects under the new 0x address.

2. Channels, Ordering & Gated Rooms​

  • Ordering: System channels (#announcements, #general) are pinned at the top. All other channels are sorted in descending order by active connected members, with alphabetical tie-breaking.
  • Gated Channels (🔒): Channels such as #hash-wardens (Lv.3+) appear with a lock icon. If your RogueMinerReputation level is below the requirement, NATS denies reading, history, and publishing at the protocol level.
  • History & Replies: Opening a room loads the latest 200 messages; click Load Older (200) to paginate backward. Hover over any message to quote-reply (reply_to) or delete your own message.
  • Creating Rooms: Click + next to Channels (requires >= 50 ROGUE or Lv.2+). Room creators can update the topic, moderate, or delete their room.

3. End-to-End Encrypted Direct Messages (E2EE DMs)​

  • Direct messages use ECIES (secp256k1 ECDH + HKDF-SHA256 + AES-256-GCM) encrypted client-to-client.
  • The recipient must have connected to rogue-nats-server at least once so their compressed secp256k1 public key is registered in ROGUE_PROFILES.
  • The server retains encrypted DM ciphertexts in ROGUE_DM for 30 days. rogue-desktop-client caches decrypted DMs locally in app_data_dir encrypted at rest using a key derived from your wallet.

[!WARNING] Key Loss / Rotation Notice: E2EE DMs are bound to your 0x wallet's secp256k1 key. If you lose your mnemonic/private key or switch to a different wallet address, historical E2EE DMs encrypted for the previous key cannot be decrypted.