DistributionX
DistributionX is a tool by the GitHub account Timidan for paying out to an allowlist without publishing recipient addresses. It runs on the Logos Execution Zone (LEZ), the Logos layer that runs on-chain programs, and comes as a Basecamp app with a Logos core module. The README does not say whether it is an official Logos project.
- What it is
- Private allowlist distributions for the Logos Execution Zone
- Stage
- Prototype
- Licence
- MIT or Apache-2.0
- Source code
- github.com
- Use it
- github.com
- Build it
- github.com
- Checked on
- 4 November 2026
- Checked against
- README and commit of 7 September 2026
What it doesedit
- A distributor creates an eligibility list and an encrypted claim bundle, then funds the allowlist without publishing recipient addresses.
- The LEZ program stores a Merkle root, one hash that stands for the whole list, and funds the distribution vault.
- Each recipient proves one eligible row and submits a
claim_ppetransaction through LEZ privacy-preserving execution. - In one transaction the program pays the recipient and records a nullifier, a one-time tag that stops the same row being claimed twice without saying whose row it is.
- By the README's account, the public state records the payout and the nullifier, and the private membership witness does not appear in the public transaction. That witness is the hidden data that proves a row is on the list. The README notes that the distributor still knows the original eligibility list.
Stage: Prototype. The README states no stage, but metadata.json gives version 0.1.0 and the README reports a verified run on the LEZ public testnet. docs/TESTNET_EVIDENCE.md dates that run 15 August 2026.
Use itedit
The helper scripts need Bash 4 or later, are tested on Linux and macOS, and should be run with bash explicitly.
- For the visual flow in Basecamp, run
bash scripts/start-basecamp.sh --reset-localnet --clean-user-dir. - To run the full command-line lifecycle with real proofs, run
bash scripts/e2e.sh ci-localnet. - The two package files,
distributionx-client.lgxandDistributionX-ui.lgx, can also be downloaded from the v0.1.0 release.
Build itedit
bash scripts/package.shbuilds and verifies both Logos package files and a SHA256SUMS file.bash scripts/ci-local.sh quickruns fast checks, andbash scripts/ci-local.sh allruns the full local CI suite.
Releasesedit
- Latest tag: v0.1.0, 14 August 2026. The README links a v0.1.0 release page.
- Version in metadata.json: 0.1.0, for both the Basecamp app (distributionx) and the core module (distributionx_client).
See alsoedit
Sourcesedit
- dist-x README, GitHub, last commit 7 September 2026
- basecamp-app/metadata.json, GitHub
- distributionx_client_module/metadata.json, GitHub
- docs/TESTNET_EVIDENCE.md, GitHub
- releases, GitHub