Lux Node - Core Validator Implementation

git clone https://github.com/luxfi/node.git
cd node

# Minimal build (default: ZAP transport, all VMs, stripped ~30MB)
make build

# Or use build profiles:
./scripts/build.sh              # minimal stripped build
./scripts/build.sh -p full      # full build with gRPC+ZAP, all features (~36MB)
./scripts/build.sh -p dev       # development with debug symbols (~40MB)
./scripts/build.sh -p tiny      # UPX compressed (~20MB)
./scripts/build.sh -p core      # P/X/C only, plugin-ready (~25MB)

# Binary is at ./build/luxd

# Mainnet (default)
./build/luxd

# Testnet
./build/luxd --network-id=testnet

# Custom local network
./build/luxd --network-id=custom \
  --staking-enabled=false \
  --http-host=0.0.0.0 \
  --http-port=9660

# Or use Makefile targets
make run-mainnet    # Network ID 96369
make run-testnet    # Network ID 96368

# Node info
curl -X POST http://localhost:9630/ext/info \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"info.getNodeID"}'

# Health check
curl -X POST http://localhost:9630/ext/health \
  -d '{"jsonrpc":"2.0","id":1,"method":"health.health"}'

# Bootstrap status
curl -X POST http://localhost:9630/ext/info \
  -d '{"jsonrpc":"2.0","id":1,"method":"info.isBootstrapped","params":{}}'

# P-Chain: current validators
curl -X POST http://localhost:9630/ext/bc/P \
  -d '{"jsonrpc":"2.0","id":1,"method":"platform.getCurrentValidators","params":{}}'

# C-Chain: EVM JSON-RPC
curl -X POST http://localhost:9630/ext/bc/C/rpc \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

# X-Chain: asset balance
curl -X POST http://localhost:9630/ext/bc/X \
  -d '{"jsonrpc":"2.0","id":1,"method":"avm.getBalance","params":{"address":"X-lux1...","assetID":"LUX"}}'

c := client.New("http://localhost:9630")

nodeID, _ := c.Info().GetNodeID(ctx)
peers, _ := c.Info().Peers(ctx)
fmt.Printf("Node: %s, Peers: %d\n", nodeID, len(peers))

# Build image
./scripts/run-task.sh build-image

# Run
docker run -ti -p 9630:9630 -p 9631:9631 \
  -v luxd-data:/data \
  ghcr.io/luxfi/node:latest \
  --network-id=mainnet --db-dir=/data

luxd (main/main.go)
├── app/              — Application lifecycle (Start/Stop/ExitCode)
├── node/             — Node initialization, VM registration, resource management
├── chains/           — Chain manager (creates/manages all chain instances)
│   └── rpc/          — Inter-chain RPC communication
├── consensus/        — Consensus infrastructure
│   ├── engine/chain/ — Linear chain consensus engine (vote messages)
│   ├── quasar/       — Hybrid quantum-safe finality (BLS + Ringtail)
│   └── zap/          — ZAP bridge (W3C DID identity, agentic consensus)
├── network/          — P2P networking, peer management, IP tracking
│   ├── peer/         — Peer connections, handshake
│   ├── throttling/   — Inbound/outbound bandwidth throttling
│   ├── dialer/       — Connection dialing
│   └── tracker/      — Connection tracking
├── vms/              — Virtual Machine implementations
│   ├── platformvm/   — P-Chain (staking, validators, subnet creation)
│   ├── exchangevm/   — X-Chain (UTXO-based asset transfers, DAG consensus)
│   ├── evm/          — C-Chain support (LP-176/LP-226 precompiles; EVM runs as plugin)
│   ├── quantumvm/    — Q-Chain (post-quantum crypto, Ringtail keys)
│   ├── aivm/         — A-Chain (AI compute attestation, TEE/nvtrust)
│   ├── bridgevm/     — B-Chain (cross-chain bridge, MPC signing)
│   ├── thresholdvm/  — T-Chain (MPC-as-a-service, threshold signing)
│   ├── zkvm/         — Z-Chain (zero-knowledge proofs, FHE, nullifiers)
│   ├── graphvm/      — G-Chain (GraphQL/DGraph data layer)
│   ├── dexvm/        — D-Chain (decentralized exchange, orderbook, AMM)
│   ├── keyvm/        — K-Chain (distributed KMS, ML-KEM post-quantum)
│   ├── oraclevm/     — O-Chain (oracle data feeds, ZK aggregation)
│   ├── relayvm/      — R-Chain (cross-chain relay/message passing)
│   ├── identityvm/   — I-Chain (W3C DID, decentralized identity)
│   ├── servicenodevm/— Service node registration/discovery
│   ├── proposervm/   — Block proposal wrapper (Linear++, soft leader election)
│   ├── rpcchainvm/   — gRPC plugin VM interface
│   ├── chainadapter/ — Chain adapter utilities
│   ├── falconfx/     — Falcon post-quantum signature FX for X-Chain
│   ├── da/           — Data availability (blob store)
│   ├── components/   — Shared VM components (chain caching, state)
│   └── registry/     — VM discovery and registration
├── config/           — Node configuration (flags, viper, YAML)
├── genesis/          — Genesis block building
├── message/          — P2P message definitions (protobuf)
├── staking/          — TLS certificates, ML-DSA post-quantum key pairs
├── warp/             — LP-118 Warp cross-chain messaging (IPC sockets)
├── service/          — HTTP API services
│   ├── admin/        — Admin API
│   ├── health/       — Health check API
│   ├── info/         — Node info API
│   ├── keystore/     — Keystore API
│   ├── metrics/      — Prometheus metrics
│   ├── auth/         — API authentication
│   ├── backup/       — State backup
│   └── warp/         — Warp message API
├── server/           — HTTP server
├── indexer/          — Transaction/block indexer
├── upgrade/          — Network upgrade definitions
├── version/          — Version constants (semantic versioning, compatibility)
├── trace/            — OpenTelemetry tracing
├── benchlist/        — Validator benchmarking/blacklisting
├── benchmarks/       — Performance benchmarks
├── cache/            — Caching utilities (LRU)
├── gas/              — Gas pricing
├── nat/              — NAT traversal (UPnP, NAT-PMP)
├── pubsub/           — Pub/sub event system
├── router/           — Message routing
├── utils/            — General utilities
├── wallet/           — Wallet implementation
├── tests/            — E2E, load, upgrade tests
├── proto/            — Protobuf definitions
├── scripts/          — Build, test, lint scripts
├── docker/           — Docker-related files
├── k8s/              — Kubernetes manifests
└── x/                — Extended/experimental features

SignatureTypeBLS      = 0  // Classical BLS aggregate
SignatureTypeRingtail = 1  // Post-quantum threshold
SignatureTypeQuasar   = 2  // Hybrid BLS + Ringtail
SignatureTypeMLDSA    = 3  // ML-DSA fallback

# Key CLI flags
--network-id=mainnet|testnet|devnet|custom|<number>
--http-port=9630              # HTTP API port
--staking-port=9631           # P2P staking port
--http-host=127.0.0.1         # API listen address
--db-dir=/path/to/db          # Database directory
--data-dir=/path/to/data      # Data directory
--log-dir=/path/to/logs       # Log directory
--log-level=info|debug|trace  # Log verbosity
--bootstrap-ips=...           # Bootstrap node IPs
--bootstrap-ids=...           # Bootstrap node IDs
--staking-enabled=true        # Enable staking/TLS
--staking-tls-cert-file=...   # Staking TLS cert
--staking-tls-key-file=...    # Staking TLS key
--index-enabled=true          # Enable transaction indexer
--api-admin-enabled=false     # Enable admin API
--http-allowed-origins="*"    # CORS origins
--consensus-sample-size=20    # Consensus sample size
--consensus-quorum-size=14    # Consensus quorum size

make build              # Build luxd binary (minimal profile)
make test               # Run all tests with race detector
make test-short         # Short tests only
make test-unit          # Unit tests
make test-integration   # Integration tests
make test-e2e           # End-to-end tests
make test-package PKG=./vms/platformvm  # Test specific package
make fmt                # Format with gofumpt
make lint               # Run golangci-lint
make clean              # Remove build artifacts
make install            # Install to $GOPATH/bin
make install-system     # Install to /usr/local/bin (sudo)
make install-local      # Install to ~/.local/bin
make install-dev        # Symlink for development
make run-mainnet        # Start mainnet node
make run-testnet        # Start testnet node
make node-status        # Check bootstrap status
make stop-node          # Stop running node
make verify-fips        # Show FIPS environment
make build-release      # Optimized release binary (~46MB)
make build-release-upx  # Release + UPX compression (~20MB)
make build-mlx          # Build with MLX GPU acceleration
make mockgen            # Generate mock files
make dev-setup          # Download dependencies