Skip to content

luxfi/LPs

BranchesTags

Repository files navigation

Lux Proposals (LPs) 🚀

The governance and standardization framework for the Lux Network

Lux Network is an 8-chain blockchain ecosystem designed for quantum-safe operations, AI integration, and high-performance DeFi.

Documentation License Network Status

🌐 Network Architecture

Lux Network operates an 8-chain architecture with specialized chains for different workloads:

┌───────────────────────────────────────────────────────────────────────────────────────┐
│                                🟢 LUX NETWORK (8-Chain Architecture) 🟢               │
├───────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                       │
│   ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐                │
│   │    P-Chain  │  │    C-Chain  │  │    X-Chain  │  │    Q-Chain  │                │
│   │  Platform   │  │  Contract   │  │  Exchange   │  │   Quantum   │                │
│   │    1xxx     │  │    2xxx     │  │    3xxx     │  │    4xxx     │                │
│   │   🔷🟢      │  │    🟢       │  │    🟢       │  │    🟢       │                │
│   └─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘                │
│                                                                                       │
│   ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐                │
│   │    A-Chain  │  │    B-Chain  │  │    T-Chain  │  │    Z-Chain  │                │
│   │     AI      │  │   Bridge    │  │ Threshold   │  │   ZK Proofs │                │
│   │    5xxx     │  │    6xxx     │  │    7xxx     │  │    8xxx     │                │
│   │    🟢       │  │    🟢       │  │    🟢       │  │    🟢       │                │
│   └─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘                │
│                                                                                       │
│   ┌─────────────────────────────────────────────────────────────────────────────────┐ │
│   │        📡 Warp (Native XCM) • BLS + Ringtail • Sub-second Finality             │ │
│   │                          Platform-level Quantum-Safe                           │ │
│   └─────────────────────────────────────────────────────────────────────────────────┘ │
│                                                                                       │
│   ┌─────────────────────────────────────────────────────────────────────────────────┐ │
│   │      📈 DEX/Finance Suite • Order Book • AMM • Perpetuals • HFT Venues        │ │
│   │                                 9xxx Series                                     │ │
│   └─────────────────────────────────────────────────────────────────────────────────┘ │
│                                                                                       │
│   Legend: 🟢 Active • 🟡 Development • 🔷 Platform • 📡 Cross-Chain                  │
└───────────────────────────────────────────────────────────────────────────────────────┘

🔄 Cross-Chain Communication Stack

┌──────────────────────────────────────────────────────────────────────────────────────┐
│                    🌐 EXTERNAL BLOCKCHAINS (ETH, BTC, Cosmos)                        │
└─────────────────────────────────────┬────────────────────────────────────────────────┘
                                      │
                    Multi-Party Computation Signatures (CGGMP21, FROST)
                                      │
                        ┌─────────────▼─────────────┐
                        │   🌉 TELEPORT BRIDGE     │
                        │    (6xxx Series)         │
                        │   T-Chain ↔ B-Chain      │
                        │   MPC-Based Custody      │
                        └─────────────┬─────────────┘
                                      │
                    Uses Internal Quantum-Safe Primitives
                                      │
                        ┌─────────────▼─────────────┐
                        │    📡 WARP 1.5 (PQ-Safe) │
                        │    BLS + Ringtail        │
                        │    Validator Attestations │
                        │    Sub-second Finality    │
                        └─────────────┬─────────────┘
                                      │
┌─────────────────────────────────────▼────────────────────────────────────────────────┐
│         🟢 P-Chain ↔ C-Chain ↔ X-Chain ↔ Q-Chain ↔ A-Chain ↔ ... (Intra-Lux)        │
│                        Native Cross-Chain Messaging                                  │
└──────────────────────────────────────────────────────────────────────────────────────┘

🚀 Quick Start

📋 Browse Proposals

🎯 Essential LPs

Category Resource Description
Core Architecture LP-0000 Network foundation and community framework
Chain Organization LP-0099 LP numbering scheme and chain organization
Token Standards LRC-20 Fungible token standard (Ethereum-compatible)
NFT Standards LRC-721 Non-fungible token standard
DEX Core LP-9000 Core DEX specification
Quantum Safety LP-4200 Post-quantum cryptography suite

🏗️ Chain Specifications

Chain Series Focus Status
P-Chain 1xxx Platform, Staking, L1s ✅
C-Chain 2xxx EVM Contracts, Token Standards ✅
X-Chain 3xxx Exchange, Asset Transfers ✅
Q-Chain 4xxx Quantum-Safe Operations ✅
A-Chain 5xxx AI/Attestation, TEE ✅
B-Chain 6xxx Cross-Chain Bridges ✅
T-Chain 7xxx MPC, Threshold Signatures ✅
Z-Chain 8xxx Zero-Knowledge Proofs ✅
DEX/Fi 9xxx DeFi Protocols, Trading ✅

🔷 P-Chain — Platform (1xxx Series)

Validator management, staking, chain creation

LP Title Status
1000 Core Platform Specification ✅
1010 Platform Chain Specification ✅
1024 Parallel Validation & Shared Mempool 📝
1033 State Rollup to C-Chain EVM 📝
1034 Superchain L2 (OP Stack) 📝
1181 Epoching & Validator Rotation ✅
1605 Elastic Validator L1s 📝

🟢 C-Chain — Contract/EVM (2xxx Series)

EVM-compatible smart contracts, token standards

LP Title Status
2000 EVM Specification ✅
2001 AIVM - AI Virtual Machine ✅
2012 Contract Chain Specification ✅
2025 L2 to Sovereign L1 Ascension 📝
2026 EVM Equivalence & Core EIPs ✅
2118 EVM Compatibility ✅
2176 Dynamic Gas Pricing ✅
2204 secp256r1 Curve Integration ✅
2226 Dynamic Block Times (Granite) ✅
2320 Dynamic EVM Gas Limit ✅
2327 BadgerDB + Verkle Optimization ✅

🪙 Token Standards

LP Standard Status
2300 LRC-20 Fungible Token ✅
2721 LRC-721 Non-Fungible Token ✅
2155 LRC-1155 Multi-Token ✅
2027 LRC Standards Adoption ✅
2028 LRC-20 Burnable Extension ✅
2029 LRC-20 Mintable Extension ✅
2030 LRC-20 Bridgable Extension ✅
2031 LRC-721 Burnable Extension ✅

🔧 Precompiles & Infrastructure

LP Title Status
2032 Rollup Plugin Architecture 📝
2035 Stage-Sync Pipeline ✅
2076 Random Number Generation ✅
2311 ML-DSA Precompile ✅
2312 SLH-DSA Precompile ✅
2313 Warp Messaging Precompile ✅
2314 Fee Manager Precompile ✅
2326 Regenesis & State Migration ✅
2604 State Sync & Pruning ✅
2606 Verkle Trees ✅

🟢 X-Chain — Exchange (3xxx Series)

High-speed asset transfers, UTXO model, order books Implementation: github.com/luxfi/node/vms/exchangevm

LP Title Status
3000 Exchange Specification ✅
3011 Exchange Chain Specification ✅
3036 Order-Book DEX API & RPC ✅
3037 Native Swap Integration ✅

🟢 Q-Chain — Quantum (4xxx Series)

Post-quantum cryptography, quantum-safe operations Implementation: github.com/luxfi/crypto (FIPS 203-205)

LP Title Status
4000 Quantum Specification ✅
4004 Quantum-Resistant Crypto ✅
4005 Quantum-Safe Wallets ✅
4082 Quantum Resistant Chain ✅
4099 Quasar Consensus Family ✅
4100 NIST PQC Integration ✅
4105 Lamport OTS for Lux Safe ✅
4110 Quasar Consensus Protocol ✅

🔐 Post-Quantum Standards

LP Algorithm Status
4316 ML-DSA (Dilithium) ✅
4317 SLH-DSA (SPHINCS+) ✅
4318 ML-KEM (Kyber) ✅
4200 PQC Suite ✅
4201 Hybrid Transitions ✅
4202 Crypto Agility Framework ✅
4303 Q-Security P-Chain ✅

🟢 A-Chain — AI/Attestation (5xxx Series)

AI compute, attestations, TEE integration Implementation: github.com/luxfi/node/vms/aivm

LP Title Status
5000 AI/Attestation Specification ✅
5075 TEE Integration Standard ✅
5080 Attestation Chain Spec ✅
5101 Solidity GraphQL Extension 📝
5102 Immutable Training Ledger ✅
5106 LLM Gateway (Hanzo AI) ✅
5200 AI Mining Standard 📝
5302 Privacy AI Attestation ✅
5601 AI Compute Gas Pricing ✅
5607 GPU Acceleration ✅

📡 Warp — Native Cross-Chain Messaging (Platform)

Platform-level XCM primitive for intra-Lux messaging. Uses BLS + Ringtail signatures. Implementation: github.com/luxfi/warp

LP Title Status
6603 Warp 1.5 (PQ-Safe) ✅
6602 Warp Protocol (BLS) ✅
2313 Warp EVM Precompile ✅
6022 Warp Native Transfers ✅

🌉 B-Chain — Bridge (6xxx Series)

External bridge for Ethereum, Bitcoin, Cosmos. Uses MPC (CGGMP21, FROST) via T-Chain.

LP Title Status
6000 Bridge Specification ✅
6301 Cross-Chain Bridge Protocol ✅

🌉 Teleport Protocol

LP Title Status
6332 Teleport Architecture ✅
6016 Teleport Protocol ✅
6021 Teleport Implementation ✅
6329 Bridge System Index ✅

🔗 Bridge Infrastructure

LP Title Status
6015 MPC Bridge Protocol ✅
6017 Asset Registry ✅
6018 Message Format ✅
6019 Security Framework ✅
6081 Bridge Chain Spec ✅
6331 BridgeVM Specification ✅
6023 NFT Interchain Transfer 📝
6315 Enhanced Cross-Chain 📝
6335 Smart Contract Integration 📝
6339 Emergency Procedures 📝
6340 Bridge SDK 📝
6341 Secrets Management 📝

🟢 T-Chain — Threshold (7xxx Series)

MPC custody, threshold signatures, key management Implementation: github.com/luxfi/threshold, github.com/luxfi/crypto

LP Title Status
7000 Threshold Specification ✅
7330 ThresholdVM Specification ✅

🔐 Threshold Signatures

LP Protocol Status
7321 FROST Precompile ✅
7322 CGGMP21 ECDSA Precompile ✅
7324 Ringtail Precompile ✅
7104 FROST (EdDSA) ✅

🔑 MPC & Key Management

LP Title Status
7013 MPC Custody & Swap-Sig ✅
7014 CGG21 Threshold Sigs ✅
7083 Threshold Sig Chain ✅
7103 MPC-LSS Resharing ✅
7319 T-Chain MPC Custody ⚠️
7323 LSS-MPC Extension ✅
7325 KMS/HSM Integration ✅
7333 Dynamic Signer Rotation ✅
7334 Per-Asset Key Management ✅
7336 K-Chain KeyManagementVM 📝

🟢 Z-Chain — Zero-Knowledge (8xxx Series)

Privacy, ZK proofs, FHE, confidential transactions Implementation: github.com/luxfi/node/vms/zkvm

LP Title Status
8000 ZKVM Specification ✅
8045 Encrypted Execution Layer ✅
8046 ZKVM Architecture ✅

🕵️ Privacy DeFi

LP Title Status
8400 Private AMM ✅
8401 Confidential Lending 📝
8402 ZK Swap Protocol ✅
8403 Private Staking 📝

🔄 Layer 2 Rollups

LP Title Status
8500 L2 Rollup Framework 📝
8501 Data Availability Layer 📝
8502 Fraud Proof System 📝
8503 Validity Proof System 📝
8504 Sequencer Registry 📝
8505 L2 Block Format 📝

📈 DEX & Finance (9xxx Series)

Trading, DeFi, derivatives, oracle Implementation: github.com/luxfi/exchange, github.com/luxfi/dex

LP Title Status
9000 DEX Core Specification ✅
9099 DEX Series Overview ✅

🏪 Trading Engine

LP Title Status
9001 Trading Engine ✅
9002 API & RPC Specification ✅
9003 High-Performance Protocol ✅
9005 Native Oracle ✅
9006 HFT Trading Venues ✅
9040 Perpetuals & Derivatives ✅

🏛️ Application Standards

LP Title Status
9060 DeFi Protocols Overview ✅
9070 NFT Staking ✅
9071 Media Content NFT ✅
9072 Bridged Asset Standard ✅
9073 Multicall Standard ✅
9074 CREATE2 Factory ✅

⚙️ Core & Meta (0xxx Series)

Architecture, governance, research, developer tools

LP Title Status
0000 Network Architecture ✅
0001 Tokenomics ✅
0002 VM & Execution ✅
0003 Chain Architecture ✅
0099 LP Numbering Scheme ✅

🛠️ Developer Tools

LP Title Status
0006 Network Runner ✅
0007 VM SDK ✅
0008 Plugin Architecture ✅
0009 CLI Tool ✅
0039 Python SDK 📝
0040 Wallet Standards ✅
0042 Multi-Sig Wallet ✅
0050 Dev Tools Overview ✅
0098 GraphDB & GraphQL 📝

📊 Consensus

LP Title Status
0111 Photon Consensus ✅
0112 Flare DAG Finalization ✅

🔍 Research Papers

LP Title Status
0085 Security Audit Framework ✅
0090 Research Papers Index 📝
0091 Payment Processing 📝
0092 Cross-Chain Messaging ✅
0093 Decentralized Identity 📝
0094 Governance Framework 📝
0095 Stablecoin Mechanisms 📝
0096 MEV Protection 📝
0097 Data Availability 📝

📋 Status Legend

Symbol Meaning
✅ Final - Implemented and deployed
📝 Draft - In development or review
⚠️ Superseded - Replaced by newer standards

🔄 LP Process

💡 Idea → 📝 Draft → 🔄 Review → ⏰ Last Call → ✅ Final
  1. Discuss on Lux Forum
  2. Draft using make new
  3. Submit PR (PR# = LP#)
  4. Review by editors
  5. Consensus through community discussion
  6. Last Call (14 days)
  7. Final - Ready for implementation

🛠️ Development Tools

Quick Commands

make new          # Create a new LP
make validate-all # Validate all LPs
make check-links  # Verify links
make stats        # Statistics
make pre-pr       # Run all pre-PR checks

Documentation Commands

cd docs && pnpm install  # Install documentation dependencies
cd docs && pnpm dev      # Run docs locally on http://localhost:3002
cd docs && pnpm build    # Build static documentation site
cd docs && pnpm start    # Run production documentation server

Advanced Commands

make list         # List all LPs
make update-index # Update the LP index in README.md
make decision     # Create an Informational Decision LP draft
make watch        # Watch for changes and auto-validate

🌐 Community & Resources

Forum Documentation Discord Twitter

Contributing

  1. Explore the existing LPs to understand current specifications
  2. Discuss your idea on the Lux Forum
  3. Draft your proposal using make new
  4. Submit a Pull Request to start the formal review process

📄 License & Patents

Specifications: BSD 3-Clause License

Technology Innovation: We are seeking patent protection for the core technologies described in these LPs. See LP-0010: Technology Portfolio for the complete portfolio of 100+ innovations.

Why We Can't Share More: US patent law (since the America Invents Act of 2013) and UK law provide no grace period for prior public disclosure, preventing us from fully open-sourcing certain innovations until patent applications are filed. We believe these laws harm independent inventors but must operate within them.

Commercial Use: Contact oss@lux.network for commercial licensing inquiries.

Open AI Protocol Exception: Automatic license granted for operating nodes on Lux Network and any network built on the Open AI Protocol (PoAI consensus).

🚀 Building the future of decentralized finance, one proposal at a time.

Lux Network - Quantum-Safe, AI-Integrated, High-Performance DeFi

About

Lux Proposals (LPs) - Standards and specifications for the Lux Network

lps.lux.network/

Resources

Readme

License

Unknown, Unknown licenses found

Licenses found

Unknown
LICENSE
Unknown
LICENSE.md

Contributing

Contributing

Security policy

Security policy
Activity
Custom properties

Stars

2 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases

2 tags

Packages

 
 
 

Contributors

Languages