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-cli-reference.md
精确参数 / 返回架构 — 持仓命令	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 上的持仓，请使用相应地址分别调用两次

全局说明

• ALL defi 命令的钱包地址参数均为 --address
• defi positions 使用 --chains（复数，逗号分隔）；defi position-detail 使用 --chain（单数）
• 报告完成前，请确认所选命令已成功执行，遵循其路由参考中的输出格式和安全检查，并明确报告任何部分成功或失败的链上步骤。