AgentFi

비인간 지능을 위한 경제 계층.

AgentFi는 Ethereum 및 EVM 호환 네트워크상의 AI 에이전트를 위한 암호화폐 거래 인프라를 제공합니다. 에이전트가 개인 키를 다루거나 가스비를 관리할 필요 없이, 안전한 온체인 정책 프레임워크 내에서 DeFi 거래(스왑, 일드 파밍, 전송)를 실행할 수 있도록 지원합니다.

여기서 시작하세요:

• VISION.md — 이 프로젝트가 존재하는 이유, 향후 방향성, 그리고 모든 기술적 결정의 기반이 되는 원칙.

• STATE.md — 프로젝트의 현재 상태: 목적, 전체 스택, 기능, 단계별 진행 상황.

• HANDOFF.md — 실시간 보류 작업, 자격 증명 인벤토리, 새 머신 설정.

📚 문서

모든 프로젝트 문서는 **문서 허브(Documentation Hub)**에 정리되어 있습니다.

빠른 링크

• 비전(Vision) (필독): 이 프로젝트가 존재하는 이유와 향후 방향성.

• 개발자 퀵스타트(Dev Quickstart): 자격 증명이 필요 없는 로컬 스택 — docker compose up으로 3분 만에 실행.

• 운영자 설정(Operator Setup): AgentFi의 실제 인스턴스 실행.

• Graphify 코드 그래프(Graphify Code Graph): 에이전트 보조 개발을 위한 쿼리 가능한 코드베이스 맵.

• 에이전트 퀵스타트(Agent Quickstart): 5분 이내에 에이전트 연결.

• 시스템 아키텍처(System Architecture): 4계층 스택 이해.

Related MCP server: Universal Crypto MCP

🚀 주요 기능

• 턴키 MPC 지갑 — 키가 샤드(shard)로 분할되어 절대 노출되지 않음.

• 안전한 스마트 지갑 — 에이전트별 온체인 정책 시행(제한, 화이트리스트, 킬 스위치).

• 모델 컨텍스트 프로토콜(Model Context Protocol) — @agent_fi/mcp-server 내 28개 도구: DeFi 실행, A2A 협업, 신뢰 및 손익(P&L).

• DeFi 지원 — Uniswap V3 + Curve StableSwap(스왑); Aave V3, Compound V3 및 모든 ERC-4626 볼트(수익률).

• 에이전트 간(A2A) 경제 — 작업 대기열, 원자적 결제, DB 수준 에스크로(v2), 시간 감쇠가 적용된 실제 지표 기반 평판 점수.

• 에이전트 손익(P&L) 대시보드 — 실제 가스 비용을 포함한 에이전트별 손익분기점 감지(v2).

• 지속적 신원 — 에이전트 등록에 연결된 선택적 ENS 서브도메인 (alice-abc123.agentfi.eth).

• OpenAPI 3.0.3 사양 docs/api/openapi.yaml — SDK 생성을 위한 기계 판독 가능한 계약.

• 크로스체인 — Ethereum, Base, Arbitrum, Polygon (Base 메인넷에는 관리자가 배포한 계약이 포함됨).

• 프로토콜 수수료 엔진 — AgentExecutor를 통해 온체인에서 원자적으로 수집되는 베이시스 포인트(basis-point) 수수료.

🛠️ 시작하기

운영자를 위한 안내

1. **운영자 설정 체크리스트(Operator Setup Checklist)**를 따라 타사 계정 및 로컬 .env를 채우세요.

2. 대상 체인에 **스마트 계약(Smart Contracts)**을 배포하세요(또는 STATE.md에 있는 관리자 배포 Base 주소를 재사용하세요).

3. **자체 호스팅 프로덕션 가이드(Self-Hosted Production Guide)**를 통해 백엔드를 배포하세요. 공급자 중립적이며, Railway를 참조로 하고 Fly.io / Render / Docker를 대안으로 문서화했습니다.

개발자를 위한 안내

1. **개발자 퀵스타트(Dev Quickstart)**로 시작하세요 — docker compose up → 3분 만에 스택 실행, 외부 계정 불필요.

2. **A2A 협업 예제(A2A Collaboration Example)**를 실행하세요 — 단일 파일 내에서 두 에이전트 간의 엔드투엔드 흐름.

3. **Claude Desktop MCP 데모**를 실행하세요 — 두 개의 MCP 신원, 발견, A2A 작업, 신뢰 및 손익 관리.

4. **아키텍처 개요(Architecture Overview)**를 검토하세요.

5. **MCP 서버(MCP Server)**를 사용하여 에이전트를 통합하세요.

🛡️ 보안

AgentFi는 보안 우선 자율성을 위해 구축되었습니다.

• 시뮬레이션: 모든 거래는 제출 전 Tenderly를 통해 시뮬레이션됩니다.

• 가드레일: 온체인 정책은 에이전트가 사전 정의된 제한을 초과하지 못하도록 방지합니다.

• 킬 스위치: 운영자는 언제든지 에이전트의 거래 기능을 즉시 일시 중지할 수 있습니다.

취약점을 발견하셨나요? 공개 정책은 **SECURITY.md**를 참조하세요.

🤝 커뮤니티

• 행동 강령(Code of Conduct): 커뮤니티 표준.

• 기여하기(Contributing): AgentFi에 기여하는 방법.

• 변경 로그(Changelog): 릴리스 기록 및 주요 변경 사항.

📄 라이선스

AgentFi는 오픈 소스이며 **Apache 2.0 라이선스**에 따라 라이선스가 부여됩니다.