Contributing to Lux Proposals

Help shape the future of the Lux Network by submitting proposals, reviewing drafts, and participating in discussions.

Quick Start

1

Discuss Your Idea

Before writing a formal proposal, discuss your idea on the forum to gather feedback and gauge community interest. This helps refine your proposal before investing time in a full write-up.

Visit Forum
2

Create Your Draft

Fork the repository and use the interactive wizard or template to create a properly formatted LP with all required sections.

# Clone and create new LP
git clone https://github.com/luxfi/lps
cd lps
make new
3

Submit Pull Request

Submit your draft as a PR. The PR number becomes your LP number. Rename your file accordingly and address editor feedback.

# Validate and submit
make pre-pr
git add LPs/lp-draft.md
git commit -m "LP: Your proposal title"
git push origin your-branch
4

Progress Through Stages

Your LP will progress through stages: Draft → Review → Last Call → Final. Address feedback, build consensus, and watch your proposal become a standard.

LP Structure

Required Frontmatter

---
lp: <number>
title: <descriptive title>
description: <one-line description>
author: <Name (@github-username)>
discussions-to: <URL to discussion>
status: Draft|Review|Last Call|Final|Withdrawn
type: Standards Track|Meta|Informational
category: Core|Networking|Interface|LRC|Bridge
created: <YYYY-MM-DD>
---

Required Sections

  • • Abstract (~200 words)
  • • Motivation
  • • Specification
  • • Rationale
  • • Backwards Compatibility
  • • Security Considerations
  • • Copyright (BSD 3-Clause)

For Standards Track

  • • Test Cases (required)
  • • Reference Implementation (recommended)
  • • 2+ independent implementations for Final

Status Progression

Draft
Review
Last Call (14 days)
Final

Draft

Initial stage for new proposals. Authors can make significant changes based on feedback. Not yet ready for implementation.

Review

Proposal is mature and seeking broader community feedback. Only minor changes expected at this stage.

Last Call

Final review period (14 days). Last chance to raise concerns before the proposal becomes Final.

Final

Accepted standard. No further changes except errata corrections. Ready for implementation across the network.

Useful Commands

make new

Create a new LP using interactive wizard

make validate FILE=LPs/lp-N.md

Validate a specific LP

make validate-all

Validate all LP files

make check-links

Check all links in documents

make update-index

Update the README index

make stats

Show LP statistics

make list

List all LPs with titles

make pre-pr

Run all pre-PR checks