Whistleblower

From Local Area Network
Revision as of 19:06, 4 November 2026 by Eleutherious (talk | contribs) (New tool page, source-checked against the project README)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
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

  1. Install the prerequisites: logos-scaffold (lgs), Docker and Nix. The README gives the cargo install command for lgs.
  2. Build the RISC0 guest with make build.
  3. Start a local network with lgs setup and lgs localnet start, then deploy with make deploy.
  4. Create and fund a signer account with lgs wallet, add its ID and the program ID to batch-anchor/batch-anchor.toml, then build batch-anchor and run its init command.
  5. Start nwaku and the watcher with batch-anchor node up and batch-anchor watch.
  6. Run the end-to-end demo with ./scripts/demo.sh, or publish a document through the GUI with lgs basecamp launch.
  7. 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 with make idl.
  • For the Basecamp modules, run make ffi, then nix build .#chronicle-install and nix build .#whistleblower-install.
  • Install them with lgs basecamp install chronicle and lgs 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

Page status: Stub. Stub · Outline · Usable · Guide · Star. Anyone can improve this page and change its status.