Repository navigation
RelaySwarm v0.2.1: experimental holder-discovery prerelease
Pre-releaseExperimental RelaySwarm prerelease, built from 1d54538c56179387b7541924e068d0d9c41d18e6 (PR #9). It stops a linked holder that is never ahead from suppressing neighbour discovery, and adds session-local holder labels to the loader's local peer diagnostics. Labels are counters, not keys; they are never sent on the wire and are not in the opted-in numeric report. Wire version 3, commitment schemas 1 and 2 and metrics version 2 are unchanged. The full list is in the changelog.
Downloads:
relayswarm-0.2.1.tgz: installable package containing the modules, demo, broadcaster, documentation and recorded fixtures.relayswarm-hls-swarm-0.2.1.mjs: standalone browser ESM bundle with its runtime dependencies included. The host supplies hls.js.SHA256SUMS: checksums for both assets.
Install the library:
npm install https://github.com/forgesworn/relayswarm/releases/download/v0.2.1/relayswarm-0.2.1.tgzRun the demo from source (Node 22.13+ and ffmpeg for synthetic media):
git clone --branch v0.2.1 --depth 1 https://github.com/forgesworn/relayswarm.git
cd relayswarm
npm ci
npm run demoSee GETTING-STARTED.md, BROADCASTING.md and INTEGRATION.md.
Validation: all nine required CI jobs passed on this commit and on its PR head. A fresh package consumption of this commit passed with 287 package members, and its built demo client is byte-identical to the client served by the pilot. On the same loader source, deployed to the public pilot, the fourteen-role short qualifier (R66) passed all 16 gates for the first time, including both-quality peer media for every receiver, with relay-only TURN over TLS/TCP. Desktop installed-browser journeys passed for Firefox 152.0.6 and Safari 26.6.2 on macOS arm64; this is desktop scope only, not physical devices, hard NAT or a separate network. At publication the pilot runs 140c256, whose runtime differs from this release only in the package version fields.
This is a prerelease and field acceptance remains open, by owner decision. The sustained two-hour run with churn and natural credential expiry is RED (its latest attempt stopped on a harness race after 640 seconds of measurement). The 3 MB both-quality shared-allowance lifecycle is RED: high-quality transfers over the relay path did not complete before the documented reservation charging used up the 3 MB cap. Desktop Safari 17.6 is RED. Physical devices, difficult networks and hard NAT are not established, and the marginal hosting cost is not determined. The npm registry remains unpublished; this release supplies GitHub assets and a pinned source tag.
Current documentation, including corrections after this release, starts at the documentation index, installation guide and release evidence page. The release tag and assets retain their original contents.