mirror of
https://github.com/luxfi/docs.git
synced 2026-09-24 00:25:32 +00:00
zeekay
e41ef79c47
Bring the user-facing docs in line with the released, semver-tagged post-quantum consensus + confidential-compute architecture, cross-checked against the actual code/tags. Consensus finality (consensus v1.26.0): - Quasar finality is the typed compact-certificate envelope (ConsensusCert), not the old "triple consensus" model. Four evidence kinds (Beam BLS / Pulsar M-LWE / Corona R-LWE / P3Q rollup), orthogonal LegKind x EvidenceMode axes, KeyEra (one group key per era, value-not-place), and the four operator postures (BLS_FAST / HYBRID_PQ_CHECKPOINT / STRICT_QUASAR / RECOVERY_MODE). - Fix the flat error that Pulsar is Ring-LWE: Pulsar is Module-LWE (FIPS-204 ML-DSA, luxfi/pulsar); Corona is Ring-LWE (Ringtail, luxfi/corona). - O(1) compaction (one group sig regardless of committee size). - Correct PQ precompile slots (0x012202/03/04/05) and stale go.mod pins (crypto v1.19.26, pulsar v1.1.5, corona v0.7.9). New page confidential-compute.mdx (+ nav): the luxfi/cc attestation verifier (one Verifier, orthogonal Kinds). Honest vendor matrix: AMD SEV-SNP and NVIDIA nvtrust are production; Intel TDX is a tracked stub. Custody (TEE) vs confidential-AI (NVIDIA GPU) use cases. Decomplect (architecture.mdx, wallet/security.mdx): dealerless PQ-threshold core + optional luxfi/mpc (CGGMP21/FROST) and luxfi/tee custody extensions; the core depends on neither. HSM (hsm/index.mdx, reference/lux-hsm.mdx): document all 16 registered backends (cloud KMS, PKCS#11/KMIP/YubiHSM/Nitrokey, hardware-wallet secure elements, air-gap, ML-DSA PQ, TR-31), the FIPS subset, and the cgo-gated backends. Bridge multi-vendor MPC (mpc/bridge.mdx): layered external-custodian cosigning (Utila/Fireblocks) as an optional institutional feature over native MPC; secrets via KMS; permissionless bridge runs on native MPC alone.
Lux Network Documentation
Official documentation for Lux Network - Post-quantum secure blockchain infrastructure.
Built with @hanzo/docs - the documentation framework by Hanzo AI.
Getting Started
# Install dependencies
pnpm install
# Start development server
pnpm dev
# Build for production
pnpm build
Documentation Structure
content/
└── docs/
├── index.mdx # Welcome page
├── learn/ # Learning resources
│ ├── introduction/ # Introduction to Lux
│ ├── architecture/ # Architecture deep-dive
│ └── consensus/ # Consensus mechanisms
├── build/ # Developer guides
│ ├── quickstart/ # Quick start guide
│ ├── sdk/ # SDK documentation
│ └── contracts/ # Smart contract development
├── nodes/ # Node operation
│ ├── run/ # Running a node
│ ├── validators/ # Validator setup
│ └── staking/ # Staking guide
└── reference/ # API reference
├── api/ # REST/RPC API
└── cli/ # CLI reference
Contributing
- Fork the repository
- Create your feature branch
- Add or modify documentation in
content/docs/ - Submit a pull request
License
MIT © Lux Network
Part of the Hanzo Docs ecosystem.