DistributionX: Difference between revisions

From Local Area Network
New tool page, source-checked against the project README
 
Plainer prose: fewer quotes, project claims attributed, glosses folded in
 
(One intermediate revision by the same user not shown)
Line 10: Line 10:
| verified_against = README and commit of 7 September 2026
| verified_against = README and commit of 7 September 2026
}}
}}
'''DistributionX''' is a tool for paying out to an allowlist without publishing recipient addresses, and it runs on the Logos Execution Zone (LEZ) with a Basecamp app and a Logos core module. The code is published by the GitHub account Timidan. The README does not say whether it is an official Logos project.
'''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 ==
== What it does ==
* It lets a distributor fund an allowlist without publishing recipient addresses.
* A distributor creates an eligibility list and an encrypted claim bundle, then funds the allowlist without publishing recipient addresses.
* The distributor creates an eligibility list and an encrypted claim bundle.
* The LEZ program stores a Merkle root, one hash that stands for the whole list, and funds the distribution vault.
* The LEZ program stores a Merkle root and funds the distribution vault.
* Each recipient proves one eligible row and submits a <code>claim_ppe</code> transaction through LEZ privacy-preserving execution.
* Each recipient proves one eligible row and submits a <code>claim_ppe</code> transaction through LEZ privacy-preserving execution.
* The program pays the recipient and records a nullifier in one transaction.
* 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.
* The public state records the payout and nullifier, not the private membership witness. The README notes that the distributor still knows the original eligibility list.
* 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. The version in metadata.json is 0.1.0, and the README reports a verified run on the LEZ public testnet.
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. <code>docs/TESTNET_EVIDENCE.md</code> dates that run 15 August 2026.


== Use it ==
== Use it ==
The helper scripts need Bash 4 or later on Linux or macOS. Run them with <code>bash</code>, not <code>/bin/sh</code>.
The helper scripts need Bash 4 or later, are tested on Linux and macOS, and should be run with <code>bash</code> explicitly.
# For the visual flow in Basecamp, run <code>bash scripts/start-basecamp.sh --reset-localnet --clean-user-dir</code>.
# For the visual flow in Basecamp, run <code>bash scripts/start-basecamp.sh --reset-localnet --clean-user-dir</code>.
# To run the full command-line lifecycle with real proofs, run <code>bash scripts/e2e.sh ci-localnet</code>.
# To run the full command-line lifecycle with real proofs, run <code>bash scripts/e2e.sh ci-localnet</code>.
Line 29: Line 28:


== Build it ==
== Build it ==
* Run <code>bash scripts/package.sh</code> to build and verify both Logos package files and a SHA256SUMS file.
* <code>bash scripts/package.sh</code> builds and verifies both Logos package files and a SHA256SUMS file.
* Run <code>bash scripts/ci-local.sh quick</code> for fast checks, or <code>bash scripts/ci-local.sh all</code> for the full local CI suite.
* <code>bash scripts/ci-local.sh quick</code> runs fast checks, and <code>bash scripts/ci-local.sh all</code> runs the full local CI suite.


== Releases ==
== Releases ==
Line 45: Line 44:
* [https://github.com/Timidan/dist-x/blob/master/basecamp-app/metadata.json basecamp-app/metadata.json], GitHub
* [https://github.com/Timidan/dist-x/blob/master/basecamp-app/metadata.json basecamp-app/metadata.json], GitHub
* [https://github.com/Timidan/dist-x/blob/master/distributionx_client_module/metadata.json distributionx_client_module/metadata.json], GitHub
* [https://github.com/Timidan/dist-x/blob/master/distributionx_client_module/metadata.json distributionx_client_module/metadata.json], GitHub
* [https://github.com/Timidan/dist-x/blob/master/docs/TESTNET_EVIDENCE.md docs/TESTNET_EVIDENCE.md], GitHub
* [https://github.com/Timidan/dist-x/releases releases], GitHub


{{Page status|Stub}}
{{Page status|Stub}}

Latest revision as of 23:26, 4 November 2026

DistributionX
What it does: Private allowlist distributions for the Logos Execution Zone
Stage: Prototype
Licence: MIT or Apache-2.0
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

Sources

Page status: Stub. Stub · Outline · Usable · Guide · Star. Anyone can improve this page and change its status.
Retrieved from "https://alienware-1.tailb5c716.ts.net/index.php?title=DistributionX&oldid=846"