Lux Plugins Core

plugins-core/
  vms/                   -- VM definitions (one YAML per VM)
    blobvm.yaml              Content-addressable KV store VM
    spacesvm.yaml            Hierarchical storage VM
    evm.yaml          Sovereign L1 EVM (Solidity smart contracts)
  chains/               -- Chain definitions (one YAML per chain)
    spaces.yaml              Spaces Chain Demo (SpacesVM)
    wagmi.yaml               Zoo EVM Demo (high-throughput testbed)
  examples/              -- Template files for contributors
    vm.yaml                  VM definition template
    chain.yaml              Chain definition template
  README.md              -- Contributing guide
  LICENSE

k: 20                            -- Sample size
alpha: 15                        -- Quorum size
betaVirtuous: 15                 -- Confidence threshold (virtuous)
betaRogue: 20                    -- Confidence threshold (rogue)
concurrentRepolls: 4             -- Concurrent repolls
optimalProcessing: 50            -- Optimal processing buffer
maxOutstandingItems: 1024        -- Max outstanding items
maxItemProcessingTime: 120s      -- Max processing time per item
parents: 5                       -- Parent count
batchSize: 30                    -- Batch size
validatorOnly: false             -- Open to non-validators

vm:
  # Required: Base58-encoded VM ID (deterministic from build)
  id: "kM6h4LYe3AcEU1MB2UNg6ubzAiDAALZzpVrbX8zn3hXF6Avd8"

  # Required: Unique human-readable alias (used in LPM commands)
  alias: "blobvm"

  # Required: Project homepage URL
  homepage: "https://github.com/luxdefi/blobvm"

  # Required: Human-readable description
  description: "Content-Addressable Key-Value Store w/EIP-712 Compatibility"

  # Required: Maintainer contact emails
  maintainers:
    - "z@lux.network"

  # Required: Path to build script (relative to extracted source)
  # LPM clones the repo and runs this script to build the binary
  installScript: "scripts/build.sh"

  # Required: Path to the built binary (relative to extracted source)
  # Must match the VM ID for the node to load it correctly
  binaryPath: "build/kM6h4LYe3AcEU1MB2UNg6ubzAiDAALZzpVrbX8zn3hXF6Avd8"

  # Required: URL to release tarball (for pre-built download)
  url: "https://github.com/luxdefi/blobvm/archive/refs/tags/v0.0.6.tar.gz"

  # Required: SHA256 checksum of the release tarball
  sha256: "72d1b8fa3ee89412b406e7b0e9a968ca06746ea1bb5dd02c2b87f1ad1eaa4ca6"

  # Required: Semantic version
  version:
    major: 0
    minor: 0
    patch: 6

chain:
  # Required: Base58-encoded Chain ID (from P-Chain)
  id: "Ai42MkKqk8yjXFCpoHXw7rdTWSHiKEMqh5h8gbxwjgkCUfkrk"

  # Required: Unique human-readable alias
  alias: "spaces"

  # Required: Project homepage
  homepage: "https://tryspaces.xyz"

  # Required: Description
  description: |
    Spaces enables authenticated, hierarchical storage of arbitrary
    keys/values using any EIP-712 compatible wallet.

  # Required: Maintainer emails
  maintainers:
    - "z@lux.network"

  # Optional: Install script (empty if no additional setup needed)
  installScript: ""

  # Required: List of VM aliases this chain uses
  vms:
    - "spacesvm"

  # Optional: Chain-specific configuration
  config:
    # Gossip settings
    gossipAcceptedFrontierValidatorSize: 0
    gossipAcceptedFrontierNonValidatorSize: 0
    gossipAcceptedFrontierPeerSize: 35
    gossipOnAcceptValidatorSize: 0
    gossipOnAcceptNonValidatorSize: 0
    gossipOnAcceptPeerSize: 20
    appGossipValidatorSize: 10
    appGossipNonValidatorSize: 0
    appGossipPeerSize: 0

    # Access control
    validatorOnly: false

    # Consensus parameters
    consensusParameters:
      k: 20              # Sample size
      alpha: 15           # Quorum threshold
      betaVirtuous: 15    # Virtuous confidence
      betaRogue: 20       # Rogue confidence
      concurrentRepolls: 4
      optimalProcessing: 50
      maxOutstandingItems: 1024
      maxItemProcessingTime: 120_000_000_000  # 120 seconds in nanoseconds
      parents: 5
      batchSize: 30

~/.lux/plugins/kM6h4LYe3AcEU1MB2UNg6ubzAiDAALZzpVrbX8zn3hXF6Avd8   # BlobVM
~/.lux/plugins/sqja3uK17MJxfC7AN8nGadBw9JK5BcrsNwNynsqP5Gih8M5Bm   # SpacesVM
~/.lux/plugins/mgj786NP7uDwBCcq6YwThhaN8FLyybkCa4zBWTQbNgmK6k9A6   # Sovereign L1 EVM

# Add this repository (ships as default with LPM)
lpm add-repository --alias luxfi --url https://github.com/luxfi/plugins-core.git

# List all available VMs
lpm list-vms

# Install a VM by alias
lpm install --vm blobvm
lpm install --vm spacesvm
lpm install --vm evm

# Update a VM to latest version
lpm update --vm evm

# Install a chain (installs all referenced VMs)
lpm install --chain spaces

# List installed VMs
lpm list-installed