mercurymesh-federated-reproducible-marke/README.md

MercuryMesh Federated Reproducible Market Sandbox (MVP)

Overview

• A minimal, portable Python-based MVP for a federated, contract-driven market microstructure sandbox.
• Primitives: MarketStateSnapshot, SharedSignals, PlanDelta, AuditLog.
• Coordination: FederatedCoordinator provides a tiny, safe aggregation layer to mimic cross-venue signal exchange.
• Deterministic replay and auditability are scaffolded around the core data contracts.

What you get in this MVP

• A reproducible Python package: mercurymesh_federated_reproducible_marke
• Lightweight, testable contracts and a toy federated coordinator
• Basic tests ensuring serialization, coordination, and data contracts work as intended
• A test script (test.sh) to run tests and packaging checks

Usage

• Install: python3 -m build (outside-of-repo tooling) and pip install dist/*
• Run tests: bash test.sh

Notes

• This is a starter MVP meant for extension. It intentionally focuses on clarity and correct packaging wiring, not production-grade performance or security.