Communitygithub.com

ahmetenesdur/starkfi

查看全面的 DeFi 投資組合儀表板,並透過自動重新平衡最佳化資產配置。當使用者想要概覽、摘要、儀表板、總價值、淨值、投資組合重新平衡、目標配置,或想要一次查看 Starknet 上所有 DeFi 部位時,使用此技能。

starkfi 是什麼?

此技能提供一個單一命令的 Starknet DeFi 投資組合儀表板,彙總代幣餘額、質押部位、Troves 金庫部位、Endur 流動性質押 (LST)、借貸部位、DCA 訂單以及機密的 Tongo 餘額,全部以美元計價。它還支援透過自動批量交換,將投資組合重新平衡到目標配置,讓使用者能夠有效地最佳化其持倉。該技能與 StarkZap SDK 整合以獲取價格資料,並使用容錯聚合來處理部分失敗情況。它支援 Claude Code、Cursor 和 Codex 等平台,透過命令列介面與 Starkfi 基礎設施互動。

相容平台~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. USD 價格來自 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 代幣及其 USD 價值。
  2. 質押部位 — 所有驗證者/礦池中的活性質押,包含待領獎勵。當退出意圖啟用時,顯示解除質押金額和冷卻日期。
  3. 借貸部位 — 活躍的 Vesu V2 部位:供應和借入的金額,附帶礦池詳細資訊。
  4. DCA 訂單 — 活躍的平均成本法定期交換訂單。
  5. 機密 Tongo 餘額 — Tongo Cash 下的私人活躍和待處理餘額。
  6. Troves 金庫部位 — Troves DeFi 收益策略中的活躍存款,包含當前價值和 APY。
  7. LST 部位 — 來自 Endur 流動性質押的 xSTRK 持倉,包含當前 STRK 價值和累計收益。

範例

使用者:「顯示我的投資組合」

npx starkfi@latest portfolio

使用者:「我在 Starknet 上的總價值是多少?」

npx starkfi@latest portfolio

使用者:「以 JSON 格式取得我的投資組合以進行分析」

npx starkfi@latest portfolio --json

使用者:「重新平衡到 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

使用者:「我想要 60% ETH 和 40% STRK」

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

使用者:「以 2% 滑點最佳化我的投資組合」

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。

相關技能