SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场zerion-vaultsfyi-deposit

zerion-vaultsfyi-deposit

数据与分析

查看项目

更新于 10-16 04:12

技能介绍

用途

该技能用于在向 DeFi 金库存款前执行尽职调查，并通过 Zerion CLI 构建存款交易。它结合 vaults.fyi 的数据与 Zerion 的钱包操作能力，在构建交易前设置安全闸门：对存在严重标记的金库直接阻止存款，对存在警告标记的金库要求用户明确确认。

主要能力

  • 通过 vaults.fyi MCP 获取金库详情（评分、标记、费用、管理人、协议、容量、底层资产）
  • 获取 30 天历史 APY 与 TVL 趋势
  • 获取网络基准利率用于对比
  • 获取存款资产、精度、钱包余额及可用操作
  • 构建未签名存款交易，支持单步与多步复杂流程
  • 通过 Zerion CLI 检查钱包持仓、DeFi 头寸，并执行兑换或跨链桥接
  • 存款后提交交易哈希并查询交易状态

使用方式

环境要求

  • Zerion CLI：npm install -g zerion-cli
  • Zerion API 密钥：export ZERION_API_KEY="zk_..."
  • 已连接 vaults.fyi 托管 MCP v2
  • 一个已充值且持有足够存款资产的钱包

工作流程

  1. 确认钱包就绪：使用 zerion portfolio <address> 检查当前持仓与余额。若缺少存款代币，先标记缺口并询问用户如何处理。

  2. 解析金库：若用户提供名称而非地址，调用 vaults_search 按名称、资产和网络查找匹配金库；若返回多个结果，与用户确认。若提供地址，直接调用 vault_details。

  3. 执行尽职调查：调用 vault_details 获取评分、标记、费用、管理人、协议、容量和底层资产；调用 vault_apy_history 获取 30 天 APY 趋势（fromTimestamp 设为当前 Unix 时间戳减 2592000）；调用 vault_tvl_history 获取 30 天 TVL 趋势；调用 benchmark_apy 获取对应基准（稳定币用 usd，ETH 计价金库用 eth）。存在 apyComposite.totalApy 时优先使用。整理为尽调摘要，包含金库名称/协议/管理人/网络、APY（1d/7d/30d）、相对基准的利差、TVL 及 30 天趋势、评分（满分 100 及扣分说明）、标记、费用、容量。

  4. 安全闸门：这是构建交易前的硬性安全检查。存在严重标记时停止，不构建交易，报告“BLOCKED: this vault has an active critical incident. Do not deposit.”；存在警告标记时展示警告详情并要求用户明确确认；无标记且评分高于阈值时以绿色状态继续。

  5. 检查余额并准备存款资产：调用 transaction_context 获取所需存款资产及精度、钱包余额、可用存款操作。若余额不足，停止并通知用户，说明所需资产及数量、当前网络持仓、其他网络是否持有该资产（可桥接）或当前网络是否持有其他代币（可兑换），询问用户选择兑换还是桥接，确认后再继续。兑换命令：zerion swap <chain> <amount> <held-token> <deposit-asset>；桥接命令：zerion bridge <from-chain> <held-token> <amount> <vault-chain> <deposit-asset> --cheapest。

  6. 检查存款流程类型：查看 transactionalProperties.depositStepsType。"instant" 为标准单步存款；"complex" 为多步流程，可能包含 approve → deposit → stake 或 deposit → bridge → confirm 等顺序交易，需提前向用户展示全部步骤及预期顺序和延迟，部分步骤需等待链上确认后才能执行下一步。

  7. 构建存款交易：安全与余额检查通过后，调用 build_vault_tx，参数为 action: "deposit"、userAddress、network、vaultId，并优先使用 humanAmount（如 "10"）加 transaction_context 中的精度（如 USDC 为 6，WETH 为 18），工具会自动转换为基本单位。复杂流程会返回多个有序步骤。向用户展示未签名交易步骤和解码后的调用。不要签名或广播，必须由用户明确批准。

  8. 存款后跟踪：用户签名并广播后，调用 submit_tx_hash 传入 sessionId、stepId 和广播的 txHash；调用 get_transaction_status 确认存款到账；使用 zerion positions <address> 验证新头寸。

适用场景

  • “向 [网络] 上的 [金库名称] 存款”
  • “这个金库存款安全吗？”
  • “把我的 USDC 存入 Base 上的 Morpho”
  • “存款前研究一下这个金库”
  • “质押到收益金库”
  • 任何要求向特定 DeFi 金库存款、进入或质押并需要安全或尽职调查步骤的请求

限制

  • 存在严重标记的金库会被阻止存款，这是有意设计，不应绕过。
  • 金库名称搜索无结果时，需用户直接提供合约地址和网络。
  • 余额不足时需用户先选择兑换或桥接。
  • 部分金库有存款上限，容量耗尽时需建议替代方案。
  • 复杂存款流程可能需要多笔顺序交易，部分步骤需等待链上确认，不能盲目批量执行。
  • 即使存款为即时，金库可能具有复杂赎回机制（先请求后领取、冷却期、季度结算窗口），需在尽调阶段向用户说明流动性特征。
  • 构建的交易为未签名交易，必须由用户自行签名和广播。

相关技能

  • zerion-trading — 用于获取存款资产的兑换和桥接命令
  • zerion-analyze — 存款前的钱包分析
  • zerion-vaultsfyi-yield-optimizer — 存款前寻找最佳金库
  • zerion-vaultsfyi-market-intel — 市场背景与金库对比