Aegis

자율 DeFi 에이전트를 위한 안전 계층입니다. | 웹사이트 | 문서

온체인에서 거래하는 AI 에이전트는 합법적인 토큰과 허니팟을 구분할 방법이 없습니다. Aegis가 이를 해결합니다. Aegis는 모든 에이전트가 연결할 수 있는 MCP 서버이며, 안전 검사를 강제하는 온체인 컨트랙트를 기반으로 합니다.

에이전트가 스왑을 수행하기 전에 Aegis는 대상 컨트랙트를 스캔하고 트랜잭션을 시뮬레이션한 뒤, 간단한 통과/차단(go/no-go) 결과를 반환합니다. 만약 컨트랙트에 99%의 매도 수수료나 숨겨진 일시 정지 기능이 있다면, 에이전트는 해당 컨트랙트에 절대 접근하지 않습니다.

이 프로젝트가 존재하는 이유

우리는 한 에이전트가 30초도 안 되어 허니팟 토큰에 지갑 전체를 잃는 것을 목격했습니다. 해당 토큰은 겉보기에는 검증된 컨트랙트, 적절한 유동성, 활발한 거래 등 문제가 없어 보였습니다. 하지만 코드 내부에는 99%의 매도 수수료와 가짜 renounceOwnership() 뒤에 숨겨진 소유자 권한이 있었습니다.

기존의 어떤 에이전트 프레임워크도 이를 잡아낼 방법이 없었습니다. 그래서 우리가 직접 만들었습니다.

Related MCP server: agentshield-mcp

작동 원리

Agent -> Aegis (scan + simulate + decide) -> Chain

1. 에이전트가 MCP를 통해 Aegis에 연결 (설정 한 줄)

2. 스왑/승인/전송 전, 에이전트가 assess_risk 호출

3. Aegis가 컨트랙트 소스를 스캔하고, 트랜잭션을 시뮬레이션하며, 허니팟 패턴을 확인

4. 위험 점수(0-100)와 함께 ALLOW(허용), WARN(경고), BLOCK(차단) 반환

5. 온체인: AegisGateway 컨트랙트가 트랜잭션을 전달하기 전에 증명(attestation)을 강제함

빠른 시작

# Add to Claude Code
claude mcp add aegis npx aegis-defi

# Or clone and try the demo
git clone https://github.com/StanleytheGoat/aegis
cd aegis && npm install
npx tsx demo/catch-honeypot.ts

데모는 의도적으로 악의적인 토큰(99% 매도 수수료, 가짜 소유권 포기, 숨겨진 관리자)을 배포하고 Aegis가 모든 위험 신호를 잡아내는 과정을 보여줍니다:

Aegis Risk Assessment
  Risk Score: 100/100
  Findings:
    [CRITICAL] Fake Ownership Renounce
    [CRITICAL] Asymmetric Buy/Sell Tax (99% sell)
    [CRITICAL] Sell Pause Mechanism
    [HIGH]     Hidden Max Sell Amount
    [HIGH]     Hidden Admin Functions
  Decision: BLOCK

도구

MCP 서버 (TypeScript) - 모든 MCP 호환 에이전트가 사용할 수 있는 6가지 도구:

스마트 컨트랙트 (Solidity) - Base 메인넷에 배포됨:

문서

• 에이전트 통합 가이드 - 에이전트 연결 방법

• 프로젝트 통합 가이드 - Aegis를 제품에 통합하는 방법

• Flaunch 통합 - Flaunch 밈코인 거래를 위한 안전 검사

• ElizaOS 플러그인 - ElizaOS 에이전트를 위한 네이티브 Aegis 액션

• AgentKit 제공자 - Aegis를 위한 Coinbase AgentKit ActionProvider

• llms.txt - 에이전트 검색을 위한 기계 판독 가능한 설명

보안

이더리움 보안 모범 사례를 따라 구축되었습니다 (ethskills 참고):

• 서명: 모든 서명된 메시지에 체인 ID + 컨트랙트 주소 포함 (교차 체인 리플레이 방지). EIP-2 s-값 가변성 검사. address(0)에 대한 ecrecover 검증.

• 수수료 계산: 나눗셈 전 곱셈 수행. 명시적인 오버플로우 방지. 베이시스 포인트(백분율 아님) 사용.

• 접근 제어: Gateway에 OZ Ownable + ReentrancyGuard 적용. Hook에 불변(Immutable) 소유자 설정. 불변 수수료 수취인 설정.

• 배포: Safe Singleton Factory CREATE2 배포자 사용. Basescan에서 소스 검증 완료. 소유권은 Safe 멀티시그로 이전됨.

• 테스트: 165개 테스트 (컨트랙트 42개 + TypeScript 123개). 실제 Base 메인넷 상태에 대한 포크 테스트 수행.

테스트

npm test              # TypeScript unit tests (123)
npm run test:contracts # Solidity contract tests (42)
npm run demo          # Honeypot detection demo

변경 로그

v0.5.0 (현재)

• 훅 증명 지원 - assess_risk가 이제 Uniswap v4 보호 풀을 위한 게이트웨이 및 훅 증명을 모두 반환함

• EVM 주소 검증 - 모든 MCP 도구 입력값이 올바른 주소 형식을 검증함

• 잘 알려진 컨트랙트 확장 - Paraswap, Balancer Vault, CoW Protocol, Permit2, Uniswap V4 PoolManager

• SDK 내보내기 - attester 및 solodit 모듈을 프로그래밍 방식으로 사용 가능

• 요청 강화 - response.ok 확인, 모든 외부 요청에 10초 타임아웃 적용

• 보안 헤더 및 랜딩 페이지용 SEO 파일 추가

v0.4.0

• Solodit 통합 - search_solodit 도구가 Cyfrin, Sherlock, Code4rena, Trail of Bits 등에서 제공하는 5만 개 이상의 실제 감사 결과를 쿼리함

• 자동 강화 - SOLODIT_API_KEY가 설정되면 assess_risk가 감지된 패턴을 실제 감사 결과와 교차 참조함

• 옵트인 API 키 모델 - 각 에이전트가 자신의 Solodit 키를 제공하며, 공유 속도 제한 없음

v0.3.0

• 165가지 익스플로잇 패턴 (25개 카테고리, 기존 22개에서 증가)

• 트레이스 수준 분석 - trace_transaction 도구가 모든 내부 호출을 추적하고 각 컨트랙트를 스캔함

v0.2.0

• 22가지 익스플로잇 패턴 (기존 12개에서 증가) - 메타모픽 컨트랙트, 오라클 조작, MEV 샌드위치

• 에이전트 스킬 - Claude Code용 설치 가능한 스킬 파일

• Flaunch SDK 통합 - Uniswap v4 풀에서의 밈코인 출시를 위한 안전 스캔

라이선스

MIT