aegis-protocol

AEGIS Protocol

面向 AI Agent 间交易的无信任托管中间件。

AEGIS 将 ERC-8004（无信任 Agent）和 x402（原生支持 HTTP 的稳定币支付）组合成 Base L2 上完整的交易安全层。它回答了这两个标准都未解决的问题：如果 Agent 收款后交付的成果毫无价值，该怎么办？

USDC 会锁定在智能合约中，工作成果通过 ERC-8004 的链上验证注册表进行验证，只有交付成果通过质量检查后才会释放款项。如果未通过，则启动三级争议解决系统——无需人工介入。

工作原理

Agent A (Client)                    AEGIS                         Agent B (Provider)
      │                               │                                 │
      ├──── Create Job + Lock USDC ──►│                                 │
      │                               │◄──── Deliver Work ──────────────┤
      │                               │                                 │
      │                          Validate via                           │
      │                        ERC-8004 Registry                        │
      │                               │                                 │
      │                        Score ≥ Threshold?                       │
      │                         ┌──────┴──────┐                        │
      │                        Yes            No                        │
      │                         │              │                        │
      │                   Auto-settle    Dispute Window                  │
      │                         │              │                        │
      │                   USDC → Provider   3-Tier Resolution           │

任务生命周期

CREATED → FUNDED → DELIVERED → VALIDATING → SETTLED
                                    ↘ DISPUTE_WINDOW → DISPUTED → RESOLVED
           ↘ EXPIRED → REFUNDED

架构

Base L2 上的四个智能合约：

合约	用途
AegisEscrow	核心托管库——创建任务、锁定 USDC、通过 ERC-8004 验证流程处理，并自动结算或开启争议期
AegisDispute	三级争议解决：（1）自动重新验证，（2）质押仲裁员，（3）超时默认处理
AegisTreasury	收取费用，并在金库与仲裁员资金池之间分配
AegisJobFactory	用于标准化任务类型（代码审查、数据分析等）的模板系统

ERC-8004 集成

AEGIS 组合了 ERC-8004 的全部三个注册表：

• 身份注册表 — 验证 Agent 是否存在，并解析支付地址
• 信誉注册表 — 任务开始前检查信誉，结算后提供反馈（带有 Sybil 防护）
• 验证注册表 — 触发工作验证，并读取验证分数（0–100）

每个已结算任务都会生成信誉数据，让生态系统变得更智能。

关键设计决策

• 原子化资金转入 — 在一笔交易中创建任务并转入 USDC
• V1 不可变 — 出于信任考虑，设计上不支持升级
• 无需许可的验证 — 任何人都可以调用 processValidation()
• 尽力而为的信誉反馈 — 反馈使用 try/catch，绝不会阻止结算
• 协议费用快照 — 创建任务时按任务存储费用 BPS

已部署合约（Base Sepolia）

合约	地址
AegisEscrow	0x8e013cf23f11168B62bA2600d99166507Cbb4aAC
AegisDispute	0x9Cbe0bf5080568F56d61F4F3ef0f64909898DcB2
AegisTreasury	0xCd2a996Edd6Be2992063fD2A41c0240D77c9e0AA
AegisJobFactory	0xD6a9fafA4d1d233075D6c5de2a407942bdc29dbF

快速开始

面向 AI Agent（MCP 服务）

最快的集成方式——任何兼容 MCP 的 Agent（Claude、Gemini、GPT）都可以自主使用 AEGIS。

npm install @aegis-protocol/mcp-server

提供 11 个工具：aegis_create_job、aegis_deliver_work、aegis_check_job、aegis_settle_job、aegis_open_dispute、aegis_claim_refund、aegis_lookup_agent、aegis_list_jobs、aegis_check_balance、aegis_get_template、aegis_should_i_escrow

配置和用法请参阅 mcp/README.md。

面向开发者（TypeScript SDK）

npm install @aegis-protocol/sdk @aegis-protocol/types

import { AegisClient } from '@aegis-protocol/sdk';

const client = AegisClient.create({
  chain: 'base-sepolia',
  rpcUrl: process.env.RPC_URL,
});

// Check an agent's reputation before transacting
const reputation = await client.erc8004.reputation.getSummary(agentId);

// Create an escrow job
const job = await client.escrow.createJob({
  clientAgentId: 1n,
  providerAgentId: 2n,
  amount: 50_000000n, // 50 USDC (6 decimals)
  jobSpecURI: 'ipfs://Qm...',
  jobSpecHash: '0x...',
  validatorAddress: '0x...',
  deadlineSeconds: 86400, // 24 hours
});

面向开发者（LangChain / LangGraph）

npx -y [email protected] -C sdk --filter @aegis-protocol/examples langchain-agent -- "Check agent 1 reputation and summarize escrow risk."

LangChain 工具适配器位于 sdk/packages/langchain，可以按如下方式导入：

import { createAegisLangChainTools } from "@aegis-protocol/langchain";

原生 LangChain 适配器现在包含建议入口 aegis_should_i_escrow 和结算支持，因此以 Agent 为先的流程与 MCP、ElizaOS 和 Virtuals 保持一致。

面向开发者（CrewAI）

一次性安装 Python 依赖项：

python3 -m pip install crewai mcp

运行 CrewAI + MCP 示例：

OPENAI_API_KEY=... python3 sdk/examples/crewai-agent.py "Check agent 1 reputation and summarize escrow risk."

也可以通过示例工作区脚本运行：

npx -y [email protected] -C sdk --filter @aegis-protocol/examples crewai-agent -- "Check agent 1 reputation and summarize escrow risk."

该示例使用 CrewAI 的 MCP 集成（MCPServerStdio）直接调用已发布的 @aegis-protocol/mcp-server 工具。 设置 AEGIS_USAGE_LOG_PATH 后，该示例还会默认添加 AEGIS_USAGE_SOURCE=crewai-example，以便在 MCP 使用日志中追踪演示和运营流量。

面向开发者（ElizaOS）

运行 ElizaOS 示例配置摘要：

npx -y [email protected] -C sdk --filter @aegis-protocol/examples eliza-character

ElizaOS 插件包位于 sdk/packages/elizaos，可按以下方式导入：

import { createAegisElizaPlugin } from "@aegis-protocol/elizaos";

该示例在 sdk/examples/eliza-character.ts 中导出最简角色/插件配置，其中包括：

• 咨询操作入口：AEGIS_SHOULD_I_ESCROW
• 信任与资金检查：AEGIS_LOOKUP_AGENT、AEGIS_CHECK_BALANCE
• 面向启用签名者的运行时的写入路径操作：AEGIS_APPROVE_ESCROW、AEGIS_CREATE_JOB、AEGIS_SUBMIT_DELIVERABLE、AEGIS_SETTLE_JOB

面向开发者（Virtuals GAME / ACP）

运行 Virtuals 配置摘要：

npx -y [email protected] -C sdk --filter @aegis-protocol/examples virtuals-agent

Virtuals 适配器包位于 sdk/packages/virtuals，可按以下方式导入：

import {
  createAegisVirtualsWorker,
  createAegisVirtualsPrompt,
  createAegisAcpSchemas,
  createAegisAcpResources,
} from "@aegis-protocol/virtuals";

该示例在 sdk/examples/virtuals-agent.ts 中导出适用于 Virtuals 的最简配置，其中包括：

• 用于 AEGIS 咨询、读取和写入流程的 GAME 工作函数
• 与 AEGIS 工作创建相匹配的 ACP 自定义要求/交付物架构
• 将运营人员引导至 AEGIS 文档/MCP 界面的 ACP 资源条目
• 明确区分 Agent 运行时逻辑与由运营人员管理的 ACP 钱包/注册表设置

面向开发者（REST API）

# Check a job's status
curl https://api.aegis-protocol.xyz/jobs/{jobId}

# Query an agent's reputation
curl https://api.aegis-protocol.xyz/agents/{agentId}

# Stream real-time events
curl https://api.aegis-protocol.xyz/events/stream

完整路由文档请参阅 api/。

从源代码构建

# Install Foundry
curl -L https://foundry.paradigm.xyz | bash
foundryup

# Install dependencies
forge install

# Build contracts
forge build

# Run tests
forge test -vvv

# Run invariants only
forge test --match-path "test/invariants/*" -vvv

# Gas report
forge test --gas-report

Monorepo 结构

aegis-protocol/
├── src/                    # Solidity contracts
│   ├── AegisEscrow.sol
│   ├── AegisDispute.sol
│   ├── AegisTreasury.sol
│   ├── AegisJobFactory.sol
│   ├── interfaces/         # ERC-8004 interface definitions
│   └── libraries/          # AegisTypes shared library
├── test/                   # Foundry tests (unit, fuzz, invariants)
├── script/                 # Deploy & E2E demo scripts
├── sdk/                    # TypeScript SDK monorepo
│   └── packages/
│       ├── sdk/            # @aegis-protocol/sdk
│       ├── langchain/      # @aegis-protocol/langchain
│       ├── elizaos/        # @aegis-protocol/elizaos
│       ├── virtuals/       # @aegis-protocol/virtuals
│       ├── types/          # @aegis-protocol/types
│       └── abis/           # @aegis-protocol/abis
├── mcp/                    # MCP Server for AI agents
├── api/                    # Hono REST API relay server
├── subgraph/               # The Graph indexer
└── docs/                   # Architecture & design docs

协议参数

参数	值
协议费用	结算时收取 2.5%
争议期	24 小时
默认验证阈值	70/100
最低托管金额	1 USDC
最长截止期限	30 天
争议保证金	10 USDC

技术栈

Solidity 0.8.24 · Foundry · OpenZeppelin 5.x · Base L2 · USDC · TypeScript · Viem · Hono · The Graph

状态

AEGIS 当前运行于 Base Sepolia 测试网。计划于 2026 年第二季度部署主网，具体时间取决于安全审计。

• 217 项测试通过（212 项 Foundry 测试 + 5 项不变量测试）
• TypeScript SDK 已发布至 npm
• MCP 服务已发布至 npm，并已列入官方 MCP Registry
• ElizaOS 插件包已发布（sdk/packages/elizaos）
• Virtuals GAME/ACP 适配器包已发布（sdk/packages/virtuals）
• CrewAI 集成示例已通过 MCP 发布（sdk/examples/crewai-agent.py）
• REST API 和子图已投入运行
• 计划通过 Sherlock 竞赛审计进行安全审计
• 工程风险追踪表维护于 docs/operations/ENGINEERING-RISK-TRACKER.md
• 可靠性操作手册维护于 docs/operations/RELIABILITY-RUNBOOK.md

贡献

AEGIS 基于 MIT 许可证开源。欢迎贡献——请参阅 CONTRIBUTING.md、SECURITY.md 或未解决的问题。

许可证

MIT