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

T

Hanzo AI 7bd8c1e597 chore: kill fuji — no Avalanche/Fuji terminology

Per canonical rule: Lux is its own thing, fuji isn't ours. Sweep
removes positive references to the Avalanche testnet name from
comments, function names, test fixtures, and example data. Where
defensive code rejects non-Lux HRPs (lux/genesis), the test input
swapped from 'P-fuji1...' to 'P-avax1...' so the rejection behavior
still proves out without naming fuji as a thing.

Build clean.

2026-05-29 23:29:11 -07:00

.github/workflows

chore: bump Go toolchain to 1.26.3 (#3 )

2026-05-16 16:43:14 -07:00

builder

chore: brand-neutral cleanup — remove cross-tenant references

2026-05-25 15:13:09 -07:00

cmd

chore: kill fuji — no Avalanche/Fuji terminology

2026-05-29 23:29:11 -07:00

configs

fix(genesis): canonical 0x prefix on all devnet alloc keys + fail-loud bootstrap-l2 (#72 ) (#5 )

2026-05-29 20:02:37 -07:00

docs

canonical: drop SubnetEVMTimestamp alias — single evmTimestamp field

2026-05-05 21:30:08 -07:00

pkg/genesis

chore: kill fuji — no Avalanche/Fuji terminology

2026-05-29 23:29:11 -07:00

scripts

JSON tags: ethAddr → evmAddr (chain-model name, paired with utxoAddr)

2026-05-22 20:10:48 -07:00

.gitignore

chore(genesis): kill subnet — rename to chainID across genesis tool surface (#6 )

2026-05-29 21:07:57 -07:00

CHANGELOG.md

genesis: HD branch hardening + LIGHT_MNEMONIC production refusal (F12/F30/F31/F35)

2026-05-10 17:19:38 -07:00

go.mod

fix(genesis): canonical 0x prefix on all devnet alloc keys + fail-loud bootstrap-l2 (#72 ) (#5 )

2026-05-29 20:02:37 -07:00

go.sum

fix(genesis): canonical 0x prefix on all devnet alloc keys + fail-loud bootstrap-l2 (#72 ) (#5 )

2026-05-29 20:02:37 -07:00

LICENSE

genesis: regenerate all network configs

2026-04-04 11:22:32 -07:00

LICENSING.md

docs: add LICENSING.md pointing at canonical Lux IP strategy

2026-05-15 16:35:26 -07:00

LLM.md

consume crypto/keccak256 (was crypto/keccak) — bump crypto v1.19.14

2026-05-23 16:21:45 -07:00

Makefile

genesis: regenerate all network configs

2026-04-04 11:22:32 -07:00

README.md

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

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

README.md

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