36 lines
1.7 KiB
Markdown
36 lines
1.7 KiB
Markdown
# 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
|