ポートフォリオスキル は何をしますか?
トリガー
- キーワード: Portfolio, portfolio, ポジション, {PRIMARY_PROVIDER}, プロトコル, レンディング, ステーキング, 流動性
使用すべきでない場合
- 一般的なトークンクエリ(ポートフォリオのポジションではない)
- トランザクション構築(対応するプロバイダーを使用)
- ポートフォリオに関連しない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 のフローを説明