fix(general): remove unused deps, cleanup schemas

Author: dineshpinto

CONTRIBUTING.md

@@ -20,22 +20,23 @@ We strive for high-quality, maintainable code. Please adhere to the following pr
     - Use descriptive names for variables, functions, and classes.
     - Keep code focused and avoid unnecessary complexity.
 
-2.  **Strict Type Safety:**
+2.  **Formatting, Linting & Type-Checking:**
 
-    - This project uses **strict type hinting**, enforced by **`pyright`**.
-    - **All new code MUST include accurate type hints.**
+    - Use [ruff](https://docs.astral.sh/ruff/) for formatting and linting, both settings are defined in `pyproject.toml`.
+    - Use [pyright](https://github.com/microsoft/pyright) for type checking, all new code MUST include accurate type hints.
     - Avoid using `typing.Any` unless absolutely necessary and clearly justified in comments.
-    - Ensure your code passes `pyright` checks without errors. (`uv run pyright`).
-
-3.  **Linting & Formatting:**
-    - We use **`ruff`** for comprehensive linting and code formatting.
-    - Your code must be free of `ruff` linting errors and warnings.
-    - Run the linter and formatter before committing:
+    - You can also install [Pylance](https://marketplace.visualstudio.com/items?itemName=ms-python.vscode-pylance) into VSCode for an easier experience.
+    - Ensure your code passes all checks locally without errors:
       ```bash
-      uv run lint
-      uv run format
+      uv run ruff format
+      uv run ruff check --fix
+      uv run pyright
       ```
 
+3.  **Use dependencies sparingly:**
+    - Every dependency added is a potential security risk.
+    - If the dependency is required, it should live in under `[project.optional-dependencies]` with a key marking the high level function, e.g. `rag`, `consensus`.
+
 ## 🧪 Test Extensively
 
 - New features **must** include appropriate unit and/or integration tests using `pytest`.

pyproject.toml

@@ -8,7 +8,7 @@ license-files = ["LICENSE"]
 authors = [
     { name = "Dinesh Pinto", email = "annual.fallout_0z@icloud.com" }
 ]
-keywords = ["flare", "blockchain", "ai", "agent", "sdk", "confidential computing"]
+keywords = ["flare", "confidential-space", "blockchain", "ai", "agent", "sdk", "confidential computing"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
@@ -19,20 +19,17 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3 :: Only",
     "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed"
 ]
 requires-python = ">=3.12"
 dependencies = [
-    "aiohttp>=3.11.14",
     "google-genai>=1.8.0",
     "httpx>=0.28.1",
     "pydantic>=2.11.1",
     "pydantic-ai>=0.0.46",
     "structlog>=25.2.0",
     "tenacity>=8.2.3,<9.0.0",
-    "web3>=7.10.0",
-    "pillow>=11.3.0",
-    "pymupdf>=1.26.1",
-    "pytesseract>=0.3.13",
+    "web3>=7.10.0"
 ]
 
 [project.urls]
@@ -47,25 +44,28 @@ flare-ai-kit = "flare_ai_kit.main:start"
 [project.optional-dependencies]
 rag = [
     "qdrant-client>=1.13.3",
-    "dulwich>=0.23.2",
+    "dulwich>=0.23.2"
 ]
 social = [
     "python-telegram-bot>=22.0",
     "tweepy>=4.15.0",
     "async_lru>=2.0.5",
     "slack-sdk>=3.26.2",
-    "discord.py >=2.3.2",
-    "httpx >=0.27.0"
+    "discord.py>=2.3.2"
 ]
 tee = [
     "cryptography>=44.0.2",
     "pyjwt>=2.10.1",
-    "pyopenssl>=25.0.0",
-    "python-dotenv >=1.0.1" 
+    "pyopenssl>=25.0.0"
 ]
 a2a = [
     "fastapi[standard]>=0.116.1",
 ]
+ingestion = [
+    "pillow>=11.3.0",
+    "pymupdf>=1.26.1",
+    "pytesseract>=0.3.13"
+]
 
 [build-system]
 requires = ["hatchling"]

src/flare_ai_kit/common/schemas.py

@@ -2,7 +2,9 @@
 
 from dataclasses import dataclass
 from enum import Enum
-from typing import Literal, override
+from typing import Any, Literal, override
+
+from pydantic import BaseModel
 
 
 # --- Schemas for Text Chunking and Embeddings ---
@@ -182,4 +184,82 @@ class RedemptionRequest:
     recipient_underlying_address: str
 
 
+# --- Agents ---
+
 AgentRole = Literal["user", "system", "assistant", "summarizer", "critic", "filter"]
+
+# --- DA Layer ---
+# This uses Pydantic for stricter validation.
+
+
+class AttestationRequest(BaseModel):
+    """Represents an attestation request structure."""
+
+    attestation_type: str
+    source_id: str
+    message_integrity_code: str
+    request_body: dict[str, Any]
+
+
+class AttestationResponse(BaseModel):
+    """Represents an attestation response structure."""
+
+    attestation_type: str
+    source_id: str
+    voting_round: int
+    lowest_used_timestamp: int
+    request_body: dict[str, Any]
+    response_body: dict[str, Any]
+
+
+class MerkleProof(BaseModel):
+    """Represents a Merkle proof for attestation verification."""
+
+    merkle_proof: list[str]
+    leaf_index: int
+    total_leaves: int
+
+
+class AttestationData(BaseModel):
+    """Complete attestation data including response and proof."""
+
+    response: AttestationResponse
+    proof: MerkleProof
+
+
+class VotingRoundData(BaseModel):
+    """Data for a specific voting round."""
+
+    voting_round: int
+    merkle_root: str
+    timestamp: int
+    total_attestations: int
+    finalized: bool
+
+
+class FTSOAnchorFeed(BaseModel):
+    """FTSO anchor feed data structure."""
+
+    id: str
+    name: str
+    decimals: int
+    category: str
+    description: str
+
+
+class FTSOAnchorFeedValue(BaseModel):
+    """FTSO anchor feed value with proof."""
+
+    id: str
+    value: int
+    timestamp: int
+    decimals: int
+    proof: MerkleProof
+
+
+class FTSOAnchorFeedsWithProof(BaseModel):
+    """FTSO anchor feeds with proof for a specific voting round."""
+
+    voting_round: int
+    merkle_root: str
+    feeds: list[FTSOAnchorFeedValue]