# 🏛️ KeeperGov AI: Autonomous Multi-Sig DAO Vault Keeper & Governance Execution Engine

> **KeeperGov AI** is an autonomous governance and multi-sig vault execution platform built for **KeeperHub** and **Model Context Protocol (MCP v1.0)**. It solves **"The Last Mile"** for DAO Governance: automatically monitoring passed Snapshot & Tally proposals, verifying timelocks, and executing approved multisig transactions reliably onchain.

---

## 🌟 Key Features

1. **Automated DAO Governance Execution**:
   - Continuously monitors active proposals across Snapshot, Tally, and Safe Multi-Sig vaults. Executes transactions automatically as soon as timelock delays expire.

2. **Governance Payload Guardrail Inspection**:
   - Verifies target contract addresses against whitelisted registries and enforces spending caps to prevent rogue governance attacks.

3. **Dual-Protocol Routing (x402 / MPP)**:
   - Supports x402 HTTP Pay-per-Execution headers and MPP micropayments for seamless agent settlement.

4. **MCP v1.0 Protocol Integration (`/api/mcp`)**:
   - Exposes native JSON-RPC tools for AI agents (ElizaOS, OpenClaw, Hermes, Claude Desktop):
     - `keeper_gov_inspect_proposal`
     - `keeper_gov_execute_vault`
     - `keeper_list_jobs`
     - `keeper_get_audit_trail`

5. **100% Real EIP-1193 Web3 Wallet Extension Popup**:
   - Direct extension popup wallet authentication (MetaMask, Coinbase Wallet, Rabby) for multi-sig transaction approval.

6. **$1,000 Special UX Bounty Teardown Spec**:
   - Technical teardown evaluating `@keeperhub/sdk` DAO multi-sig integration and proposed SDK PR contributions.

---

## 🚀 Quickstart

```bash
# 1. Clone repository
git clone https://github.com/Webghost01-NG/keeperguardian-ai.git
cd keeperguardian-ai

# 2. Install dependencies
npm install

# 3. Start local dev server
npm run dev
```

Open `http://localhost:3001` in your browser.

---

## 📄 License
MIT License.