Provides tools for interacting with the AEGIS Registry on the Base network (an Ethereum Layer 2), allowing for the discovery of registered AI agent skills, retrieval of skill attestations, and verification of zero-knowledge proofs on-chain.
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/APIThe 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/mcp-server — 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 scriptsQuick Start
git clone https://github.com/aegis-zk/aegisprotocol.git
cd aegis
pnpm install
pnpm buildRequires Node.js 20+ and pnpm 9+.
Packages
Package | Description | npm |
TypeScript SDK for querying and interacting with the AEGIS Registry | ||
MCP server exposing AEGIS as tools for Claude, Cursor, and other AI agents |
Deployed Contracts
Contract | Network | Address |
AegisRegistry | Base Sepolia |
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
MCP Server — npmjs.com/package/@aegisaudit/mcp-server
GitHub — github.com/aegis-zk/aegisprotocol
License
MIT