Aave Guard MCP

Aave Concierge API

LoanGuardian-Aave Concierge API和Hedera Logger

🚀 项目概述

Aave Concierge API 是一个符合MCP的API，允许Aya等人工智能代理使用简单的自然语言命令管理Aave贷款、供应和借款。

项目描述

LoanGuardian 是一个全面的DeFi平台，将Aave协议集成与去中心化共识日志相结合。该项目由两个互补的API组成：

Aave Concierge API： 像Aave这样的DeFi协议功能强大，但它们的复杂性给AI代理带来了障碍。Aave Concierge API通过充当一个简单、智能的桥梁来解决这一问题。

我们的无服务器API是用Python和FastAPI构建的，它公开了一套完全符合模型上下文协议（MCP）的干净端点（/health、/supply、/browrow和/report）。这允许AI代理（如Aya Wallet中的AI代理）发现并使用这些工具根据用户的自然语言命令执行链上交易。

Hedera共识记录器API： 为了确保透明度和不变性，我们使用Hedera Hashgraph Consensus service（HCS）实现了一个去中心化的日志服务。这个API为所有事务提供了不可变的审计跟踪，创建了一个值得信赖的记录，Hedera网络上的任何人都可以验证。

对于这次黑客马拉松，两个API都部署在Vercel上-Aave API在Base Sepolia测试网上运行，而Hedera Logger在Hedera测试网运行，提供了一个具有去中心化共识功能的完整解决方案。

📋 特性

Aave Concierge API

一个全面的符合MCP的API，用于Aave V3协议交互，具有内置的安全功能：

• GET/health/{网络}/{用户}：实时健康因素监测和借用安全评估
• POST/供应：向Hedera HCS提供自动交易记录的安全资产
• 邮寄/借用：智能借贷，自动健康因素检查和清算保护
• 邮寄/还款：通过遗嘱执行人钱包管理安全偿还债务
• GET/baland/{网络}/{用户}：跨支持的网络进行多令牌余额检查
• POST/模拟：无风险交易模拟，以预览健康因素的影响
• 内置安全功能：自动健康因素监测、气体优化和事务失败处理
• 多网络支持：目前支持Base Sepolia和ETH Sepolia测试网
• AI代理就绪：完全符合人工智能集成综合清单的MCP

Hedera共识记录器API

一种去中心化的日志服务，使用Hedera Hashgraph Consensus service（HCS）提供不可变的审计跟踪：

• POST/api/log：向Hedera HCS提交日志消息以达成去中心化共识
• 带有序列号的不可变事务日志记录
• 基于Node.js/TypeScript的无服务器架构
• 优雅的故障处理，不会阻止主要的API操作

Aave地址更新程序

用于在所有支持的网络中维护最新Aave V3池地址的实用程序脚本：

• 多网络支持：导出以太坊、Arbitrum、Avalanche、Base、BNB、Celo、Gnosis、Linea、Metis、Optimism、Polygon、Scroll等地址
• 分类出口：将主网和测试网地址分开，以便有组织地使用
• 自动更新：从官方Aave地址簿包中提取最新地址
• JSON格式：易于使用的JSON文件，用于API集成

👥 团队信息

团队名称： LoanGuardian

主要联系人（团队负责人）：

• 姓名： 克里斯托弗·哈迪·古纳万
• 电子邮件： christopher.hygunawan@gmail.com
• 电报： @kimchiigu
• X/推特： @Kimchiigu73

团队成员： 1

🛠️ 安装和设置

先决条件

• Python 3.8+（适用于Aave API）
• Node.js 16+（适用于Hedera Logger API和Aave地址更新程序）
• TypeScript（用于Aave地址更新程序）
• 虚拟环境（推荐）

步骤1：克隆存储库

git clone https://github.com/Kimchiigu/aave-guard-mcp.git
cd aave-guard-mcp

步骤2：Aave Concierge API设置

2.1创建虚拟环境

python -m venv venv
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

2.2安装依赖项

cd aave-concierge-api
pip install -r requirements.txt

2.3 Aave API的环境变量

创建一个名为的文件 .env 在 aave-concierge-api 目录：

ALCHEMY_API_KEY="your_alchemy_api_key_for_base_sepolia"
EXECUTOR_PRIVATE_KEY="your_secure_executor_wallet_private_key"
AAVE_POOL_ADDRESS_PROVIDER_V3_BASE_SEPOLIA="0xE4C23309117Aa30342BFaae6c95c6478e0A4Ad00"
HEDERA_LOGGER_URL="https://your-hedera-api-url.vercel.app/api/log"
NETWORK="base-sepolia"

2.4本地运行Aave API

uvicorn main:app --reload

步骤3:地址更新程序设置

aave更新工具可帮助您在所有支持的网络中维护最新的aave V3池地址。

3.1安装依赖关系

cd aave-updater
npm install

3.2更新地址

运行更新程序以生成最新的Aave池地址JSON文件：

npx ts-node update-addresses.ts

这将在中创建三个文件 aave-updater 目录：

• aave_addresses_mainnet.json -主网池地址
• aave_addresses_testnet.json -测试网池地址
• aave_addresses_all.json -主网和测试网地址组合

步骤4：Hedera Logger API设置

4.1安装依赖项

cd hedera-logger-api
npm install

4.2创建Hedera主题

node create_topic.js

这将创建一个新的HCS主题，并为您提供主题ID。

4.3 Hedera API的环境变量

创建一个名为的文件 .env 在 hedera-logger-api 目录：

HEDERA_ACCOUNT_ID="your_hedera_account_id"
HEDERA_PRIVATE_KEY="your_hedera_private_key"
HEDERA_TOPIC_ID="topic_id_from_create_topic_script"

API 文档

• 保存API文档： http://127.0.0.1:8000/docs
• A有备选文件： http://127.0.0.1:8000/redoc
• Hedera记录器端点： POST/api/log

🚀 部署

Vercel部署

这两个API都设计为在Vercel上部署为无服务器功能。

Aave Concierge API部署

1. 在aave礼宾api中创建vercel.json：

{
  "builds": [
    {
      "src": "main.py",
      "use": "@vercel/python"
    }
  ],
  "routes": [
    {
      "src": "/(.*)",
      "dest": "main.py"
    }
  ]
}

Hedera Logger API部署

1. 在hedera logger api中创建vercel.json：

{
  "builds": [
    {
      "src": "api/log.ts",
      "use": "@vercel/node"
    }
  ],
  "routes": [
    {
      "src": "/api/(.*)",
      "dest": "api/log.ts"
    }
  ]
}

1. 部署两个API：

- 将您的GitHub存储库连接到Vercel - 将每个API部署为单独的项目或使用单回购设置 - 在每个API的Vercel项目设置中添加环境变量

实时实例：

• Aave Concierge API： https://aave-guard-mcp.vercel.app/
• Hedera记录仪API： 单独部署（URL取决于您的Vercel设置）

🤖 AI代理集成

MCP（模型上下文协议）集成

该项目包括一个全面的MCP清单文件(mcp-manifest.json)以人工智能代理可以理解的机器可读格式描述API的功能。

内置功能：

• 自动Hedera测井：所有Aave交易都会通过以下方式自动登录Hedera HCS schedule_log() 函数
• 多网络支持：内置支持Base Sepolia和ETH Sepolia测试网
• 健康因素安全：借款操作前自动健康因素检查
• 模拟模式：无需真实交易的安全测试模拟模拟

可用的MCP方法：

• supply：向Aave提供代币
• borrow：借用带有安全检查的代币
• repay：偿还借来的代币
• health：检查用户健康因素
• balance：获取代币余额
• simulate：模拟交易而不执行

📖 使用示例

Aave Concierge API示例

检查用户健康状况

curl -X GET "https://aave-guard-mcp.vercel.app/health/base-sepolia/0x123...abc"

供应资产

curl -X POST "https://aave-guard-mcp.vercel.app/supply" \
  -H "Content-Type: application/json" \
  -d '{"user_address": "0x123...abc", "token": "USDC", "amount": 1000, "network": "base-sepolia"}'

借用资产

curl -X POST "https://aave-guard-mcp.vercel.app/borrow" \
  -H "Content-Type: application/json" \
  -d '{"user_address": "0x123...abc", "token": "USDC", "amount": 500, "network": "base-sepolia"}'

偿还债务

curl -X POST "https://aave-guard-mcp.vercel.app/repay" \
  -H "Content-Type: application/json" \
  -d '{"user_address": "0x123...abc", "token": "USDC", "amount": 250, "network": "base-sepolia"}'

获取代币余额

curl -X GET "https://aave-guard-mcp.vercel.app/balance/base-sepolia/0x123...abc"

模拟交易

curl -X POST "https://aave-guard-mcp.vercel.app/simulate" \
  -H "Content-Type: application/json" \
  -d '{"user_address": "0x123...abc", "token": "USDC", "amount": 1000, "network": "base-sepolia"}'

Hedera Logger API示例

提交日志消息

curl -X POST "https://your-hedera-api-url.vercel.app/api/log" \
  -H "Content-Type: application/json" \
  -d '{"log_message": "User 0x123...abc supplied 1000 USDC to Aave"}'

提交交易日志

curl -X POST "https://your-hedera-api-url.vercel.app/api/log" \
  -H "Content-Type: application/json" \
  -d '{"log_message": "TX_HASH: 0xabc...123 | ACTION: borrow | ASSET: USDC | AMOUNT: 500 | USER: 0x123...abc"}'

内置集成示例

Aave API已经包含内置的Hedera日志集成。它是如何自动工作的：

在Aave API中自动登录：

# From main.py - this happens automatically for every transaction
async def log_to_hedera(msg: str):
    async with aiohttp.ClientSession() as session:
        try:
            await session.post(HEDERA_LOGGER_URL, json={"log_message": msg}, timeout=5)
        except Exception as e:
            print("[WARN] Hedera log failed:", e)

def schedule_log(msg: str):
    try:
        asyncio.create_task(log_to_hedera(msg))
    except RuntimeError:
        asyncio.run(log_to_hedera(msg))

环境变量配置：

# In Aave API .env file
HEDERA_LOGGER_URL="https://your-hedera-api-url.vercel.app/api/log"

自动日志消息示例：

• SUPPLY 1000 USDC on base-sepolia by 0x123...abc, status=1
• BORROW 500 USDC on base-sepolia, HF_before=2.5, status=1
• REPAY 250 USDC on base-sepolia by 0x123...abc, status=1

⚠️ 当前限制和未来计划

当前仅测试网部署

当前状态：

• Aave API：仅在Base Sepolia和ETH Sepolia测试网上运行
• Hedera记录仪：仅在Hedera测试网上运行
• 所有交易：使用没有实际值的测试网令牌

已知技术问题

• 主题配置：Hedera主题创建需要通过手动设置 create_topic.js 脚本
• 交叉API配置: HEDERA_LOGGER_URL 环境变量需要适当的配置才能进行生产部署

未来发展路线图

第1阶段-主网集成：

• 在以太坊主网和Polygon网络上部署Aave API
• 在Hedera主网上部署Hedera Logger以进行生产审核跟踪
• 通过适当的风险管理实施实物资产支持

第2阶段-网络扩展：

• 添加对其他EVM兼容网络（Arbitrum、Optimism、Avalanche）的支持
• 使用Hedera共识服务实现多链日志记录
• 通过跨链操作增强AI代理能力

第3阶段-高级功能：

• 流动性池分析和优化建议
• 自动化风险管理和清算保护
• 先进的模拟和预测工具
• 与Aave之外的其他DeFi协议集成

🔗 链接

• GitHub存储库： https://github.com/Kimchiigu/aave-guard-mcp
• Aave Concierge API： https://aave-guard-mcp.vercel.app/
• Aave API文档： https://aave-guard-mcp.vercel.app/docs
• MCP清单： https://github.com/Kimchiigu/aave-guard-mcp/blob/main/aave-concierge-api/mcp-manifest.json
• Hedera哈希图文档： https://docs.hedera.com/hedera/getting-started/mainnet
• Aave V3文档： https://docs.aave.com/developers/guides/liquidations

📄 许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

🤝 支持

如需支持、提问或合作：

• 电报： @kimchiigu
• 电子邮件： christopher.hygunawan@gmail.com
• X/推特： @金正日73

______________________________________________________________________

内置于❤️ 为了 Aya钱包黑客马拉松