Whistleblower
Whistleblower
What it does: A censorship-resistant document upload and indexing pipeline for the Logos stack
Stage: Prototype
Licence: MIT OR Apache-2.0
Verified on 4 November 2026 against README and commit of 2 July 2026.
Whistleblower is a tool for publishing documents so they survive takedowns, and it runs on Logos Storage, Logos Messaging (Logos Delivery) and the Logos Execution Zone (LEZ), with a Basecamp app. The code is published by the GitHub account aegonmyy. The README does not say whether it is an official Logos project.
What it does
- Anyone can upload a document to Logos Storage and get its content identifier (CID).
- The CID is broadcast peer to peer in real time over Logos Delivery.
- The CID can be anchored on chain in a LEZ registry, so it stays discoverable without a trusted host.
- A batch-anchor CLI watches Waku and anchors CIDs in batches of up to 50.
- The registry is a RISC0 program built with the SPEL framework. Its setup instruction is permissionless.
- The core is a reusable document-indexing module, Chronicle, that other Basecamp apps can use.
- A Basecamp app provides the GUI for publishing.
Stage: Prototype. The README states no stage. It says the registry is live on the hosted LEZ v0.2.0 testnet.
The README calls it a "submission for LP-0017".
Use it
- Install the prerequisites: logos-scaffold (
lgs), Docker and Nix. The README gives the cargo install command forlgs. - Build the RISC0 guest with
make build. - Start a local network with
lgs setupandlgs localnet start, then deploy withmake deploy. - Create and fund a signer account with
lgs wallet, add its ID and the program ID tobatch-anchor/batch-anchor.toml, then build batch-anchor and run itsinitcommand. - Start nwaku and the watcher with
batch-anchor node upandbatch-anchor watch. - Run the end-to-end demo with
./scripts/demo.sh, or publish a document through the GUI withlgs basecamp launch. - Look up an anchored CID with
batch-anchor lookup.
Build it
- Build the guest with
make build. The IDL is committed and can be regenerated withmake idl. - For the Basecamp modules, run
make ffi, thennix build .#chronicle-installandnix build .#whistleblower-install. - Install them with
lgs basecamp install chronicleandlgs basecamp install whistleblower. - Run CI locally with
./scripts/ci-local.sh.
Releases
- Latest tag: submission-rc5-27360cb7, 30 June 2026.
- Version in metadata.json: 1.0.0, for both the Basecamp app (whistleblower) and the core module (chronicle).
- GitHub lists no releases.
See also
Sources
- logoz README, GitHub, last commit 2 July 2026
- logos-whistleblower/metadata.json, GitHub
- logos-chronicle/metadata.json, GitHub
Page status: Stub. Stub · Outline · Usable · Guide · Star. Anyone can improve this page and change its status.