Files
zeekayandHanzo Dev 2d2eb972a8 Publish under the org, not a person
Bylines, paper authorship, correspondence addresses and the founder blurb under
each post named an individual. They name the organisation that published the
work instead: the brand on posts and pages, the research byline on papers, and
research@ in place of a personal address. Both are what these repositories
already used elsewhere — nothing new was coined.

Co-authors are untouched. Where a paper named someone else alongside, they stay
named; only the one byline changed. Bibliography entries, running heads,
PDF metadata and affiliations move with it, so a citation still resolves to
whoever the cited paper names.

Sample and fixture data uses the placeholder name these tests already use
elsewhere, so no assertion changed meaning.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-01 08:56:24 -07:00
..
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-09-01 08:56:24 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00
2026-04-01 15:52:56 -07:00

Lux Exchange (LX) - HyperLiquid Feature Parity Implementation

Overview

This repository contains the implementation plan and code to achieve feature parity between Lux Exchange (LX) and HyperLiquid DEX. The implementation covers both the decentralized exchange (X-Chain DEX) and centralized exchange (LX Pro) components.

Current Implementation Status

✅ Completed

  • Comprehensive feature parity implementation plan
  • Smart contract architecture for order book (OrderBook.sol)
  • Perpetual futures contract implementation (PerpetualMarket.sol)
  • High-performance matching engine in Go (matching_engine.go)
  • Documentation and technical specifications

🚧 In Progress

  • Frontend interface for trading
  • WebSocket implementation for real-time data
  • Oracle integration for price feeds
  • Liquidation engine optimization
  • Cross-margin account system

❌ Not Started

  • Mobile applications (iOS/Android)
  • Advanced order types (TWAP, Iceberg)
  • Copy trading functionality
  • Market maker incentive program
  • Security audits

Key Features to Implement

1. Core Trading Features

  • Spot Trading: Token-to-token swaps with limit and market orders
  • Perpetual Futures: Up to 50x leverage with funding rates
  • Order Types: Market, Limit, Stop-Loss, Take-Profit, Trailing Stop
  • Cross-Margin: Portfolio-based margin calculation

2. Performance Requirements

  • Throughput: 100,000+ orders per second
  • Latency: <10ms order placement, <1ms matching
  • Settlement: Near-instant for spot, epoch-based for derivatives

3. Risk Management

  • Liquidation Engine: Automatic position liquidation
  • Insurance Fund: Protection against bankruptcy
  • ADL (Auto-Deleveraging): Cascade liquidation prevention
  • Circuit Breakers: Extreme volatility protection

Project Structure

lux/
├── contracts/           # Smart contracts
│   └── exchange/
│       ├── OrderBook.sol
│       ├── PerpetualMarket.sol
│       ├── CrossMargin.sol
│       └── ...
├── services/           # Backend services
│   ├── matching/       # Order matching engine
│   ├── risk/          # Risk management
│   ├── settlement/    # Settlement service
│   └── market-data/   # Price feeds and data
├── exchange/          # Frontend application
│   ├── src/
│   ├── public/
│   └── package.json
└── docs/              # Documentation
    ├── HYPERLIQUID_FEATURE_PARITY_PLAN.md
    └── XCHAIN_VAULT_ARCHITECTURE.md

Getting Started

Prerequisites

  • Node.js v18+
  • Go 1.21+
  • Solidity 0.8.20+
  • Docker & Docker Compose

Installation

  1. Clone the repository
git clone https://github.com/luxfi/lux
cd lux
  1. Install dependencies
# Smart contracts
cd contracts
npm install

# Backend services
cd ../services
go mod download

# Frontend
cd ../exchange
npm install
  1. Configure environment
cp .env.example .env
# Edit .env with your configuration
  1. Deploy contracts (testnet)
cd contracts
npx hardhat deploy --network lux-testnet
  1. Start services
# Start matching engine
cd services/matching
go run .

# Start frontend
cd exchange
npm start

Development Roadmap

Phase 1: Core Infrastructure (Weeks 1-4)

  • Order book smart contracts
  • Basic matching engine
  • Spot trading implementation
  • Basic frontend interface

Phase 2: Perpetual Futures (Weeks 5-8)

  • Perpetual contract system
  • Funding rate mechanism
  • Liquidation engine
  • Mark price calculation

Phase 3: Advanced Features (Weeks 9-12)

  • Cross-margin accounts
  • Oracle integration
  • Advanced order types
  • Risk management system

Phase 4: Optimization (Weeks 13-16)

  • Gas optimization
  • Latency reduction
  • Scalability improvements
  • Load testing

Phase 5: Production Ready (Weeks 17-20)

  • Security audits
  • Bug bounty program
  • Liquidity bootstrapping
  • Mainnet deployment

Technical Architecture

X-Chain (DEX)

  • Consensus: Multi-consensus with X-Chain for exchange operations
  • Smart Contracts: Solidity-based order book and perpetuals
  • Settlement: On-chain settlement with cross-chain bridges
  • Oracle: Chainlink and Pyth Network price feeds

LX Pro (CEX)

  • Matching Engine: High-performance Go implementation
  • Database: PostgreSQL for orders, Redis for caching
  • API: REST and WebSocket for real-time data
  • Infrastructure: Kubernetes deployment with auto-scaling

API Documentation

REST Endpoints

POST   /api/v1/orders       - Place order
GET    /api/v1/orders       - Get open orders
DELETE /api/v1/orders/:id   - Cancel order
GET    /api/v1/positions    - Get positions
GET    /api/v1/account      - Account information
GET    /api/v1/markets      - Market data

WebSocket Streams

// Subscribe to order book
ws.send({ op: "subscribe", channel: "orderbook", market: "BTC-USD" })

// Subscribe to trades
ws.send({ op: "subscribe", channel: "trades", market: "ETH-USD" })

// Subscribe to account updates
ws.send({ op: "subscribe", channel: "account" })

Testing

Unit Tests

# Smart contracts
cd contracts
npx hardhat test

# Backend services
cd services
go test ./...

# Frontend
cd exchange
npm test

Integration Tests

# Run full integration test suite
make test-integration

Load Testing

# Run load tests
make test-load

Security

Smart Contract Security

  • Multi-sig admin controls
  • Timelock for critical functions
  • Emergency pause mechanism
  • Formal verification

CEX Security

  • Cold/hot wallet separation
  • HSM for key management
  • DDoS protection
  • Rate limiting

Audit Status

  • CertiK audit (planned)
  • Trail of Bits audit (planned)
  • OpenZeppelin audit (planned)

Contributing

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

Resources

Documentation

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact


Note: This is an active development project. Features and specifications are subject to change. Please refer to the latest documentation for current implementation status.