mirror of https://github.com/luxfi/crypto.git synced 2026-10-30 16:59:13 +00:00

Files

T

zeekay 16ae3e2a24 rust: add per-crate READMEs and PUBLISHING runbook for crates.io

All 23 lux-crypto-* crates now have:
- README.md with algorithm description, build instructions
  (CRYPTO_DIR / CRYPTO_BUILD_DIR), source attribution
- workspace-inherited authors/homepage/repository/documentation
- crates.io-ready metadata (description, keywords, categories)

cargo publish --dry-run --no-verify passes for all 23 crates.

PUBLISHING.md documents the publish runbook: license decision required
before upload, cargo login flow, name reservation order, dry-run sweep,
ordered upload, native-archive dependency (Option C documented), docs.rs
follow-up, versioning policy, source attribution table.

This prepares the crates for a human with a crates.io token to run the
real cargo publish step. No upload happens automatically -- the LICENSE
decision (BSD-3-Clause vs Lux Ecosystem License) must be confirmed first.

2025-12-28 03:19:14 -08:00

833 B

Raw Permalink Blame History

lux-crypto-banderwagon

Canonical Rust binding for Banderwagon, the prime-order subgroup of the Bandersnatch curve used in Verkle commitments.

Wraps the C-ABI exposed by luxcpp/crypto/banderwagon.

Algorithm

Banderwagon -- prime-order subgroup of Bandersnatch (twisted Edwards over BLS12-381 scalar)
Used as the base group for Pedersen / IPA / Verkle

Build

Set CRYPTO_DIR (install prefix) or CRYPTO_BUILD_DIR (cmake build dir) so the build script can find libbanderwagon_cpu.a.

git clone https://github.com/luxfi/crypto
cd crypto && cmake -S . -B build-cto && cmake --build build-cto
export CRYPTO_BUILD_DIR=$(pwd)/build-cto
cargo build -p lux-crypto-banderwagon

Attribution

Curve constants derived from the public Banderwagon SRS.

License

See LICENSE at the repository root.

833 B Raw Permalink Blame History