企业官网建设流程全解析

XRP & EVM 钱包安全审计清单：自动锁定、失败冷却与密码解锁机制逐条拆解

【免费下载链接】XRP-community-walletFully decentralized and the most secure XRP & EVM wallet - built by the community, for the community.项目地址: https://gitcode.com/gh_mirrors/xr/XRP-community-wallet

Ripple Community Wallet（XRP-community-wallet）是一款由社区构建的全去中心化 XRP & EVM 钱包，私钥永不离开你的设备。这篇文章以"安全审计清单"的视角，逐条拆解它的三大核心防护机制：自动锁定（Auto-lock）、密码失败冷却（Cooldown）和密码解锁（Unlock），帮你在安装钱包前就能看懂它到底"安全在哪"。🔐

一、安全总览：三道防线如何协同

钱包的安全模型可以概括为一句话：密钥加密存储 → 会话内存隔离 → 失败行为惩罚。

三道防线分别覆盖"人离开""人在猜密码""正常解锁"三种场景，缺一不可。下面逐条拆解。

二、自动锁定机制：15 分钟不操作就锁

审计项 1：无操作自动上锁 ✅

打开 useAutoLock.ts，核心逻辑非常直白：

• 监听mousemove、mousedown、keydown、touchstart、scroll五类事件，任何一次操作都会重置计时器；
• 计时器到期（默认15 分钟）后调用lock()清空内存中的解锁状态，并强制跳转到/unlock页面；
• 每次重置之间加了1 秒节流（RESET_THROTTLE_MS = 1000），防止鼠标快速移动时频繁创建/销毁定时器。

审计项 2：切走标签页立即锁定 ✅

onVisibility监听器会在document.visibilityState === 'hidden'（你切到别的标签页、切到别的 App）时立即上锁。这个默认行为对齐了 MetaMask 等主流钱包的规范——注释里标注了security audit L2，说明这是安全审计后主动加强的默认值。

审计项 3：设置项可配置 ✅

自动锁定时长不是写死的。在 GeneralSettings.tsx 的"安全"卡片里，用户可以选择1m / 5m / 15m / 30m / 1h五档，还可以单独开关"标签页隐藏时立即锁定"。配置项autoLockMinutes与lockOnHidden持久化在 IndexedDB 的preferences中（见 vault.ts 的DEFAULT_PREFERENCES）。

💡新手提示：在公共电脑上使用钱包，建议把自动锁定调到1 分钟，并保留"切走即锁"开启。

三、失败冷却机制：错 5 次密码，等 30 秒

审计项 4：暴力破解有惩罚 ✅

UnlockPage.tsx 的提交逻辑里，冷却期间表单按钮直接禁用，并展示"Too many attempts. Try again in {{sec}} seconds."的倒计时提示（role="alert"，对读屏器也友好）。

审计项 5：阈值与时长 ✅

真正的计数逻辑在 vaultMutations.ts 的unlock()里：

• 每次解密失败，failedAttempts加 1；
• 累计达到 5 次失败，设置cooldownUntil = Date.now() + 30_000（30 秒冷却）；
• 冷却期间再次输入密码会直接抛出vault: cooldown错误，连 KDF 计算都不会执行；
• 解锁成功后，失败计数和冷却时间立即清零并写回存储。

审计项 6：刷新页面无法绕过 ✅

这是很多钱包会踩的坑。冷却状态通过persistLockoutState()写入 IndexedDB 的lockout键，应用启动时由ensureLockoutHydrated()恢复（vault.ts）。源码注释明确标注security audit M1："重新加载页面不应重置防护"——也就是说，攻击者无法靠刷新页面把失败计数刷掉。

四、密码解锁机制：Argon2id + AES-GCM-256

审计项 7：密码强度硬门槛 ✅

创建钱包时，密码必须满足"至少 10 位 + 大小写混合 + 数字 + 特殊字符"（要求见 onboarding.json），强度评级由 passwordStrength.ts 实时计算，弱密码根本无法提交。

审计项 8：密钥派生参数符合 OWASP ✅

密码本身不直接当密钥。kdf.ts 使用Argon2id从"密码 + 随机 16 字节盐"派生 32 字节密钥：

派生过程通过 Web Worker 运行 WASM 版 Argon2id（kdfWorker.ts），解锁时的算力开销不会卡死页面。

审计项 9：加密算法与内存卫生 ✅

派生出的密钥用AES-GCM-256加密助记词（见 vault.ts 的encryptSecret/decryptBlob）。两个细节值得表扬：

• 每次加解密结束后执行key.fill(0)，主动清零密钥，避免残留在 JS 堆里；
• 解密出的明文经地址一致性校验（address mismatch则判定档案损坏），防止"错误密码 + 巧合明文"的边界情况。

审计项 10：路由级 Vault 门禁 ✅

App.tsx 中的VaultGate组件是所有页面的守门人：钱包状态为locked时，任何功能路由（收款、转账、设置）都会被重定向到/unlock。即使攻击者手动改了 URL，也进不了任何涉及私钥的页面。

五、忘记密码的"逃生通道"：WIPE 重置

审计项 11：不可逆操作有双重确认 ✅

解锁页底部有"Forgot password? Reset wallet…"入口，点击后必须手动输入单词WIPE才能执行reset()（vaultMutations.ts）。该操作会彻底删除本地加密档案、自定义代币库、后端访问令牌，之后可以凭助记词重新导入——没有助记词，资金不可恢复。

审计项 12：查看助记词也有密码保护 ✅

SecuritySettings.tsx 中，"查看助记词"需要重新输入钱包密码，且展示的明文60 秒后自动隐藏并清空（注释标注security audit M3，防止敏感信息长期挂在组件 state 里）。

六、安全设置在哪里自己调？

全部安全配置都收敛在设置 → 安全页面（SecuritySettings.tsx）：

自动锁定时长与"切走即锁"开关则在设置 → 通用页的"安全"卡片中调整。

七、审计结论：这套机制好在哪

1. 默认即安全：15 分钟自动锁定、切走即锁、5 次失败冷却全部默认开启，新手不需要任何配置；
2. 防绕过：冷却状态持久化 + 路由级门禁，刷新页面和改 URL 都无法跳过保护；
3. 业界基线：Argon2id 参数直接对齐 OWASP 2024 最低标准，密码策略有硬性校验；
4. 密钥生命周期管理干净：解锁槽只在内存中存活，加解密后立即清零，敏感展示自动过期。

如果你正在评估一款 XRP & EVM 钱包的安全水位，这份基于源码的逐条清单可以作为对照模板——自动锁定、失败冷却、密码解锁三件套，缺一不可。✅

【免费下载链接】XRP-community-walletFully decentralized and the most secure XRP & EVM wallet - built by the community, for the community.项目地址: https://gitcode.com/gh_mirrors/xr/XRP-community-wallet