{
  "markdown": "# DEOS\n\n> A forkable economic runtime where issuance, liquidity, routing, governance, and automation operate as one bounded cybernetic system.\n\nDEOS is a Polkadot SDK framework for building protocol economies. It moves recurring economic coordination out of multisigs, bots, and operator convention into explicit runtime mechanisms that can be inspected, tested, configured, and forked.\n\n**TMCTOL** is the flagship standard implemented on DEOS. DEOS provides the reusable substrate; TMCTOL defines one concrete economy running on it.\n\n[Start in 60 seconds](./wiki/getting-started/deos-in-60-seconds.en.md) | [Evaluate DEOS](./wiki/getting-started/partner-pitch.en.md) | [Read the specification](./docs/tmctol.specification.en.md) | [Run locally](#run-locally)\n\n---\n\n## One Economic Circuit\n\n- **TMC — deterministic issuance.** A unidirectional curve defines how assets enter circulation without promising protocol redemption.\n- **TOL — owned liquidity.** Mint output can accumulate into protected and governed liquidity lanes under an explicit bucket policy.\n- **DEOS Router — max-output execution.** A bounded set of XYK, TMC, and Native-anchored routes compete by expected recipient output.\n- **DEOS Actors — autonomous operations.** Typed execution plans drive the Burn Actor, Liquidity Actor, splitters, buckets, and treasuries within storage and block-weight bounds.\n- **Governance — constrained change.** Domain-scoped primary/protection tracks execute typed payloads instead of exposing unrestricted administration.\n\nDEOS makes deterministic execution claims, not deterministic market-outcome claims. Liquidity support, burn dynamics, oracle guards, and governance safety hold only under the preconditions defined in the specifications.\n\n---\n\n## Framework, Not Product Policy\n\nDEOS owns reusable mechanisms: runtime primitives, invariants, adapters, bounded read models, validation gates, and reference implementations.\n\nA downstream ecosystem owns its identity, dApps, launch policy, labor model, treasury choices, token names, and concrete economic parameters.\n\nRead the [Framework / Instance Contract](./docs/framework-instance.contract.en.md) before turning the reference topology into a product.\n\n---\n\n## Run Locally\n\n### Requirements\n\n- [Rust](https://rustup.rs/)\n- [Node.js](https://nodejs.org/)\n- Linux environment suitable for Polkadot SDK tooling\n\n### Start the network\n\n```bash\n./scripts/bootstrap-local-network.sh\n```\n\nThis builds the runtime, prepares the chain specification, downloads the required operator binaries, and starts a local Zombienet network through Omni Node.\n\n### Start the reference client\n\n```bash\ncd web-client\nnpm install\nnpm run dev\n```\n\nOptional demo-state seeding, from the repository root:\n\n```bash\n./scripts/seed-web-client-state.sh\n```\n\nSee [`scripts/README.md`](./scripts/README.md) for individual operator workflows and [`template/README.md`](./template/README.md) for Rust workspace commands.\n\n---\n\n## Repository\n\n| Path | Role | Entrypoint |\n| --- | --- | --- |\n| `docs/` | Specifications and shipped architecture | [`docs/README.md`](./docs/README.md) |\n| `template/` | Runtime, pallets, primitives, weights, tests | [`template/README.md`](./template/README.md) |\n| `web-client/` | Browser reference client | [`web-client/README.md`](./web-client/README.md) |\n| `simulator/` | Deterministic TMCTOL mathematical reference | [`simulator/README.md`](./simulator/README.md) |\n| `scripts/` | Bootstrap, validation, benchmarks, administration | [`scripts/README.md`](./scripts/README.md) |\n| `wiki/` | Guided newcomer and frontend knowledge layer | [`wiki/index.en.md`](./wiki/index.en.md) |\n\n### Core contracts\n\n- [TMCTOL Specification](./docs/tmctol.specification.en.md)\n- [DEOS Actors Specification](./template/pallets/actors/docs/specification.en.md)\n- [DEOS Actors External Runtime Embedding Guide](./template/pallets/actors/docs/embedding.md)\n- [DEOS Actors Control-Plane Contract](./docs/actors-control-plane.contract.en.md)\n- [Governance Specification](./template/pallets/governance/docs/specification.en.md)\n- [Read-Model Contract](./docs/read-model.contract.en.md)\n- [Core Architecture](./docs/core.architecture.en.md)\n\n---\n\n## Validate\n\nDefault changed-scope completion gate:\n\n```bash\n./.agents/skills/alignment/scripts/completion-gate.sh\n```\n\nSelect narrower or escalated routes through the [Project Skill Graph](./.agents/skills/README.md) and [`alignment` route matrix](./.agents/skills/alignment/SKILL.md). Run the broad local audit only when that complete surface is intended:\n\n```bash\n./scripts/validate-local.sh fast\n```\n\nWhen tokenomics, formulas, thresholds, or invariants change:\n\n```bash\nnode ./simulator/tests.js\n```\n\n---\n\n## Project State\n\n- [`BACKLOG.md`](./BACKLOG.md) — Open work and external gates\n- [`CHANGELOG.md`](./CHANGELOG.md) — Completed delivery history\n- [`AGENTS.md`](./AGENTS.md) — Durable architecture and engineering protocol\n\nDEOS is infrastructure for economies whose rules must remain visible. It does not make markets predictable; it makes the protocol's own behavior explicit.\n",
  "bytes": 5068,
  "sha": "593065725ec516391a0bbb5fa759620d0e349b9ea37f9182a9605a3754e1e77b",
  "repo_slug": "atmo-network/deos",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_atmo_network_deos_wiki_index_md_597a116f/readme"
}