handshakeMessage

fun handshakeMessage(name: String, credential: String = ""): String(source)

Builds the Iam <name> (or Iam <name> <credential>) datagram body a client sends to open a connection.

Return

the Iam <name> datagram body, with <credential> appended when credential is non-empty

Parameters

name

the client's chosen name; must not contain whitespace, since handshake messages are whitespace-split

credential

an optional opaque token the server's MultiConnectionUDPServer.admit receives verbatim; must be whitespace-free (base64url-encode a structured or binary credential). The default (empty string) omits the token entirely, producing the pre-1.4.0 Iam <name>.