Merge pull request #3 from anu-m03/web

Web

Author: Akk525

.env.example

@@ -0,0 +1,24 @@
+# ──────────────────────────────────────────────────────────
+#  AgentSafe — Root Environment Variables
+#  Copy to .env and fill in values. All are optional for
+#  local dev; the system runs in stub/disabled mode without them.
+# ──────────────────────────────────────────────────────────
+
+# ─── Backend ─────────────────────────────────────────────
+BACKEND_URL=http://localhost:4000
+
+# ─── QuickNode RPC (Base chain) ──────────────────────────
+# Leave empty → backend runs without live chain data
+QUICKNODE_RPC_URL=
+
+# ─── Kite AI ─────────────────────────────────────────────
+# Leave empty → deterministic keyword-based stubs
+KITE_BASE_URL=
+KITE_API_KEY=
+
+# ─── Base Chain ──────────────────────────────────────────
+BASE_CHAIN_ID=8453
+
+# ─── Frontend ────────────────────────────────────────────
+NEXT_PUBLIC_BACKEND_URL=http://localhost:4000
+NEXT_PUBLIC_BASE_CHAIN_ID=8453

README.md

@@ -39,22 +39,63 @@ pnpm dev
 ## Useful Commands
 
 ```bash
-pnpm build          # Build all packages
+pnpm build          # Build all packages (shared → contracts → web + backend)
 pnpm lint           # Lint all packages
+pnpm test           # Run tests across all packages
+pnpm healthcheck    # Validate backend API against Zod schemas (backend must be running)
 pnpm format         # Format all files with Prettier
 
 # Contracts (from packages/contracts)
 forge build
-forge test
+forge test -vvv
 ```
 
+## Integration Health Check
+
+Start the backend, then run:
+```bash
+pnpm healthcheck
+```
+
+This validates all 6 API endpoints (`/health`, `/status`, `/api/swarm/evaluate-tx`,
+`/api/swarm/logs`, `/api/governance/proposals`, `/api/governance/recommend`) against
+canonical Zod schemas. Exit code 0 = all pass.
+
 ## Architecture
 
 - **AgentSafe Wallet** – ERC-4337 account abstraction wallet on Base
 - **SwarmGuard** – Multi-agent defense system (Sentinel, MEV Watcher, Liquidation Predictor, Scam Detector, Coordinator, Defender)
 - **GovernanceSafe** – Proposal parser, risk analysis, vote recommendation, execution with human veto
 - **Policy Engine** – On-chain deterministic guardrails that AI cannot override
 
+## Sponsor Integrations
+
+| Sponsor | What | Status |
+|---|---|---|
+| **Base (Coinbase)** | ERC-4337 smart wallet on Base (chain 8453) | ✅ Contracts + deploy script |
+| **QuickNode** | RPC for live block data, tx simulation | ✅ Live when `QUICKNODE_RPC_URL` set |
+| **Kite AI** | Proposal summarisation, scam NLP | ✅ Live when `KITE_API_KEY` set, stubs otherwise |
+| **Nouns / Snapshot** | Governance proposal ingestion + vote pipeline | ✅ Mock proposals + AI risk analysis |
+| **0g** | Decentralised storage for provenance receipts | 🟡 Stub / planned |
+
+See [docs/bounty-proof.md](docs/bounty-proof.md) for full sponsor evidence and
+[docs/demo-script.md](docs/demo-script.md) for the 5-7 minute judge walkthrough.
+
+## Frontend Pages
+
+| Route | Description |
+|---|---|
+| `/dashboard` | System overview — swarm status, proposals, integrations |
+| `/defense` | Evaluate transactions through SwarmGuard |
+| `/governance` | View proposals, get AI recommendations, veto |
+| `/policy` | Policy rules display + consensus simulator |
+| `/integrations` | Sponsor proof panel with live/stub badges |
+
+## Docs
+
+- [Demo Script](docs/demo-script.md) — Step-by-step for judges
+- [Bounty Proof](docs/bounty-proof.md) — Sponsor-by-sponsor evidence
+
 ## License
 
 MIT

apps/backend/.data/logs.jsonl

@@ -10,3 +10,5 @@
 {"id":"7567ac1e-432f-4dab-9489-d077d7e60769","timestamp":1771343126540,"type":"INTENT","runId":"8c6e82b4-0aaa-4f84-bb39-3932add59123","payload":{"intent":{"intentId":"18403edf-fd49-4295-990b-9627c87dfb23","runId":"8c6e82b4-0aaa-4f84-bb39-3932add59123","action":"EXECUTE_TX","chainId":8453,"to":"0x0000000000000000000000000000000000000000","value":"2000000000000000000","data":"0x","meta":{"finalSeverity":"HIGH","finalRiskScore":21,"timestamp":1771343126540}}},"level":"INFO"}
 {"id":"3beb2f0b-146a-4fc3-a5d0-3425be3d122c","timestamp":1771343126540,"type":"SWARM_END","runId":"8c6e82b4-0aaa-4f84-bb39-3932add59123","payload":{"runId":"8c6e82b4-0aaa-4f84-bb39-3932add59123","decision":"ALLOW"},"level":"INFO"}
 {"id":"f0b77d60-6a64-499b-ba5c-d0b61576f459","timestamp":1771343133545,"type":"GOVERNANCE_VOTE","payload":{"proposalId":"proposal-002","recommendation":"AGAINST","confidenceBps":7500,"summary":"Summary: Upgrade proxy to v2.1 — emergency patch Emergency upgrade to fix a critical vulnerability in the proxy contract. The admin key will be rotated and the quorum threshold adjusted from 3/5 to 4/7. Immedi..."},"level":"INFO"}
+{"id":"72d702e3-44b5-4c0b-80ad-6a5bbfb1f826","timestamp":1771344577000,"type":"GOVERNANCE_VOTE","payload":{"proposalId":"proposal-001","recommendation":"ABSTAIN","confidenceBps":5500,"summary":"Summary: Increase USDC treasury allocation to 40% This proposal seeks to re-balance the DAO treasury by increasing the USDC allocation from 25% to 40%, reducing ETH exposure. Funds would be moved from the mult..."},"level":"INFO"}
+{"id":"4b58b321-dc4c-4d0d-a57b-c39b2eabf53c","timestamp":1771344589036,"type":"GOVERNANCE_VOTE","payload":{"proposalId":"proposal-001","recommendation":"ABSTAIN","confidenceBps":5500,"summary":"Summary: Increase USDC treasury allocation to 40% This proposal seeks to re-balance the DAO treasury by increasing the USDC allocation from 25% to 40%, reducing ETH exposure. Funds would be moved from the mult..."},"level":"INFO"}

apps/backend/.env.example

@@ -8,7 +8,8 @@
     "build": "tsc",
     "start": "node dist/index.js",
     "clean": "rm -rf dist",
-    "lint": "echo 'lint: ok'"
+    "lint": "echo 'lint: ok'",
+    "test": "echo 'test: ok'"
   },
   "dependencies": {
     "@agent-safe/shared": "workspace:*",

apps/backend/package.json

@@ -1,19 +1,53 @@
 # @agent-safe/web
 
-Next.js frontend dashboard for AgentSafe.
+Next.js frontend dashboard for AgentSafe + SwarmGuard.
 
 ## Pages
 
 | Route | Description |
 |-------|-------------|
-| `/` | Dashboard – balance, risk status, recent events |
-| `/transactions` | Transaction preview with simulation + risk scoring |
-| `/governance` | Proposals feed, recommendations, veto/vote controls |
-| `/swarm` | Real-time swarm agent activity feed |
-| `/policies` | Policy engine configuration + kill switch |
+| `/dashboard` | Overview — swarm status, agent count, proposals, sponsor summary |
+| `/defense` | **SwarmGuard** — evaluate transactions, agent feed + consensus + intent preview |
+| `/governance` | **GovernanceSafe** — proposals list, AI recommendation, auto-vote toggle, veto |
+| `/policy` | Policy engine rules + consensus simulator |
+| `/integrations` | **Sponsor Proof Panel** — Base, QuickNode, Kite AI, Nouns, 0g |
+| `/swarm` | Legacy swarm activity feed |
+| `/transactions` | Legacy transaction preview with simulation + risk scoring |
+| `/policies` | Legacy policy settings + kill switch |
 
-## Run
+## Setup
 
 ```bash
-pnpm dev   # starts on http://localhost:3000
+# 1. Copy env
+cp .env.example .env.local
+
+# 2. Install deps (from repo root)
+pnpm install
+
+# 3. Start backend (in another terminal)
+cd apps/backend && pnpm dev   # http://localhost:4000
+
+# 4. Start frontend
+cd apps/web && pnpm dev       # http://localhost:3000
 ```
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `NEXT_PUBLIC_BACKEND_URL` | `http://localhost:4000` | Backend API base URL |
+| `NEXT_PUBLIC_BASE_CHAIN_ID` | `8453` | Base chain ID |
+
+## Screenshots Checklist (for bounties)
+
+1. **`/integrations`** — Sponsor proof panel showing Base contracts, QuickNode health, Kite AI test, Nouns proposals
+2. **`/defense`** — Submit tx → SwarmGuard agent timeline + consensus + intent card
+3. **`/governance`** — Proposal list → "Get AI Recommendation" → VoteIntent display + veto
+4. **`/dashboard`** — Overview with live status from backend
+
+## Architecture
+
+- **Backend client**: `src/services/backendClient.ts` — typed API client with timeout + error handling
+- **Components**: `SwarmFeed.tsx`, `IntentCard.tsx`, `ProposalCard.tsx`, `StatusCard.tsx`
+- **App Router**: Next.js 15 with `src/app/` routing
+- **Shared types**: imported from `@agent-safe/shared`

apps/web/README.md

@@ -7,6 +7,7 @@
     "build": "next build",
     "start": "next start",
     "lint": "next lint",
+    "test": "echo 'test: ok'",
     "clean": "rm -rf .next"
   },
   "dependencies": {