Lux SpacesVM - Authenticated Hierarchical Storage VM

[v0.0.15] Luxd@v1.9.6-v1.9.7
[v0.0.14] Luxd@v1.9.4
[v0.0.13] Luxd@v1.9.4
[v0.0.12] Luxd@v1.9.3
[v0.0.11] Luxd@v1.9.2
[v0.0.10] Luxd@v1.9.2
[v0.0.9]  Luxd@v1.9.0-1.9.1
[v0.0.8]  Luxd@v1.8.0-v1.8.6

spacesvm/
├── chain/          — Core chain logic
│   ├── block.go        — Block construction and validation
│   ├── builder.go      — Block builder
│   ├── claim_tx.go     — ClaimTx implementation
│   ├── set_tx.go       — SetTx implementation
│   ├── delete_tx.go    — DeleteTx implementation
│   ├── lifeline_tx.go  — LifelineTx implementation
│   ├── move_tx.go      — MoveTx implementation
│   ├── transfer_tx.go  — TransferTx implementation
│   ├── storage.go      — State storage layer
│   ├── genesis.go      — Genesis configuration
│   ├── codec.go        — Transaction serialization
│   └── crypto.go       — EIP-712 signature verification
├── vm/             — VM implementation (Lux VM interface)
├── client/         — Go SDK client
├── cmd/            — CLI tools
│   └── spaces-cli/     — CLI for interacting with SpacesVM
├── mempool/        — Transaction mempool
├── parser/         — Transaction parsing
├── tree/           — Merkle tree for state
├── tdata/          — EIP-712 typed data
├── tests/          — E2E tests
├── networks/       — Network genesis configs
├── scripts/        — Build and run scripts
├── utils/          — Utilities
└── version/        — Version management

github.com/luxdefi/node@v1.9.8           — Lux node (VM interface)
github.com/luxdefi/lux-netrunner@v1.3.5  — Network testing
github.com/ethereum/go-ethereum@v1.10.26 — EIP-712 signing
github.com/gorilla/rpc@v1.2.0            — JSON-RPC server
github.com/spf13/cobra@v1.6.1            — CLI framework

# Install
git clone https://github.com/luxfi/spacesvm.git
cd spacesvm
go install -v ./cmd/spaces-cli

# Claim a space
spaces-cli claim myspace

# Set a key-value pair
spaces-cli set myspace mykey "myvalue"

# Resolve a value
spaces-cli resolve myspace/mykey

# Upload a file
spaces-cli set-file myspace ~/photo.jpg

# Download a file
spaces-cli resolve-file myspace/<hash> output.jpg

# Transfer SPC
spaces-cli transfer 0x1234... 1000

# Check balance
spaces-cli info myspace

# Ping
curl -X POST <endpoint>/public -d '{"jsonrpc":"2.0","method":"spacesvm.ping","params":{},"id":1}'

# Check if space is claimed
curl -X POST <endpoint>/public -d '{"jsonrpc":"2.0","method":"spacesvm.claimed","params":{"space":"myspace"},"id":1}'

# Get suggested fee (returns EIP-712 typed data for signing)
curl -X POST <endpoint>/public -d '{"jsonrpc":"2.0","method":"spacesvm.suggestedFee","params":{"input":{"type":"claim","space":"myspace"}},"id":1}'

# Issue signed transaction
curl -X POST <endpoint>/public -d '{"jsonrpc":"2.0","method":"spacesvm.issueTx","params":{"typedData":<typed_data>,"signature":"0x..."},"id":1}'

# Resolve a path
curl -X POST <endpoint>/public -d '{"jsonrpc":"2.0","method":"spacesvm.resolve","params":{"path":"myspace/mykey"},"id":1}'

# Get balance
curl -X POST <endpoint>/public -d '{"jsonrpc":"2.0","method":"spacesvm.balance","params":{"address":"0x..."},"id":1}'

# Recent activity
curl -X POST <endpoint>/public -d '{"jsonrpc":"2.0","method":"spacesvm.recentActivity","params":{},"id":1}'

1. spacesvm.claimed {"space":"myspace"}              → check availability
2. spacesvm.suggestedFee {"input":{...}}              → get EIP-712 typed data + cost
3. Sign EIP-712 typed data with Web3 wallet           → signature
4. spacesvm.issueTx {"typedData":..., "signature":..} → get txId
5. spacesvm.hasTx {"txId":...}                        → poll until accepted

c := client.New("<endpoint>/public")

// Check space
claimed, _ := c.Claimed("myspace")

// Resolve value
exists, value, meta, _ := c.Resolve("myspace/mykey")

// Get balance
bal, _ := c.Balance(addr)

// Issue transaction
fee, cost, _ := c.SuggestedFee(input)
txID, _ := c.IssueTx(typedData, signature)
ok, _ := c.PollTx(ctx, txID)

# Build VM binary and CLI
./scripts/build.sh

# Run local network
./scripts/run.sh 1.9.7

# Run E2E tests
E2E=true ./scripts/run.sh 1.9.7

# Deploy as Luxd plugin
mv build/sqja3uK17MJxfC7AN8nGadBw9JK5BcrsNwNynsqP5Gih8M5Bm \
   ~/node/build/plugins/