Lux Docs

lux key

Manage cryptographic keys and addresses

The key command manages all cryptographic keys used in the Lux network. Keys are stored in ~/.lux/keys/<name>/ with separate subdirectories for each type.

Key Types

TypeAlgorithmPurpose
ECsecp256k1Transaction signing, Ethereum compatibility
BLSBLS12-381Consensus participation, aggregated signatures
RingtailRing signaturesPrivacy-preserving operations
ML-DSANIST Level 3Post-quantum digital signatures

Commands

# Create a new key set from mnemonic
lux key create <name>

# Create from existing mnemonic
lux key create <name> --mnemonic

# Batch generate multiple key sets
lux key generate -n 5
lux key generate -n 10 -p validator

# Derive keys from LUX_MNEMONIC env var
lux key derive -n 5
lux key derive -n 5 --show

# List all key sets
lux key list

# Show public keys and addresses
lux key show <name>

# Export mnemonic (handle with care)
lux key export <name>

# Delete a key set
lux key delete <name>

# Lock/unlock keys in memory
lux key lock <name>
lux key lock --all
lux key unlock <name>

# Migrate plaintext keys to encrypted storage
lux key migrate

Storage Layout

~/.lux/keys/<name>/
  ec/       secp256k1 keys
  bls/      BLS consensus keys
  rt/       Ringtail ring signature keys
  mldsa/    ML-DSA post-quantum keys

All keys are derived from a single BIP-39 mnemonic phrase using HKDF.

On this page