Dysnomia Smart Contract Ecosystem

Overview

Dysnomia is a sophisticated PulseChain-based smart contract ecosystem implementing:

• ERC20-like token mechanics with multi-owner governance
• Cryptographic state transformations using modular exponentiation
• Geographic coordinate-based mapping system (Hecke Meridians)
• User identity/session management with “Soul” IDs
• Encryption/messaging between users
• Gaming/voting mechanics with acronym system

What This Means For Players

Plain English Summary: Dysnomia is an on-chain game and social platform where you create a player account, join venues (like chatrooms or marketplaces), claim territory, earn rewards, and trade tokens. Think of it as a blockchain-based virtual world where everything you do - from chatting to claiming land - is recorded on-chain and earns you various rewards.

Real-World Analogy: Imagine a massively multiplayer online game where instead of a company running the servers, everything runs on the blockchain. Your character (LAU token), your inventory (YUE wallet), the places you visit (QING venues), and the land you own (WORLD territories) are all permanent, verifiable, and tradeable. It’s like a combination of Second Life, a cryptocurrency exchange, and a social chat platform.

What You Can Do:

• Create an account (LAU) - Your permanent on-chain identity with a Soul ID
• Chat & socialize - Send messages in venues using your LAU
• Explore venues (QINGs) - Visit different locations on the game map
• Claim territory (WORLD) - Become a creator and earn VITUS credits
• Battle for resources (WAR) - Fight to earn H2O (water) tokens
• Trade tokens - Exchange any game currency using built-in market rates
• Play word games - Submit acronym guesses and vote on submissions

Architecture Diagram

A clickable dependency graph — click any node to open its technical reference page. Two clusters: the core pipeline (identity, crypto, and DeFi contracts) and the domain contracts (venues, territory, and the Soeng power chain).

graph TD
    subgraph Core["Core Pipeline"]
        LAUFactory["LAUFactory (11c)"] -->|creates| LAU["LAU (11)<br/>User Layer"]
        LAU --> DYSNOMIA["DYSNOMIA (01/01v2)<br/>Base Token"]
        DYSNOMIA --> VMREQ["VMREQ (00b)<br/>RNG Core"]
        DYSNOMIA --> SHA["SHA (02)<br/>Crypto"]
        SHA --> SHIO["SHIO (03)<br/>Rod/Cone"]
        SHIO --> YI["YI (04)<br/>DeFi Orch"]
        YI --> ZHENG["ZHENG (05)<br/>Installer"]
        LAU --> VOID["VOID (10)<br/>Sessions"]
        VOID --> SIU["SIU (09)<br/>Token Gen"]
        SIU --> YANG["YANG (08)<br/>Aggregator"]
        YANG --> YAU["YAU (07)<br/>Protocol"]
        ZHENG --> ZHOU["ZHOU (06)<br/>Market Rate"]
        YAU --> ZHOU
    end

    subgraph Domain["Domain Contracts"]
        CHO["CHO (dan)"] --> QING["QING (dan)"]
        QING --> MAP["MAP"]
        CHO --> CHAN["CHAN (sky)"]
        QING --> YUE["YUE"]
        MAP --> WORLD["WORLD"]
        CHAN --> YUE
        YUE --> WORLD
        CHAN --> CHOA["CHOA (sky)"]
        WORLD --> CHEON
        CHOA --> SEI["SEI (tang)"]
        SEI --> CHEON["CHEON (tang)"]
        CHEON --> META["META (tang)"]

        subgraph Soeng["Soeng Chain — Power Progression"]
            QI["QI"] --> MAI["MAI"] --> XIA["XIA"] --> XIE["XIE"] --> ZI["ZI"] --> PANG["PANG"] --> GWAT["GWAT"]
        end

        H2O["H2O (asset)"]
        VITUS["VITUS (asset)"]
        WAR["WAR (game mechanics)"]
    end

    click LAUFactory "/technical/core/11c_laufactory/"
    click LAU "/technical/core/11_lau/"
    click DYSNOMIA "/technical/core/01_dysnomia/"
    click VMREQ "/technical/core/00b_vmreq/"
    click SHA "/technical/core/02_sha/"
    click SHIO "/technical/core/03_shio/"
    click YI "/technical/core/04_yi/"
    click ZHENG "/technical/core/05_zheng/"
    click VOID "/technical/core/10_void/"
    click SIU "/technical/core/09_siu/"
    click YANG "/technical/core/08_yang/"
    click YAU "/technical/core/07_yau/"
    click ZHOU "/technical/core/06_zhou/"
    click CHO "/technical/domain/dan/cho/"
    click QING "/technical/domain/dan/qing/"
    click MAP "/technical/domain/map/"
    click CHAN "/technical/domain/sky/chan/"
    click YUE "/technical/domain/yue/"
    click WORLD "/technical/domain/world/"
    click CHOA "/technical/domain/sky/choa/"
    click SEI "/technical/domain/tang/sei/"
    click CHEON "/technical/domain/tang/cheon/"
    click META "/technical/domain/tang/meta/"
    click QI "/technical/domain/soeng/qi/"
    click MAI "/technical/domain/soeng/mai/"
    click XIA "/technical/domain/soeng/xia/"
    click XIE "/technical/domain/soeng/xie/"
    click ZI "/technical/domain/soeng/zi/"
    click PANG "/technical/domain/soeng/pang/"
    click GWAT "/technical/domain/soeng/gwat/"
    click H2O "/technical/domain/assets/h2o/"
    click VITUS "/technical/domain/assets/vitus/"
    click WAR "/technical/domain/dan/war/"

Search All Contracts

53 of 53 contracts

ACRONYMACRONYM is the data structure for the acronym game/voting mechanic. It stores a user's phrase submission along with their identity information.ATTRIBUTEATTRIBUTE is the user attribute storage library. It manages key-value attributes for users identified by Soul ID, supporting both generic attributes and…BaoBao is the central operation context structure used throughout the Dysnomia ecosystem. It encapsulates a SHIO pair with associated state and reaction…CHANCHAN is the player channel manager that coordinates YUE (player banks) and handles opt-in mechanics for game contracts. It provides controlled access to…CHEONCHEON is the player management contract that coordinates player rewards through the Su function. It manages interactions between SEI and CHAN.CHOCHO is the primary login and user authentication contract. It manages user delegation, entropy tracking, and system address registry. CHO serves as the…CHOACHOA is the game operations contract that handles player gameplay actions. It manages playing, chatting, and coordinates with SEI for player state.COREREACTIONSLIBCOREREACTIONSLIB provides centralized reaction functions for the Dysnomia ecosystem. It orchestrates entropy-based state transformations across multiple…DSSDSS is a utility contract that allows users to chat and purchase their own LAU tokens atomically. It's designed for users who want to interact with the…DYSNOMIADYSNOMIA is the abstract base token contract for the entire ecosystem. It implements ERC20-like functionality with multi-owner governance, market rate…DYSNOMIADYSNOMIA V2 is an alternate implementation of the base token with minor internal differences. It's functionally equivalent to DYSNOMIA but used by…ENCRYPTENCRYPT is the encryption library for secure user-to-user messaging. It uses the SHIO reaction mechanism to perform stream cipher encryption, allowing…FaFa is the core state container for SHA tokens. It holds cryptographic values used in modular exponentiation operations and pairing protocols.GWATGWAT is the seventh and final contract in the soeng chain. It creates derivative QINGs (also called GWATs) that are personal variations of existing QINGs.H2OH2O is the water token created by WAR. It represents a game resource with controlled minting and overflow mechanics.HeckeHecke implements a geographic coordinate system with 90 meridian bands. It maps large numbers (Waat values) to latitude/longitude coordinates, enabling…LAULAU is the user interface layer contract that provides a personal token for each user. It wraps VOID functionality with user-specific context and manages…LAUFactoryLAUFactory is the factory contract for deploying new LAU user token instances. It manages the connection to VOID and handles ownership configuration…MAIMAI is the second contract in the soeng chain. It extends QI calculations to incorporate QING-specific balance data.MAPMAP is the geographic token registry that maps tokens to coordinates using the Hecke meridian system. It manages QING token creation and provides…METAMETA is the meta-calculation contract that provides the Beat function for computing game values. It coordinates between RING and the power calculation…MultiOwnableMultiOwnable is an abstract contract providing multi-owner access control. Unlike OpenZeppelin's Ownable which has a single owner, MultiOwnable allows…PANGPANG is the sixth contract in the soeng chain. It provides the Push function that combines ZI's Spin with additional power calculations.PKMinterCreates player-owned TT contracts after CHO validates the caller's active LAU and the submitted signer set.QIQI is the first contract in the soeng chain. It provides energy calculations based on SHIO balances and entropy values for both users and QINGs.QINGQING is the token wrapper contract that creates tradeable representations of any token with geographic positioning, access control, and chat…RegistryRegistry is a flexible key-value storage contract supporting multiple data types. It provides a generic storage mechanism with type conversion utilities…RINGRING is the time/moment tracking contract that calculates Eta values and tracks player moments. It coordinates with PANG for push operations.SEISEI is the player onboarding contract that creates YUE (player bank) instances and manages the Start function for new players.setaddressessetaddresses is a deployment contract that registers known system addresses in CHO. It's a one-time initialization contract that populates the named…SHASHA is a cryptographic state token that implements modular exponentiation-based transformations. Each SHA instance maintains internal state (Fa) that can…SHAFactorySHAFactory is a factory contract for deploying new SHA token instances. It handles ownership setup and transfer during creation.SHIOSHIO (Paired Token System) combines two SHA tokens (Rod and Cone) into a cryptographically-bound pair. The pairing enables symmetric reactions and logging…SHIOFactorySHIOFactory is a factory contract for deploying new SHIO token instances with proper ownership configuration for both the SHIO and its underlying SHA…SIUSIU is the token generation contract with Aura identity. It provides the bridge between the protocol infrastructure and user-facing operations, generating…STRINGLIBSTRINGLIB provides string manipulation utilities including palindrome checking, string reversal, acronym validation, and random acronym generation for the…TTA player-created PKI token whose creator controls signer permissions, stored data, ownership transfer, and asset withdrawal.UserUser is the identity structure for users in the Dysnomia ecosystem. It combines a Soul ID with a Bao operation context, username, and entropy value.UserVoteUserVote tracks a user's voting activity in the acronym game, including their vote choice, submission count, and current round.VITUSVITUS is the creator reward token distributed by WORLD. It represents accumulated creation credits that can be withdrawn by players.VMREQVMREQ (Virtual Machine Request) is the random number generator contract for the Dysnomia ecosystem. It uses modular exponentiation with pre-seeded state…VOIDVOID is the user session and chat management contract. It handles user registration, authentication, chat logging, and attribute storage. It serves as the…WARWAR is the game mechanics contract for territory warfare and resource generation. It manages H2O (water) token minting and CO2 accumulation based on…WORLDWORLD is the world simulation contract that manages territory, creation tracking, and reward distribution. It coordinates between players, geographic…XIAXIA is the third contract in the soeng chain. It calculates charge values using Fomalhaute SHIO and combines QI and MAI calculations.XIEXIE is the fourth contract in the soeng chain. It calculates power values using Fornax SHIO and provides the Power function used throughout the game.YANGYANG is the multi-state aggregator that creates a three-part state structure (Bang, Lai, Le). It orchestrates multiple reactions and installations to…YAUYAU is the protocol coordinator that extends the installation chain by creating a secondary Rod installation. It reacts against ZHOU and stores the…YIYI is the DeFi orchestration layer that manages SHIO creation, Bao operations, and coordinates between SHA/SHIO factories. It serves as the primary…YUEYUE is the player's personal bank contract. Each player has a YUE that holds their assets, manages exchange rates, and provides withdrawals. It integrates…ZHENGZHENG is the Rod/Cone installation manager that handles registering and installing Bao operations into indexed slots. It provides the infrastructure for…ZHOUZHOU is the market rate orchestrator that initializes a complete token hierarchy during deployment. It creates a primary SHIO pair and installs it as a…ZIZI is the fifth contract in the soeng chain. It provides spin calculations using CHOA's Yuan and CHO's (Tethys) balance data.

Key Constants

Constant	Value	Description
MotzkinPrime	953467954114363	Prime number used across all cryptographic operations
Gua	1652929763764148448182513644633101239607891671119935657884642	Universe constant in CHO

Core Data Structures

Fa (SHA State)

struct Fa {
    uint64 Base, Secret, Signal, Channel, Contour, Pole;
    uint64 Identity, Foundation, Element, Coordinate;
    uint64 Charge, Chin, Monopole;
}

Bao (Operation Context)

struct Bao {
    address Phi;      // Address reference
    SHA Mu;           // Associated SHA token
    uint64 Xi, Pi;    // State values
    SHIO Shio;        // Associated SHIO pair
    uint64 Ring;      // Ring value
    uint64 Omicron, Omega;  // Reaction outputs
}

User

struct User {
    uint64 Soul;       // 64-bit user identifier
    Bao On;            // User's Bao context
    string Username;   // Display name
    uint64 Entropy;    // User-specific entropy
}

Contract Categories

Core Contracts

Base infrastructure including token mechanics, cryptographic primitives, and session management.

Contract	Purpose
VMREQ	Random number generation via modular exponentiation
DYSNOMIA	Base ERC20-like token with market rates
SHA	Cryptographic state token
SHIO	Paired Rod/Cone token system
YI	DeFi orchestration layer
ZHENG	Rod/Cone installation manager
ZHOU	Market rate orchestrator
YAU	Protocol coordinator
YANG	Multi-state aggregator
SIU	Token generation with Aura identity
VOID	User session & chat management
LAU	User interface layer

Domain Contracts

Application-specific logic for gaming, mapping, and asset management.

• dan/: CHO (login), QING (tokens), WAR (game)
• sky/: CHAN (player), CHOA (game), RING (time)
• soeng/: QI→MAI→XIA→XIE→ZI→PANG→GWAT chain
• tang/: SEI, CHEON, META (player management)
• assets/: H2O, VITUS (game currencies)

Library Contracts

Reusable utilities and helpers.

Library	Purpose
MultiOwnable	Multi-owner access control
Registry	Key-value storage
Encrypt	User-to-user encryption
StringLib	String manipulation
Hecke	Geographic coordinate system
ReactionsCore	Entropy-based reactions
Attribute	User attribute storage

Include Structures

Shared data structures used across contracts.

Structure	Purpose
Fa	SHA state container
Bao	Operation context
User	User identity
Acronym	Game voting entry
UserVote	Vote tracking

License

All contracts use SPDX-License-Identifier: Sharia

Solidity Version

All contracts target Solidity ^0.8.21

Cross-Reference Legend

• Inherits: Contract extends another contract
• Uses: Contract calls functions on another contract
• Creates: Contract deploys new instances of another contract
• Owns: Contract holds ownership privileges on another contract