Protocol Reference

Protocol Reference#

opendesk’s wire protocol carries every byte exchanged between a controller (client) and a controlled machine (server). This section covers the full stack: transport, encoding, encryption, handshakes, frames, and mDNS discovery.

Section

Transport & Encoding

WebSocket transport, msgpack encoding

Encryption & Identity

ChaCha20-Poly1305 AEAD, X25519 keypairs

Pairing Handshake

First-contact 3-message PSK exchange

Auth Handshake

Reconnect 2-message static-key exchange

Frames & Errors

HELLO, REQ, RES, CANCEL, PUSH, error codes

Session & Methods

Session lifecycle, method namespace

Discovery & Admin

mDNS, capability manifest, admin IPC, crypto summary