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/conscious
command
Command conscious drives a fresh, REAL Lux A-Chain (aivm) ChainVM through the production block lifecycle to produce the FIRST CONSCIOUS BLOCKS and prints the trace to stdout.
|
Command conscious drives a fresh, REAL Lux A-Chain (aivm) ChainVM through the production block lifecycle to produce the FIRST CONSCIOUS BLOCKS and prints the trace to stdout. |
|
cmd/plugin
command
|
|
|
cmd/plugin
command
|
|
|
cmd
|
|
|
dex-assets-validate
command
Command dex-assets-validate is the CI gate for the DEX real-assets-only model.
|
Command dex-assets-validate is the CI gate for the DEX real-assets-only model. |
|
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 the RPC API for the DEX VM proxy.
|
Package api provides the RPC API for the DEX VM proxy. |
|
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 — a STATELESS ATOMIC ZAP PROXY.
|
Package config defines configuration types for the DEX VM — a STATELESS ATOMIC ZAP PROXY. |
|
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. |
|
plugin
command
|
|
|
registry
Package registry is the DEX's real-assets-only enforcement layer: the single, orthogonal place that decides which assets and which markets are admissible.
|
Package registry is the DEX's real-assets-only enforcement layer: the single, orthogonal place that decides which assets and which markets are admissible. |
|
registry/rpcverify
Package rpcverify is the REAL, network-backed ChainVerifier used by CI (and any out-of-process validator) to prove a manifest's assets exist on the TARGET net before a deploy.
|
Package rpcverify is the REAL, network-backed ChainVerifier used by CI (and any out-of-process validator) to prove a manifest's assets exist on the TARGET net before a deploy. |
|
state
Package state manages persistent state for the DEX VM proxy.
|
Package state manages persistent state for the DEX VM proxy. |
|
txs
Package txs defines transaction types for the DEX VM — a STATELESS ATOMIC ZAP PROXY.
|
Package txs defines transaction types for the DEX VM — a STATELESS ATOMIC ZAP PROXY. |
|
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
|
|
|
allocate_auth.go — the cryptographic half of the leaderless pinned-writer gate.
|
allocate_auth.go — the cryptographic half of the leaderless pinned-writer gate. |
|
cmd/plugin
command
|
|
|
object
Package object wires the S3 OBJECT path to the S-Chain storage VM, proving the on-chain-metadata / off-chain-blob split end to end:
|
Package object wires the S3 OBJECT path to the S-Chain storage VM, proving the on-chain-metadata / off-chain-blob split end to end: |
|
pinning
Package pinning is the deterministic single-writer assignment for the S-Chain storage VM.
|
Package pinning is the deterministic single-writer assignment for the S-Chain storage VM. |
|
state
Package state manages persistent state for the S-Chain — the Lux storage VM.
|
Package state manages persistent state for the S-Chain — the Lux storage VM. |
|
txs
Package txs defines the transaction surface for the S-Chain — the Lux STORAGE VM.
|
Package txs defines the transaction surface for the S-Chain — the Lux STORAGE VM. |
|
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.