Namespace Uniform.Matrix.Server.Federation

Classes

FederationClient

Requests to other servers, signed with this server's key as FederationAuth describes.

FederationEndpoint

Endpoint metadata of federation endpoints: they answer only with federation on, and when Signed, only requests signed by the server they come from.

FederationQueue

Outgoing transactions, one queue per destination server: PDUs and EDUs are batched, and retried with growing pauses while the server cannot be reached.

Sends new room events to the other servers in each room as transactions: events of local users, and joins of remote users that this server accepted as the room's server; and device changes and presence of local users as m.device_list_update and m.presence EDUs.

RemoteActivity

Typing, read receipts and received presence with other servers: local users' ones go to the room's other servers as EDUs, and theirs are shown here.

RemoteDevices

End-to-end encryption with other servers' users: their device and one-time keys from their servers, and to-device messages to them, such as room keys, as m.direct_to_device EDUs.

RemoteEvents

Events other servers send in transactions: their senders' keys are gathered, and when they build on events this server does not have, those are asked for with get_missing_events and accepted first.

RemoteInvites

Invites of other servers' users: the invite is signed here, sent to the invitee's server, which signs it too, and then stored like any event.

RemoteJoins

Joining rooms of other servers: make_join for a template, sign it, send_join, check the returned state and store the room.

RemoteServerKeys

Other servers' signing keys: fetched from each server's /_matrix/key/v2/server, else from the TrustedKeyServers, and kept in the database until their valid_until_ts, at most a week.

RoomAcls

The server ACLs of rooms here: requests and transactions of a server the room's m.room.server_acl denies are refused for that room.

RoomHistory

Room history for other servers, which fill gaps with it before they can show new events: missing events, backfill, single events and the state at an event.

ServerAddress

Where to reach a server: the base address, whose host the TLS certificate must be valid for, and the Host header.

ServerAuthentication

Checks signed requests of other servers on endpoints with FederationEndpoint metadata, and tells endpoints who sent them, see GetOrigin(HttpContext).

ServerResolver

Resolve server names to addresses: IP literals and names with a port directly, otherwise through /.well-known/matrix/server delegation, then SRV records (_matrix-fed._tcp, and the older _matrix._tcp), else port 8448.

SrvLookup

Looks up DNS SRV records over UDP at the system's name servers, for resolving server names that delegate with _matrix-fed._tcp.