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