okx-defi

OKX DeFi

onchainos defi CLI グループを通じて、複数のチェーンに対応した、OKX が集約する DeFi プロダクトやポジションを見つけて管理します。

事前確認

事前確認：各スレッドの開始時に、../okx-agentic-wallet/_shared/preflight.md の確認を完了してください。ファイルが見つからない場合は、_shared/preflight.md を読んでください。

インテントのルーティング

選択したルートに必要な参照ファイルのみを読み込んでください。

ユーザーのインテント	参照先
DeFi プロダクトを見つける／検索する、最適な APY を探す	invest.md
プロダクトの詳細（APY、TVL、受け入れトークン）	invest.md
預け入れ／ステーキング／流動性の提供	invest.md
ポジションの出金／償還（全額または一部）	invest.md
報酬の請求（プラットフォーム／投資／V3 手数料／ボーナス／ロック解除済み元本）	invest.md
APY 履歴、TVL 履歴、V3 の深度／価格チャート	invest.md
DeFi ポジション／保有資産の概要を表示する	portfolio.md
プロトコルごとのポジション詳細	portfolio.md
正確なパラメーター／戻り値のスキーマ — invest、共通サポート、チャートのコマンド	invest-cli-reference.md
正確なパラメーター／戻り値のスキーマ — positions コマンド	portfolio-cli-reference.md
エラー／預け入れの失敗／期限切れの calldata	invest-troubleshooting.md
エラー／ポジションが空／アドレス形式の問題	portfolio-troubleshooting.md

一般的なフローは両方にまたがります：ポジションを確認する（Portfolio）→ 償還または請求を行う（Invest）。リクエストがこれらを連続して行う場合は、両方の参照ファイルを読んでください。

名前が指定されたサードパーティー DApp に関するリクエストは、プロトコル固有の APY、TVL、取引量、履歴、期間分析を含め、okx-dapp-discovery にルーティングしてください。プロトコル横断的な一般の利回り／APY／TVL や V3 流動性の分析は、ここで扱います。トークンの検索／価格／チャートのリクエストは okx-dex-market に、現物スワップ、ウォレット残高、ログイン、コントラクト呼び出し、トランザクションのブロードキャストは okx-agentic-wallet にルーティングしてください。

チェーン名のサポート

CLI はチェーン名を自動的に解決します（例：ethereum → 1、bsc → 56、solana → 501）。DeFi 固有の別名については、portfolio.md の Chain Support テーブルを使用してください。

セキュリティ

アドレスの解決

ユーザーがウォレットアドレスを指定していない場合は、defi コマンドを実行する前に Agentic Wallet から自動的に解決してください。

1. onchainos wallet status          → check if logged in, get active account
2. onchainos wallet addresses       → get addresses grouped by chain category:
                                       - XLayer addresses
                                       - EVM addresses (Ethereum, BSC, Polygon, etc.)
                                       - Solana addresses
3. Match address to target chain:
   - EVM chains → use EVM address
   - Solana     → use Solana address
   - XLayer     → use XLayer address

ルール：

• ユーザーが明示的にアドレスを指定した場合は、そのアドレスを直接使用し、この手順を省略してください
• ウォレットにログインしていない場合は、まずログインするようユーザーに依頼するか（→ okx-agentic-wallet）、アドレスを手動で指定するよう案内してください
• ユーザーが「すべてのアカウントを確認」または「すべてのウォレット」と言った場合は、wallet balance --all を使ってすべてのアカウント ID を取得し、各アカウントについて wallet switch <id> + wallet addresses を実行してください
• アカウントに同じタイプのアドレスが複数ある場合は、処理を続ける前に必ず解決したアドレスをユーザーに確認してください

アドレスとチェーンの互換性

--address とチェーンのパラメーターは互換性がなければなりません。EVM アドレス（0x…）で照会できるのは EVM チェーンのみです。Solana アドレス（base58）で照会できるのは solana のみです。これらを混在させないでください。API はエラー 84019（アドレス形式エラー）を返します。

• 0x… アドレス → EVM チェーンのみを指定してください：ethereum,bsc,polygon,arbitrum,base,xlayer,avalanche,optimism,fantom,linea,scroll,zksync
• base58 アドレス → solana のみを指定してください
• Sui アドレス → sui のみを指定してください。Tron アドレス（T…）→ tron のみを指定してください。TON アドレス → ton のみを指定してください
• ユーザーが EVM と Solana の両方のポジションを希望する場合は、それぞれのアドレスを使って2 回に分けて呼び出してください

全般的な注意事項

• すべての defi コマンドで、ウォレットアドレスのパラメーターは --address です。
• defi positions では --chains（複数形、カンマ区切り）を使用し、defi position-detail では --chain（単数形）を使用します。
• 完了を報告する前に、選択したコマンドが正常に実行されたことを確認し、参照先のリファレンスに記載された出力形式と安全性チェックを適用したうえで、オンチェーン処理に一部未完了または失敗した手順があれば明示してください。