Aegis-ZK

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:

1. A developer registers a skill definition (what the agent claims to do)

2. An auditor evaluates the skill and generates a ZK proof of their assessment

3. The attestation (proof + result) is submitted on-chain to the AEGIS Registry

4. Anyone can verify the proof on-chain or dispute a fraudulent attestation

Related MCP server: trust-mcp

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:

1. Query AEGIS — is this skill registered? Has it been audited?

2. Verify the proof — is the audit cryptographically valid?

3. Check the stake — how much ETH did the auditor risk on this assessment?

4. 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

Deployed Contracts

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