Skill de Portfólio
Gatilho
- Palavras-chave: Portfólio, portfólio, posição, {PRIMARY_PROVIDER}, protocolo, empréstimo, staking, liquidez
Quando NÃO Usar
- Consultas gerais de tokens (não posições de portfólio)
- Construção de transações (use o provedor correspondente)
- Problemas de API não relacionados ao portfólio
Arquivos Principais
| Tipo | Arquivo | Propósito |
|---|
| Controlador | src/entity/portfolio/portfolio.controller.ts | API REST |
| Roteador | src/service/portfolio/source-router/*.service.ts | Orquestração de roteamento |
| Cliente | src/service/portfolio/providers/{provider}/*.ts | Integração {PRIMARY_PROVIDER} |
| Agregador | src/service/portfolio/aggregation/*.service.ts | Cálculo de agregação |
| DTO | src/dto/portfolio/position.types.ts | Modelo de posição |
Visão Geral da API
Base: /onchain/v1/portfolio
| Endpoint | Método | Propósito |
|---|
/positions | POST | Obter posições de portfólio |
/chains | GET | Lista de cadeias suportadas |
/protocols | GET | Lista de protocolos suportados |
Saída
- Resultados de consultas específicas de domínio com referências de código
- Análise e recomendações com base na arquitetura atual
Verificação
- Dados de posição normalizados corretamente
- Acerto/erro de cache funcionando adequadamente
- Cálculos de agregação precisos
Guia de Desenvolvimento
Adicionar Suporte a Protocolo
- Verifique se {PRIMARY_PROVIDER} oferece suporte
- Se for necessário uma construção personalizada: implemente
PortfolioPositionExtractor + registre + configure roteamento
Adicionar Fonte de Dados
- Implemente
ProviderClient + Adapter
- Registre com
SourceRouter
- Configure a estratégia de roteamento
Depuração
redis-cli keys "portfolio:{provider}:*"
redis-cli get "portfolio:{provider}:positions:0x...:v2:..."
curl -X POST /positions -d '{"isForceRefresh": true, ...}'
Referências
references/architecture.md - Arquitetura do sistema + estratégia de cache
references/api.md - Referência da API + modelos de dados
- @docs/features/portfolio/ - Documentação detalhada
Testes
| Tipo | Localização |
|---|
| Unitário | test/unit/service/portfolio/ |
| Integração | test/integration/portfolio/ |
Exemplos
Entrada: Como consultar posições de portfólio?
Ação: Explicar API POST /positions + estratégia de roteamento
Entrada: Como funciona a integração {PRIMARY_PROVIDER}?
Ação: Explicar fluxo do {PRIMARY_PROVIDER}Client + {PRIMARY_PROVIDER}Adapter