Dysnomia — per-contract dev reference

One doc per contract (~36 named scopes; identical instances share type docs), schema per doc: Identity · Role · Dependencies · State · Function table · Integration notes · Provenance. Function tables are EXTRACTED MECHANICALLY from the recovered sources. Signatures are never hand-transcribed; narrative is hand-written on top.

Standing rules: positive framing (a fully on-chain social OS — chat-world shell — with a partially-staged, MUD-inspired world layer; Second Life-style social virtual world over “game”); Q-3 identity discipline; full addresses; [src]/[chain]/[ext]/[irc] provenance. Onchain snapshot: block 27,584,967 (2026-09-19) unless noted.

Prose pass: every deployed-contract doc carries an “In player terms” block near the top — plain-language rows for what a user actually does with / experiences from the contract, our own words from our own [src]/[chain] understanding (the undeployed set keeps its designed-loop paragraphs instead). The shared vocabulary lives in ../08-glossary.md.

The wiring at a glance

Five panels, one per concern. Legend for every arrow used:

A ──owns──> B    A is a MultiOwnable owner of B (authority; passes on
                 msg.sender OR tx.origin — see dysnomia-base.md)
A ──makes──> B   A deployed B (factory call or constructor internal create)
A ──calls──> B   runtime call path (steady-state dependency)

1 · Wave 1 — the kernel spine (boot order 2024-08-23, ~7 minutes end to end)

Each layer takes ownership of the layers below it as it boots; the deployer EOA 0x0474606332105A1dA6FC8EF7De2470551D389Cb9 remains an owner everywhere via constructor tx.origin adds — so authority flows down AND out.

   SHAFactory ──makes──> SHA  (keypair objects, by the thousand)
   SHIOFactory ──makes──> SHIO (channels; each SHIO owns its two SHAs)
        │                        │
        │   YI.Beta / YI.Kappa ──┘   the system's factory gateways
        ▼                    ▼
        YI ────makes────────> (Fornax) SHIO = YI.Psi
        ▲ │
        │ owns
   ZHENG─┘ │   soul registry Sigma: uint64 Soul → Bao; Mau() = the
        ▲   │   one-call user factory (creates SHA pair + SHIO + slot)
        │   │
     ZHOU ──┘   the global chat target; (Fomalhaute) SHIO = its rod
        ▲
        │
      YAU       boot relay; feeds YANG's Bang leg
        ▲
        │
     YANG       Tai{Bang, Le, Lai}; (Eris) SHIO = Lai; Pole[3] are the
        ▲       public coordinates SIU copies into every user's Saat[0]
        │
      SIU       Miu() = the user gate; Aura() = address mod MotzkinPrime
        ▲
        │
      VOID      sessions; Chat(); the library loader (see panel 3)
        ▲                   ▲
        │ owns              │ registers as libraries
  LibAttribute ────────────┤  ("libattribute")
        ▲                   │
   LAUFactory ──owns────────┘
        │
        └──makes──> LAU  (the user-account token — ×18,660 live)

2 · The user journey (what actually happens when you join and talk)

 joining:
   EOA ──> LAUFactory.New("handle","SYM")
             │
             └─makes─> LAU ──> VOID.Enter(name,symbol)
                                   │
                                   └─calls─> SIU.Miu ──calls─> ZHENG.Mau
                                                              │
                          SHAFactory <──makes── YI.Beta <──────┤
                          SHIOFactory <──makes── YI.Kappa <────┤
                                                              ▼
                          user SHA pair + SHIO ──install──> ZHENG.Sigma[soul]
                          (soul = Random(); aura = address mod p; the user's
                           LAU + wallet own their SHIO, system owns the rod)

 chatting (the main room):
   LAU.Chat(line) ──calls──> VOID.Chat
        │                       │ requires a session + Username attribute
        │                       ▼
        │                 ZHOU's SHIO (Fomalhaute) .Log(soul, aura,
        │                                    "<Username> line")
        ▼                                   │
   meters on the way                      emits LogEvent  ← the chat archive

3 · Wave 2 — the CHO era (2025-02): hub, map, venues

   ReactionsLib ("corereactions") ─┐
   LibStrings    ("strings") ──────┼──register on──> VOID
   LibAttribute  ("libattribute") ─┘

   CHO ──owns──> the entire wave-1 spine (VOID down)
    │  │
    │  └──calls──> ReactionsLib     the entropy orbit: React / Recall /
    │                                ReactUser advance per-user + system state
    │
    ├──< alias-dir (one-shot)       wrote ~90 aliases into CHO's address book:
    │                                "source" = Maria #2, the treasury corpus,
    │                                "mariarahel", ban tokens WITHOUT/…
    │
    │            HECKE             Waat ↔ (lat,lon) meridian transform
    │              ▲               (deployer-created; standalone — everyone
    │              │                reads its constant table)
    ▼              │
   MAP ──New(asset)──makes──> QING (×917 live venues; ONE per ERC-20, ever)
    │  │   coordinate = CHO.Luo() × HECKE.Meridians[0]; tile via
    │  │   HECKE.Compliment (MAP owns CHO + VOID; MAP calls HECKE)
    │  │
    └── QING ◄──mutual ownership──► CHO      venue = chat room + bouncer
         Join(LAU): WITHOUT-ban check | cover charge | 1-day guest list
         Chat(LAU,msg): emits LogEvent(Username, Soul, aura, msg)
         bouncer: staff | ≥25 CROWS | asset stake | asset-owner
         GWAT flag: creation lottery — most venues' escrow is locked forever

4 · Waves 3–5 — the physics ladder + the account layer (2025-03 → 06)

Construction chain — each contract is built against the one to its left (SEI additionally takes ownership of CHAN + CHO, CHEON of CHO + CHAN, CHOA of CHAN; the ladder contracts proper carry only deployer-EOA ownership + market-rate wiring):

 Zürich QING ─> QI ─> MAI ─> XIA ─> XIE ─> CHAN ─> SEI ─> { CHEON, CHOA }
 ("Phobos")                                                    │
                                    ZI ─> PANG ─> RING ─> META │
                                    ▲                          │
                                    └──constructed against─────┘

 physics constants (hardwired):   derived quantities:
   QI   = Eris.balance ÷ entropy     XIA  = modExp(QI, MAI, Fomalhaute)
   MAI  = venue.holdings ÷ entropy   XIE  = (Charge, Omicron, Omega) via Fornax
   (Eris = YANG's SHIO;              ZI/PANG = spins vs CHOA.Yuan (purchasing
    Fomalhaute = ZHOU's;              power = wallet + 10×LAU + 40×YUE)
    Fornax = YI's Psi)               META.Beat = the tile oracle → territory

 accounts:
   EOA ──SEI.Start(LAU)──> YUE (×93 account/vault tokens, one per wallet)
                           │  registered in CHAN.Yan (the directory)
   CHOA.Chat(qing,msg) ───┤  chat-to-mine: QING.Chat + advance YUE bars
        │                 │  + MAI bounty from CHOA's own balance → YUE
        └──> CHAN.ReactYue ──> YUE.React ──> XIE.Power
   CHEON.Su(qing) = the settle primitive (advance + payout + drip)
   custody: ONLY CHAN (with the player's OptIn) may Withdraw/MintToOrigin a YUE

5 · The undeployed world layer ★ and the treasury bridge

 ★WORLD(cheon, meta, map) ──makes──> ★VITUS (seeds 1:1 with MV)
   │   Code(lat,lon,qing): CHEON.Su + META.Beat (Yeo bounds the tile radius)
   │                          + tile mass + VITUS minted to the player's YUE
   └─> ★WAR(world) ──makes──> ★H2O (seeds 1:1 with "Call")
            └─> ★GWAT(war)   user-spawned sub-venues ("…'s <asset> GWAT")

 treasury bridge (deployed, 2026-05-30):
   PKMinter ──makes──> TT   (Parent = the creator's LAU; treasury vocabulary:
    │                      _hu ladder, ho() inbox, FuckOff, TTDATA fallback)
    │  hardcodes V1 TbillMinter, V2 FederalMinter, V3 IndexMinter,
    │  V4 PersonalMinter, BUREAU root + MATH as the mathlib;
    │  GetTreasuryTokenOwner falls back to V3 for non-PKMinter tokens
    ▼
   CHO <──only mint target── Basilica (treasury side, Maria #1, 2025-06-24)

 funding + naming: Maria #2 ──300k PLS──> deployer EOA (25 blocks before
 boot; +100M PLS 2025-03); CHO's address book aliases her as "source";
 the dev's in-world account is the mariarahel LAU (diyat tax recipient).

The shared base

Wave 1 — the kernel (2024-08-23)

Wave 2 — the CHO era (2025-02-25 → 02-27)

Waves 3–5 — the soeng ladder + accounts + tile oracle (2025-03 → 06)

Waves 6–7 — DO + the bridge (2025-06 / 2026-05)

The undeployed world layer — complete in source, never shipped

The undeployed fringe

Further fringe WITHOUT per-contract docs (see ../04-data-layer.md): VirtualDisk (256-byte block device), GasContract.yul (minimal-Yul ERC-20 study), RandomGenerator (precomputed orbit + diyat gas tax), SolidityCreate2Factory (standard CREATE2), ABILookupToken (“CL9” lookup, execute_dc/run_command hints — an undeployed museum piece), std/ ALGOL 61 museum, strategies/ toy-language programs, domain/data/ 411 voxel-asset JSONs, etc/DysnomiaSelfSnipe.sol (community snippet), lib/BesselSolver + lib/registry + lib/yai.sol.old.

The function tables

Every <!-- fntable --> table is generated mechanically from the recovered sources — signatures are never hand-transcribed. The generation tooling does not ship with this portal.