DistributionX

DistributionX

What it does: Private allowlist distributions for the Logos Execution Zone

Stage: Prototype

Licence: MIT or Apache-2.0

Build · Use · Code · User reviews

Verified on 4 November 2026 against README and commit of 7 September 2026.

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 does

• 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_ppe transaction 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 it

The helper scripts need Bash 4 or later, are tested on Linux and macOS, and should be run with bash explicitly.

1. For the visual flow in Basecamp, run bash scripts/start-basecamp.sh --reset-localnet --clean-user-dir.
2. To run the full command-line lifecycle with real proofs, run bash scripts/e2e.sh ci-localnet.
3. The two package files, distributionx-client.lgx and DistributionX-ui.lgx, can also be downloaded from the v0.1.0 release.

Build it

• bash scripts/package.sh builds and verifies both Logos package files and a SHA256SUMS file.
• bash scripts/ci-local.sh quick runs fast checks, and bash scripts/ci-local.sh all runs the full local CI suite.

Releases

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

• Basecamp
• Tools
• Logos Blockchain

Sources

• 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

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