Whistleblower: Difference between revisions

From Local Area Network
Second check: fixes to facts, dates (UTC), glosses and attribution
Plainer prose: fewer quotes, project claims attributed, glosses folded in
 
Line 10: Line 10:
| verified_against = README and commit of 2 July 2026
| verified_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.
'''Whistleblower''' is a document-publishing pipeline by the GitHub account aegonmyy. Its README describes it 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 README does not say whether it is an official Logos project.


== What it does ==
== What it does ==
Line 17: Line 17:
* The CID can be anchored on chain in a LEZ registry, which the README says keeps it 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 Logos Delivery (formerly 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 (code whose runs can be proved in zero knowledge) built with SPEL, a framework for writing LEZ programs. Its setup instruction is permissionless.
* The registry is a RISC0 program, so its runs can be proved in zero knowledge. It is built with SPEL, a framework for writing LEZ programs, and its setup instruction is permissionless.
* The core is a reusable document-indexing module, Chronicle, that other Basecamp apps can use.
* The core is Chronicle, a reusable document-indexing module that other Basecamp apps can use.
* A Basecamp app provides the GUI for publishing.
* 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.
Stage: Prototype. The README, last changed on 2 July 2026, states no stage and 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".
The README calls it a submission for LP-0017.


== Use it ==
== Use it ==
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>.
# 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.
# 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 (a Logos Messaging node) 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>.
# 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>.
# Look up an anchored CID with <code>batch-anchor lookup</code>.


== Build it ==
== Build it ==
* <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>.
* <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>.
* The Basecamp modules are built with <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>.
* <code>lgs basecamp install chronicle</code> and <code>lgs basecamp install whistleblower</code> install them.
* <code>lgs basecamp install chronicle</code> and <code>lgs basecamp install whistleblower</code> install them.

Latest revision as of 23:27, 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 document-publishing pipeline by the GitHub account aegonmyy. Its README describes it 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 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, so its runs can be proved in zero knowledge. It is built with SPEL, a framework for writing LEZ programs, and its setup instruction is permissionless.
  • The core is Chronicle, a reusable document-indexing module that other Basecamp apps can use.
  • A Basecamp app provides the GUI for publishing.

Stage: Prototype. The README, last changed on 2 July 2026, states no stage and 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

  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, a Logos Messaging node, 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

  • 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.

See also

Sources

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