mirror of https://github.com/luxfi/consensus.git synced 2026-09-24 00:26:58 +00:00

Files

T

zeekay 7825c427e5 feat(config): CertPolicy record (LP-217) and drop LUX_ env prefix

- Introduce config/cert_policy.go: single CertPolicy record (Mode +
  Variant + TimeoutMs + Fallback) collapses three knobs from LP-217 /
  LP-202 / LP-204 into one operator-facing struct. Validated at chain
  genesis; refuses launch when invalid. Distinct from PQMode enum
  (pq_mode.go) — CertPolicy is the deployment knob, PQMode is the
  protocol-level identifier.
- Add config/cert_policy_test.go and config/bench_cert_policy_test.go
  covering validation matrix + fallback-tier degradation contract.
- PQModeFromEnv: drop legacy LUX_CONSENSUS_PQ_MODE fallback per the
  "one canonical, unprefixed name" directive. CONSENSUS_PQ_MODE is the
  only honoured env var.
- engine/pq/consensus.go: minor follow-up wiring.
- paper/* + PQ-GPU-AUDIT.md + README.md: align prose with CertPolicy
  framing and unprefixed env names.

2026-06-04 17:04:32 -07:00

sections

feat(config): CertPolicy record (LP-217) and drop LUX_ env prefix

2026-06-04 17:04:32 -07:00

.gitignore

feat: Implement Nova/Nebula/Quasar consensus with Ray/Field engines

2025-08-23 00:08:03 -05:00

main.tex

docs: add all 12 protocol pages + formal verification to consensus docs

2026-03-25 18:07:12 -07:00

README.md

feat: Implement Nova/Nebula/Quasar consensus with Ray/Field engines

2025-08-23 00:08:03 -05:00

references.bib

feat: Implement Nova/Nebula/Quasar consensus with Ray/Field engines

2025-08-23 00:08:03 -05:00

README.md

Lux Consensus White Paper

This directory contains the LaTeX source for the Lux Consensus white paper.

Structure

main.tex - Main LaTeX document that includes all sections
sections/ - Individual section files for easier management:
- abstract.tex - Paper abstract
- introduction.tex - Introduction and motivation
- background.tex - Background and related work
- protocol-design.tex - Core protocol design and algorithms
- analysis.tex - Mathematical analysis and security guarantees
- implementation.tex - Implementation considerations and deployment
- conclusion.tex - Conclusion and future work
references.bib - BibTeX bibliography file
figures/ - Directory for figures and diagrams (currently empty)

Building the Paper

Prerequisites

You need a LaTeX distribution installed:

macOS:

brew install --cask mactex

Ubuntu/Debian:

sudo apt-get install texlive-full

Other systems: Install TeXLive or MiKTeX

Build Commands

Using Make (recommended):

# Build the PDF
make paper

# Clean build artifacts
make paper-clean

# Watch for changes and rebuild automatically
make paper-watch

Manual build:

cd paper
pdflatex main.tex
bibtex main
pdflatex main.tex
pdflatex main.tex

The final PDF will be generated as paper/main.pdf.

Editing Guidelines

Each section is in its own file for easier collaboration
Use standard LaTeX formatting and BibTeX for references
Add new figures to the figures/ directory
Update references.bib for new citations
Follow academic paper conventions for structure and tone

Physics Metaphors

The paper extensively uses physics and astrophysics metaphors to explain the consensus protocol:

Photon - Basic voting messages/interactions
Wave - Threshold voting with interference patterns
Focus - Confidence accumulation (like laser focusing)
Prism - Conflict set separation
Nova - Linear chain finality (stellar explosion)
Nebula - DAG consensus (star formation)
Quasar - Post-quantum security overlay (cosmic beacons)

These metaphors are not just pedagogical—they guide the actual protocol design and implementation.

Contributing

When contributing to the paper:

Edit the appropriate section file in sections/
Add new references to references.bib
Test the build with make paper
Ensure all citations work properly

The modular structure allows multiple authors to work on different sections simultaneously without conflicts.