Portfolio Skill
Auslöser
- Schlüsselwörter: Portfolio, portfolio, Position, {PRIMARY_PROVIDER}, Protokoll, Lending, Staking, Liquidität
Wann NICHT verwenden
- Allgemeine Token-Abfragen (keine Portfolio-Positionen)
- Transaktionserstellung (entsprechenden Provider verwenden)
- Nicht- Portfolio-bezogene API-Probleme
Kerndateien
| Typ | Datei | Zweck |
|---|
| Controller | src/entity/portfolio/portfolio.controller.ts | REST-API |
| Router | src/service/portfolio/source-router/*.service.ts | Routing-Orchestrierung |
| Client | src/service/portfolio/providers/{provider}/*.ts | {PRIMARY_PROVIDER}-Integration |
| Aggregator | src/service/portfolio/aggregation/*.service.ts | Aggregationsberechnung |
| DTO | src/dto/portfolio/position.types.ts | Positionsmodell |
API-Übersicht
Basis: /onchain/v1/portfolio
| Endpunkt | Methode | Zweck |
|---|
/positions | POST | Portfolio-Positionen abrufen |
/chains | GET | Liste unterstützter Chains |
/protocols | GET | Liste unterstützter Protokolle |
Ausgabe
- Domänenspezifische Abfrageergebnisse mit Code-Referenzen
- Analyse und Empfehlungen basierend auf der aktuellen Architektur
Überprüfung
- Positionsdaten korrekt normalisiert
- Cache-Hit/Miss funktioniert ordnungsgemäß
- Aggregationsberechnungen korrekt
Entwicklungsanleitung
Protokollunterstützung hinzufügen
- Prüfen, ob {PRIMARY_PROVIDER} dies unterstützt
- Falls benutzerdefinierter Build erforderlich:
PortfolioPositionExtractor implementieren + registrieren + Routing konfigurieren
Datenquelle hinzufügen
ProviderClient + Adapter implementieren
- Bei
SourceRouter registrieren
- Routing-Strategie konfigurieren
Debuggen
redis-cli keys "portfolio:{provider}:*"
redis-cli get "portfolio:{provider}:positions:0x...:v2:..."
curl -X POST /positions -d '{"isForceRefresh": true, ...}'
Referenzen
references/architecture.md - Systemarchitektur + Cache-Strategie
references/api.md - API-Referenz + Datenmodelle
- @docs/features/portfolio/ - Detaillierte Dokumentation
Tests
| Typ | Ort |
|---|
| Unit | test/unit/service/portfolio/ |
| Integration | test/integration/portfolio/ |
Beispiele
Eingabe: Wie frage ich Portfolio-Positionen ab?
Aktion: POST /positions API + Routing-Strategie erklären
Eingabe: Wie funktioniert die {PRIMARY_PROVIDER}-Integration?
Aktion: {PRIMARY_PROVIDER}Client + {PRIMARY_PROVIDER}Adapter-Ablauf erklären