tradecipher-blockchain-back.../AGENTS.md

1.2 KiB

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.