community
/
mercurymesh-privacy-preserving-market-da
17
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
mercurymesh-privacy-preserv.../AGENTS.md

1.1 KiB
Raw Blame History

MercuryMesh Agents

Architecture overview

  • Client adapters (VenueAdapter implementations) produce Signals at data sources near venues.
  • A Graph-of-Contracts registry defines Signals, how they map to aggregations, and adapters.
  • Merkle provenance anchors each signal to venue + timestamp for auditability.
  • Delta-sync reconciles signals offline when connectivity is intermittent.
  • Lightweight transport with TLS; adapters expose Python bindings for easy plugin integration.
  • Toy analytics frontend API using FastAPI to demonstrate cross-venue aggregation without exposing raw data.

Tech stack

  • Python 3.9+
  • FastAPI for API surface
  • Pydantic for data models (via Signals)
  • Lightweight Merkle provenance (SHA-256)
  • Simple delta-sync algorithm for MVP

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 for venues without touching core contracts.
  • Write tests for new features; ensure existing tests remain green.
  • Update AGENTS.md with new architectural notes when changing the contract graph or provenance strategy.