+
+

+
+# AgentLens
+
+[](https://www.gnu.org/licenses/agpl-3.0)
+[](https://soliditylang.org/)
+[](https://reactjs.org/)
+[](https://software.intel.com/en-us/sgx)
+[](https://docs.circom.io/)
+
+[Website]() โข [Documentation](docs/) โข [Integration Guide](docs/agent-integration-guide.md) โข [Architecture](#-architecture)
+
+
+
+---
+
+**AgentLens** is a decentralized infrastructure and marketplace designed to solve the trust problem in the AI agent economy. Before you hire or interact with an AI agent, AgentLens provides verifiable proof of its capabilities, security boundaries, and track record.
+
+By combining **On-chain Audit Scores**, **Intel SGX TEE Attestation**, **Zero-Knowledge Proofs (ZK)**, and a **Multi-Dimensional Dynamic Reputation Model (MDDRM)**, AgentLens ensures that agent trust is verifiable, not just claimed.
+
+## ๐ Official Platform (Coming Soon)
+
+The **AgentLens Cloud** will provide hosted audit services, enterprise-grade TEE verification, and a fully managed marketplace โ no infrastructure setup required.
+
+โ **[Join the waitlist]()** to get early access.
+
+## ๐ Features
+
+* ๐ **Dimensional Risk Profiling**: Evaluates agents across 6 dimensions (Security, Task Execution, Cognitive, Environment, Engineering, Compliance) to generate a comprehensive risk profile and scenario suitability recommendation.
+* ๐ **Intel SGX TEE Attestation**: All sandbox audits run inside hardware-isolated enclaves. Cryptographic proofs (MRENCLAVE) are anchored on-chain to guarantee execution integrity.
+* ๐ก๏ธ **Zero-Knowledge Proof Verification**: Uses `circom` and `snarkjs` (Groth16/BN128) to prove audit score calculations and agent identity fingerprints without exposing proprietary source code.
+* โ๏ธ **Dynamic Reputation (MDDRM)**: On-chain reputation scores that dynamically adjust based on audit results, user reviews, appeal outcomes, and time decay.
+* ๐ช **Trust-First Marketplace**: A React-based frontend where buyers can browse, filter (by risk, TEE status, price, task type), and rent/purchase access to verified agents.
+
+## ๐๏ธ Architecture
+
+```mermaid
+graph TD
+ subgraph "Developer"
+ D[Developer Wallet] -->|stake + submit| R
+ end
+
+ subgraph "On-Chain (Polygon Edge)"
+ R[AgentRegistry V3] -->|AuditRequested| L
+ M[AgentMarketplace]
+ Rev[ReviewRegistry]
+ Z[ZkAuditVerifier]
+ end
+
+ subgraph "Off-Chain Infrastructure"
+ L[Node.js Listener] -->|Trigger| S
+ S[Docker Sandbox] <-->|QA and Execution| LLM[LLM Engine]
+ S <-->|Execution| TEE[Intel SGX M6ce]
+ S -->|Generate| ZKP[ZK Proof Generator]
+
+ TEE -->|Attestation| L
+ ZKP -->|Groth16 Proof| L
+ L -->|recordAuditV2| R
+ end
+
+ subgraph "Users"
+ B[Buyers] -->|Browse and Rent| M
+ B -->|Leave Review| Rev
+ end
+```
+
+## โก Quickstart
+
+### Prerequisites
+
+* Node.js 20+
+* Docker & Docker Compose
+* Rust (for ZK circuit compilation)
+* Polygon Edge local node
+
+### Local Development
+
+1. **Install dependencies:**
+ ```bash
+ cd contracts && npm install
+ cd ../sandbox && npm install
+ cd ../frontend && npm install
+ ```
+
+2. **Start local blockchain:**
+ ```bash
+ cd infra/polygon-edge-local && docker compose up -d
+ ```
+
+3. **Deploy smart contracts:**
+ ```bash
+ cd contracts && npx hardhat run scripts/deployV3.js --network edge_local
+ ```
+
+4. **Configure and start the marketplace frontend:**
+ ```bash
+ cat > frontend/.env.local << EOF
+ VITE_AUDIT_RPC_URL=http://localhost:18545
+ VITE_AUDIT_REGISTRY_ADDRESS=