MercuryMesh MVP Architecture
- Goal: Privacy-preserving market-data federation for cross-exchange analytics.
- Core primitives: MarketSignal, AggregatedSignal, PlanDelta, PrivacyBudget, AuditLog, ProvenanceProof.
- Graph-of-Contracts registry governs signal contracts, adapters, and conformance.
- Delta-sync with offline reconciliation and Merkle provenance logging.
- Lightweight TLS-based transport; plugin adapters for venue feeds.
- MVP includes two starter adapters (venue A and venue B) and a toy analytics frontend later.

Tech Stack (in this repo)
- Language: Python 3.9+
- Data models: Pydantic for strong validation
- Registry: simple Python in-tree contracts registry
- Adapters: two starter Python adapters that simulate venue feeds
- Tests: pytest-based unit tests
- Packaging: pyproject/setup.cfg with setuptools-based build

Testing and commands
- Run tests: bash test.sh
- Build package: python3 -m build
- Linting: optional (not included in MVP)

Contribution rules
- Keep interfaces stable; add adapters without touching core contracts unnecessarily.
- Add tests for new features; ensure existing tests stay green.
- Do not commit secrets or credentials.