Communitygithub.com

ahmetenesdur/starkfi

Visualiza un panel completo de cartera DeFi y optimiza la asignación de tu cartera mediante reequilibrio automatizado. Utiliza esta skill cuando el usuario quiera una visión general, resumen, panel, valor total, patrimonio neto, reequilibrio de cartera, asignación objetivo, o ver todas sus posiciones DeFi en Starknet de una sola vez. También se activa cuando el usuario pregunta '¿qué tengo?', 'muéstrame todo', '¿cuánto valgo?', 'mis posiciones', 'mis inversiones', 'reequilibrar mi cartera', 'quiero 50% ETH', 'optimiza mis tenencias', o cualquier solicitud de una visión holística de sus tenencias en Starknet, incluso si no mencionan explícitamente 'cartera'.

¿Qué es starkfi?

Esta skill proporciona un panel de control integral de cartera DeFi para Starknet, agregando saldos de tokens, posiciones de staking, posiciones de bóvedas Troves, staking líquido Endur (LST), posiciones de préstamo, órdenes DCA y saldos confidenciales de Tongo, todo con valoraciones en USD. También permite reequilibrar la cartera a una asignación objetivo mediante intercambios por lotes automatizados, con un modo de simulación para previsualizar el plan antes de ejecutarlo. Es compatible con herramientas de línea de comandos como npx y está diseñada para asistentes de IA agente como Claude Code, Cursor, Codex y otros, permitiendo una gestión eficiente de carteras DeFi en Starknet.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Visión General y Optimización de Cartera

Muestra un panel completo de cartera DeFi que agrega saldos de tokens, posiciones de staking, posiciones de bóvedas Troves, staking líquido Endur (LST), posiciones de préstamo, órdenes DCA y saldos confidenciales de Tongo, todo con valoraciones en USD. Reequilibra la cartera a una asignación objetivo mediante intercambios por lotes automatizados.

Prerrequisitos

  • Se requiere una sesión activa.
  • Para reequilibrio: saldos de tokens suficientes + gas para transacciones de intercambio por lotes.

Reglas

  1. Usa portfolio como el PRIMER comando cuando el usuario pregunte "¿qué tengo?" o quiera una evaluación general.
  2. El comando portfolio es de solo lectura — nunca modifica ningún estado en la cadena.
  3. Los precios en USD provienen del SDK de StarkZap y pueden tener ligeras variaciones.
  4. Para portfolio-rebalance, SIEMPRE usa --simulate primero para previsualizar el plan antes de ejecutar.
  5. Las asignaciones objetivo deben sumar 100%. Si no es así, informa al usuario y pídele que las ajuste.
  6. Después de reequilibrar, ejecuta portfolio nuevamente para confirmar la nueva asignación.

Comandos

Panel de Cartera

npx starkfi@latest portfolio [--json]

Reequilibrio de Cartera

# Reequilibrar a asignación objetivo
npx starkfi@latest portfolio-rebalance --target "<asignación>" [--slippage <n>] [--simulate] [--json]

Parámetros

portfolio

ParámetroTipoDescripciónObligatorio
--jsonflagSalida en JSONNo

portfolio-rebalance

ParámetroTipoDescripciónObligatorio
--targetstringAsignación objetivo (ej. "50 ETH, 30 USDC, 20 STRK")Sí
--slippagenúmeroTolerancia de deslizamiento % (por defecto: 1)No
--simulateflagPrevisualizar plan sin ejecutarNo
--jsonflagSalida en JSONNo

Formato de asignación objetivo: Pares <porcentaje> <token> separados por comas que suman 100.

Secciones del Panel

El panel muestra siete secciones:

  1. Saldos de Tokens — STRK, ETH y todos los tokens ERC-20 con saldos no nulos y sus valores en USD.
  2. Posiciones de Staking — Stakes activos en todos los validadores/pools con recompensas pendientes. Muestra cantidades en proceso de retiro y fechas de enfriamiento cuando hay intenciones de salida activas.
  3. Posiciones de Préstamo — Posiciones activas de Vesu V2: cantidades prestadas y tomadas prestadas con detalles del pool.
  4. Órdenes DCA — Órdenes activas de intercambio recurrente de promedio de costos en dólares.
  5. Saldo Confidencial de Tongo — Saldos privados activos y pendientes bajo Tongo Cash.
  6. Posiciones de Bóvedas Troves — Depósitos activos en estrategias de rendimiento DeFi de Troves con valor actual y APY.
  7. Posiciones LST — Tenencias de xSTRK del staking líquido Endur con valor actual en STRK y rendimiento acumulado.

Ejemplos

Usuario: "Muéstrame mi cartera"

npx starkfi@latest portfolio

Usuario: "¿Cuál es mi valor total en Starknet?"

npx starkfi@latest portfolio

Usuario: "Obtén mi cartera como JSON para análisis"

npx starkfi@latest portfolio --json

Usuario: "Reequilibrar a 50% ETH, 30% USDC, 20% STRK"

# 1. Ver asignación actual
npx starkfi@latest portfolio

# 2. Previsualizar el plan de reequilibrio
npx starkfi@latest portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK" --simulate

# 3. Ejecutar después de que el usuario confirme
npx starkfi@latest portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK"
npx starkfi@latest tx-status <hash>

# 4. Verificar nueva asignación
npx starkfi@latest portfolio

Usuario: "Quiero 60% ETH y 40% STRK"

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

Usuario: "Optimiza mi cartera con 2% de deslizamiento"

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

Manejo de Errores

ErrorAcción
No autenticadoEjecuta primero la skill authenticate-wallet.
Fallo parcialAlgunas secciones pueden mostrar errores mientras otras tienen éxito. La cartera utiliza agregación tolerante a fallos.
Error de redReintentar una vez. Usa config para establecer un RPC personalizado.
Asignación inválidaAsegúrate de que los porcentajes objetivo sumen 100 y los símbolos de tokens sean válidos.
Reequilibrio fallidoVerifica saldos, asegúrate de que los tokens tengan suficiente liquidez en los proveedores compatibles.
Saldo insuficienteNo hay suficientes tokens para ejecutar los intercambios — verifica balance primero.

Skills Relacionadas

  • Usa balance para una vista enfocada solo en saldos de tokens.
  • Usa staking stake-status para posiciones detalladas de staking.
  • Usa lending lend-status para posiciones detalladas de préstamo.
  • Usa lending lend-monitor para monitorear factores de salud en posiciones de préstamo.
  • Usa dca dca-list para ver órdenes DCA activas.
  • Usa troves troves-position para posiciones detalladas de bóvedas.
  • Usa lst lst-position para posiciones detalladas de staking líquido.
  • Usa trade si necesitas intercambiar un solo par de tokens (no un reequilibrio completo).

Skills relacionados