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
- Usa
portfoliocomo el PRIMER comando cuando el usuario pregunte "¿qué tengo?" o quiera una evaluación general. - El comando
portfolioes de solo lectura — nunca modifica ningún estado en la cadena. - Los precios en USD provienen del SDK de StarkZap y pueden tener ligeras variaciones.
- Para
portfolio-rebalance, SIEMPRE usa--simulateprimero para previsualizar el plan antes de ejecutar. - Las asignaciones objetivo deben sumar 100%. Si no es así, informa al usuario y pídele que las ajuste.
- Después de reequilibrar, ejecuta
portfolionuevamente 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ámetro | Tipo | Descripción | Obligatorio |
|---|---|---|---|
--json | flag | Salida en JSON | No |
portfolio-rebalance
| Parámetro | Tipo | Descripción | Obligatorio |
|---|---|---|---|
--target | string | Asignación objetivo (ej. "50 ETH, 30 USDC, 20 STRK") | Sí |
--slippage | número | Tolerancia de deslizamiento % (por defecto: 1) | No |
--simulate | flag | Previsualizar plan sin ejecutar | No |
--json | flag | Salida en JSON | No |
Formato de asignación objetivo: Pares <porcentaje> <token> separados por comas que suman 100.
Secciones del Panel
El panel muestra siete secciones:
- Saldos de Tokens — STRK, ETH y todos los tokens ERC-20 con saldos no nulos y sus valores en USD.
- 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.
- Posiciones de Préstamo — Posiciones activas de Vesu V2: cantidades prestadas y tomadas prestadas con detalles del pool.
- Órdenes DCA — Órdenes activas de intercambio recurrente de promedio de costos en dólares.
- Saldo Confidencial de Tongo — Saldos privados activos y pendientes bajo Tongo Cash.
- Posiciones de Bóvedas Troves — Depósitos activos en estrategias de rendimiento DeFi de Troves con valor actual y APY.
- 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
| Error | Acción |
|---|---|
No autenticado | Ejecuta primero la skill authenticate-wallet. |
Fallo parcial | Algunas secciones pueden mostrar errores mientras otras tienen éxito. La cartera utiliza agregación tolerante a fallos. |
Error de red | Reintentar una vez. Usa config para establecer un RPC personalizado. |
Asignación inválida | Asegúrate de que los porcentajes objetivo sumen 100 y los símbolos de tokens sean válidos. |
Reequilibrio fallido | Verifica saldos, asegúrate de que los tokens tengan suficiente liquidez en los proveedores compatibles. |
Saldo insuficiente | No hay suficientes tokens para ejecutar los intercambios — verifica balance primero. |
Skills Relacionadas
- Usa
balancepara una vista enfocada solo en saldos de tokens. - Usa
stakingstake-statuspara posiciones detalladas de staking. - Usa
lendinglend-statuspara posiciones detalladas de préstamo. - Usa
lendinglend-monitorpara monitorear factores de salud en posiciones de préstamo. - Usa
dcadca-listpara ver órdenes DCA activas. - Usa
trovestroves-positionpara posiciones detalladas de bóvedas. - Usa
lstlst-positionpara posiciones detalladas de staking líquido. - Usa
tradesi necesitas intercambiar un solo par de tokens (no un reequilibrio completo).