mirror of
https://github.com/luxfi/crypto.git
synced 2026-07-27 01:54:50 +00:00
Hanzo AI
30366a421f
One Rust crate per algorithm, plus an `lux-crypto` umbrella that re-exports
each per-algorithm crate behind a Cargo feature.
5 working crates with verified spec vectors:
- lux-crypto-keccak (Ethereum keccak256)
- lux-crypto-secp256k1 (ecrecover precompile + batch)
- lux-crypto-sha256 (FIPS 180-4)
- lux-crypto-ripemd160 (Bitcoin/Ethereum address derivation)
- lux-crypto-blake2b (RFC 7693)
15 wired-but-NOTIMPL crates (canonical Rust binding shipped, body returns
CRYPTO_ERR_NOTIMPL today; spec-vector tests gated `#[ignore]` with FIXME):
blake3, ed25519, slhdsa, mldsa, mlkem, bls, kzg, bn254, aead, ipa,
pedersen, lamport, ntt, poly-mul, evm256.
cargo check --release --workspace --all-features OK
cargo test --release --workspace 55 pass / 0 fail / 25 ignored
cargo doc --no-deps --workspace clean
cargo publish --dry-run --no-verify OK for all 20 leaf crates
Workspace docs added at rust/{README,PUBLISHING,RUST_CRATE_STATUS}.md.
Per-crate README.md and `Cargo.toml` metadata (description, license,
repository, keywords, categories, readme) wired for crates.io publish.
Build directives normalized: link both `lib<alg>.a` (C-ABI shim) and
`lib<alg>_cpu.a` (CPU body); brand-neutral C symbols (no lux_ prefix) per
the prefix-uniform audit.
lux-crypto
Umbrella crate over the per-algorithm Lux crypto bindings.
Re-exports each lux-crypto-<alg> crate behind a Cargo feature so a single
dependency line can pull in exactly the surface a consumer needs.
Use
[dependencies]
# Default set: keccak, secp256k1, sha256, ripemd160
lux-crypto = "0.1"
# Or pick specific algorithms:
lux-crypto = { version = "0.1", default-features = false, features = ["keccak", "secp256k1"] }
# Or include every working algorithm (default + blake2b):
lux-crypto = { version = "0.1", default-features = false, features = ["working"] }
# Or pull in every per-algorithm crate (including NOTIMPL stubs):
lux-crypto = { version = "0.1", default-features = false, features = ["all"] }
use lux_crypto::keccak;
let digest = keccak::hash(b"abc");
Algorithm status
| Crate | Feature | Status |
|---|---|---|
lux-crypto-keccak |
keccak |
wired, vectors verified |
lux-crypto-secp256k1 |
secp256k1 |
wired, vectors verified |
lux-crypto-sha256 |
sha256 |
wired, vectors verified |
lux-crypto-ripemd160 |
ripemd160 |
wired, vectors verified |
lux-crypto-blake2b |
blake2b |
wired, vectors verified |
lux-crypto-blake3 |
blake3 |
binding shipped, C-ABI NOTIMPL |
lux-crypto-ed25519 |
ed25519 |
binding shipped, C-ABI NOTIMPL |
lux-crypto-slhdsa |
slhdsa |
binding shipped, C-ABI NOTIMPL |
lux-crypto-mldsa |
mldsa |
binding shipped, C-ABI NOTIMPL |
lux-crypto-mlkem |
mlkem |
binding shipped, C-ABI NOTIMPL |
lux-crypto-bls |
bls |
binding shipped, C-ABI NOTIMPL |
lux-crypto-kzg |
kzg |
binding shipped, C-ABI NOTIMPL |
lux-crypto-bn254 |
bn254 |
binding shipped, C-ABI NOTIMPL |
lux-crypto-aead |
aead |
binding shipped, C-ABI NOTIMPL |
lux-crypto-ipa |
ipa |
binding shipped, C-ABI NOTIMPL |
lux-crypto-pedersen |
pedersen |
binding shipped, C-ABI NOTIMPL |
lux-crypto-lamport |
lamport |
binding shipped, C-ABI NOTIMPL |
lux-crypto-ntt |
ntt |
binding shipped, C-ABI NOTIMPL |
lux-crypto-poly-mul |
poly-mul |
binding shipped, C-ABI NOTIMPL |
lux-crypto-evm256 |
evm256 |
binding shipped, C-ABI NOTIMPL |
Build environment
Each per-algorithm crate links statically against libcrypto/<alg>.a (and
the corresponding <alg>_cpu.a body). The build script discovers the static
archives in this order:
CRYPTO_DIR— install prefix; archives at$CRYPTO_DIR/lib/<alg>/.CRYPTO_BUILD_DIR— cmake build dir; archives at$CRYPTO_BUILD_DIR/<alg>/.- Default fallback to
../../../../luxcpp/crypto/build-cto/.
CRYPTO_BUILD_DIR=/path/to/luxcpp/crypto/build-cto cargo build --release
License
Apache-2.0 OR MIT (workspace inherits BSD-3-Clause; see workspace Cargo.toml).
Source
C-ABI canonical: luxcpp/crypto/c-abi/lux_crypto.h.