🛑 ARCHITECTURAL ANCHOR

This project is part of the Berlin AI Automation Studio. It is governed by the global rules in RULES.md.

---

Agent Chain Anchor

Chain-agnostic blockchain anchoring for ZK-SLA proofs, trust scores, and decision audit logs.

🎯 What This Does

The Chain Anchor service provides cryptographic proof anchoring for the AgentOps Suite:

• ZK-SLA Proofs — Anchor proof hashes proving agents met/missed deadlines
• Trust Score Snapshots — Immutable reputation checkpoints
• Decision Audit Logs — Tamper-proof evidence for regulators

The service is chain-agnostic by design, supporting multiple blockchain backends:

• Mock (for testing/development)
• Solana (planned)
• zkSync (planned)
• Starknet (planned)

📡 API Endpoints

Method	Endpoint	Description
GET	/api/health	Health check with current chain status
GET	/api/openapi.json	OpenAPI 3.0 specification
GET	/api/docs	Swagger UI documentation
POST	/api/anchor	Anchor a proof hash on-chain
GET	/api/verify/:txId	Verify an existing anchor

🏗️ Architecture

src/
├── lib/chain-anchor/
│   ├── domain/           # AnchorResult entity, IBlockchainAnchorPort interface
│   ├── application/      # AnchorProof, VerifyAnchor use cases
│   └── infrastructure/   # Chain-specific adapters (Mock, Solana, etc.)
└── app/                  # Next.js App Router (API routes and Dashboard)

🚀 Quick Start

# Install dependencies
npm install

# Start development server
npm run dev

# Run tests
npm run test

# Quality gate (lint + duplication + coverage)
npm run quality

🔗 Dependencies

Service	Purpose
None required	Mock adapter uses in-memory storage

📊 Status

• Deployment: Railway
• Production URL: https://agent-chain-anchor-production.up.railway.app
• Catalog Entry: Microservices_Catalog.md
• OpenAPI: ✅ Agent-Ready

📜 License

MIT