mirror of https://github.com/luxfi/genesis.git synced 2026-07-27 05:54:08 +00:00

Files

T

Hanzo AI a4b05b40f5 genesis: shard-driven primary chain set (X opt-in like C/Q/Z)

Make every primary-network chain (X/C/D/Q/A/B/T/Z/G/K) opt-in via its
own <x>chain.json shard. Absent shard -> empty ConfigOutput field ->
builder skips the CreateChainTx -> daemon doesn't start that chain.

Lux mainnet/testnet/devnet ship full chain set as shards; localnet and
local ship the same canonical X asset shard. P-only sovereign L1 boot
shape (<tenant> etc.) is achieved by shipping pchain.json+network.json
only — no env knob, no special builder branch.

X-Chain genesis was previously hardcoded inside FromConfig as a literal
{Symbol:"LUX",Name:"Lux",Denomination:9}. Now sourced from xchain.json
shard, which keeps the same canonical asset for Lux but lets a sibling
network (lqd / <tenant>) ship its own descriptor or ship none and
boot a P-only primary network.

builder.FromConfig:
  - HRP hoisted above the X-Chain conditional (used on both branches).
  - X-Chain construction gated on config.XChainGenesis != "".
  - Returns ids.Empty for xAssetID when X is absent.
  - Single chainEntries table replaces the per-chain switch and the
    DefaultChainGenesis stub-data fallback.
  - "platform" alias renamed to "protocol" (PChainAliases / VMAliases /
    Aliases output) — value is "P-Chain", served by ProtocolVM.

configs.loadAllChainShards / readAllChainShards:
  - Single dispatch over primaryChainShardFiles in canonical order
    (X,C,D,Q,A,B,T,Z,G,K). Adding a new primary chain is one entry +
    one slot, not a new env knob and not a new builder branch.

pkg/genesis/types.go:
  - ConfigOutput.XChainGenesis (omitempty) added; threaded through
    Config <-> ConfigOutput conversions.

Tests:
  - builder/builder_test.go: TestFromConfig_ChainSetIsShardDriven pins
    the contract — full mainnet emits 10 chains + non-empty xAssetID;
    same config with all chain shards stripped emits 0 chains + empty
    xAssetID, validators + UTXOs intact.
  - configs/chain_shards_test.go: TestGetGenesis_XChainShardPresent...
    asserts every Lux network embeds the canonical {LUX,Lux,9} asset;
    AbsentShardEmptyOptIn extended to cover xChainGenesis.

2026-05-14 12:32:53 -07:00

4.3 KiB

Raw Blame History

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)
│   ├── pchain.json    # P-Chain genesis (ProtocolVM)
│   ├── 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
├── devnet/            # LUX Devnet (Chain ID: 96370) - Fast iteration network
│   └── 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
LUX Devnet	96370	96370	Fast iteration dev network
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)

Devnet (96370)

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

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

# 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

4.3 KiB Raw Blame History