idea160-exprove-open-source/README.md

1.2 KiB

ExProve Open-Source Execution Provenance Engine

ExProve provides cryptographically verifiable provenance primitives for cross-venue execution decisions in equity trading. This repository implements core data contracts and a deterministic planning primitive suitable for testing, backtesting, and regulatory review workflows.

Key Primitives

  • LocalExecutionTask: per instrument/venue planning unit
  • SharedMarketContext: privacy-safe, versioned market signals
  • PlanDelta: incremental routing/size/timing decisions with metadata
  • Attestation/AuditLog: cryptographic attestations and an append-only log
  • GraphOfContracts: registry for adapters and data-contract schemas
  • compute_delta / compute_plan_delta: deterministic, replayable routing plans for a task/context pair

How to use

  • Install dependencies and run tests via the provided test script (test.sh).
  • The core models are defined under exprove.contracts; the reference planner lives in exprove.engine.
  • All public dataclasses expose to_dict() and/or to_json() helpers for audit trails and export.

Development notes

  • This repo focuses on a production-ready, minimal core that can be extended to a full edge-native solver and delta-sync pipeline.