Skip to Content
DevelopersError CodesCodesAuthAddress mismatch

Address mismatch

Code

AUTH/ADDRESS_MISMATCH

What it means

The address asserted by the client during handshake verification does not match what the server expects for this connection.

When it happens

  • The handshake verify address does not match the identity/address used by the server.

Typical scenarios:

  • Client uses stale verifyMeta.address from a previous session
  • IdentityId/address mapping changed but the client didn’t refresh
  • Malicious/invalid client tries to spoof verification metadata

How to handle

  • Treat as an authorization failure (403).
  • Log safe identifiers only (do not log tokens).
  • Client should refresh world route (host/token/address) before reconnecting.
Last updated on
Docsv1.0.10