aegis-protocol

AEGIS Protocol

AI エージェント間取引のための、トラストレスなエスクロー・ミドルウェアです。

AEGIS は、ERC-8004（トラストレスなエージェント）と x402（HTTP ネイティブのステーブルコイン決済）を Base L2 上で組み合わせ、完全な取引安全レイヤーを実現します。どちらの標準も解決していない疑問に答えます。エージェントが支払いを受け取って、粗悪な成果物を納品したらどうなるのでしょうか？

USDC はスマートコントラクトにロックされ、作業は ERC-8004 のオンチェーン Validation Registry を通じて検証されます。成果物が品質チェックに合格した場合にのみ、支払いがリリースされます。合格しなかった場合は、3 段階の紛争解決システムが作動します。人間による対応は不要です。

仕組み

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 上の 4 つのスマートコントラクト：

コントラクト	目的
AegisEscrow	中核となる保管庫 — ジョブを作成し、USDC をロックし、ERC-8004 の検証を通し、自動決済または紛争申し立て期間の開始を行います
AegisDispute	3 段階の紛争解決：(1) 自動再検証、(2) ステークされた仲裁人、(3) タイムアウト時のデフォルト処理
AegisTreasury	トレジャリーと仲裁人プールに分配する手数料の徴収
AegisJobFactory	標準化されたジョブタイプ（コードレビュー、データ分析など）向けのテンプレートシステム

ERC-8004 との統合

AEGIS は、ERC-8004 の 3 つのレジストリすべてを組み合わせます。

• Identity Registry — エージェントの登録を確認し、支払い先アドレスを解決します
• Reputation Registry — ジョブ開始前の評判チェックと、決済後のフィードバック（Sybil 対策を含む）を行います
• Validation Registry — 作業の検証を開始し、検証スコア（0～100）を読み取ります

決済されたジョブはすべて評判データを生成し、エコシステムの改善に役立てられます。

主な設計上の判断

• アトミックな資金供給 — ジョブの作成と USDC の送金を 1 つのトランザクションで行います
• 不変の V1 — 信頼性を確保するため、設計上アップグレードできないようにしています
• パーミッションレスな検証 — 誰でも processValidation() を呼び出せます
• ベストエフォートの評判処理 — フィードバックには try/catch を使い、決済をブロックしません
• プロトコル手数料のスナップショット — 手数料 BPS はジョブの作成時にジョブごとに保存されます

デプロイ済みコントラクト（Base Sepolia）

コントラクト	アドレス
AegisEscrow	0x8e013cf23f11168B62bA2600d99166507Cbb4aAC
AegisDispute	0x9Cbe0bf5080568F56d61F4F3ef0f64909898DcB2
AegisTreasury	0xCd2a996Edd6Be2992063fD2A41c0240D77c9e0AA
AegisJobFactory	0xD6a9fafA4d1d233075D6c5de2a407942bdc29dbF

クイックスタート

AI エージェント向け（MCP サーバー）

最も手早く統合できます。MCP 対応のエージェント（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 と決済サポートが追加されました。これにより、エージェント優先の導線が 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."

または、examples ワークスペースのスクリプトから実行します。

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 リソースエントリー
• エージェントのランタイムロジックと、オペレーターが管理する 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

モノレポの構成

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 年第 2 四半期を予定しています。

• 217 件のテストが成功（Foundry 212 件 + 不変条件テスト 5 件）
• TypeScript SDK を npm で公開済み
• MCP サーバーを npm で公開済み。公式 MCP Registry に登録済み
• ElizaOS プラグインパッケージをリリース済み（sdk/packages/elizaos）
• Virtuals GAME／ACP アダプターパッケージをリリース済み（sdk/packages/virtuals）
• MCP 経由の CrewAI 統合サンプルをリリース済み（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、または未解決の Issue をご覧ください。

ライセンス

MIT