Skip to content

Security: luxfi/node

SECURITY.md

Security

Reporting Vulnerabilities

Report security issues to security@lux.network. Do not open public issues for vulnerabilities.

  • Provide a description, reproduction steps, and affected components.
  • We will acknowledge receipt within 48 hours.
  • We will provide an initial assessment within 7 business days.
  • We coordinate disclosure timelines with the reporter.

If the vulnerability affects production funds or consensus safety, we treat it as P0 and begin remediation immediately.

Cryptographic Primitives

Production implementations live in lux/crypto/ and lux/lattice/. Formal verification proofs for each primitive are in lux/papers/proofs/.

Signatures

PrimitiveStandardImplementationUse
BLS12-381draft-irtf-cfrg-bls-signaturecrypto/bls/Validator consensus, warp message aggregation
ECDSA secp256k1SEC 2crypto/secp256k1/EVM transaction signing, C-Chain
ECDSA secp256r1FIPS 186-5crypto/secp256r1/WebAuthn, hardware key support
ML-DSA-65FIPS 204crypto/mldsa/Post-quantum validator identity
SLH-DSAFIPS 205crypto/slhdsa/Hash-based PQ fallback signatures
Falcon-512/1024NIST Round 3crypto/pq/EVM precompile PQ signatures (ETHFALCON)
CoronaInternallux/lattice/Lattice-based threshold signatures for anonymous validator participation

Key Encapsulation

PrimitiveStandardImplementationUse
ML-KEM-768FIPS 203crypto/mlkem/Post-quantum key exchange, encrypted P2P handshake
HPKERFC 9180crypto/hpke/Hybrid public key encryption

Symmetric and AEAD

PrimitiveStandardImplementationUse
ChaCha20-Poly1305RFC 8439crypto/aead/Authenticated encryption for P2P transport
AES-256-GCMNIST SP 800-38Dcrypto/aead/Alternative AEAD for hardware-accelerated paths

Key Derivation and Hashing

PrimitiveStandardImplementationUse
Argon2idRFC 9106crypto/kdf/Password hashing, key stretching
HKDF-SHA256RFC 5869crypto/kdf/Key derivation from shared secrets
Keccak-256FIPS 202crypto/keccak.goEVM address derivation, state hashing
BLAKE2bRFC 7693crypto/blake2b/Non-EVM hashing, content addressing
Poseidon2ZK-friendlycrypto/hash/Zero-knowledge circuit hashing (Z-Chain)

Threshold and MPC

PrimitiveProtocolImplementationUse
FROSTKomlo-Goldberg 2020crypto/threshold/Threshold Schnorr signatures for bridge custody
CGGMP21Canetti et al. 2021crypto/cggmp21/Threshold ECDSA for multi-chain custody
LSSShamir + live resharingcrypto/secret/Dynamic secret sharing with participant rotation

Fully Homomorphic Encryption

PrimitiveSchemeImplementationUse
TFHETorus FHEcrypto/ + precompilesEncrypted smart contract computation
CKKSApproximate arithmeticcrypto/Privacy-preserving ML inference

Network Security

P2P Transport

  • All peer connections use mutual TLS 1.3.
  • Post-quantum handshake option via ML-KEM-768 + X25519 hybrid key exchange (crypto/kem/).
  • Peer identity bound to staking key (BLS public key for validators, secp256k1 for API nodes).
  • Eclipse resistance via peer discovery protocol with formal proof (papers/proofs/proof-network-peer-discovery.tex).

Consensus Transport

  • ZAP binary wire protocol (papers/lux-zap-wire-protocol.tex) for consensus messages.
  • Zero-allocation serialization path -- no GC pressure under load.
  • Warp messaging for cross-chain: BLS aggregate signatures verified on-chain (papers/lux-warp-messaging.tex).

Validator Security

  • Zero-trust validator architecture (papers/lux-zero-trust-validators.tex).
  • HSM boundary design for validator keys (papers/lux-hsm-boundary.tex).
  • Hybrid certificate chains with PQ trust anchors (papers/lux-hybrid-certificates.tex).
  • Reproducible builds with content-addressed attestation (papers/lux-reproducible-builds.tex).

Key Management

Validator Keys

  • BLS signing keys stored in HSM (PKCS#11) or secure enclave where available.
  • Threshold key generation via DKG -- no single party holds the full key.
  • Key rotation via live secret resharing (LSS protocol) without chain downtime.

HD Wallets

  • BIP-32/44 hierarchical deterministic derivation.
  • secp256k1 and secp256r1 key paths.
  • Hardware wallet integration (Ledger, Trezor) for end-user keys.

MPC Custody (M-Chain)

  • FROST t-of-n for Schnorr/Taproot custody.
  • CGGMP21 t-of-n for ECDSA custody (Ethereum, Bitcoin legacy).
  • Session lifecycle management with NATS transport.
  • Formal proofs: papers/proofs/proof-crypto-frost.tex, papers/proofs/proof-crypto-cggmp21.tex.

Bridge Custody

  • Teleport bridge uses MPC group keys -- no single custodian.
  • Per-chain governance: each chain's bridge parameters are sovereign.
  • Configurable key rotation delay.
  • Formal proof: papers/proofs/proof-bridge-teleport.tex.

Audit History

Round 1 -- December 2025 (Component Audits)

3 targeted audits covering DexVM, oracle protocol, and perpetuals contracts:

ReportScope
audits/2025-12-11-dexvm-audit.mdDEX VM code review
audits/2025-12-11-oracle-audit.mdOracle and price feed implementation
audits/2025-12-11-perpetuals-audit.mdPerpetuals and derivatives contracts

Round 2 -- December 2025 (Full Ecosystem)

12 component audits covering the entire node implementation. Compiled from commit 66d514d2b7.

ReportScope
audits/2025-12-30-architecture-review.mdFull architecture review
audits/2025-12-30-consensus-audit.mdConsensus layer (Quasar, including Nova linear and Nebula DAG modes)
audits/2025-12-30-contracts-audit.mdSmart contract security
audits/2025-12-30-crypto-audit.mdCryptography stack (BLS, PQ, MPC)
audits/2025-12-30-database-audit.mdStorage layer
audits/2025-12-30-dexvm-audit.mdDexVM (D-Chain)
audits/2025-12-30-network-audit.mdNetwork layer and P2P
audits/2025-12-30-oracle-protocol-audit.mdOracle and attestation protocol
audits/2025-12-30-other-vms-audit.mdSecondary VMs
audits/2025-12-30-platformvm-audit.mdPlatformVM (P-Chain)
audits/2025-12-30-proposervm-evm-audit.mdProposerVM and EVM integration
audits/2025-12-30-mpcvm-audit.mdThresholdVM (T-Chain)
audits/2025-12-30-warp-audit.mdWarp cross-chain messaging
audits/2025-12-30-zkvm-audit.mdZKVM (Z-Chain)

Summary report: security/2025-12-30-final-security-analysis.md Status report: security/2025-12-30-FINAL-STATUS.md

164 total findings (17 critical, 42 high, 58 medium, 47 low). Identified development placeholders (XOR stubs, length-only verification) in advanced features not yet in production. Core chains (P-Chain, X-Chain, C-Chain) passed clean.

Round 3 -- January/March 2026 (Smart Contracts)

Two focused audits on the Solidity contract stack:

ReportScope
audits/standard-2026-01-30/@luxfi/standard contract suite -- 832 tests, 105 fuzz tests
audits/2026-03-25-comprehensive-security-audit.mdlux/standard v1.6.5, lux/liquid v1.1.0, liquidity/contracts

The March 2026 comprehensive audit used red/blue adversarial methodology with Foundry, Slither, Semgrep, Aderyn, Halmos (symbolic execution), and Lean 4 (theorem proving).

Results: 15 critical, 13 high, 10 medium, 3 low -- all remediated. 1,383 tests passing. 48 Halmos symbolic proofs + 33 Lean 4 theorems + 33 Foundry invariant tests.

Post-remediation risk: LOW. CI enforces Slither (fail-on: medium), Semgrep, Aderyn, and forge fmt on every push to main.

Current Status

All critical and high findings from the contract audits are resolved. The December 2025 node audit identified development stubs in post-quantum and zero-knowledge subsystems that are not deployed to production; these are tracked and being replaced with real implementations as each subsystem matures.

Formal Verification

50 mechanized proofs in papers/proofs/, covering:

  • Consensus: safety, liveness, BFT thresholds, finality composition, validator economics
  • Cryptography: BLS aggregation, FROST unforgeability, CGGMP21 UC-security, ML-DSA, ML-KEM, SLH-DSA, Corona, TFHE, CKKS, Verkle commitments, hybrid signatures, threshold composition, linear secret sharing
  • DeFi: AMM invariants, order book correctness, flash loan safety, router correctness, governance, fee models
  • Bridge: Teleport protocol, warp message security/delivery/ordering
  • Network: peer discovery and eclipse resistance
  • Build: reproducibility, attestation, coeffect algebra, cross-ecosystem verification
  • Trust: authority lattice, vouch model, revocation

See papers/INDEX.md for the full list.

Bug Bounty

If you discover a vulnerability, contact security@lux.network. We will work with you on responsible disclosure and appropriate recognition.


Lux Industries -- security@lux.network

There aren't any published security advisories