Skill de Portafolio
Activación
- Palabras clave: Portfolio, portafolio, posición, {PRIMARY_PROVIDER}, protocolo, lending, staking, liquidez
Cuándo NO Usarlo
- Consultas generales de tokens (no posiciones del portafolio)
- Construcción de transacciones (usa el proveedor correspondiente)
- Problemas de API no relacionados con portafolio
Archivos Principales
| Tipo | Archivo | Propósito |
|---|
| Controlador | src/entity/portfolio/portfolio.controller.ts | API REST |
| Enrutador | src/service/portfolio/source-router/*.service.ts | Orquestación de enrutamiento |
| Cliente | src/service/portfolio/providers/{provider}/*.ts | Integración con {PRIMARY_PROVIDER} |
| Agregador | src/service/portfolio/aggregation/*.service.ts | Cálculo de agregación |
| DTO | src/dto/portfolio/position.types.ts | Modelo de posición |
Resumen de API
Base: /onchain/v1/portfolio
| Endpoint | Método | Propósito |
|---|
/positions | POST | Obtener posiciones del portafolio |
/chains | GET | Lista de cadenas compatibles |
/protocols | GET | Lista de protocolos compatibles |
Salida
- Resultados de consultas específicas del dominio con referencias a código
- Análisis y recomendaciones basados en la arquitectura actual
Verificación
- Datos de posición normalizados correctamente
- Aciertos/fallos de caché funcionando correctamente
- Cálculos de agregación precisos
Guía de Desarrollo
Agregar Soporte para un Protocolo
- Verificar si {PRIMARY_PROVIDER} lo soporta
- Si se necesita una construcción personalizada: implementar
PortfolioPositionExtractor + registrar + configurar enrutamiento
Agregar una Fuente de Datos
- Implementar
ProviderClient + Adapter
- Registrar con
SourceRouter
- Configurar estrategia de enrutamiento
Depuración
redis-cli keys "portfolio:{provider}:*"
redis-cli get "portfolio:{provider}:positions:0x...:v2:..."
curl -X POST /positions -d '{"isForceRefresh": true, ...}'
Referencias
references/architecture.md - Arquitectura del sistema + estrategia de caché
references/api.md - Referencia de API + modelos de datos
- @docs/features/portfolio/ - Documentación detallada
Pruebas
| Tipo | Ubicación |
|---|
| Unitarias | test/unit/service/portfolio/ |
| Integración | test/integration/portfolio/ |
Ejemplos
Entrada: ¿Cómo consultar las posiciones del portafolio?
Acción: Explicar la API POST /positions + estrategia de enrutamiento
Entrada: ¿Cómo funciona la integración con {PRIMARY_PROVIDER}?
Acción: Explicar el flujo de {PRIMARY_PROVIDER}Client + {PRIMARY_PROVIDER}Adapter