DistributionX: Difference between revisions

From Local Area Network
Newer edit →
New tool page, source-checked against the project README
 
Second check: fixes to facts, dates (UTC), glosses and attribution
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 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, 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.


== What it does ==
== What it does ==
* It lets a distributor fund an allowlist without publishing recipient addresses.
* It lets a distributor fund an allowlist without publishing recipient addresses.
* The distributor creates an eligibility list and an encrypted claim bundle.
* The distributor creates an eligibility list and an encrypted claim bundle.
* The LEZ program stores a Merkle root and funds the distribution vault.
* 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 <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.
* The program pays the recipient and records a nullifier in one transaction. A nullifier is 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.
* The README says the public state records the payout and the nullifier. The README says the private membership witness, the hidden data that proves a row is on the list, does not appear in the public transaction. 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. The version in metadata.json is 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 and are tested on Linux and macOS. The README asks for them to 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 29:


== 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 45:
* [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}}

Revision as of 21:00, 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 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, 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.

What it does

  • It lets a distributor fund an 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.
  • Each recipient proves one eligible row and submits a claim_ppe transaction through LEZ privacy-preserving execution.
  • The program pays the recipient and records a nullifier in one transaction. A nullifier is a one-time tag that stops the same row being claimed twice without saying whose row it is.
  • The README says the public state records the payout and the nullifier. The README says the private membership witness, the hidden data that proves a row is on the list, does not appear in the public transaction. 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. docs/TESTNET_EVIDENCE.md dates that run 15 August 2026.

Use it

The helper scripts need Bash 4 or later and are tested on Linux and macOS. The README asks for them to 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=808"