README
¶
Lux Chains
Independent VM plugin binaries for the Lux Network.
Each directory builds to a standalone binary that the Lux node loads as a plugin via --plugin-dir.
Build
make # build all VMs
make evm # build one VM
make test # test all
Install
lpm install evm
lpm install dexvm
Or copy binaries to ~/.lux/plugins/<vmid>.
VMs
| VM | Chain | Purpose |
|---|---|---|
| evm | C-Chain | EVM smart contracts |
| dexvm | D-Chain | Decentralized exchange |
| aivm | A-Chain | AI/ML inference |
| bridgevm | B-Chain | Cross-chain bridge |
| graphvm | G-Chain | GraphQL data layer |
| identityvm | I-Chain | Decentralized identity |
| keyvm | K-Chain | Key management |
| oraclevm | O-Chain | Oracle/off-chain data |
| quantumvm | Q-Chain | Post-quantum consensus signing (Pulsar) |
| relayvm | R-Chain | Cross-chain relay |
| servicenodevm | S-Chain | Service node registry |
| teleportvm | T-Chain | Unified teleport (bridge + relay + oracle) |
| thresholdvm (MPC) | M-Chain | MPC ceremonies (CGGMP21, FROST, Pulsar-general) — bridge custody for external wallets |
| thresholdvm (FHE) | F-Chain | FHE compute + TFHE bootstrap-key generation (encrypted EVM) |
| zkvm | Z-Chain | Groth16 over BLS12-381 (rolls N × ML-DSA-65 sigs into 192-byte proof) |
Directories
¶
| Path | Synopsis |
|---|---|
|
Package aivm GPU backend — runtime-loaded plugin bridge.
|
Package aivm GPU backend — runtime-loaded plugin bridge. |
|
cmd/plugin
command
|
|
|
cmd/plugin
command
|
|
|
Package dexvm implements a high-performance decentralized exchange VM for the Lux blockchain network.
|
Package dexvm implements a high-performance decentralized exchange VM for the Lux blockchain network. |
|
api
Package api provides RPC and REST API handlers for the DEX VM.
|
Package api provides RPC and REST API handlers for the DEX VM. |
|
block
Package block implements block structure for the DEX VM.
|
Package block implements block structure for the DEX VM. |
|
cmd/plugin
command
|
|
|
config
Package config defines configuration types for the DEX VM.
|
Package config defines configuration types for the DEX VM. |
|
lending
Package lending provides a DeFi lending protocol for the DEX VM.
|
Package lending provides a DeFi lending protocol for the DEX VM. |
|
liquidity
Package liquidity implements AMM liquidity pools for the DEX VM.
|
Package liquidity implements AMM liquidity pools for the DEX VM. |
|
mev
Package mev implements MEV protection via commit-reveal scheme.
|
Package mev implements MEV protection via commit-reveal scheme. |
|
network
Package network provides peer-to-peer networking and Warp messaging for the DEX VM.
|
Package network provides peer-to-peer networking and Warp messaging for the DEX VM. |
|
oracle
Package oracle provides price oracle implementations for the DEX VM.
|
Package oracle provides price oracle implementations for the DEX VM. |
|
orderbook
Package orderbook implements a high-performance order book for the DEX VM.
|
Package orderbook implements a high-performance order book for the DEX VM. |
|
perpetuals
Package perpetuals provides perpetual futures trading functionality for the DEX VM.
|
Package perpetuals provides perpetual futures trading functionality for the DEX VM. |
|
plugin
command
|
|
|
state
Package state manages persistent state for the DEX VM.
|
Package state manages persistent state for the DEX VM. |
|
txs
Package txs defines transaction types for the DEX VM.
|
Package txs defines transaction types for the DEX VM. |
|
Backend selection (cgo build): wire the C++ EVM (cevm) into the parallel-execution registry and pick the best available backend.
|
Backend selection (cgo build): wire the C++ EVM (cevm) into the parallel-execution registry and pick the best available backend. |
|
cevm
Package cevm provides Go bindings to the C++ EVM (cevm) with GPU acceleration.
|
Package cevm provides Go bindings to the C++ EVM (cevm) with GPU acceleration. |
|
Package gvm implements the Graph VM (G-Chain) — a shared GraphQL database across all Lux chains.
|
Package gvm implements the Graph VM (G-Chain) — a shared GraphQL database across all Lux chains. |
|
cmd/plugin
command
|
|
|
cmd/plugin
command
|
|
|
Package kmsvm implements the KMS Virtual Machine (K-Chain) for distributed key management using ML-KEM post-quantum cryptography and threshold sharing.
|
Package kmsvm implements the KMS Virtual Machine (K-Chain) for distributed key management using ML-KEM post-quantum cryptography and threshold sharing. |
|
cmd/plugin
command
|
|
|
Package oraclevm is a thin re-export of the canonical O-Chain VM implementation in github.com/luxfi/oracle/vm.
|
Package oraclevm is a thin re-export of the canonical O-Chain VM implementation in github.com/luxfi/oracle/vm. |
|
cmd/plugin
command
|
|
|
Package quantumvm GPU backend — runtime-loaded plugin bridge via the ABI v14 vtbl entry point.
|
Package quantumvm GPU backend — runtime-loaded plugin bridge via the ABI v14 vtbl entry point. |
|
cmd/plugin
command
|
|
|
Package relayvm is a thin re-export of the canonical R-Chain VM implementation in github.com/luxfi/relay/vm.
|
Package relayvm is a thin re-export of the canonical R-Chain VM implementation in github.com/luxfi/relay/vm. |
|
cmd/plugin
command
|
|
|
Package tvm implements the Threshold VM substrate (M-Chain MPC and F-Chain FHE per LP-134).
|
Package tvm implements the Threshold VM substrate (M-Chain MPC and F-Chain FHE per LP-134). |
|
cert
Package cert provides the QuasarCertLane registration and certificate-subject binding logic shared by M-Chain and F-Chain.
|
Package cert provides the QuasarCertLane registration and certificate-subject binding logic shared by M-Chain and F-Chain. |
|
cmd/plugin
command
|
|
|
fhe
Package fhe provides GPU-accelerated FHE operations for ThresholdVM.
|
Package fhe provides GPU-accelerated FHE operations for ThresholdVM. |
|
protocol/cggmp21
Package cggmp21 declares the M-Chain CGGMP21 protocol surface.
|
Package cggmp21 declares the M-Chain CGGMP21 protocol surface. |
|
protocol/corona_general
Package corona_general declares the M-Chain general-purpose Corona (Ring-LWE) threshold protocol surface.
|
Package corona_general declares the M-Chain general-purpose Corona (Ring-LWE) threshold protocol surface. |
|
protocol/frost
Package frost declares the M-Chain FROST protocol surface.
|
Package frost declares the M-Chain FROST protocol surface. |
|
protocol/tfhe_keygen
Package tfhe_keygen declares the cross-chain TFHE bootstrap-key generation surface.
|
Package tfhe_keygen declares the cross-chain TFHE bootstrap-key generation surface. |
|
runtime
Package runtime defines the adapter contracts the host chains (M-Chain and F-Chain) implement to plug into the ThresholdVM substrate.
|
Package runtime defines the adapter contracts the host chains (M-Chain and F-Chain) implement to plug into the ThresholdVM substrate. |
|
types
Package types defines the data types of the ThresholdVM substrate.
|
Package types defines the data types of the ThresholdVM substrate. |
|
cmd/plugin
command
|
|
|
fhe
Package fhe provides GPU-accelerated FHE operations for the zkvm.
|
Package fhe provides GPU-accelerated FHE operations for the zkvm. |
Click to show internal directories.
Click to hide internal directories.