2026-06-28 20:36:29 -07:00
|
|
|
<p align="center"><img src=".github/hero.svg" alt="genesis" width="880"></p>
|
|
|
|
|
|
2026-04-04 09:18:58 -07:00
|
|
|
# Lux Network Genesis Configurations
|
|
|
|
|
|
|
|
|
|
This repository contains the canonical genesis configurations for all Lux networks.
|
|
|
|
|
|
|
|
|
|
## Directory Structure
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
genesis/
|
|
|
|
|
├── mainnet/ # LUX Mainnet (Chain ID: 96369)
|
|
|
|
|
│ ├── cchain.json # C-Chain genesis (EVM compatible)
|
2026-05-14 12:32:53 -07:00
|
|
|
│ ├── pchain.json # P-Chain genesis (ProtocolVM)
|
2026-04-04 09:18:58 -07:00
|
|
|
│ ├── xchain.json # X-Chain genesis (Exchange chain)
|
|
|
|
|
│ ├── network.json # Network configuration
|
|
|
|
|
│ └── genesis.json # Full network genesis
|
|
|
|
|
├── testnet/ # LUX Testnet (Chain ID: 96368)
|
|
|
|
|
│ ├── cchain.json # C-Chain genesis (EVM compatible)
|
|
|
|
|
│ └── genesis.json # Full testnet genesis
|
2026-06-23 13:59:49 -07:00
|
|
|
├── devnet/ # LUX Devnet (Chain ID: 96367) - Fast iteration network
|
2026-04-04 09:18:58 -07:00
|
|
|
│ └── cchain.json # C-Chain genesis (EVM compatible)
|
|
|
|
|
├── local/ # Local development network (Chain ID: 1337)
|
|
|
|
|
│ ├── cchain.json # C-Chain genesis (EVM compatible)
|
|
|
|
|
│ └── genesis.json # Local network genesis
|
|
|
|
|
├── bootstrappers.json # Network bootstrapper nodes
|
|
|
|
|
└── checkpoints.json # Network checkpoints
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Mainnet C-Chain Genesis
|
|
|
|
|
|
|
|
|
|
The mainnet C-Chain was initialized with a single genesis allocation:
|
|
|
|
|
|
|
|
|
|
| Address | Balance |
|
|
|
|
|
|---------|---------|
|
|
|
|
|
| `0x9011e888251ab053b7bd1cdb598db4f9ded94714` | 2,000,000,000,000,000,000,000,000,000,000 wei (2T LUX) |
|
|
|
|
|
|
|
|
|
|
### Key Parameters
|
|
|
|
|
|
|
|
|
|
- **Chain ID**: 96369
|
|
|
|
|
- **Gas Limit**: 30,000,000 (0x1C9C380)
|
|
|
|
|
- **Min Base Fee**: 25 gwei
|
|
|
|
|
- **Block Rate**: 2 seconds
|
|
|
|
|
|
|
|
|
|
## Network IDs
|
|
|
|
|
|
|
|
|
|
| Network | Chain ID | Network ID | Purpose |
|
|
|
|
|
|---------|----------|------------|---------|
|
|
|
|
|
| LUX Mainnet | 96369 | 96369 | Production network |
|
|
|
|
|
| LUX Testnet | 96368 | 96368 | Public test network |
|
2026-06-23 13:59:49 -07:00
|
|
|
| LUX Devnet | 96367 | 3 | Fast iteration dev network |
|
2026-04-04 09:18:58 -07:00
|
|
|
| Local | 1337 | 1337 | Local development |
|
|
|
|
|
|
|
|
|
|
## Network Configurations
|
|
|
|
|
|
|
|
|
|
### Mainnet (96369)
|
|
|
|
|
- **Block Rate**: 2 seconds
|
|
|
|
|
- **Gas Limit**: 30M
|
|
|
|
|
- **Min Base Fee**: 25 gwei
|
|
|
|
|
- **Genesis Account**: `0x9011...` with 2T LUX
|
|
|
|
|
|
|
|
|
|
### Testnet (96368)
|
|
|
|
|
- **Block Rate**: 2 seconds
|
|
|
|
|
- **Gas Limit**: 12M
|
|
|
|
|
- **Min Base Fee**: 25 gwei
|
|
|
|
|
- **Genesis Account**: `0x9011...` with 2T LUX (same as mainnet)
|
|
|
|
|
|
2026-06-23 13:59:49 -07:00
|
|
|
### Devnet (96367)
|
2026-04-04 09:18:58 -07:00
|
|
|
- **Block Rate**: 1 second (faster)
|
|
|
|
|
- **Gas Limit**: 20M
|
|
|
|
|
- **Min Base Fee**: 1 gwei (cheaper)
|
|
|
|
|
- **Genesis Account**: `0x9011...` with 2T LUX
|
|
|
|
|
- All upgrades enabled at genesis (Shanghai, Cancun, etc.)
|
|
|
|
|
|
|
|
|
|
### Local (1337)
|
|
|
|
|
- **Block Rate**: 1 second
|
|
|
|
|
- **Gas Limit**: 15M
|
|
|
|
|
- **Min Base Fee**: 1 gwei
|
|
|
|
|
- **Genesis Account**: `0x9011...` with 2T LUX
|
|
|
|
|
- All upgrades enabled at genesis
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
These genesis files are used by:
|
|
|
|
|
- `luxd` node for network initialization
|
|
|
|
|
- `coreth` for C-Chain configuration
|
|
|
|
|
- Block explorers for genesis block verification
|
|
|
|
|
- Migration tools for state reconstruction
|
|
|
|
|
|
|
|
|
|
## RPC Endpoints
|
|
|
|
|
|
|
|
|
|
- **Mainnet**: `http://localhost:9630/ext/bc/C/rpc`
|
|
|
|
|
- **Testnet**: `http://localhost:9630/ext/bc/C/rpc` (testnet node)
|
|
|
|
|
- **Devnet**: `http://localhost:9630/ext/bc/C/rpc` (devnet node)
|
|
|
|
|
|
|
|
|
|
## Genesis Account
|
|
|
|
|
|
|
|
|
|
All networks use the same production genesis account:
|
|
|
|
|
|
|
|
|
|
| Account | Balance | Networks |
|
|
|
|
|
|---------|---------|----------|
|
|
|
|
|
| `0x9011e888251ab053b7bd1cdb598db4f9ded94714` | 2T LUX | All networks |
|
|
|
|
|
|
|
|
|
|
## State Data & RLP Exports
|
|
|
|
|
|
|
|
|
|
Blockchain state exports and RLP-encoded blocks are maintained in a separate repository:
|
|
|
|
|
|
|
|
|
|
**Repository**: [github.com/luxfi/state](https://github.com/luxfi/state)
|
|
|
|
|
|
|
|
|
|
### Available Data
|
|
|
|
|
|
|
|
|
|
| Network | Chain ID | Blocks | RLP Location |
|
|
|
|
|
|---------|----------|--------|--------------|
|
|
|
|
|
| Lux Mainnet | 96369 | 1,082,780 | `rlp/lux-mainnet/lux-mainnet-96369.rlp` |
|
|
|
|
|
| Lux Testnet | 96368 | 219 | `rlp/lux-testnet/lux-testnet-96368.rlp` |
|
|
|
|
|
| Zoo Mainnet | 200200 | 799 | `rlp/zoo-mainnet/zoo-mainnet-200200.rlp` |
|
|
|
|
|
| Zoo Testnet | 200201 | 85 | `rlp/zoo-testnet/zoo-testnet-200201.rlp` |
|
|
|
|
|
|
|
|
|
|
### Import Workflow
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# Clone repos
|
|
|
|
|
git clone https://github.com/luxfi/genesis
|
|
|
|
|
git clone https://github.com/luxfi/state
|
|
|
|
|
|
|
|
|
|
# Initialize with genesis
|
|
|
|
|
geth init --datadir /path/to/db genesis/mainnet/cchain.json
|
|
|
|
|
|
|
|
|
|
# Import blocks from state repo
|
|
|
|
|
geth import --datadir /path/to/db state/rlp/lux-mainnet/lux-mainnet-96369.rlp
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Source Data
|
|
|
|
|
|
|
|
|
|
The state repo also contains:
|
|
|
|
|
- `pebbledb/` - Original SubnetEVM PebbleDB databases
|
|
|
|
|
- `docs/` - State verification and recovery documentation
|
|
|
|
|
- `pkg/` - Go tools for archaeology, bridge, and scanning
|
