# Donkai — Simulation OS for Sovereign Financial & Infrastructure Systems

> Donkai turns static portfolios and platforms into living simulations you can observe, stress-test, and activate. NOT project management. NOT a restaurant.

## Positioning

- **Donkai** = simulation OS inside the UnyKorn ecosystem
- **One-liner**: static portfolios → living simulations with state, health, topology, procedures
- **Audience**: operators, family offices, structured credit, energy developers, tokenization counterparties

## Web3 enforcement (not vibes)

- Policy: five criteria — on_chain, canonical_registry, aatem_spec, utility_circuits, event_emission
- Status: web3_native | web3_partial | needs_repair | art_only | legacy_mode
- AATEM = governance layer (UNYKORN, Donkai, TROPTIONS)
- Six mandatory blocks: asset_anchor, legal_wrapper, token_model, rights_model, simulation_model, market_controls
- AATEM spec: https://donkai.org/aatem/
- APIs: /api/aatem, /api/aatem/standard, /api/aatem/governance, /api/aatem/policy, /api/aatem/{id}/validate
- APIs: /api/web3/compliance, /api/web3/gaps, /api/web3/templates
- Page: https://donkai.org/web3/enforcement/
- gap_checker runs nightly via donk-web3-builder → repair_board

## Brand pillars

1. Sovereign — self-hosted, zero-exposed ports, canonical doc pipelines
2. Canonical — registry rows, portfolio views, health records, doc sets
3. Simulated — MTN lifecycles, project DNA, loan flows, time + state
4. Agentic — swarms observe, repair, execute (Nerve, gap_checker, repair_board)

## Modules

| Module | Purpose | Entry |
|--------|---------|-------|
| Donkai Registry | Canonical inventory | https://platform.unykorn.org/ |
| Donkai Twin | Per-entity digital twins | https://donkai.org/web3/twins/ |
| Donkai Nerve | Health, gap detection, repair | https://donkai.org/dashboard/ |
| Donkai Scenarios | What-if simulation runs | https://donkai.org/simulation/ |
| Donkai Views | Atlas, cockpit, metaverse | https://donkai.org/metaverse/ |

## Key pages

- Home: https://donkai.org/
- Entities: https://donkai.org/entities/
- Simulation: https://donkai.org/simulation/
- MTN Twin: https://donkai.org/simulation/mtn/
- Genesis Twin: https://donkai.org/simulation/genesis/
- Genesis API: https://donkai.org/api/simulation/genesis
- Genesis reboot: POST https://donkai.org/api/simulation/genesis/reboot
- Status: https://donkai.org/status/

## Example twins

- MTN seasoned basket: twin:mtn:seasoned-basket-2026 (US404280AH22)
- Genesis Protocol: twin:genesis:protocol-world-2026 (13-crate metabolic sim, web3_partial, platform-class not AATEM)
  - Zenodo: https://doi.org/10.5281/zenodo.18729652
  - Showcase: https://donkai.org/genesis/
  - Determinism proof: https://donkai.org/genesis/#determinism
  - crates.io: genesis-multiverse
- TROPTIONS OS, Exchange OS, XRPL Loans Platform Hub
- Energy project DNA sequences

## APIs

- https://donkai.org/api/donk/health
- https://donkai.org/api/metaverse/agents
- https://donkai.org/data/mtn-seasoned-basket.json
- https://donkai.org/data/genesis-world.json
- https://donkai.org/api/simulation/genesis
- https://donkai.org/.well-known/donkai.json

## Ecosystem

- UnyKorn: https://unykorn.org/
- Doc Intelligence: https://docs.unykorn.org/
- TROPTIONS: https://troptions.unykorn.org/
- Platform Hub: https://platform.unykorn.org/