tajniak81andClaude Opus 5.5
6aaf554336
CI / Test (ubuntu-latest) (push) Canceled after 0s
CI / Test (windows-latest) (push) Canceled after 0s
CI / Storage tests on PostgreSQL (push) Canceled after 0s
CI / Complement (federation off) (push) Canceled after 0s
CI / golangci-lint (push) Canceled after 0s
CI / Smoke test the binary (push) Canceled after 0s
Implements PLAN.md Phase 5: the Server-Server API. Warp joins rooms on other servers and lets their users join its rooms, invites across servers with the invitee's server countersigning, rejects remote invites (locally if the inviter is unreachable), and exchanges events, typing, receipts and to-device messages with other homeservers — all behind the runtime switch, which now starts and stops real outbound traffic. The protocol lives in internal/federation with no knowledge of rooms: X-Matrix signing (fuzzed parser), the spec's discovery algorithm keeping the dial address and the TLS name apart, a signed client that refuses every request while the switch is off or the policy denies the destination, and a key ring that caches other servers' keys for at most a week, with optional notaries. The roomserver takes events from elsewhere through the spec's intake: signatures and hashes (a hash mismatch keeps the redacted form), the rules against the event's own auth events, against the state before it — with /get_missing_events for small gaps and /state_ids for wide ones — and against the current state, where a failure is a soft failure. Events held without their state are outliers: a column on roomserver_events, because the current state of a room joined over federation is almost all outliers, and excluded from every timeline query. Forks are resolved at the room's head. Membership across servers is make_join/send_join, make_leave/send_leave and countersigned invites, in both directions; m.room.server_acl is enforced on everything another server sends. History before a remote join is backfilled when /messages pages past it, stored at negative stream positions. internal/federationapi is the running component: the inbound endpoints, and an outbound queue that persists what it owes each destination, sends it in transactions of 50 PDUs and 100 EDUs, backs off from ten seconds to six hours, survives restarts, and drops events persisted while federation is off rather than delivering a backlog in one burst. Its Module is what the switch starts and stops. Also: a TLS listener for port 8448, trusted key servers, key validity and an outbound CA bundle in the config; per-destination health and backoff reset in the admin API; remote profiles, aliases and directories in the Client-Server API; a Complement federation profile. See docs/federation.md, including its known gaps (no partial-state joins, no key rotation). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
61 lines
2.1 KiB
Docker
61 lines
2.1 KiB
Docker
# Warp as a Complement homeserver image.
|
|
#
|
|
# Complement (https://github.com/matrix-org/complement) is the official
|
|
# Matrix integration suite: it runs one container per homeserver per test and
|
|
# drives it over the real HTTP API. Its image contract is short, and this
|
|
# file exists to meet it:
|
|
#
|
|
# - EXPOSE 8008 (client) and 8448 (federation).
|
|
# - Take the server name from the SERVER_NAME environment variable.
|
|
# - Keep storage inside the container.
|
|
# - Survive the entrypoint being run more than once.
|
|
# - Answer GET /_matrix/client/versions with a 200.
|
|
#
|
|
# Build it from the repository root, because the build context is the Go
|
|
# module one directory up:
|
|
#
|
|
# docker build -t complement-warp -f server/test/complement/Dockerfile .
|
|
#
|
|
# Federation is served on 8448 over TLS, with a certificate the entrypoint
|
|
# has the CA Complement mounts at /complement/ca sign. The federation
|
|
# profile of run.sh switches it on; the default profile leaves it off and
|
|
# runs the C-S tests only.
|
|
|
|
FROM golang:1.26-alpine AS build
|
|
|
|
# The workspace file is not copied, so the build must not look for one.
|
|
ENV GOWORK=off
|
|
ENV CGO_ENABLED=0
|
|
|
|
WORKDIR /src
|
|
|
|
# Dependencies first, so that editing Go sources does not re-download them.
|
|
COPY server/go.mod server/go.sum ./
|
|
RUN go mod download
|
|
|
|
COPY server/ ./
|
|
RUN go build -trimpath -o /out/warp ./cmd/warp
|
|
|
|
FROM alpine:3.21
|
|
|
|
# curl is what the health check uses, ca-certificates the roots outbound
|
|
# federation trusts, and openssl signs the federation certificate.
|
|
RUN apk add --no-cache ca-certificates curl openssl
|
|
|
|
COPY --from=build /out/warp /usr/local/bin/warp
|
|
COPY server/test/complement/entrypoint.sh /usr/local/bin/warp-complement
|
|
RUN chmod +x /usr/local/bin/warp-complement
|
|
|
|
# Everything mutable lives here: the SQLite database and the signing key.
|
|
VOLUME /data
|
|
|
|
EXPOSE 8008 8448
|
|
|
|
# Complement waits for the container to become healthy before it starts a
|
|
# test, so the interval is short and the retries generous: a cold start has
|
|
# to run the migrations first.
|
|
HEALTHCHECK --interval=1s --timeout=2s --start-period=1s --retries=60 \
|
|
CMD curl -fsS http://localhost:8008/healthz || exit 1
|
|
|
|
ENTRYPOINT ["/usr/local/bin/warp-complement"]
|