LPsLux Proposals
Governance & Impact
All Proposals
LP-99

LP Numbering Scheme and Chain Organization

Final

Canonical governance anchor defining LP numbering, status semantics, and normative classification

Type
Meta
Created
2025-01-15
coremetagovernance
Edit on GitHub

LP-134 canonical naming (2025-12-15): This LP predates the M-Chain / F-Chain split. Per LP-134 (Lux Chain Topology), MPC ceremonies for bridge custody of external wallets (BTC, ETH, SOL, etc.) now run on M-Chain (CGGMP21, FROST, Pulsar-general). FHE compute and TFHE bootstrap-key generation run on F-Chain. The name "T-Chain" is removed entirely — teleport / cross-chain messaging is B-Chain (bridgevm, LP-6000). Where this LP says "T-Chain MPC" / "T-Chain threshold" / "T-Chain FHE" / "T-Chain custody", read it as M-Chain (for MPC) or F-Chain (for FHE).

2026-05-18 unified-4xxx-for-crypto consolidation: All cryptographic-primitive specifications now live in the 4xxx range with family sub-ranges (4100 classical curves, 4200 classical sigs, 4300 classical hashes, 4400 PQ lattice sigs, 4500 PQ hash sigs, 4600 PQ KEM, 4700 threshold + MPC primitives, 4800 ZK/STARK/SNARK, 4900 hybrid envelopes + cert profiles). The 4xxx range is now the single canonical home for cryptography. See NUMBER-PLAN-2026-05-18.md and CRYPTO-MIGRATION-2026-05-18.md for sub-range tables and the migration map.

2026-05-18 chain-letter IA lock: The top-level numeric ranges are now assigned per the chain-letter scheme: A-Chain → 5xxx, B-Chain → 6xxx, M-Chain → 7xxx, F-Chain → 8xxx, Z-Chain → 8xxx (paired with F-Chain as privacy chains), D (DeFi) → 9xxx, C-Chain identity → 1xxx + Solidity contracts → 3xxx, P/Q/X chain identity → 1xxx, 4xxx = ALL crypto primitives (classical + PQ + ZK + threshold + FHE + hybrid + cert profiles). F-Chain (the chain) moved from LP-7200 → LP-8200 under this lock; 7xxx is now M-Chain / MPC topology only. The chain hierarchy diagram and hard rules live in CHAIN-IA-2026-05-18.md (single source of truth for "which chain lives where").

LP-0099: LP Numbering Scheme (Canonical)

Abstract

This LP is the canonical governance anchor for all Lux Proposals. It defines:

  1. Reserved number ranges (hard rules)
  2. Status semantics (enforceable)
  3. Normative vs non-normative classification
  4. Decision rules for LP placement

Anything outside its designated range is invalid and MUST be renumbered.

Motivation

Problems Solved

ProblemSolution
Numbering driftReserved ranges with hard boundaries
Category bleedDomain-first, not chain-first organization
Lifecycle confusionStrict status semantics
Mixed normative/researchExplicit classification

Design Principles

  1. Domain-first: Group by semantic domain, not chain identity
  2. Normative separation: Standards vs research vs guides
  3. Machine-navigable: Predictable ranges for tooling
  4. Protocol-enforceable: Clear rules, no ambiguity

Specification

🔒 Reserved Ranges (Hard Rules — chain-letter IA, 2026-05-18)

RangePurposeChain-letterStatus Allowed
0–99Constitutional / Meta / governance / process—Final only
100–999Core Protocols (consensus, validators, epochs)—Draft, Final
1000–1999Chain identity + base chain specs (P, X, C, Q identity)P/Q/X/C-idDraft, Final
2000–2999DAO / Governance / ESG / community—Draft, Final, Research
3000–3999C-Chain Solidity / Tokens / LRC contractsC (contracts)Draft, Final
4000–4999ALL crypto primitives (classical + PQ + ZK + threshold + FHE + hybrid + cert profiles)—Draft, Final
5000–5999A-Chain / AIVM — AI execution / attestation / TEEADraft, Final
6000–6999B-Chain — Bridge / cross-chain / warp / teleportBDraft, Final
7000–7999M-Chain — MPC topology / threshold custody chain behavior (NOT primitives)MDraft, Final
8000–8999F-Chain (FHE) + Z-Chain (privacy ZK) + ZK-rollup chain specsF / ZDraft, Final
9000–9999D-Chain — DeFi / DEX / lending / perps / marketsDDraft, Final
10000–19999Learning Paths—Research only
50000–59999Research Indexes—Research only

Rule: LPs outside their designated range are INVALID.

Hard chain-letter rules (2026-05-18 IA lock — see CHAIN-IA-2026-05-18.md):

  1. One chain letter = one numeric range. A→5xxx, B→6xxx, M→7xxx, F→8xxx (with Z), Z→8xxx (with F), D→9xxx. No bleed.
  2. Primitives vs chains are decoupled. FHE primitives live in 4xxx; F-Chain (the chain using FHE) lives in 8xxx. Threshold primitives live in 4xxx; M-Chain (the chain using MPC) lives in 7xxx. ZK primitives live in 4xxx; Z-Chain (the chain using ZK) lives in 8xxx.
  3. C-Chain is special-cased. Identity is 1xxx (chain spec); Solidity / tokens / LRC contracts are 3xxx.
  4. P / Q / X chain identity all live in 1xxx alongside C-Chain identity (these are foundational chain specs, not chain-letter assignments under the new scheme).
  5. All crypto primitives stay in 4xxx, no exceptions. The 4xxx range is the single canonical home for classical + PQ + ZK + threshold + FHE + hybrid + cert profiles.

Status Semantics (Strict)

Each LP MUST declare exactly one status:

StatusMeaningBinding?
DraftActively evolvingNo
FinalNormative standardYes
SupersededReplaced, read-onlyNo
ResearchInformational onlyNever

Hard Rules:

  • Learning Paths (10000+) can NEVER be Final
  • Research Indexes (50000+) can NEVER be Final
  • Only ranges 0–9999 can reach Final status

Range Details

0–99: Constitutional / Meta

Purpose: What Lux IS — network identity, LP process, governance.

Sub-rangePurpose
0–9Core architecture, tokenomics
10–49Developer tools, SDKs
50–89Wallet, key management, security
90–99Meta (this document), indexes

Status: Final only. These are foundational.

100–999: Core Protocols

Purpose: HOW Lux operates — consensus, validators, epochs.

Sub-rangePurpose
100–199Consensus protocols (Quasar, Photon, Flare)
200–299Validator coordination
300–399Epoch management
400–599(Reserved)
600–799Protocol extensions
800–999(Reserved)

Rule: Core protocol changes require reference implementation.

1000–1999: Chain Specifications

Purpose: Chain-specific core specs (P, X, C identity).

Sub-rangePurpose
1000–1099P-Chain (Platform)
1100–1199X-Chain (Exchange)
1200–1299C-Chain (Contract)
1300–1399(Reserved for future chains)
1400–1999Chain extensions

Rule: One chain = one sub-range. No mixing.

2000–2999: DAO, Governance & ESG

Purpose: On-chain governance, DAOs, treasury, and sustainability (non-normative).

Sub-rangePurpose
2000–2099DAO platforms
2100–2199Voting systems
2200–2299Treasury management
2300–2799(Reserved)
2800–2849DAO governance (Azorius, voting)
2850–2899Fund management indexes
2900–2989ESG framework (carbon, green compute)
2990–2999ESG impact & measurement

Rule: Governance and ESG are domain specs. Token standards go in 3xxx.

3000–3999: Solidity, Tokens & Web3

Purpose: Token standards (LRC-20/721/1155), Solidity contracts, Web3 interfaces.

Sub-rangePurpose
3000–3019Token index, standards overview
3020–3069LRC-20 (fungible tokens)
3070–3099Token extensions (staking, media)
3100–3154Account abstraction, multisig
3155–3199LRC-1155 (multi-token)
3200–3399Contract patterns, security
3400–3499Precompiles (curves, crypto)
3500–3599Signature precompiles
3600–3699Messaging precompiles
3700–3720Teleport, bridged assets
3721–3799LRC-721 (NFTs)
3800–3999Web3 extensions

Rule: All Solidity/token/Web3 standards go in 3xxx.

4000–4999: All Cryptography (unified-crypto range, 2026-05-18)

Purpose: ALL crypto primitives — classical + PQ + ZK + threshold

  • FHE + hybrid + cert profiles. Single canonical home; chain-topology specs that use these primitives live in their chain-letter ranges (M→7xxx, F/Z→8xxx).
Sub-rangeFamily
4000–4099Cross-cuts (suite umbrella, agility framework, hybrid policy)
4100–4199Classical curves (BLS12-381, BN254, secp256k1, secp256r1, BabyJubJub)
4200–4299Classical signatures (Ed25519, sr25519, ECDSA, Schnorr, multisig wallets)
4300–4399Classical hashes (SHA-2, SHA-3/Keccak, BLAKE2b/3, RIPEMD160, Poseidon)
4400–4499PQ lattice signatures (ML-DSA, Pulsar, Corona, Falcon, threshold lattice)
4500–4599PQ hash signatures (SLH-DSA, Magnetar, Lamport, XMSS, LMS)
4600–4699PQ KEM (ML-KEM, HQC, Classic McEliece, BIKE)
4700–4799Threshold + MPC primitives (FROST suite, CGGMP21, DKG, LSS)
4800–4899ZK / STARK / SNARK (P3Q, Groth16, PLONK, Halo2, KZG, IPA)
4900–4999Hybrid envelopes + cert profiles (Aurora, Polaris, X-Wing, X-Wing+)

Rule: One algorithm = one LP. All crypto primitives in 4xxx — no exceptions. FHE primitives are 4xxx; the FHE chain is LP-8200.

5000–5999: A-Chain — AI / AIVM / Attestation

Purpose: A-Chain AI execution, AIVM, AI compute, TEE, attestation. The A of the chain-letter IA.

Sub-rangePurpose
5000–5099A-Chain core / AIVM
5100–5199AI integration (LLM gateway)
5200–5299AI mining
5300–5399TEE (legacy T-Chain FHE tombstones land here; FHE chain is LP-8200)
5400–5499Confidential compute
5500–5599GPU acceleration
5600–5699Training ledger
5700–5999(Reserved)

6000–6999: B-Chain — Bridges & Interop

Purpose: Cross-chain messaging, bridges.

Sub-rangePurpose
6000–6099B-Chain core
6100–6199Teleport protocol
6200–6299Warp messaging
6300–6399Asset registry
6400–6499Security framework
6500–6699Bridge SDK
6700–6999(Reserved)

7000–7999: M-Chain — MPC Topology / Custody Chain Behavior

Purpose: M-Chain spec, MPC ceremonies, bridge custody as chain behavior (not primitives). MPC math primitives live in 4xxx (4700-4799).

Sub-rangePurpose
7000–7099T-Chain supersession stubs (T-Chain → M-Chain/F-Chain migration map at 7050)
7100–7199M-Chain spec / MPC ceremony chain behavior
7200–7299(Reserved — legacy F-Chain slot at 7200 is now SUPERSEDED → LP-8200; do not reuse for new specs)
7300–7399Custody / vault chain behavior
7400–7499KMS integration (operational)
7500–7599MPC bridges (chain-level)
7600–7699MPC swaps (chain-level)
7700–7999(Reserved)

Rule: MPC as chain/network = 7xxx. MPC math primitives = 4xxx (4700-4799). F-Chain (FHE chain) is NOT here — it moved to LP-8200.

8000–8999: F-Chain (FHE) + Z-Chain (ZK / Privacy) + ZK-Rollups

Purpose: Privacy / encrypted-execution chain specs. Both F-Chain (FHE chain) and Z-Chain (privacy ZK chain) share this range because both are privacy/encrypted-execution chains; their primitives still live in 4xxx.

Sub-rangePurpose
8000–8099Z-Chain core (LP-8000)
8100–8199Z-Chain encrypted execution interfaces (LP-8045 lives here)
8200–8299F-Chain core (LP-8200 F-Chain FHE bootstrap-keys + encrypted EVM)
8300–8399(Reserved)
8400–8499Encrypted execution / Z↔F bridges
8500–8599L2 / ZK-rollup chain specs
8600–8699FHE chain accelerators (chain-level)
8700–8999(Reserved)

Hard Rule: ZK/FHE primitives live in 4xxx only. ZK/FHE chains live here (8xxx). No bleed across these boundaries.

9000–9999: D-Chain — DeFi / Markets

Purpose: D-Chain — DEX, AMM, lending, perps, trading infrastructure. The D of the chain-letter IA.

Sub-rangePurpose
9000–9049DEX core
9050–9099Oracles
9100–9199DeFi protocols (AMM, lending)
9200–9299Operations, risk
9300–9399DeFi precompiles
9400–9499Perpetuals, derivatives
9500–9599HFT venues
9600–9699Market making
9700–9799CEX integration
9800–9899MEV
9900–9999(Reserved)

Rule: Latency, throughput, market microstructure = 9xxx.

10000–19999: Learning Paths

Purpose: Educational guides (NON-NORMATIVE).

Sub-rangeMirrors
10000–10099Indexes, paths
10100–19999Topic-specific guides

Status: Research only. NEVER Final.

50000+: Research Indexes

Purpose: Non-binding references and research papers.

RangePurpose
50000–59999Research papers

Status: Research only. NEVER Final.

Decision Rules (chain-letter IA, 2026-05-18)

If your spec is about...RangeChain-letterCan be Final?
Network identity, LP process0–99—Yes (must be)
Consensus, validators, epochs100–999—Yes
P / X / C / Q chain identity1000–1999—Yes
DAO, governance, ESG2000–2999—Yes
C-Chain Solidity / tokens / LRC contracts3000–3999C (contracts)Yes
All crypto primitives (incl. FHE/ZK/threshold)4000–4999—Yes
A-Chain — AI / AIVM / attestation / TEE5000–5999AYes
B-Chain — bridges / warp / teleport6000–6999BYes
M-Chain — MPC topology / custody chain behavior7000–7999MYes
F-Chain (FHE) + Z-Chain (privacy ZK) chain specs8000–8999F / ZYes
D-Chain — DeFi / DEX / lending / perps / markets9000–9999DYes
Learning guides10000–19999—No
Research, indexes50000+—No

Validation Rules (LP-lint)

# LP-lint rules (machine-enforceable)
rules:
  range_check:
    - "LP 0-99 MUST have status: Final"
    - "LP 10000+ MUST have status: Draft"
    - "LP 50000+ MUST have status: Draft"
    - "LP outside defined range is INVALID"
  
  status_check:
    - "status MUST be one of: Draft, Final, Superseded, Research"
    - "Research LPs cannot reference normative behavior"
  
  content_check:
    - "Final LPs MUST have reference implementation OR test vectors"
    - "Superseded LPs MUST reference replacement LP"
    - "No duplicate LP numbers allowed"

Migration History

v5.2 (Current, 2026-05-18)

  • Chain-letter IA lock — A=5xxx, B=6xxx, M=7xxx, F=8xxx, Z=8xxx, D=9xxx
  • F-Chain (the chain) moved LP-7200 → LP-8200 (joins Z-Chain in 8xxx)
  • LP-5331 (legacy T-Chain FHE Implementation Guide) tombstoned → LP-8200
  • 4xxx unified as the single canonical home for ALL crypto primitives (classical + PQ + ZK + threshold + FHE + hybrid + cert profiles)
  • 7xxx restricted to M-Chain / MPC topology only (NOT primitives)
  • See CHAIN-IA-2026-05-18.md and NUMBER-PLAN-2026-05-18.md

v5.1

  • DAO (71xxx) → 2800-2849
  • ESG (72xxx) → 2900-2999
  • Removed 70000-79999 range

v5.0

  • Applied canonical renumbering
  • ESG, DeFi, tokens moved to proper ranges
  • See docs/LP-RENUMBERING-DIFF.md

Backwards Compatibility

  • Legacy LP numbers remain valid references
  • Superseded LPs redirect to new numbers
  • Old URLs 301-redirect to canonical locations

Security Considerations

This is a meta/organizational proposal. No direct security impact.

Indirect impact: Clear LP organization prevents:

  • Normative confusion (implementing research as spec)
  • Scope creep (mixing domains)
  • Governance attacks (hiding changes in wrong categories)

Copyright and related rights waived via CC0.

LP-2804: DAO Account Abstraction

Previous Page

LP-10: Brand Sovereignty and Federation Discove...

Next Page

On this page

AbstractMotivationProblems SolvedDesign PrinciplesSpecification🔒 Reserved Ranges (Hard Rules — chain-letter IA, 2026-05-18)Status Semantics (Strict)Range Details0–99: Constitutional / Meta100–999: Core Protocols1000–1999: Chain Specifications2000–2999: DAO, Governance & ESG3000–3999: Solidity, Tokens & Web34000–4999: All Cryptography (unified-crypto range, 2026-05-18)5000–5999: A-Chain — AI / AIVM / Attestation6000–6999: B-Chain — Bridges & Interop7000–7999: M-Chain — MPC Topology / Custody Chain Behavior8000–8999: F-Chain (FHE) + Z-Chain (ZK / Privacy) + ZK-Rollups9000–9999: D-Chain — DeFi / Markets10000–19999: Learning Paths50000+: Research IndexesDecision Rules (chain-letter IA, 2026-05-18)Validation Rules (LP-lint)Migration Historyv5.2 (Current, 2026-05-18)v5.1v5.0Backwards CompatibilitySecurity ConsiderationsCopyright