포트폴리오 스킬
트리거
- 키워드: Portfolio, portfolio, position, {PRIMARY_PROVIDER}, protocol, lending, staking, liquidity
사용하지 말아야 할 경우
- 일반 토큰 조회(포트폴리오 포지션이 아닌 경우)
- 트랜잭션 구축(해당 공급자 사용)
- 포트폴리오와 관련 없는 API 문제
핵심 파일
| 유형 | 파일 | 목적 |
|---|
| 컨트롤러 | src/entity/portfolio/portfolio.controller.ts | REST API |
| 라우터 | src/service/portfolio/source-router/*.service.ts | 라우팅 오케스트레이션 |
| 클라이언트 | src/service/portfolio/providers/{provider}/*.ts | {PRIMARY_PROVIDER} 통합 |
| 집계기 | src/service/portfolio/aggregation/*.service.ts | 집계 계산 |
| DTO | src/dto/portfolio/position.types.ts | 포지션 모델 |
API 개요
기본 경로: /onchain/v1/portfolio
| 엔드포인트 | 메서드 | 목적 |
|---|
/positions | POST | 포트폴리오 포지션 가져오기 |
/chains | GET | 지원 체인 목록 |
/protocols | GET | 지원 프로토콜 목록 |
출력
- 코드 참조가 포함된 도메인 특화 쿼리 결과
- 현재 아키텍처 기반 분석 및 권장 사항
검증
- 포지션 데이터가 올바르게 정규화됨
- 캐시 적중/실패가 올바르게 작동함
- 집계 계산이 정확함
개발 가이드
프로토콜 지원 추가
- {PRIMARY_PROVIDER}가 이를 지원하는지 확인
- 사용자 정의 구축이 필요한 경우:
PortfolioPositionExtractor 구현 + 등록 + 라우팅 구성
데이터 소스 추가
ProviderClient + Adapter 구현
SourceRouter에 등록
- 라우팅 전략 구성
디버그
redis-cli keys "portfolio:{provider}:*"
redis-cli get "portfolio:{provider}:positions:0x...:v2:..."
curl -X POST /positions -d '{"isForceRefresh": true, ...}'
참조
references/architecture.md - 시스템 아키텍처 + 캐시 전략
references/api.md - API 참조 + 데이터 모델
- @docs/features/portfolio/ - 상세 문서
테스트
| 유형 | 위치 |
|---|
| 단위 | test/unit/service/portfolio/ |
| 통합 | test/integration/portfolio/ |
예시
입력: 포트폴리오 포지션을 어떻게 조회하나요?
동작: POST /positions API + 라우팅 전략 설명
입력: {PRIMARY_PROVIDER} 통합은 어떻게 작동하나요?
동작: {PRIMARY_PROVIDER}Client + {PRIMARY_PROVIDER}Adapter 흐름 설명