# ExProve: Open-Source Execution Provenance Engine for Cross-Venue Equity Trading

ExProve provides a minimal, production-oriented MVP for verifiable cross-venue execution provenance.

- Core primitives: LocalExecutionTask, SharedMarketContext, PlanDelta, Attestation, AuditLog, GraphOfContracts
- Edge-native planner: deterministic PlanDelta generation for replay and backtesting
- Deterministic delta-synchronization for offline replay
- Python-based MVP with a small test suite and packaging metadata

- How to run
  1. Install dependencies via pyproject.toml (build uses setuptools)
  2. Run test script: bash test.sh
- What’s included
  - AGENTS.md: SWARM guidelines and MVP plan
  - src/exprove: core primitives and engine
  - tests/test_exprove_basic.py: basic unit tests
  - test.sh: build and test harness

This README should evolve as the MVP matures and more adapters and backtests are added.