DEX-OS is a comprehensive operating system for decentralized exchanges, providing a complete infrastructure for building, deploying, and managing DEX platforms.
os-dex-full/
├── Cargo.toml ← Workspace root
├── README.md ← Full docs + deployment
├── docker-compose.yml ← Local chain + services
├── rust-toolchain.toml ← Rust nightly (edition2024)
├── crates/ ← Shared libs (5K LoC)
│ ├── security/ ← Your protection layer
│ ├── crypto/ ← ZK + sigs
│ └── p2p/ ← libp2p utils
├── kernel/ ← 18.5K LoC (from previous tarball)
│ └── ... (vm/, consensus/, etc.)
├── chains/ ← Multi-chain adapters (8K LoC)
│ ├── evm/ ← Solidity hooks + ethers-rs
│ ├── svm/ ← Serum DEX fork (Rust programs)
│ │ └── programs/ ← Anchor-based AMM (from solana-labs/dexterity)
│ ├── cosmwasm/ ← DEX contracts (from multiversx/mx-exchange-sc)
│ │ └── contracts/ ← Pair, Router, Factory (Rust + CosmWasm)
│ └── ibc/ ← Hyperlane + IBC relay
├── plugins/ ← Extensible modules (6K LoC)
│ ├── hooks/ ← WASM hooks (V4-style)
│ ├── ai/ ← Fee oracle + keeper agents
│ └── mev/ ← Shield + private mempool
├── services/ ← Off-chain Rust microservices (12K LoC)
│ ├── p2p/ ← libp2p node (from rust-libp2p examples)
│ ├── indexer-zk/ ← ZK-rollup event processing
│ ├── api/ ← GraphQL + REST (Axum)
│ ├── bundler-zk/ ← AA bundler (ERC-4337)
│ └── security-monitor/ ← Anomaly detection
├── ui/ ← Frontend (8K LoC)
│ ├── pwa/ ← Yew + Tailwind (from jetli/rust-yew-realworld-example-app)
│ │ └── src/ ← Components: Swap, Pool, Wallet
│ ├── tauri/ ← Desktop app (Tauri + Yew)
│ └── ai-chat/ ← Grok-like trade assistant
├── tests/ ← 12-layer matrix (5K LoC)
│ ├── security/ ← Reentrancy, DoS, ZK exploits
│ ├── fuzz/ ← Proptest for inputs
│ ├── chaos/ ← Node crashes (chaos-mesh)
│ └── e2e/ ← Cypress for UI flows
├── infra/ ← Deployment (3K LoC)
│ ├── docker/ ← Services + local node
│ ├── k8s/ ← Manifests
│ └── offline/ ← Air-gapped sync
└── governance/ ← DAO (2K LoC)
├── dao/ ← On-chain voting (Substrate pallet)
└── treasury/ ← Fee distribution
Before setting up the project, ensure you have the following installed:
- Rust nightly toolchain (required for edition2024 support)
- Node.js (for development tools)
- Docker (for containerized services)
- GPG (for Git commit signing)
Run the automated setup script for your platform:
Windows (PowerShell):
.\setup-environment.ps1Linux/macOS (Bash):
chmod +x setup-environment.sh ./setup-environment.sh
-
Install Rust nightly (required for edition2024 support):
rustup install nightly rustup default nightly
-
Build the workspace:
cargo build
-
Run tests:
cargo test
The kernel provides the core virtual machine and consensus mechanisms.
Multi-chain adapters for various blockchain networks:
- EVM: Ethereum Virtual Machine support
- SVM: Solana Virtual Machine support
- CosmWasm: Cosmos-based smart contracts
- IBC: Inter-Blockchain Communication protocol
Extensible modules that can be added to enhance functionality:
- Hooks: WASM-based extension points
- AI: Artificial intelligence modules for fee optimization and keeper agents
- MEV: Miner Extractable Value protection mechanisms
Off-chain microservices that support the DEX operations:
- P2P: Peer-to-peer networking
- Indexer-ZK: Zero-knowledge rollup event processing
- API: GraphQL and REST APIs
- Bundler-ZK: Account abstraction transaction bundler
- Security Monitor: Anomaly detection and threat monitoring
Frontend applications:
- PWA: Progressive Web App using Yew and Tailwind CSS
- Tauri: Desktop application
- AI Chat: AI-powered trading assistant
The system can be deployed using Docker Compose for local development or Kubernetes for production environments.
This project is licensed under either of:
- Apache License, Version 2.0
- MIT License
at your option.