AgentFi

非人类智能的经济层。

AgentFi 为以太坊及 EVM 兼容网络上的 AI 智能体提供加密交易基础设施。它允许智能体在无需处理私钥或管理 Gas 的情况下执行 DeFi 交易（兑换、流动性挖矿、转账），所有操作均在安全的链上策略框架内进行。

从这里开始：

• VISION.md — 为什么存在这个项目，它的发展方向，以及每个技术决策背后的原则。

• STATE.md — 当前项目状态：目标、完整技术栈、功能、阶段进展。

• HANDOFF.md — 实时待办任务、凭证清单、新机器设置。

📚 文档

所有项目文档均整理在我们的 文档中心 中。

快速链接

• 愿景（必读）：为什么存在这个项目以及它的发展方向。

• 开发快速入门：零凭证本地环境——运行 docker compose up，3 分钟即可启动。

• 操作员设置：运行一个真实的 AgentFi 实例。

• Graphify 代码图谱：用于智能体辅助开发的交互式代码库地图。

• 智能体快速入门：在 5 分钟内连接您的智能体。

• 系统架构：了解 4 层技术栈。

Related MCP server: Universal Crypto MCP

🚀 核心功能

• 开箱即用的 MPC 钱包 — 密钥分片存储，绝不暴露。

• 安全智能钱包 — 每个智能体独立的链上策略执行（限额、白名单、紧急停止）。

• 模型上下文协议 (MCP) — @agent_fi/mcp-server 中包含 28 个工具：DeFi 执行、A2A 协作、信任评估及盈亏分析。

• DeFi 覆盖 — Uniswap V3 + Curve StableSwap（兑换）；Aave V3、Compound V3 及任何 ERC-4626 金库（收益）。

• 智能体间经济 — 任务队列、原子支付、数据库级托管 (v2)、基于真实指标且带时间衰减的声誉评分。

• 智能体盈亏仪表盘 — 每个智能体的盈亏平衡检测，包含真实 Gas 成本 (v2)。

• 持久身份 — 可选的 ENS 子域名（alice-abc123.agentfi.eth），并集成到智能体注册中。

• OpenAPI 3.0.3 规范 — 位于 docs/api/openapi.yaml，用于 SDK 生成的机器可读契约。

• 跨链支持 — 以太坊、Base、Arbitrum、Polygon（Base 主网拥有维护者部署的合约）。

• 协议费用引擎 — 通过 AgentExecutor 在链上原子化收取基点费用。

🛠️ 入门指南

给操作员

1. 按照 操作员设置清单 填写第三方账户和本地 .env 文件。

2. 将 智能合约 部署到您的目标链（或复用 STATE.md 中维护者部署的 Base 地址）。

3. 通过 自托管生产环境指南 部署后端——与提供商无关，以 Railway 为参考，并记录了 Fly.io / Render / Docker 作为替代方案。

给开发者

1. 从 开发快速入门 开始——运行 docker compose up → 3 分钟内启动环境，无需外部账户。

2. 运行 A2A 协作示例 — 在一个文件中实现两个智能体的端到端流程。

3. 运行 Claude Desktop MCP 演示 — 包含两个 MCP 身份、发现、A2A 任务、信任及盈亏分析。

4. 查看 架构概览。

5. 使用 MCP 服务器 集成您的智能体。

🛡️ 安全性

AgentFi 专为安全优先的自主性而构建。

• 模拟交易：每笔交易在提交前都会通过 Tenderly 进行模拟。

• 护栏机制：链上策略防止智能体超出预设限额。

• 紧急停止：操作员可以随时暂停任何智能体的交易能力。

发现漏洞？请参阅 SECURITY.md 了解我们的披露政策。

🤝 社区

• 行为准则：我们的社区标准。

• 贡献指南：如何为 AgentFi 做出贡献。

• 更新日志：发布历史和重要变更。

📄 许可证

AgentFi 是开源项目，采用 Apache 2.0 许可证。