Skip to content

atmo-network/deos

Repository files navigation

DEOS: Deterministic Economic Operating System

A forkable parachain framework for launching sovereign token economies with protocol-owned liquidity and deterministic automation.

DEOS replaces unbounded political governance and vulnerable redemption models with immutable "physics". By encoding liquidity accumulation and token distribution directly into the protocol, it transforms unlimited downside risk into calculable bounded risk.

DEOS is intentionally the foundation layer, not a finished product. It provides the execution substrate for partner teams to fork, customize, and launch their own dApps and living ecosystems.

Why the name DEOS:

  • Deterministic: Protocol-managed economic reactions (minting, distributions, liquidity provision) are explicit and repeatable. They are executed by the runtime scheduler, not left to ad-hoc operator discretion.
  • Economic: The managed domain is capital formation and allocation—not arbitrary general-purpose application logic.
  • Operating System: The runtime kernel, AAA scheduler, routing, and governance act as domain-specific operating services for forked token economies.

TMCTOL (Token Minting Curve with Treasury-Owned Liquidity) is the flagship economic standard currently running on top of DEOS.


1. Key Mechanics

Unidirectional Minting (TMC)

The protocol issues new tokens along a linear price curve. There is no redemption path—minting is the only way to move along the curve. This strict unidirectional rule ensures the ceiling price increases deterministically with supply.

Treasury-Owned Liquidity (TOL)

When tokens are minted, the protocol automatically allocates a fixed share (66.6% in TMCTOL) into XYK liquidity pools. This creates a hyperbolic price floor that cannot reach zero. TOL liquidity is split across four buckets:

Bucket Role Share
A — Anchor Permanent pool liquidity, never withdrawn 50%
B — Building LP unwind → BLDR buyback for ecosystem development 16.6%
C — Capital Gradual LP unwind for treasury operations 16.6%
D — Dormant LP held until governance decides future policy 16.6%

Bidirectional Compression & The Ratchet Effect

A built-in fee is taken on trades and burned, reducing the circulating supply. The true power of this mechanic is its systemic outcome: a bidirectional squeeze that simultaneously lowers the minting ceiling and raises the pool-based floor. This continuously narrows the price corridor and drives the economy toward Elasticity Inversion—a mathematical threshold where new supply expansion no longer degrades the effective floor. Together, these mechanics create a powerful Ratchet Effect: the economy can expand and compress upward, but its baseline value cannot collapse backward.


2. Deterministic Automation (AAA)

The pallet-aaa (Account Abstraction Actors) scheduler is DEOS's deterministic execution engine. Instead of relying on external keepers or centralized bots, DEOS orchestrates protocol operations from within the runtime.

  • Stability Contract: Each actor pipeline has strict weight bounds, distinct fee accounting, and atomicity guarantees. Identical network state produces identical outcomes.
  • Event-Driven: Actors can be triggered by scheduled timers or on-chain events (e.g., specific asset ingress).
  • Execution Plans: Complex economic flows are codified into predictable pipelines. DEOS currently ships with plans for Minting (distributing users/TOL shares), Zapping (converting raw emissions to LP), and Burning (selling accrued fees).

3. Project Topology

  • /docs — Core architectural contracts, specifications, and architecture notes.
  • /template — The Polkadot Omni Node-ready Rust runtime workspace (pallets/, runtime/, primitives/).
  • /web-client — The SvelteKit browser reference UI and transaction flows.
  • /scripts — Operator and developer automation.
  • /simulator — The mathematical proving ground for validating core tokenomics.
  • /wiki — Generated documentation optimized for frontend and newcomer onboarding.

4. Getting Started

DEOS provides a unified local bootstrap script that automates the network environment: downloading the Polkadot SDK binaries (including the Omni Node), building the reference runtime, generating the chain spec, and spinning up a local Zombienet test network.

Prerequisites: Rust and Node.js.

Open Terminal 1 for the network:

# Bootstrap the local network
# (Downloads binaries, builds runtime, starts Omni Node via Zombienet, and seeds state)
./scripts/bootstrap-local-network.sh

Open Terminal 2 for the web client:

# Install dependencies and start the UI
cd web-client
npm install
npm run dev

(Note: When altering tokenomics or invariants, validate the math via node ./simulator/tests.js before touching the runtime)


5. Documentation Index

Entrypoints

Specifications

Architecture Notes

About

Deterministic Economic Operation System

Resources

License

Stars

Watchers

Forks

Contributors