Communitygithub.com

ahmetenesdur/starkfi

查看全面的 DeFi 投资组合仪表盘,并通过自动再平衡优化投资组合配置。

starkfi 是什么?

该技能提供了一个统一的 Starknet DeFi 投资组合仪表盘,可聚合代币余额、质押头寸、Troves 金库头寸、Endur 流动性质押 (LST)、借贷头寸、DCA 订单和机密 Tongo 余额,并以美元计价显示总价值。其核心功能是自动再平衡:用户只需指定目标配置(如“50% ETH, 30% USDC, 20% STRK”),技能即可通过批量交换执行,并先通过 `--simulate` 模拟预览。它支持 StarkFi CLI 工具,在 Claude Code、Cursor 和 Codex 等平台上以 npx 命令运行。该技能基于 StarkZap SDK 获取美元价格,并采用容错聚合,即使部分数据源失败也能提供部分结果。特别适用于用户查询“我有什么?”、“重新平衡我的投资组合”或“我想 60% ETH 和 40% STRK”等场景。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ahmetenesdur/starkfi/tree/HEAD/skills/portfolio

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

投资组合总览与优化

展示全面的 DeFi 投资组合仪表盘,聚合代币余额、质押头寸、Troves 金库头寸、Endur 流动性质押 (LST)、借贷头寸、DCA 订单以及机密 Tongo 余额——全部以美元估值。通过自动批量交换将投资组合再平衡至目标配置。

先决条件

  • 需要活跃会话。
  • 针对再平衡:足够的代币余额 + 用于批量交换交易的 gas。

规则

  1. 当用户询问“我有什么?”或希望进行全面评估时,使用 portfolio 作为第一条命令。
  2. portfolio 命令是只读的——它从不修改任何链上状态。
  3. 美元价格来源于 StarkZap SDK,可能存在轻微差异。
  4. 对于 portfolio-rebalance,在执行前务必先使用 --simulate 预览计划。
  5. 目标配置必须合计为 100%。如果不是,请告知用户并要求调整。
  6. 再平衡后,再次运行 portfolio 以确认新的配置。

命令

投资组合仪表盘

npx starkfi@latest portfolio [--json]

投资组合再平衡

# 再平衡至目标配置
npx starkfi@latest portfolio-rebalance --target "<配置>" [--slippage <n>] [--simulate] [--json]

参数

portfolio

参数类型描述是否必需
--json标志以 JSON 格式输出否

portfolio-rebalance

参数类型描述是否必需
--target字符串目标配置(例如 "50 ETH, 30 USDC, 20 STRK")是
--slippage数字滑点容忍度百分比(默认:1)否
--simulate标志预览计划但不执行否
--json标志以 JSON 格式输出否

目标配置格式: 逗号分隔的 <百分比> <代币> 对,合计为 100。

仪表盘部分

投资组合显示七个部分:

  1. 代币余额 — STRK、ETH 以及所有非零余额的 ERC-20 代币及其美元价值。
  2. 质押头寸 — 所有验证者/池中的活跃质押及其待领取奖励。当存在退出意图时,显示解除质押金额和冷却日期。
  3. 借贷头寸 — 活跃的 Vesu V2 头寸:供应和借入金额以及池详情。
  4. DCA 订单 — 活跃的定投重复交换订单。
  5. 机密 Tongo 余额 — 在 Tongo Cash 下的机密活跃和待处理余额。
  6. Troves 金库头寸 — Troves DeFi 收益策略中的活跃存款及其当前价值和 APY。
  7. LST 头寸 — 来自 Endur 流动性质押的 xSTRK 持仓及其当前 STRK 价值和累计收益。

示例

用户: "Show me my portfolio"

npx starkfi@latest portfolio

用户: "What's my total value on Starknet?"

npx starkfi@latest portfolio

用户: "Get my portfolio as JSON for analysis"

npx starkfi@latest portfolio --json

用户: "Rebalance to 50% ETH, 30% USDC, 20% STRK"

# 1. 查看当前配置
npx starkfi@latest portfolio

# 2. 预览再平衡计划
npx starkfi@latest portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK" --simulate

# 3. 用户确认后执行
npx starkfi@latest portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK"
npx starkfi@latest tx-status <hash>

# 4. 验证新配置
npx starkfi@latest portfolio

用户: "I want 60% ETH and 40% STRK"

npx starkfi@latest portfolio-rebalance --target "60 ETH, 40 STRK" --simulate

用户: "Optimize my portfolio with 2% slippage"

npx starkfi@latest portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK" --slippage 2

错误处理

错误操作
Not authenticated首先运行 authenticate-wallet 技能。
Partial failure某些部分可能显示错误,而其他部分成功。投资组合使用容错聚合。
Network error重试一次。使用 config 设置自定义 RPC。
Invalid allocation确保目标百分比合计为 100 且代币符号有效。
Rebalance failed检查余额,确保代币在支持的提供者上有足够流动性。
Insufficient balance代币不足以执行交换——先检查 balance。

相关技能

  • 使用 balance 仅聚焦查看代币余额。
  • 使用 staking stake-status 查看详细的质押头寸。
  • 使用 lending lend-status 查看详细的借贷头寸。
  • 使用 lending lend-monitor 监控各借贷头寸的健康因子。
  • 使用 dca dca-list 查看活跃的 DCA 订单。
  • 使用 troves troves-position 查看详细的金库头寸。
  • 使用 lst lst-position 查看详细的流动性质押头寸。
  • 如需交换单个代币对(非完整再平衡),使用 trade。

相关技能