github.com/luxfi/node/
├── api/                    # RPC API implementations
│   ├── admin/              # Admin API
│   ├── auth/               # Authentication
│   ├── health/             # Health checks
│   ├── info/               # Node info API
│   ├── keystore/           # Key management
│   └── server/             # HTTP server
├── app/                    # Application entry point
│   └── main.go             # Node binary
├── chains/                 # Chain management
│   ├── manager.go          # Chain lifecycle
│   └── nets.go             # Network management
├── database/               # Storage layer
│   ├── badger/             # BadgerDB backend
│   ├── pebble/             # PebbleDB backend
│   ├── leveldb/            # LevelDB backend
│   └── heightindexdb/      # Height indexing
├── genesis/                # Genesis configuration
│   ├── genesis.go          # Genesis parsing
│   └── params.go           # Network parameters
├── network/                # P2P networking
│   ├── peer/               # Peer management
│   ├── throttling/         # Rate limiting
│   └── p2p/                # Protocol handlers
├── vms/                    # Virtual Machines
│   ├── platformvm/         # D-Chain (Platform)
│   ├── exchangevm/         # X-Chain (Exchange)
│   ├── cchainvm/           # C-Chain (EVM)
│   ├── bridgevm/           # B-Chain (Bridge)
│   ├── thresholdvm/        # T-Chain (Threshold)
│   ├── quantumvm/          # Q-Chain (Quantum)
│   ├── zkvm/               # Z-Chain (Zero Knowledge)
│   ├── aivm/               # A-Chain (Attestation)
│   └── proposervm/         # Block proposer wrapper
├── wallet/                 # Wallet implementation
│   └── net/                # Network wallet ops
└── x/                      # Extended packages
    ├── merkledb/           # Merkle database
    └── sync/               # State sync

// Key files
vms/platformvm/
├── vm.go                   // VM implementation
├── block/                  // Block structures
│   ├── builder/            // Block building
│   └── executor/           // Block execution
├── state/                  // Chain state
├── txs/                    // Transaction types
│   ├── executor/           // TX execution
│   └── mempool/            // Transaction pool
├── validators/             // Validator management
│   └── manager.go          // Validator set ops
└── warp/                   // Warp messaging
    ├── signature.go        // BLS signatures
    └── validator.go        // Warp validators

vms/exchangevm/
├── vm.go                   // VM implementation
├── block/                  // Block handling
├── state/                  // UTXO state
├── txs/                    // Transaction types
└── network/                // Gossip protocol

vms/cchainvm/
├── vm.go                   // Geth integration
├── evm/                    // EVM execution
├── precompile/             // Custom precompiles
└── txpool/                 // Transaction pool

vms/bridgevm/
├── vm.go                   // VM implementation
├── rpc.go                  // JSON-RPC endpoints
├── factory.go              // VM factory
└── signer_test.go          // Signer tests

// SignerSet manages LP-333 opt-in signers
type SignerSet struct {
    Signers      []*SignerInfo // Active signers (max 100)
    Waitlist     []ids.NodeID  // Waiting for slot
    CurrentEpoch uint64        // Increments on reshare
    SetFrozen    bool          // True at 100 signers
    ThresholdT   int           // t value for threshold
    PublicKey    []byte        // Combined MPC public key
}

// SignerInfo tracks validator bond
type SignerInfo struct {
    NodeID     ids.NodeID
    BondAmount uint64  // 100M LUX bond (slashable)
    Slashed    bool
    SlashCount int
}

vms/thresholdvm/
├── vm.go                   // VM implementation
├── dkg.go                  // Distributed key gen
├── sign.go                 // Threshold signing
└── reshare.go              // Key resharing

vms/quantumvm/
├── vm.go                   // VM implementation
├── ringtail.go             // Ringtail signatures
└── hybrid.go               // Hybrid BLS+RT

vms/zkvm/
├── vm.go                   // VM implementation
├── circuit/                // ZK circuits
├── verifier/               // Proof verification
└── prover/                 // Proof generation

# Go 1.23+
go version

# Clone repository
git clone https://github.com/luxfi/node.git
cd node

# Build node binary
make build

# Output: ./build/luxd

# Build with race detector
make build-race

# Run all tests
go test ./... -count=1

# Run specific package
go test ./vms/platformvm/... -v

# Run with race detector
go test -race ./...

# Run benchmarks
go test -bench=. ./vms/exchangevm/...

# Mainnet
./build/luxd

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

# Local network
./build/luxd --network-id=12345

# With specific options
./build/luxd \
  --http-host=0.0.0.0 \
  --http-port=9650 \
  --staking-port=9651 \
  --log-level=info

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

# Get validators
curl -X POST http://localhost:9650/ext/bc/P \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"platform.getCurrentValidators","params":{},"id":1}'

# Get balance
curl -X POST http://localhost:9650/ext/bc/X \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"avm.getBalance","params":{"address":"X-lux1...","assetID":"LUX"},"id":1}'

require (
    github.com/luxfi/consensus v1.22.5
    github.com/luxfi/crypto v0.8.0
    github.com/luxfi/geth v1.13.14
    github.com/dgraph-io/badger/v4 v4.2.0
    github.com/prometheus/client_golang v1.18.0
)

replace (
    github.com/luxfi/consensus => ../consensus
    github.com/luxfi/crypto => ../crypto
)