zlay #

an AT Protocol relay in Zig. It discovers PDS hosts, processes their repository events, verifies signatures when signing keys are available, and serves a combined WebSocket stream and sync APIs. Protocol primitives come from zat; the collection index draws on lightrail.

live: zlay.waow.tech.

install #

requires Zig 0.17, a C toolchain and PostgreSQL. Clone the repo and build:

zig build -Dbackend=zio -Doptimize=ReleaseSafe -j2

use #

Set DATABASE_URL for a dedicated PostgreSQL database, choose writable event and collection-index directories, then run zig-out/bin/zlay. Configure credentials and discovery before exposing the service; see the docs for startup, retention and deployment.

develop #

zig fmt --check build.zig build.zig.zon src scripts # formatting
zig build test -j2                                # tests
zig build test-index -j2                          # collection index behavior
zig build -Dbackend=zio -j2                        # analyze the production I/O backend

Normal builds use std.Io.Threaded; -Dbackend=zio selects lalinsky’s zio. Use ReleaseSafe for deployments.

docs #

docs/ covers architecture, configuration and operation.

license #

MIT