Communitygithub.com

StarkFi - Portfólio Starknet

Visualize um painel completo de portfólio DeFi e otimize a alocação por meio de rebalanceamento automatizado. Use essa skill quando o usuário quiser uma visão geral, resumo, painel, valor total, patrimônio líquido, rebalanceamento de portfólio, alocação-alvo ou quiser ver todas as suas posições DeFi na Starknet de uma só vez.

O que é StarkFi - Portfólio Starknet?

Esta skill fornece uma visão holística e consolidada do portfólio DeFi de um usuário na rede Starknet. Ela agrega saldos de tokens, posições em staking, vaults Troves, participações em staking líquido Endur (LST), posições de empréstimo, ordens DCA e saldos confidenciais do Tongo Cash, tudo com valores em USD. Além da visualização, a skill também suporta o rebalanceamento automatizado do portfólio para uma alocação-alvo definida pelo usuário, usando swaps em lote. A segurança é priorizada com um modo de simulação (`--simulate`) que permite visualizar o plano de rebalanceamento antes de executá-lo, e o comando de portfólio é somente leitura, nunca alterando o estado on-chain. A skill é ideal para desenvolvedores e usuários que desejam uma visão completa de seus ativos e uma maneira simplificada de otimizar sua exposição no ecossistema Starknet.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Visão Geral e Otimização do Portfólio

Exiba um painel completo de portfólio DeFi que agrega saldos de tokens, posições em staking, posições em vaults Troves, staking líquido Endur (LST), posições de empréstimo, ordens DCA e saldos confidenciais do Tongo Cash — tudo com valores em USD. Rebalanceie o portfólio para uma alocação-alvo por meio de swaps em lote automatizados.

Pré-requisitos

  • Sessão ativa necessária.
  • Para rebalanceamento: saldos de tokens suficientes + gás para transações de swap em lote.

Regras

  1. Use portfolio como o PRIMEIRO comando quando o usuário perguntar "o que eu tenho?" ou quiser uma avaliação geral.
  2. O comando portfolio é somente leitura — ele nunca modifica nenhum estado on-chain.
  3. Os preços em USD são obtidos do SDK StarkZap e podem apresentar pequenas variações.
  4. Para portfolio-rebalance, SEMPRE use --simulate primeiro para visualizar o plano antes de executar.
  5. As alocações-alvo devem somar 100%. Se não somarem, informe o usuário e peça para ajustá-las.
  6. Após o rebalanceamento, execute portfolio novamente para confirmar a nova alocação.

Comandos

Painel do Portfólio

npx starkfi@latest portfolio [--json]

Rebalanceamento do Portfólio

# Rebalancear para alocação-alvo
npx starkfi@latest portfolio-rebalance --target "<alocação>" [--slippage <n>] [--simulate] [--json]

Parâmetros

portfolio

ParâmetroTipoDescriçãoObrigatório
--jsonflagSaída em JSONNão

portfolio-rebalance

ParâmetroTipoDescriçãoObrigatório
--targetstringAlocação-alvo (ex.: "50 ETH, 30 USDC, 20 STRK")Sim
--slippagenúmeroTolerância de slippage % (padrão: 1)Não
--simulateflagVisualizar plano sem executarNão
--jsonflagSaída em JSONNão

Formato da alocação-alvo: Pares <porcentagem> <token> separados por vírgula que somam 100.

Seções do Painel

O portfólio exibe sete seções:

  1. Saldos de Tokens — STRK, ETH e todos os tokens ERC-20 com saldos não zero e seus valores em USD.
  2. Posições em Staking — Stakes ativos em todos os validadores/pools com recompensas pendentes. Mostra valores em processo de retirada e datas de cooldown quando intenções de saída estão ativas.
  3. Posições de Empréstimo — Posições ativas do Vesu V2: valores fornecidos e emprestados com detalhes do pool.
  4. Ordens DCA — Ordens de swap recorrentes de Dollar-Cost Averaging ativas.
  5. Saldo Confidencial Tongo — Saldos privados ativos e pendentes no Tongo Cash.
  6. Posições em Vaults Troves — Depósitos ativos em estratégias de yield DeFi da Troves com valor atual e APY.
  7. Posições LST — Participações em xSTRK do staking líquido Endur com valor atual em STRK e rendimento acumulado.

Exemplos

Usuário: "Mostre meu portfólio"

npx starkfi@latest portfolio

Usuário: "Qual é meu valor total na Starknet?"

npx starkfi@latest portfolio

Usuário: "Obtenha meu portfólio como JSON para análise"

npx starkfi@latest portfolio --json

Usuário: "Rebalanceie para 50% ETH, 30% USDC, 20% STRK"

# 1. Visualizar alocação atual
npx starkfi@latest portfolio

# 2. Visualizar o plano de rebalanceamento
npx starkfi@latest portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK" --simulate

# 3. Executar após confirmação do usuário
npx starkfi@latest portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK"
npx starkfi@latest tx-status <hash>

# 4. Verificar a nova alocação
npx starkfi@latest portfolio

Usuário: "Quero 60% ETH e 40% STRK"

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

Usuário: "Otimize meu portfólio com 2% de slippage"

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

Tratamento de Erros

ErroAção
Não autenticadoExecute a skill authenticate-wallet primeiro.
Falha parcialAlgumas seções podem mostrar erros enquanto outras funcionam. O portfólio usa agregação tolerante a falhas.
Erro de redeTente novamente uma vez. Use config para definir um RPC personalizado.
Alocação inválidaGaranta que as porcentagens-alvo somem 100 e que os símbolos dos tokens sejam válidos.
Rebalanceamento falhouVerifique os saldos e garanta que os tokens tenham liquidez suficiente nos provedores compatíveis.
Saldo insuficienteNão há tokens suficientes para executar swaps — verifique balance primeiro.

Skills Relacionadas

  • Use balance para uma visão focada apenas nos saldos de tokens.
  • Use staking stake-status para posições detalhadas de staking.
  • Use lending lend-status para posições detalhadas de empréstimo.
  • Use lending lend-monitor para monitorar fatores de saúde em todas as posições de empréstimo.
  • Use dca dca-list para visualizar ordens DCA ativas.
  • Use troves troves-position para posições detalhadas em vaults.
  • Use lst lst-position para posições detalhadas de staking líquido.
  • Use trade se você precisar trocar um único par de tokens (não rebalanceamento completo).

Habilidades Relacionadas