Skip to Content
DevelopersError CodesCodesAuthHandshake missing fields

Handshake missing fields

Code

AUTH/HANDSHAKE_MISSING_FIELDS

What it means

The server cannot verify the connection because the client did not provide the minimum required handshake auth information.

When it happens

  • A WebSocket client connects without required handshake auth fields (identity, roomId, token).

Typical missing fields:

  • identityId (address / identity key)
  • realm.id (room/realm id)
  • verifyMeta.token (connection verification token)

How to handle

  • Treat as a client integration error or an invalid session.
  • On the server, include booleans like hasIdentityId/hasRoomId/hasToken in meta (without leaking secrets).
  • On the client, re-run the flow that fetches the world route (host/token/address) before connecting.
Last updated on
Docsv1.0.10