Lux CLI

lux
  chain          Blockchain lifecycle (create/deploy/list/describe/delete/import)
    create       Create new blockchain configuration (L1/L2/L3)
    deploy       Deploy to local/testnet/mainnet
    list         List all configured blockchains
    describe     Show detailed blockchain information
    delete       Delete a blockchain configuration
    import       Import blocks from RLP file
    upgrade      Manage chain upgrades
      generate   Generate upgrade config
      apply      Apply upgrade
      export     Export upgrade config
      import     Import upgrade config
      print      Print upgrade config
      validate   Validate upgrade config
      vm         VM upgrade operations

  network        Manage local network runtime
    start        Start local network (mainnet/testnet/devnet/dev)
    stop         Stop and save snapshot
    status       Show network status and endpoints
    clean        Stop and delete runtime data
    monitor      Real-time network monitor
    snapshot     Manage network snapshots
    bootstrap    Bootstrap network operations
    describe     Network describe with genesis info
    send         C-Chain send convenience

  key            Manage cryptographic keys
    create       Generate new key set from mnemonic (EC, BLS, Ringtail, ML-DSA)
    list         List all key sets
    show         Show key set details and addresses
    delete       Delete a key set
    export       Export key set (mnemonic or individual keys)
    import       Import key set from mnemonic
    generate     Batch generate key sets (-n count, -p prefix)
    derive       Derive keys from LUX_MNEMONIC env var
    genesis      Genesis key operations
    export-signer  Export signer key
    lock         Lock key (clear from memory), --all supported
    unlock       Unlock key for use
    backend      Manage key storage backends (list/set)
    kchain       K-Chain distributed key management (status/create/sign)
    ring         Ring signatures for anonymous signing
    migrate      Migrate plaintext to encrypted storage

  validator      Manage P-Chain validator balance
    list         List validators
    getBalance   Get validator balance
    increaseBalance  Increase validator balance

  node           Manage luxd nodes (local + Kubernetes)
    link         Symlink luxd binary to ~/.lux/bin/luxd
    deploy       Deploy/update via Helm chart
    upgrade      Rolling upgrade with zero downtime (partition-based)
    status       Show pod status, images, health
    logs         Stream logs from luxd pod
    rollback     Revert to previous StatefulSet revision

  contract       Smart contract operations
    deploy       Deploy contract
    deploy-erc20 Deploy ERC20 token
    init-validator-manager  Initialize validator manager

  dev            Local development environment
    start        Start single-node dev mode (K=1 consensus)
    stop         Stop dev environment

  dex            Decentralized exchange operations
    market       Manage markets (list/info/create)
    order        Manage orders (place/cancel/list/history)
    pool         Manage liquidity pools (list/create/add/remove/swap)
    perp         Perpetual futures (markets/open/close/positions/pnl/funding)
    account      Trading account (balance/deposit/withdraw/history)
    status       DEX status and statistics

  amm            Uniswap-style AMM trading

  mpc            Multi-Party Computation (threshold signing)
    node         Manage MPC nodes
      init       Initialize t-of-n network (--threshold, --nodes)
      start      Start all nodes
      stop       Stop all nodes
      status     Check node status
      clean      Stop and remove data
      list       List networks
    deploy       Deploy MPC nodes to cloud (create/status/ssh)
    backup       Backup and restore
    wallet       Manage MPC wallets (list/create/show/export)
    sign         Threshold signing (request/approve/status)

  gpu            GPU acceleration management
    status       Check GPU availability (NTT, FHE, lattice ops)

  primary        Primary network operations
    add-validator  Add validator to primary network
    describe     Describe primary network

  config         CLI configuration
    lint         Lint configuration
    metrics      Metrics configuration

  vm             VM management
    install      Install VM binary
    link         Link VM to node
    unlink       Unlink VM
    reload       Reload VM plugins
    status       VM status

  warp           Cross-chain messaging (ICM/Interchain Messaging)

  rpc            Direct RPC calls
    transfer     RPC transfer

  self           CLI self-management (like nvm for node)
    install      Install specific CLI version
    list         List available versions
    use          Switch to specific version
    link         Link CLI binary

  update         Update CLI to latest version

  snapshot       Manage network snapshots

  netrunner      Network runner management
    link         Link netrunner binary

  kms            Key Management Service integration

  link           Unified binary linking

  backend        Hidden backend server commands
    spawnServer  Spawn backend gRPC server
    (per-network backend commands: lux-mainnet-grpc, lux-testnet-grpc, etc.)

# Initialize 3-of-5 network
lux mpc node init --threshold 3 --nodes 5 --devnet

# Start / stop / status
lux mpc node start
lux mpc node status
lux mpc node stop

# Wallet operations
lux mpc wallet create --name "Treasury"
lux mpc wallet list

# Threshold signing
lux mpc sign request --wallet <id> --message "0x..."
lux mpc sign approve <request-id>

# Market operations
lux dex market list
lux dex market info LUX/USDT

# Order placement
lux dex order place --market LUX/USDT --side buy --type limit --price 10.50 --amount 100
lux dex order list
lux dex order cancel <order-id>

# AMM liquidity
lux dex pool create --token0 LUX --token1 USDT --amount0 1000 --amount1 10000 --type constant-product --fee 30
lux dex pool swap --from LUX --to USDT --amount 100 --slippage 0.5

# Perpetual futures (up to 100x leverage)
lux dex perp open --market BTC-PERP --side long --size 0.1 --leverage 10
lux dex perp positions
lux dex perp close BTC-PERP --percent 50

# Account management
lux dex account balance
lux dex account deposit --token LUX --amount 1000

# Local binary linking
lux node link --auto

# K8s deployment via Helm
lux node deploy --mainnet
lux node deploy --testnet --set image.tag=luxd-v1.23.15

# Zero-downtime rolling upgrade
lux node upgrade --mainnet --image ghcr.io/luxfi/node:v1.23.6

# Operations
lux node status --mainnet
lux node logs --mainnet luxd-0 -f
lux node rollback --mainnet

lux gpu status

$HOME/.lux/
  cli.json           Configuration file
  chains/            Chain configurations (genesis.json, sidecar.json per chain)
  keys/              Cryptographic keys (ec/, bls/, rt/, mldsa/ per key name)
    mpc/             MPC key shards
  networks/          Network runtime data per type
  snapshots/         Network snapshots
  bin/               Linked binaries (luxd, etc.)
  plugins/           VM plugins
  repos/             Downloaded repos
  logs/              CLI log files
  mpc/               MPC network data

lux key create validator1        # Generate keys
lux network start --devnet       # Start 5-node network
lux chain create mychain         # Create chain config
lux chain deploy mychain --devnet # Deploy to network
lux network status               # Check endpoints
lux network stop                 # Save and stop
lux network clean                # Wipe runtime (keeps chains)

lux contract deploy-erc20        # Deploy ERC20
lux contract init-validator-manager  # Initialize validator manager

lux chain upgrade generate       # Generate upgrade config
lux chain upgrade validate       # Validate config
lux chain upgrade apply          # Apply to running chain