# ExoRoute MVP: Cross-Venue Order Routing Orchestrator

Architecture overview
- Vendor-agnostic cross-venue routing orchestrator with deterministic replay-ready deltas.
- Privacy-first data handling: per-signal budgets and secure aggregation; raw signals stay local.
- Lightweight Graph-of-Contracts registry to map adapters to data contracts and engines.
- Deterministic offline replay via PlanDelta deltas; hash chains for auditability.
- Minimal, extensible DSL: LocalProblem, SharedVariables, PlanDelta, DualVariables, PrivacyBudget, AuditLog, Graph-of-Contracts.

Tech stack (current MVP)
- Language: Python 3.9+
- Core primitives (LocalProblem, SharedVariables, PlanDelta, DualVariables, PrivacyBudget, AuditLog, GraphOfContractsRegistry)
- Lightweight adapters (starter set): FIX/WebSocket price-feed and simulated venue adapters
- Deterministic replay: delta store and hash-based audit trail
- Minimal EnergiBridge-like interoperability layer (prototyping in this repo)

Testing and contribution
- Run tests with: ./test.sh
- Ensure python packaging builds with: python -m build
- Add unit tests for new primitives and basic flow
- Update AGENTS.md if architecture or tests shift

Branching and publishing
- This repo follows a strict, production-focused workflow. Do not publish until all tests pass.
- When ready to publish, ensure pyproject.toml or setup.py exists and README.md documents package usage.

End of document