T

Make the relay binary bind a real Quinn endpoint instead of only printing its
configuration. This is the next runtime step toward the public relay while still
keeping connection handling out of this commit.

The relay now builds a self-signed development TLS configuration, advertises the
lanparty ALPN, enables QUIC datagram buffers, binds the configured UDP address,
prints the actual local address, and waits for Ctrl-C before closing the
endpoint. The generated certificate is explicitly a development placeholder;
production certificate and client trust handling remain future work.

The rustls dependency is pinned to the ring provider to match Quinn's selected
crypto backend and avoid process-level provider ambiguity at runtime.

Test Plan:
- cargo fmt --check
- cargo test --workspace
- cargo clippy --workspace --all-targets -- -D warnings
- timeout 2s cargo run -p lanparty-relay -- --listen 127.0.0.1:0 || test $? -eq 124

Refs: PLAN.md public relay QUIC data path
Refs: https://docs.rs/quinn/0.11.9

2026-05-21 17:38:56 +02:00

crates

feat(relay): bind QUIC endpoint

2026-05-21 17:38:56 +02:00

.gitignore

Initialize repository

2026-05-21 16:54:26 +02:00

Cargo.lock

feat(relay): bind QUIC endpoint

2026-05-21 17:38:56 +02:00

Cargo.toml

feat(relay): bind QUIC endpoint

2026-05-21 17:38:56 +02:00

PLAN.md

plan

2026-05-21 17:00:58 +02:00

README.md

feat(relay): bind QUIC endpoint

2026-05-21 17:38:56 +02:00

README.md

softlan-vpn

Monorepo for a Layer 2 over QUIC LAN party bridge.

Workspace crates

lanparty-proto: shared frame format, MAC validation, MTU helpers.
lanparty-ctrl: control-plane messages (join/hello/role/version).
lanparty-obs: shared diagnostics/logging event models.
lanparty-client-core: platform-agnostic client session state.
lanparty-client-win: Windows TAP + route/metric handling binary.
lanparty-gateway: Linux AF_PACKET gateway binary.
lanparty-relay: public QUIC relay binary.

`lanparty-proto`

Transport-agnostic tunnel contract shared by all binaries:

overlay datagram header encoding and decoding
Ethernet frame header parsing
MAC address parsing and identity validation
QUIC datagram to TAP MTU budget helpers

`lanparty-ctrl`

Reliable control-plane schema shared by the QUIC stream handlers:

endpoint hello messages with role, room, MAC, and datagram budget
server welcome, reject, peer lifecycle, stats, and disconnect messages
room-code, role/MAC, peer-id, and effective-MTU validation
length-prefixed JSON control frames for reliable QUIC streams

`lanparty-obs`

Shared diagnostics and structured logging vocabulary:

gateway/relay frame logs with MACs, ethertype, length, peer, and action
tunnel counters shared by control messages and runtime diagnostics
client connectivity/TAP diagnostics and user-facing status messages

`lanparty-relay`

Public relay binary and relay-owned room state:

room admission for clients and gateways
one gateway per room, duplicate client MAC rejection, and room limits
stable effective room MTU chosen before Ethernet datagrams flow
Ethernet datagram forwarding decisions with no ingress reflection

Build

cargo check --workspace

Relay

cargo run -p lanparty-relay -- --listen 443/udp

--listen accepts either a socket address or a UDP port shorthand such as 443/udp. The relay binds a QUIC endpoint and waits for shutdown, but connection handling is not wired yet. It currently uses a generated self-signed development certificate; production certificate and client trust handling remain future work.

Description

A simple one-click Layer 2 tunnel software (Windows 11 client) to bridge people who cannot participate in person at a LAN party to the LAN party. And a simple server endpoint (Linux) software that runs physically at the LAN party and bridges the tunneled traffic and the real LAN network.

Readme 1.1 MiB