Lux Docs
Crypto

Lux Crypto

Cryptographic primitives including post-quantum signatures, BLS, and key encapsulation

Lux Crypto (github.com/luxfi/crypto) is the core cryptographic library for the Lux blockchain, implementing classical, post-quantum, and threshold cryptographic primitives.

Algorithm Overview

PackageAlgorithmSecurityQuantum SafeUse Case
bls/BLS12-381128-bitNoConsensus aggregation
secp256k1/ECDSA128-bitNoEthereum-compatible signing
secp256r1/P-256 ECDSA128-bitNoRIP-7212 verification
mldsa/ML-DSA-65 (FIPS 204)192-bitYesPost-quantum signatures
mlkem/ML-KEM-768 (FIPS 203)192-bitYesKey encapsulation
slhdsa/SLH-DSA (FIPS 205)128-bitYesHash-based signatures
lamport/Lamport OTS256-bitYesOne-time signatures
ring/LSAG / LatticeVariesLattice variantAnonymous signing

Consensus Cryptography (Quasar)

Lux consensus uses a hybrid BLS + Ringtail signing scheme:

Classical Layer:   BLS12-381 (aggregatable, 1-round)
                          +
Post-Quantum Layer: Ringtail (lattice threshold, 2-round)
PackageRoleNotes
signer/Hybrid BLS + RingtailProduction consensus signing
bls/Classical aggregatable signaturesFast single-round aggregation

Key Packages

  • hash/ -- SHA-256, SHA-512, BLAKE2b, Keccak-256, SHAKE
  • ecies/ -- Hybrid encryption (ECDH + AES-GCM)
  • kzg4844/ -- KZG polynomial commitments (EIP-4844)
  • ipa/ -- Inner product arguments (Verkle trees)
  • cb58/ -- Base58Check encoding for Lux addresses
  • rlp/ -- Recursive Length Prefix encoding
  • gpu/ -- GPU-accelerated ZK operations (Metal/CUDA)

Quick Start

go get github.com/luxfi/crypto

# Run tests
make test

# Benchmarks
make bench

On this page