Agent Wallet 会话
Agent Wallet 会话表示 AI Agent 当前通过 ukey wallet CLI 使用的钱包上下文。在现有 CLI 流程中，这条链路通常对应 App Transfer 或 App Bot Wallet 登录。
解锁哪些能力
会话激活后，Agent 就可以在同一个钱包上下文中继续执行只读和写操作：
| 能力 | 示例 |
|---|---|
| 钱包状态 | ukey wallet balance --chain eth |
| 收款地址 | ukey wallet get-address |
| 历史记录 | ukey wallet history --chain eth --detail |
| 行情上下文 | ukey wallet token trending --chain sol |
| Swap 准备 | ukey wallet swap quote --chain eth --from ETH --to USDC --amount 1 |
| 安全检查 | ukey wallet security audit --chain eth --token 0x... |
这也是为什么用户不需要把私钥粘贴给 Agent，也不需要在每个 Prompt 中反复提供地址。Agent 应读取当前活动会话，并清楚说明当前正在使用哪个钱包。
登录
ukey wallet auth login --app-transfer
UKey Wallet GUI 会提供 payload。CLI 会把会话导入本地 UKey Wallet CLI vault，并依赖操作系统凭据存储来保护敏感材料。
如果自动化环境已经拿到 payload，也可以显式传入：
ukey wallet auth login --app-transfer --payload <json-or-base64-json>
状态
每一类操作开始前，都应先读取 auth status：
ukey wallet auth status
当前 schema 通常会返回类似下面这些字段：
| 字段 | 含义 |
|---|---|
authStatus | authenticated 或 unauthenticated |
loginMethod | app_transfer 或 hardware |
walletKind | App Transfer 会话通常为 hd，硬件会话通常为 hw |
displayAddress | 展示给用户的当前活动钱包地址 |
storageBackend | CLI 使用的系统凭据存储 |
生命周期
| 阶段 | Agent 行为 |
|---|---|
| 任何操作前 | 运行 ukey wallet auth status，并明确说明未认证状态 |
| 只读操作前 | 复用当前活动地址和链默认值；只有在缺少链或 Token 上下文时才询问 |
| 资金操作前 | 展示当前活动地址、链、金额、接收方、费用或风险状态，并请求确认 |
| 会话变化后 | 重新运行 ukey wallet auth status，不要继续沿用旧地址假设 |
| 退出后 | 立即停止使用旧的钱包上下文 |
退出
ukey wallet auth logout
只有在用户明确要求结束当前会话时，Agent 才应执行 logout。