Editing SimTX API v24/Connection and handshake (section)

== Roles ==
The role byte in the handshake selects the kind of session. It cannot be changed later on the same connection.

{| class="wikitable"
! Byte !! Name !! Purpose !! Authentication
|-
| 1 || <code>RECEIVER</code> || Receive IQ at a location. See [[SimTX API v24/Receiver session|Receiver session]]. || Anonymous or ticket (<code>receiver</code>)
|-
| 2 || <code>TX_AUDIO</code> || Transmit audio or IQ streamed by the client. See [[SimTX API v24/Transmitter session|Transmitter session]]. || Ticket (<code>tx-audio</code>) with <code>game.transmit</code>
|-
| 3 || <code>TX_GENERATED</code> || Transmit a source generated by the server (white noise). || Ticket (<code>tx-generated</code>) with <code>game.transmit</code>
|-
| 4 || <code>CONTROL</code> || Station list, banners, health, maps, catalog, own-transmitter monitor. See [[SimTX API v24/Control session|Control session]]. || Anonymous or ticket (<code>control</code>)
|-
| 5 || <code>MODERATION</code> || Moderator tools. See [[SimTX API v24/Moderation session|Moderation session]]. || Ticket (<code>moderation</code>) with <code>moderation.manage</code>
|-
| 6 || <code>TIMESTAMPED_RECEIVER</code> || Receiver whose IQ blocks carry UTC timestamps. || Anonymous only
|}

A <code>TIMESTAMPED_RECEIVER</code> connection that presents a ticket is rejected with <code>CREDENTIAL_INVALID</code>, because no ticket can be issued for that role.

An authenticated receiver behaves exactly like an anonymous one, except that receiver limits and permissions such as <code>monitor.any</code> are evaluated against the account.