V7 — Architecture (Page Index) — Mawu

This directory holds the V7 (Mawu — a UE5 + Rust open-world "creator republic" of player-authored, server-authoritative realms with executable UGC) architecture reference, decomposed from the single ../V7_ARCHITECTURE.md hub into focused, in-depth, code-grounded pages. The hub remains the canonical entry point and preserves every section heading; each page below expands one part of the system with richer, code-grounded detail and an honest implemented / spec-only status. The companion feature map lives in ../V7_features.md.

Cross-reference convention. Page-to-page links are relative (./<slug>.md). Platform-foundation links point at the shared platform/ space.

Architecture landscape#

flowchart TB Studio[Mawu Studio and creator tooling] --> Ingest[Validation review signing and package registry] Ingest --> Fleet[Realm fleet and version orchestration] Player[Player clients and identity edge] --> Moremi[Moremi authoritative realm server] Fleet --> Moremi Moremi --> Ixchel[Ixchel WASM sandbox] Ixchel --> Caps[Capability enforcement and quotas] Caps --> Services[Trusted world data voice social economy and governance APIs] Moremi --> Danu[Danu server meshing] Danu --> Nephthys[(Nephthys persistence snapshots and recovery)] Services --> Sekhmet[Safety child protection integrity and anti-cheat] Services --> Abundantia[Distribution payouts and anti-fraud] Services --> Eunomia[Governance moderation appeals and Ori bridge] Nephthys --> Operations[Hosting data compliance observability performance and launch] Sekhmet --> Operations Abundantia --> Operations Eunomia --> Operations

The arrows cross explicit trust boundaries. Signing identifies a reviewed immutable package; sandboxing limits execution; capability policy authorizes individual effects; authoritative services commit state; and governance and operations retain containment, appeal, and recovery control.

Trace a change from package/hash/dependency and capability manifest through ingest/review, fleet activation, sandbox execution, Moremi authority, Danu/Nephthys state, trusted services, receipts/audit, and incident rollback. Pair it with the feature index to verify creator and player-visible behavior, not only infrastructure.

Every focused architecture page appears exactly once below. The V7 documentation guide supplies the trust/release model and role paths; the diagram atlas supplies the shared visual language. Backlog, dependencies, gap/review evidence, security and adversarial tests, signed package/runtime state, provider reconciliation, and fleet operations determine completion.

Read failures in the same ownership order. Package or dependency failures stop before activation; sandbox or capability failures terminate the offending realm execution; authority or persistence failures invoke recovery; trusted service failures withhold the requested platform effect; and governance or launch failures preserve the last safe release. That order keeps containment local while ensuring every rejected transition leaves evidence for operators, creators, and appeal reviewers.

Orientation#

Architectural Thesis, the Trust Boundary & Topology — the solve-first thesis, the platform-vs-realm trust boundary, topology, substrates reused, and determinism.

Realm Backbone#

Moremi: Realm Server & Netcode — the server-authoritative realm server and the netcode/replication layer.
Danu Server Meshing & Nephthys Persistence — server meshing for massive populations and the persistence/replication layer.

Executable UGC#

Ixchel: The Modding Runtime & WASM Sandbox — the modding runtime, the WASM sandbox safety model, and content-addressed dependency resolution.

Nàná Data Model, Pheme Voice & Hera Social Graph — the character/economy data model, proximity/radio voice, and the social graph.

Economy, Trust & Governance#

Abundantia: Distribution, Payout, the Economy Firewall & Anti-Fraud — creator distribution/payout, the economy firewall, and anti-fraud.
Sekhmet: Trust, Safety, Child-Protection & Anti-Cheat — the trust/safety/child-protection architecture and anti-cheat/client integrity.
Eunomia Governance & the Ori Cross-Version Bridge — multi-tier governance and the Ori Passport cross-version identity bridge.

Operations#

Hosting, the Realm Fleet, Data & Compliance — hosting/orchestration, the realm fleet, and data residency/compliance.
Observability, Performance, Eval Gates & Launch — observability, performance budgets, build/cook/cert, eval gates, and launch.