Univrs.io — Platform Architecture & Status Report
VUDO.dols — Imagine. Summon. Create. Le réseau est Bondieu
Date: April 4, 2026 | Network Version: 0.1.0 | DOL Version: 0.8.1
Executive Summary
Univrs.io is a distributed computing platform built entirely in Rust where programs are ontological specifications (DOL — Design Ontology Language), execute as sandboxed WebAssembly “Spirits,” and propagate through a P2P mycelial network powered by biological economics (ENR — Entropy-Nexus-Revival). The platform’s goal is the Imaginarium — a marketplace where creators publish DOL code as Spirits and earn credits from users who summon them.
Current state: The network infrastructure and economics are 80-90% complete with 203 tests passing. The DOL compiler has matured to 2,306 tests across 20 crates with three compilation backends. The critical gap is the execution layer — the bridge between the VUDO VM (L5) and the Mycelial Network (L3) that would allow Spirits to actually run on nodes.
Seven-Layer Architecture
The platform is organized into seven abstraction layers, each building on the one below. The theoretical foundation is Assembly Theory (Cronin/Walker, Nature 2023), where assembly index maps to Spirit complexity, copy number to summoning count, and assembly space to the Mycelium network.
┌─────────────────────────────────────────────────────────────────┐
│ L7 THE IMAGINARIUM [ 5%] │
│ Creator marketplace, Spirit publishing, Séances │
├─────────────────────────────────────────────────────────────────┤
│ L6 VUDO OS [ 15%] │
│ Platform services: Loa, Veve, Spirit, Ghost, Spell │
├─────────────────────────────────────────────────────────────────┤
│ L5 VUDO VM [ 40%] │
│ WASM execution, wasmtime sandbox, host functions │
├══════════════════════ CRITICAL GAP ═════════════════════════════┤
│ L4 DOL COMPILER [ 78%] │
│ Lexer, Parser, Types, Meta-programming, 3 Backends │
├─────────────────────────────────────────────────────────────────┤
│ L3 MYCELIAL NETWORK [ 90%] │
│ libp2p, gossipsub, mDNS, LoRa bridge, dashboard │
├─────────────────────────────────────────────────────────────────┤
│ L2 ENR ECONOMICS [ 85%] │
│ Entropy, Nexus topology, Revival pool, Septal gates │
├─────────────────────────────────────────────────────────────────┤
│ L1 RUST FOUNDATION [ 95%] │
│ Ed25519 identity, Youki runtime, OpenRaft, Chitchat │
└─────────────────────────────────────────────────────────────────┘
Layer Details
L1 — Rust Foundation (95% Complete) ✅
The bedrock layer providing cryptographic identity, container runtime, and consensus primitives.
| Component | Status | Technology |
|---|---|---|
| Ed25519 Identity | ✅ Done | Cryptographic node identity, private key never transmitted |
| Capability System | ✅ Done | Initial capability sets for bootstrapping |
| Youki OCI Runtime | ✅ Done | Lightweight OCI-compliant container runtime |
| Chitchat Gossip | ✅ Done | Extended for resource gradient information |
| OpenRaft Consensus | ✅ Done | Strong consistency for credit transactions |
| Docker Compose | ✅ Done | Bootstrap + scalable peers + dashboard |
Design principle: Memory safety without garbage collection. Fearless concurrency. Zero-cost abstractions.
L2 — ENR Economics (85% Complete) 🔨
Entropy-Nexus-Revival is the foundational economic primitive layer, inspired by mycorrhizal network biology. Key insight: fungi are active traders that discriminate based on exchange rates, not passive pipes.
| Component | Status | Detail |
|---|---|---|
| Entropy (4-axis) | ✅ Done | Network, Compute, Storage, Temporal tracking |
| Nexus Topology | ✅ Done | Leaf → Nexus → Poteau-Mitan hierarchy |
| Revival Pool | ✅ Done | Failed resource recycling & redistribution |
| Septal Gates | ✅ Done | Woronin body circuit breakers |
| Credit Ledger | ✅ Done | OpenRaft strong consistency |
| Pricing Models | ✅ Done | Fixed / Dynamic / Auction on ENR primitives |
| Phase 3 Stress Tests | ✅ Done | 26/26 passing, v0.9.0 ready |
Biological mapping: Second Law of Thermodynamics → Entropy accounting. Turgor pressure gradients → Resource gradients across nodes. Decomposition → Revival pool. Woronin bodies → Septal gate circuit breakers.
L3 — Mycelial Network (90% Complete) 🔨
The P2P infrastructure carrying all communication, discovery, and economic transactions. 7 workspace crates: mycelial-core, mycelial-meshtastic, mycelial-network, mycelial-protocol, mycelial-state, mycelial-wasm, mycelial-node.
| Component | Status | Detail |
|---|---|---|
| libp2p Stack | ✅ Done | TCP + Noise + Yamux + Kademlia + Gossipsub |
| mDNS Discovery | ✅ Done | Nodes auto-find each other, 10+ nodes <1sec |
| 12 Gossipsub Topics | ✅ Done | chat, announce, reputation, vouch, credit, governance, resource, direct + 4 VUDO/ENR |
| ENR Bridge | ✅ Done | Credits, Gradients, Elections, Septal gates |
| Meshtastic LoRa | ✅ Done | Protocol translation, 232-byte packet chunking |
| SQLite + LRU Cache | ✅ Done | Persistent storage with memory cache |
| WebSocket Dashboard | ✅ Done | Axum server + React panels |
| Phase 6 Economics | ✅ Done | Onboarding, reputation, mutual credit, governance |
| WASM Spirit Hosting | 🔴 GAP | Nodes cannot yet host/execute Spirits |
Test results: 203 passed, 0 failed, 2 ignored (hardware-dependent). 7 crates across mycelial-core, mycelial-meshtastic, mycelial-network, integration tests, gate_credits, and gate_election.
L4 — DOL Compiler (78% Complete) 🔨
The Design Ontology Language toolchain. DOL v0.8.1 uses gen/rule/evo/docs keywords with Rust-aligned types. 20 workspace crates including 10 VUDO host function crates.
| Component | Status | Detail |
|---|---|---|
| Lexer (logos) | ✅ Done | Part of 2,306 tests passing |
| Parser (recursive descent) | ✅ Done | Full AST with ariadne LLVM-style diagnostics |
| Type System | ✅ Done | i32, f64, Vec |
| Meta-programming | ✅ Done | Quote/Eval, Macros, Reflect, Idiom Brackets |
| Tree Shaking | ✅ Done | Dead code elimination |
| Migration Tooling | ✅ Done | Old syntax → v0.8.1 migration |
| Rust Codegen | ✅ Done | Production — Automerge CRDT annotations |
| TypeScript Codegen | ✅ Done | Working target |
| JSON Schema Codegen | ✅ Done | Working target |
| WASM Backend Ph.1-2 | ✅ Done | Imports & module structure (32 tests) |
| LLVM Native Backend | 🟡 80% | Core codegen done — blocked on LLVM 17 install |
| WASM Backend Ph.3-4 | 🔴 GAP | BLOCKER: Function body codegen pending |
| Multi-target Codegen | 🟡 Active | Rust ✅, WASM 🟡, LLVM 🟡, TypeScript ✅, JSON ✅ |
CLI binaries: 10 — dol-parse, dol-check, dol-test, dol-codegen, dol-build, dol-migrate, dol-mcp, vudo, wasm-stress-test, dol-build-crate
DOL design principles: Ontology first. Private by default. Pure by default (sex for side effects). Multi-target. Progressive complexity.
L5 — VUDO VM (40% Complete) 🟡
The WebAssembly execution engine where Spirits run in sandboxed environments.
| Component | Status | Detail |
|---|---|---|
| wasmtime Linker | ✅ Done | Host function registration to WASM |
| Sandbox Environment | ✅ Done | Resource-limited execution |
| ENR Host Functions | ✅ Done | get_entropy(), reserve_credits(), get_gradient(), get_role() |
| Host Function Registry | ✅ Done | 22 VUDO host functions, provider-based (Phase 9) |
| Spirit Scheduler | 🔴 GAP | Schedule & place Spirits on nodes |
| Spirit Migration | 🔴 GAP | State serialization + gossipsub coordination |
| DOL→WASM Codegen | 🔴 GAP | Depends on L4 WASM Backend Ph.3-4 |
Host function API:
host_enr_get_entropy(target) → i64host_enr_reserve_credits(amount) → i32(reservation_id or -1)host_enr_get_gradient(resource_type) → i64host_enr_get_role() → i32(0=Leaf, 1=Nexus, 2=Poteau-Mitan)
L6 — VUDO OS (15% Complete) 📐
Platform services with the dual vocabulary system (Developer + Mystical).
| VUDO Term | Technical Reality | Status |
|---|---|---|
| Loa | Autonomous service/agent | 📐 Design |
| Veve | Configuration schema / sacred geometry | 📐 Design |
| Spirit | Shared .dol package (6-state lifecycle) | 🟡 Partial |
| Ghost | Ephemeral instance | 📐 Design |
| Spell | Data transformation | 📐 Design |
| Medium | MCP interface for AI control | 📐 Design |
| Séance | Collaborative session | 📐 Design |
| Cheval | AI agent possession | 📐 Design |
| Gris-Gris | Security token | 📐 Design |
| Houngan/Mambo | Admin/curator role | 📐 Design |
| Bondieu | The network as whole | ✅ Conceptual |
Spirit lifecycle: Seed → Sprout → Bloom → Wilt → Dormant → Decompose
L7 — The Imaginarium (5% Complete) 🔮
The distributed marketplace and public face of VUDO OS.
| Component | Status | Detail |
|---|---|---|
| Spirit Marketplace | 🔮 Planned | Browse, summon, publish |
| Creator Revenue | 🔮 Planned | Credits on summoning |
| Attribution Chains | 🔮 Planned | Derivative works credit ancestors |
| Séance Sessions | 🔮 Planned | Real-time collaborative editing |
Credit flow: User (-10) → Creator (+8) + Bondieu pool (+2). Derivative bonus flows to ancestor Spirits.
Critical Path: Spirits on Nodes
This is the single most important engineering challenge. The pipeline required:
DOL Source (.dol)
│
▼ [BLOCKER #1: WASM Backend Ph.3-4]
WASM binary (.wasm)
│
▼ gossipsub propagation
Node receives Spirit
│
▼ [BLOCKER #2: wasmtime in mycelial-node]
wasmtime executes Spirit with VUDO host functions
│
▼ [BLOCKER #3: Spirit lifecycle manager]
Spirit state synced via CRDT + gossipsub
│
▼
ENR bridge manages fuel/credits/elections
Blockers in Priority Order
| # | Blocker | Severity | From → To | Description |
|---|---|---|---|---|
| 1 | DOL WASM Backend Ph.3-4 | 🔴 Critical | L4 → L5 | Function body codegen needed before Spirits compile to WASM |
| 2 | wasmtime in mycelial-node | 🔴 Critical | L5 → L3 | Embed WASM runtime so network nodes can execute Spirits |
| 3 | Spirit Lifecycle Manager | 🟠 High | L6 → L3 | 6-state lifecycle managed by mycelial-node |
| 4 | State Sync Protocol | 🟠 High | L3 → L5 | CRDT + gossipsub for Spirit migration between nodes |
| 5 | LLVM 17 Install | 🟡 Medium | L4 | Unblocks native compilation backend (80% done, ~2-4 hrs) |
Repository Map
| Repository | Layers | Crates | Description | Status |
|---|---|---|---|---|
univrs-dol | L4 | 20 | DOL language toolchain | 🔨 Active |
univrs-network | L3, L2 | 7 | P2P mycelial network + ENR economics | 🔨 Active |
univrs-vudo | L5, L6 | — | VUDO VM & Spirit runtime | 🟡 Partial |
univrs-orchestration | L1 | — | Container orchestration foundation | 🔨 Active |
Educational Sites (Future Spirits)
| Site | Purpose | Status |
|---|---|---|
| learn.univrs.io | Platform docs & tutorials | 🔨 Active |
| book.univrs.io/docs | DOL language reference | 🔨 Active |
| metalearn.org | Three.js periodic table for meta-learning | 🔨 Active |
| krzy.ai | ”The Critic’s Mirror” AI critique tool | 🔮 Planned |
Technology Stack
| Layer | Primary Technology | Key Crates / Tools |
|---|---|---|
| Language | Rust | logos (lexer), ariadne (diagnostics), wasmtime |
| Network | libp2p | TCP, Noise, Yamux, Kademlia, Gossipsub |
| Consensus | OpenRaft | Strong consistency for credit transactions |
| Gossip | Chitchat | Extended for resource gradient info |
| Runtime | wasmtime | WASM sandbox execution |
| Storage | SQLite | With LRU cache layer |
| Radio | Meshtastic | LoRa bridge, 232-byte packets |
| Dashboard | React + Axum | WebSocket real-time panels |
| Container | Youki | OCI-compliant runtime |
| 3D Viz | Three.js | Mycelium networks, periodic table, Veve patterns |
Strategic Direction: VM-First
The next phase prioritizes DOL→WASM compilation and VUDO VM sandbox development over continued network hardening, since network infrastructure is now proven through comprehensive stress testing.
The roadmap converges on making the Physarum polycephalum-inspired slime mold decision network operational — running across VUDO nodes with WASM 3D SVG browser visualization, demonstrating emergent optimization where credit flow optimizes routing and resource gradients guide Spirit placement.
Biological Metaphor Index
| Biology | Technology | Layer |
|---|---|---|
| Mycelial network | P2P gossipsub mesh | L3 |
| Hydraulic transport | Active credit/data flow | L2-L3 |
| Fungal hub formation | Nexus node emergence | L2 |
| Woronin bodies | Septal gate circuit breakers | L2 |
| Electrical action potentials | Gossip protocol signals | L3 |
| Decomposition/recycling | Revival pool | L2 |
| Apical tip growth | Network expansion/discovery | L3 |
| Physarum optimization | Slime mold decision network | L3-L5 |
| Assembly index | Spirit complexity | L5-L7 |
| Copy number | Summoning count | L7 |
| Assembly space | Mycelium network | L3 |
Test Summary (Verified April 4, 2026)
| Suite | Tests | Passing | Notes |
|---|---|---|---|
| DOL Compiler (all) | 2,306 | 2,306 | v0.8.1, 20 crates, 0 failed, 38 ignored |
| Mycelial Core | 30 | 30 | |
| Mycelial Meshtastic | 93 | 93 | |
| Mycelial Network | 50 | 50 | |
| Integration | 23 | 23 | 2 ignored (need hardware) |
| Gate Credits | 4 | 4 | Multi-node credit transfer with tax |
| Gate Election | 3 | 3 | Multi-cluster Nexus elections |
| ENR Stress (Phase 3) | 26 | 26 | Node Harness, Election, Credits, Partition, Septal |
| Total | 2,535 | 2,535 | 100% pass rate (0 failures) |
“The system that knows what it is, becomes what it knows.”
Make the Univrs in your image. 🍄