TradeCipher MVP - Agent Overview

- Architecture: Python-based MVP with a clean separation between data contracts, a tamper-evident ledger, and a placeholder ZK proof generator.
- Tech stack: Python 3.8+, dataclasses, in-memory ledger, JSON serialization. No external databases required for MVP.
- Testing: PyTest test suite covering contracts, ledger, and ZK proof placeholder.
- How to run tests: ./test.sh
- Publishing: when ready, follow the publishing steps in the repo's instructions and ensure READY_TO_PUBLISH is created.

Notes:
- This is a minimal interoperable skeleton designed to be extended into a full cross-venue MVP.
- Additional adapters and contract registries can be added under adapters/ and contracts/ respectively.

New architectural additions in this iteration:
- contract_registry.py: lightweight in-memory registry for versioned data contracts (LocalTrade, SharedSignals, PlanDelta, etc.).
- bridge.py: minimal EnergiBridge to translate between venue payloads and canonical TradeCipher objects.
- adapters.py: added two stub venue adapters (VenueAAdapter, VenueBAdapter) and automatic bootstrap registration for MVP wiring.
- Updated adapters module to import json and ensure safe canonical translations.