# ExoRoute: Cross-Venue Order Routing Orchestrator (EnergiBridge skeleton)

This repository provides a production-ready skeleton for ExoRoute, a cross-venue order routing and hedging orchestrator with deterministic replay semantics and privacy-preserving data handling.

- Core primitives (LocalProblem, SharedVariables, PlanDelta, DualVariables, PrivacyBudget, AuditLog, GraphOfContractsRegistry)
- Minimal EnergiBridge mapping layer to a canonical Graph-of-Contracts IR
- Packaging scaffolding for a robust build and distribution (pyproject.toml)

Usage
- Run tests: ./test.sh
- Build package: python -m build
- Import and exercise core primitives:
  - from exoroute import LocalProblem, SharedVariables, PlanDelta, DualVariables

Roadmap alignment
- Phase 0: protocol skeleton + 2 adapters (FIX/WebSocket price-feed, simulated venue) over TLS
- Phase 1: governance ledger and identity management
- Phase 2: cross-venue demo with toy two-asset setup
- Phase 3: SDKs, conformance tests, and audit dashboards

This repo adheres to the ExoRoute architecture described in AGENTS.md at the repository root.