# DeltaX-Forge: Cross-Venue Delta-Driven Execution Slicer (MVP)

This repository implements a minimal, production-oriented MVP of DeltaX-Forge:
- Canonical StrategyDelta DSL with Assets, Legs, MarketSignal, PlanDelta, and AuditLog
- Lightweight LocalVenueSolver per venue and a CentralCurator coordinating across venues
- Adapters to translate MarketSignal -> feed data and PlanDelta -> execution maps
- Deterministic replay via RunLog for post-trade analysis and audits
- Governance-friendly ledger (HMAC-based signatures) for deterministic integrity checks
- A skeleton EnergiBridge binding to bootstrap adapter interoperability

Architecture highlights
- Canonical data model and DSL (StrategyDelta, Asset, MarketSignal, PlanDelta)
- Dual-tier coordination: Local venue solvers + central curator
- Adapters for data feeds and execution (price_feed_adapter, venue_execution_adapter)
- Deterministic replay and auditability (RunLog)
- Privacy-friendly design with per-message metadata and governance ledger (LedgerSigner)

How to run tests locally
- This project uses the standard packaging flow:
  1) Build distribution: python3 -m build
  2) Install the produced wheel: python3 -m pip install dist/*.whl
  3) Run tests: pytest -q

Notes
- The EnergiBridge module under deltax_forge_cross/bridge/ provides a minimal
  scaffold to bootstrap cross-venue adapter interoperability. It is intentionally
  lightweight to avoid impacting the current MVP tests.
- This README intentionally documents the MVP boundaries and extension points for
  future work aligned with the cross-venue, audited DeltaX-Forge roadmap.

Contributing
- If you add new features, ensure unit tests cover them and keep changes scoped.
- Update README and AGENTS.md as architecture evolves.

License: MIT