feedtrust-blockchain-backed-access-contr/AGENTS.md

FeedTrust MVP: Production-Grade Architecture

Overview

• FeedTrust is a modular, blockchain-backed access-control and provenance layer for cross-venue market data feeds. The MVP demonstrates policy-driven data access with verifiable provenance across two venues, via adapters and a simple aggregator.

Tech Stack (Python)

• Policy DSL: policy.py – a lightweight DSL-ish syntax and compiler for access rules.
• Provenance Ledger: ledger_merkle.py – Merkle-tree based proofs of data lineage.
• Adapters: adapters/fix.py, adapters/websocket.py – toy adapters bridging two feed types to a canonical signal format.
• Aggregation: aggregation.py – cross-venue data mixing with lightweight provenance tagging.
• Core: core.py – orchestrates policy checks, ledger interactions, and end-to-end flow.
• Tests: tests/ – unit and integration tests ensuring policy enforcement, ledger proofs, and end-to-end flow.
• Packaging: pyproject.toml – production-grade packaging metadata; README and READY_TO_PUBLISH as per spec.

How to Run (locally)

• Ensure Python 3.11+ is installed.
• Install test dependencies: pytest
• Run tests: ./test.sh
• Build package: python -m build

Files and Responsibilities

• AGENTS.md: This document explains repository structure, testing commands, and contributor rules.
• README.md: Project marketing and integration description.
• test.sh: Test runner that executes pytest and builds the package.
• pyproject.toml: Packaging metadata.
• feedtrust/: Core library code and submodules.
• tests/: Test suite.
• READY_TO_PUBLISH: Empty placeholder signaling publish readiness.

Contribution Rules

• Keep changes minimal and well-scoped.
• Add tests for any new functionality.
• Do not modify published contract semantics without user consent in this repo.

This file is kept deliberately short to avoid noise. It exists to orient contributors and automation tools.