Skip to content

RelaySwarm v0.1.0 — experimental HLS field-test release

Pre-release
Pre-release

Choose a tag to compare

@TheCryptoDonkey TheCryptoDonkey released this 12 Oct 10:19
· 456 commits to main since this release
3e480e1

First experimental RelaySwarm GitHub release, built from 3e480e19dfe4d675f14bcb2968f3dc4926fbca25 (PR #6). It includes browser shadow and bounded peer-first HLS delivery, a Node publisher with signed playlist-bound segment commitments, the native HyperDHT proof of concept, and a publisher/player demo with explicit upload consent, limits, an origin-only kill switch and local receipts.

Downloads:

  • relayswarm-0.1.0.tgz: installable package containing the modules, demo, documentation and recorded fixtures.
  • relayswarm-hls-swarm-0.1.0.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.1.0/relayswarm-0.1.0.tgz

Run the demo from source (Node 22+ and ffmpeg for synthetic media):

git clone --branch v0.1.0 --depth 1 https://github.com/forgesworn/relayswarm.git
cd relayswarm
npm ci
npm run demo

Open http://localhost:8787. See FIELD-TEST.md for existing media, HTTPS access, consent and receipt scope, and INTEGRATION.md for the host-page contract.

Validation: all seven main CI jobs passed. The twelve-viewer loopback soak recorded zero playback stalls or fatal errors, 68.7% of fragment loads supplied by peers, corruption rejection and bounded sampled resources. Two viewers used origin throughout; these are media-load results, not net network-data savings. The packaged public modules were also checked in a clean production consumer, and the browser asset was smoke-tested in Chrome.

This is a proof of concept and a prerelease. Physical phones, separate-network/NAT trials, sustained operation, fMP4, broad adaptive bitrate behaviour and independent-client interoperability remain unverified. 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. AI index and full Markdown context are maintained on main. The release tag and assets retain their original contents.