LP Specifications

Lux Proposals (LPs) - Technical specifications for the Lux ecosystem

Lux Proposals (LPs)

Lux Proposals (LPs) are the formal specification mechanism for all technical standards, protocols, and features in the Lux ecosystem. Each LP goes through a rigorous review process before implementation.

LP Repository

LP Categories

CategoryRangeDescriptionCount
NetworkLP-0001 - LP-0099Core network protocols, testing, dev tools6
ConsensusLP-0100 - LP-0199Consensus mechanisms, DAG, finality4
BridgeLP-0300 - LP-0399, LP-6000sCross-chain, MPC, teleport8
CryptoLP-4000 - LP-4999Post-quantum, signatures, key management5
WarpLP-5000 - LP-5999Cross-chain messaging, signatures4
DeFiLP-8000 - LP-8999Lending, margin, protocols6
DEXLP-9000 - LP-9099Exchange core, orderbook, matching8
GovernanceLP-G-xxxProposal process, voting3

LP Lifecycle

┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│    Draft    │────>│   Review    │────>│  Accepted   │────>│    Final    │
│             │     │             │     │             │     │             │
│  Author     │     │  Community  │     │  Core Team  │     │  Immutable  │
│  writes LP  │     │  feedback   │     │  approval   │     │  Reference  │
└─────────────┘     └─────────────┘     └─────────────┘     └─────────────┘
       │                   │                   │
       v                   v                   v
   Withdrawn          Rejected           Superseded

Status Definitions

StatusDescription
DraftLP is under active development by author
ReviewLP is open for community review and feedback
AcceptedLP has been accepted by core team
FinalLP is finalized and implementation-ready
ImplementedLP has been fully implemented in production
SupersededLP has been replaced by a newer LP
WithdrawnLP has been withdrawn by author
RejectedLP was rejected during review

How to Propose an LP

1. Start a Discussion

Before writing a formal LP, start a discussion:

# Go to GitHub Discussions
https://github.com/luxfi/LPs/discussions/new?category=ideas

2. Write the LP

Use the LP template:

---
lp: <number>
title: <LP title>
author: <name> (@github-handle)
status: Draft
created: <YYYY-MM-DD>
requires: <LP numbers (optional)>
---

## Abstract
One paragraph summary.

## Motivation
Why is this LP needed?

## Specification
Technical specification (MUST be precise).

## Rationale
Design decisions and alternatives considered.

## Backwards Compatibility
Any breaking changes.

## Test Cases
Required test scenarios.

## Reference Implementation
Link to implementation (required for Final).

## Security Considerations
Security implications.

## Copyright
CC0 1.0 Universal

3. Submit Pull Request

# Fork and clone
git clone https://github.com/YOUR_USERNAME/LPs
cd LPs

# Create LP file
cp template.md LPs/lp-XXXX-your-title.md
# Edit your LP

# Submit PR
git add .
git commit -m "LP-XXXX: Your Title"
git push origin main
# Open PR on GitHub

4. Review Process

  1. Editor Review (1-2 days): Format and completeness check
  2. Community Review (2 weeks): Open discussion period
  3. Core Team Review (1 week): Technical review
  4. Final Call (1 week): Last chance for objections
  5. Merge: LP becomes Final

Implementation Status Overview

Fully Implemented

LPTitleRepositoryVersion
LP-9000DEX Coreluxfi/dexv1.0.0
LP-9001Trading Engineluxfi/dexv1.0.0
LP-9002DEX APIluxfi/dexv1.0.0
LP-0111Photon Consensusluxfi/consensusv1.22.0
LP-4099Quasar PQluxfi/cryptov0.5.0

In Development

LPTitleRepositoryProgress
LP-333Signer Rotationluxfi/node80%
LP-6000B-Chainluxfi/node70%
LP-9050Margin Tradingluxfi/dex60%

Planned

LPTitleTarget
LP-9100Options TradingQ2 2025
LP-9110Perpetuals v2Q3 2025
LP-6020Teleport v2Q2 2025

For Traders

For Developers

For Validators

For Researchers