Web3 加密通信与数字钱包客户端安全架构实战

关键工程指标 (Key Engineering Metrics)

• 私钥明文落盘数 (Plaintext Key Disk Writes)：0 (Zero)
• 密钥派生与硬件隔离 (Hardware Key Isolation)：Secure Enclave / TEE
• 端到端会话加密 (IM Session Security)：E2EE + Perfect Forward

工程落地核查清单 (Architecture Checklist)

• 助记词与私钥仅在内存短暂驻留，签名完成后立即覆写清零，绝不写入日志、剪贴板或崩溃快照
• 利用 iOS Secure Enclave 与 Android StrongBox Keystore 硬件安全模块保护主加密密钥
• App 切入后台自动触发高斯模糊隐私遮罩，敏感助记词备份页禁止系统截屏与录屏
• 交易确认页强制解码合约 CallData，可读化展示 ERC-20 Approve 额度、目标合约与风险预警
• RPC 与 IM 通道启用 TLS 证书锁定（SSL Pinning）与多节点健康切换，防御中间人劫持

一、密钥生成、助记词与本地安全存储

1. BIP-39 Mnemonic Generation & Hardware-Backed Local Storage

数字钱包应使用符合 BIP-32、BIP-39、BIP-44 标准的 HD Wallet 方案，通过密码学安全随机数生成助记词，并按币种派生密钥。私钥绝不能明文写入 UserDefaults、SQLite、日志或埋点。移动端优先使用 Keychain、Keystore、Secure Enclave 或 TEE 保存加密后的密钥材料，Keystore 文件采用用户口令派生 KDF 密钥加密，并设置错误次数限制、生物识别解锁与本地擦除策略。

Generate entropy exclusively via OS CSPRNG (SecRandomCopyBytes / SecureRandom) following BIP-32/39/44 standards. Wrap encrypted Keystore blobs using Argon2id/PBKDF2 combined with hardware-bound keys inside iOS Secure Enclave or Android TEE, enforcing biometric authentication and brute-force rate limits.

二、交易签名、DApp 授权与加密通信链路

2. Local Transaction Signing, WalletConnect & DApp Isolation

交易签名必须在客户端本地完成，服务端只负责广播、行情、Gas 估算等辅助能力，不应接触私钥。连接 DApp 时应展示域名、链 ID、合约地址、权限范围与授权有效期，避免无限授权。WalletConnect、Deep Link、WebView JSBridge 需校验来源、绑定会话、最小化暴露接口，并对 RPC 请求做参数白名单和签名解析。RPC 节点建议使用 HTTPS/WSS、证书锁定、节点故障切换和请求签名，防止中间人篡改与恶意链参数欺骗。

All transaction and EIP-712 typed-data signatures must happen strictly on-device. When bridging DApps via WalletConnect v2 or injected WebView providers, bind origin domains, verify chainId parameters, and never auto-sign without explicit user confirmation.

三、风控体验、钓鱼防护与链上安全审计

3. Transaction Simulation, Anti-Phishing & Pre-Release Security Audit

安全产品不能只靠底层加密，还要降低用户误操作。交易确认页应解析 ERC-20 Approve、NFT 授权、合约交互等风险动作，提示无限授权、陌生合约、地址投毒、黑名单地址和异常授权。客户端需维护恶意域名、合约和地址库，对高价值转账进行延迟确认、大额二次验证和授权记录管理。上线前应做密钥依赖审计、反编译检查、日志排查、第三方 SDK 权限审查，并结合崩溃与异常签名告警持续监控风险。

Protect users from blind signing and address poisoning by simulating asset balance changes before confirmation, highlighting unlimited token approvals, and flagging lookalike transfer addresses.

参考实现代码 (security/key_vault_policy.ts (Zero-Plaintext Signing Lifecycle))

export async function signWithEphemeralKey<T>(
  encryptedVault: Uint8Array,
  biometricToken: string,
  signer: (privateKeyBytes: Uint8Array) => Promise<T>,
): Promise<T> {
  const keyBytes = await decryptInHardwareTee(encryptedVault, biometricToken)
  try {
    return await signer(keyBytes)
  } finally {
    // Zero out sensitive buffer immediately after signature generation
    keyBytes.fill(0)
  }
}

常见问题解答 (FAQ)

问：数字钱包的私钥可以上传到服务器做云端备份吗？ (Should a non-custodial wallet ever upload raw private keys to a server for cloud backup?)

答：原则上不应上传原始私钥。若提供云备份，应只备份用户口令加密后的助记词或 Keystore，密钥派生在客户端完成，并配合强口令、设备校验、生物识别和风险登录策略。 Never upload raw private keys. If cloud backup is offered, encrypt the keystore client-side using a user-held recovery passphrase (zero-knowledge encryption) before transmission so the server never possesses decryption capability.