链上连接（钱包与 Hyperliquid）

连接钱包（Privy、MetaMask、WalletConnect 或外部地址），并绑定到 Hyperliquid 以进行链上永续交易。

入口：/account/wallets

---

1. 两步流程

在 Alphio 上链是两步，不是一步：

1. 添加钱包 ——让一个钱包可以在 Alphio 中使用（Privy 内嵌钱包、MetaMask、WalletConnect，或你自有的外部地址）。
2. 绑定到 Hyperliquid ——在 Hyperliquid 创建一个 agent-wallet 授权，让 Alphio 代表你下单永续。

如果你只想查看余额，可以添加钱包后跳过 Hyperliquid 绑定。反过来，Hyperliquid 绑定的前提是钱包已经添加。

---

2. 添加钱包

1. 进入 /account/wallets。
2. 点击添加钱包，钱包来源选择器打开。
3. 选择四种来源之一：
   • Privy ——Alphio 的内嵌钱包方案。适合新用户，无需插件或 App，恢复绑定你的 Alphio 登录。
   • MetaMask ——浏览器插件钱包。在 MetaMask 弹窗中批准连接请求。
   • WalletConnect ——用手机钱包 App 扫描二维码连接。
   • 外部地址（只读） ——粘贴公钥地址追踪余额和仓位，无法签名交易。
4. 在所选钱包中批准连接 / 签名请求。
5. 钱包随即出现在 /account/wallets，标注地址和来源。

---

3. 绑定到 Hyperliquid

Hyperliquid 是一个高性能永续合约 DEX。要通过 Alphio 交易它，你需要授权一个 agent wallet：一对额外的密钥，Hyperliquid 信任它可以替主钱包下单。资金托管仍在主钱包——agent wallet 只能下单，不能提款。

绑定流程：

1. 在 /account/wallets 找到要使用的钱包，点击绑定到 Hyperliquid。
2. 在你的钱包里签署 Hyperliquid agent-wallet 授权消息（MetaMask 弹窗、Privy 弹窗或 WalletConnect 提示）。
3. Alphio 在服务端保存 agent-wallet 凭证并确认绑定。

绑定完成后，即可从聊天、自选股或 Trade Modal 下 Hyperliquid 永续单。

安全说明： agent wallet 无法从你的 Hyperliquid 账户提款。提款始终需要主钱包签名。

---

4. 管理与移除钱包

所有钱包管理在 /account/wallets。对每个钱包可：

• 查看 ——当前余额和 Hyperliquid 绑定状态。
• 重新绑定 ——agent 消息过期时重新签名。
• 解绑 Hyperliquid ——撤销 agent wallet，但不移除钱包本身。
• 移除钱包 ——完全断开。对 Privy 钱包而言，移除不会销毁底层钱包，后续仍可通过同样的恢复路径重新添加。

---

5. 已知问题

注意

以下清单仅尽力覆盖。某些平台 / 钱包组合可能还有额外限制，请在遇到不在清单中的组合时与产品团队确认。

• WalletConnect 会话过期 ——会话会超时；如果手机收不到签名请求，请到 /account/wallets 重新连接。
• 移动版 Safari + 插件钱包 ——基于插件的钱包（MetaMask）在移动浏览器不可用，请改用钱包 App 通过 WalletConnect。
• Hyperliquid agent 重新授权 ——agent-wallet 权限由 Hyperliquid 设置时效。如果下单开始报授权错误，请到 /account/wallets 重新绑定。
• 外部（只读）钱包 ——永远无法绑定 Hyperliquid，因为它们不能签署交易。