如何在不暴露恢复短语的情况下将 Trust Wallet 连接到 Web3 dApp？

了解 Trust 钱包集成机制

1. Trust Wallet 作为非托管移动钱包运行，原生实现 WalletConnect v2 协议。它不像桌面扩展那样依赖于浏览器注入。

2. 连接流从 dApp 前端发起，生成一个会话提案，其中包含链 ID、请求的权限以及应用程序名称和徽标等元数据。

3. QR 码或深层链接携带范围为特定中继服务器的加密会话 URI。此 URI 不包含私钥材料或恢复短语数据。

4. 扫描后，Trust Wallet 使用其本地存储的配对密钥解密会话请求，并通过中继签名验证域完整性。

5. 一旦获得批准，钱包将通过中继与 dApp 建立端到端加密通道，从而实现安全的 JSON-RPC 消息交换，而不会暴露种子短语。

WalletConnect v2 会话安全架构

1. 每个会话都使用源自 dApp 和钱包之间 ECDH 密钥交换的临时对称密钥。这些密钥在会话终止后将被丢弃。

2. 中继服务器永远不会看到解密的有效负载 - 所有消息在传输前均经过 AES-256-GCM 加密。

3. 会话提案包括强制性对等元数据字段： appUrl 、 appIcon和appDescription ，防止域欺骗。

4. Trust Wallet 强制执行严格的来源验证：它根据会话启动期间注册的redirectUri交叉检查 dApp 的域。

5. 连接期间不会发生涉及恢复短语的加密操作。签名请求仅在批准后在钱包的安全飞地内处理。

存在暴露风险的常见错误配置

1. 使用已弃用的 WalletConnect v1 网桥会引入未加密的握手漏洞，并且缺乏域绑定实施。

2. 硬编码特定于钱包的 URI（例如trust:// ）会绕过 WalletConnect 的标准化发现层，并可能在 Android 上触发不安全的意图处理。

3. 未能验证sessionNamespaces对象会导致权限升级 - 例如，在连接到 Solana 链时接受以太坊方法。

4. 将会话密钥存储在 localStorage 而不是仅内存上下文中允许恶意脚本劫持活动会话。

5. 在 Trust Wallet 官方 SDK 之外实现自定义 QR 扫描仪会增加 URI 解析期间中间人拦截的风险。

客户端实施保障措施

1. 始终使用与您在 WalletConnect 云仪表板上经过验证的 dApp 身份绑定的projectId来初始化 WalletConnect。

2. 强制实施requiredNamespaces来限制 RPC 方法——例如，明确拒绝eth_signTypedData_v4，除非合约交互得到确认。

3. web3wallet SDK仅用于钱包发起的配对；避免在禁用 iframe 沙箱的上下文中嵌入@walletconnect/modal 。

4. 在分派任何交易请求之前，验证sessionEvent负载和web3.eth.getChainId()之间的链 ID 一致性。

5. 每个会话切勿多次调用eth_requestAccounts — 重复调用可能会触发多余的签名提示并增加 UI 混乱。

常见问题解答

问：如果我批准恶意 dApp，Trust Wallet 会泄露我的恢复短语吗？答：不会。在 WalletConnect 会话期间绝不会传输、处理或引用恢复短语。批准仅授予范围内的签名权限。

问：扫描 WalletConnect 二维码是否可以让 dApp 访问我钱包的交易历史记录？答：仅当通过eth_getLogs或类似的读取方法明确请求时 - 即使这样，结果也会根据请求中定义的块范围和合约地址进行过滤。

问：为什么 Trust Wallet 在连接时有时会显示“Unknown dApp”？答：当 dApp 未能在会话提案中提供有效的appUrl或appIcon时，会发生这种情况，从而触发 Trust Wallet 的后备安全警告。

问：将 Trust Wallet 连接到本地主机上运行的 dApp 是否安全？答：是的，只要本地服务器使用 HTTPS 或通过启用 WalletConnect 开发模式的127.0.0.1提供服务 — 两者都可以防止会话 URI 的外部网络泄漏。