Whistleblower: Difference between revisions

Revision as of 21:01, 4 November 2026

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 its README describes as a censorship-resistant pipeline for publishing documents. It runs on Logos Storage, Logos Messaging (Logos Delivery) and the Logos Execution Zone (LEZ), the Logos layer that runs on-chain programs, 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, which the README says keeps it discoverable without a trusted host.
A batch-anchor CLI watches Logos Delivery (formerly Waku) and anchors CIDs in batches of up to 50.
The registry is a RISC0 program (code whose runs can be proved in zero knowledge) built with SPEL, a framework for writing LEZ programs. 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. The README, last changed on 2 July 2026, says the registry is live on the hosted LEZ v0.2.0 testnet. The metadata gives version 1.0.0, and the latest tag is submission-rc5-27360cb7.

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 for lgs.
Build the RISC0 guest with make build.
Start a local network with lgs setup and lgs localnet start, then deploy with make deploy.
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.
Start nwaku (a Logos Messaging node) and the watcher with batch-anchor node up and batch-anchor watch.
Run the end-to-end demo with ./scripts/demo.sh, or publish a document through the GUI with lgs basecamp launch.
Look up an anchored CID with batch-anchor lookup.

Build it

make build builds the guest. The IDL (the file that describes the program's interface) is committed and can be regenerated with make idl.
The Basecamp modules are built with make ffi, then nix build .#chronicle-install and nix build .#whistleblower-install.
lgs basecamp install chronicle and lgs basecamp install whistleblower install them.
./scripts/ci-local.sh runs CI locally.

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.

Sources

logoz README, GitHub, last commit 2 July 2026
logos-whistleblower/metadata.json, GitHub
logos-chronicle/metadata.json, GitHub
docs/testnet-v020-live-evidence-20260702.md, GitHub
releases, GitHub

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

@@ Line 10: / Line 10: @@
 | verified_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.
+'''Whistleblower''' is a tool its README describes as a censorship-resistant pipeline for publishing documents. It runs on [[Logos Storage]], [[Logos Messaging]] (Logos Delivery) and the Logos Execution Zone (LEZ), the Logos layer that runs on-chain programs, 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.
+* The CID can be anchored on chain in a LEZ registry, which the README says keeps it discoverable without a trusted host.
-* A batch-anchor CLI watches Waku and anchors CIDs in batches of up to 50.
+* A batch-anchor CLI watches Logos Delivery (formerly 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 registry is a RISC0 program (code whose runs can be proved in zero knowledge) built with SPEL, a framework for writing LEZ programs. 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.
+Stage: Prototype. The README states no stage. The README, last changed on 2 July 2026, says the registry is live on the hosted LEZ v0.2.0 testnet. The metadata gives version 1.0.0, and the latest tag is submission-rc5-27360cb7.
 The README calls it a "submission for LP-0017".
@@ Line 30: / Line 30: @@
 # Start a local network with <code>lgs setup</code> and <code>lgs localnet start</code>, then deploy with <code>make deploy</code>.
 # Create and fund a signer account with <code>lgs wallet</code>, add its ID and the program ID to <code>batch-anchor/batch-anchor.toml</code>, then build batch-anchor and run its <code>init</code> command.
-# Start nwaku and the watcher with <code>batch-anchor node up</code> and <code>batch-anchor watch</code>.
+# Start nwaku (a Logos Messaging node) and the watcher with <code>batch-anchor node up</code> and <code>batch-anchor watch</code>.
 # Run the end-to-end demo with <code>./scripts/demo.sh</code>, or publish a document through the GUI with <code>lgs basecamp launch</code>.
 # Look up an anchored CID with <code>batch-anchor lookup</code>.
 == Build it ==
-* Build the guest with <code>make build</code>. The IDL is committed and can be regenerated with <code>make idl</code>.
+* <code>make build</code> builds the guest. The IDL (the file that describes the program's interface) is committed and can be regenerated with <code>make idl</code>.
-* For the Basecamp modules, run <code>make ffi</code>, then <code>nix build .#chronicle-install</code> and <code>nix build .#whistleblower-install</code>.
+* The Basecamp modules are built with <code>make ffi</code>, then <code>nix build .#chronicle-install</code> and <code>nix build .#whistleblower-install</code>.
-* Install them with <code>lgs basecamp install chronicle</code> and <code>lgs basecamp install whistleblower</code>.
+* <code>lgs basecamp install chronicle</code> and <code>lgs basecamp install whistleblower</code> install them.
-* Run CI locally with <code>./scripts/ci-local.sh</code>.
+* <code>./scripts/ci-local.sh</code> runs CI locally.
 == Releases ==
@@ Line 56: / Line 56: @@
 * [https://github.com/aegonmyy/logoz/blob/main/logos-whistleblower/metadata.json logos-whistleblower/metadata.json], GitHub
 * [https://github.com/aegonmyy/logoz/blob/main/logos-chronicle/metadata.json logos-chronicle/metadata.json], GitHub
+* [https://github.com/aegonmyy/logoz/blob/main/docs/testnet-v020-live-evidence-20260702.md docs/testnet-v020-live-evidence-20260702.md], GitHub
+* [https://github.com/aegonmyy/logoz/releases releases], GitHub
 {{Page status|Stub}}