README.md
On-chain zero-knowledge skill attestation for AI agents on Base
AEGIS Protocol
On-chain zero-knowledge skill attestation for AI agents on Base
What is AEGIS?
AEGIS is a protocol for verifiable AI agent skill attestation. Auditors evaluate AI agent skills, generate zero-knowledge proofs of their assessment, and submit the results on-chain to the AEGIS Registry on Base. Anyone can query, verify, and dispute these attestations — creating a trustless reputation layer for AI agents.
How it works:
- A developer registers a skill definition (what the agent claims to do)
- An auditor evaluates the skill and generates a ZK proof of their assessment
- The attestation (proof + result) is submitted on-chain to the AEGIS Registry
- Anyone can verify the proof on-chain or dispute a fraudulent attestation
How to Use
AEGIS is a trust verification layer for AI agent skills — it does not execute skills. Use it to check whether a skill has been audited before you run it.
import { AegisClient } from '@aegisaudit/sdk';
const aegis = new AegisClient({ chainId: 84532 });
// 1. Discover registered skills
const skills = await aegis.listAllSkills();
// 2. Check attestations for a skill
const attestations = await aegis.getAttestations(skills[0].skillHash);
// 3. Verify the ZK proof on-chain
const trusted = await aegis.verify(skills[0].skillHash, 0);
// 4. If trusted → execute the skill using the publisher's own SDK/API
The typical integration flow:
- Query AEGIS — is this skill registered? Has it been audited?
- Verify the proof — is the audit cryptographically valid?
- Check the stake — how much ETH did the auditor risk on this assessment?
- Execute the skill — get the code from the skill publisher (not from AEGIS) and run it
See the SDK README for a full integration guide with audit levels.
Architecture
aegis/
├── packages/
│ ├── sdk/ # @aegisaudit/sdk — TypeScript client library
│ ├── mcp-server/ # @aegisaudit/sdk — MCP tools for AI agents
│ ├── contracts/ # Solidity smart contracts (Foundry)
│ ├── circuits/ # Noir ZK circuits (Barretenberg)
│ └── cli/ # Command-line interface
├── apps/
│ └── web/ # Frontend — React + Vite + Three.js
└── scripts/ # Deployment & seed scripts
Quick Start
git clone https://github.com/aegis-zk/aegisprotocol.git
cd aegis
pnpm install
pnpm build
Requires Node.js 20+ and pnpm 9+.
Packages
| Package | Description | npm |
|---|---|---|
| `@aegisaudit/sdk` | TypeScript SDK for querying and interacting with the AEGIS Registry | |
| `@aegisaudit/sdk` | MCP server exposing AEGIS as tools for Claude, Cursor, and other AI agents |
Deployed Contracts
| Contract | Network | Address |
|---|---|---|
| AegisRegistry | Base Sepolia | `0x851CfbB116aBdd50Ab899c35680eBd8273dD6Bba` |
Tech Stack
- Language — TypeScript, Solidity, Noir
- Blockchain — Base L2 (Ethereum rollup)
- ZK Proofs — Noir circuits compiled with Barretenberg (BB.js)
- Smart Contracts — Foundry (forge)
- Client — viem
- AI Integration — Model Context Protocol (MCP)
- Frontend — React 19, Vite, Three.js, wagmi
- Build — Turborepo, pnpm workspaces, tsup
Links
- Website — aegisprotocol.tech
- SDK — npmjs.com/package/@aegisaudit/sdk
- MCP Server — npmjs.com/package/@aegisaudit/sdk
- GitHub — github.com/aegis-zk/aegisprotocol
License
MIT
Tools (3)
listAllSkillsDiscover registered skills on the AEGIS Registry.getAttestationsCheck attestations for a specific skill hash.verifyVerify the ZK proof of a skill attestation on-chain.Configuration
claude_desktop_config.json
{"mcpServers": {"aegis": {"command": "npx", "args": ["-y", "@aegisaudit/sdk"]}}}Try it
→List all registered skills currently available on the AEGIS Registry.
→Check the audit attestations for the skill with hash 0x123...
→Verify the ZK proof for the first attestation of this skill to ensure it is safe to execute.
→What is the current risk score and audit level for this AI agent skill?