企业官网建设流程全解析

私钥安全存储原理：token-core-android 如何用 PBKDF2、SCrypt 与 AES 守护资产

【免费下载链接】token-core-androida blockchain private key management library on android项目地址: https://gitcode.com/gh_mirrors/to/token-core-android

对于区块链钱包来说，私钥就是资产本身。一旦私钥泄露，任何人都可以转走你的资金。token-core-android 正是一个面向 Android 的区块链私钥管理库，它用一套被称为"Keystore 加密存储"的机制来保护 BTC、ETH、EOS 等链上的私钥与助记词。这套机制的核心，就是PBKDF2、SCrypt 两种密钥派生算法（KDF）与AES 对称加密的组合：私钥从不以明文落盘，而是先加密成密文，再用口令校验 MAC 才能解密。本文将带你从零读懂这套私钥安全存储原理。

私钥安全存储的第一步：为什么私钥不能明文保存

很多人会把私钥记在备忘录、截图甚至聊天记录里，这是极其危险的。任何拿到私钥明文的人，都能直接控制对应地址的资产。因此，主流钱包的通行做法是：

• 私钥/助记词只以加密形式（ciphertext）写入本地文件；
• 加密密钥由用户口令通过 KDF 派生，口令不落盘、不传输；
• 每次使用前必须验证口令，验证通过才解密。

在 token-core-android 中，这套逻辑集中体现在 Crypto.java：它同时管理密钥派生、AES 加密、MAC 校验三个环节，是整个私钥安全存储的心脏。

PBKDF2 密钥派生流程：把弱口令变成高强度密钥

用户口令通常很短、熵值很低，直接用作加密密钥很容易被暴力破解。PBKDF2（基于口令的密钥派生函数）通过反复进行 HMAC-SHA256 运算，把口令与随机盐混合，拉伸成 256 位（32 字节）的高强度派生密钥。

token-core-android 的 PBKDF2Crypto.java 实现如下要点：

• 随机生成32 字节盐（salt），保证相同口令在不同钱包中派生出不同密钥；
• 默认迭代次数c = 10240，每次派生都需计算上万次 HMAC，显著提高暴力破解成本；
• 使用HMAC-SHA256作为伪随机函数（prf）；
• 派生结果dklen = 32，即 32 字节密钥。

这就是 Ethereum V3 Keystore 的标准格式：在 V3Keystore.java 中，创建钱包时通过Crypto.createPBKDF2Crypto(password, prvKeyBytes)直接把私钥字节加密进 keystore。

SCrypt 密钥派生：抗硬件暴力破解的进阶之选

SCrypt 是比 PBKDF2 更"费内存"的密钥派生算法。它要求攻击者同时占用大量内存进行计算，使得用 GPU/ASIC 集群并行暴力破解的成本大幅上升。因此，对安全性要求更高的场景常选用 SCrypt。

token-core-android 的 SCryptCrypto.java 通过N、r、p 三个参数控制计算成本：

• N：CPU/内存成本参数，控制内存占用量；
• r：块大小参数；
• p：并行度参数。

创建时同样生成随机盐，并调用Crypto.createSCryptCrypto(password, origin)走同一套加密管线。两种 KDF 由 JSON 中的kdf字段区分（pbkdf2或scrypt），反序列化时自动路由到对应实现。

AES 加密：私钥明文的最后一道防线

派生出的 32 字节密钥并非全部用于加密。在 Crypto.java 中：

• 取派生密钥的前 16 字节作为AES-128加密密钥；
• 随机生成16 字节 IV（初始化向量），保证同一私钥每次加密结果都不同；
• 默认使用AES-128-CTR 模式（NoPadding），明文与密文等长，无填充开销。

AES.java 封装了 CTR 与 CBC 两种模式、带填充与无填充共 6 种组合的加解密方法，doAES内部通过标准Cipher完成运算。加密后的私钥以十六进制字符串存入 keystore 的ciphertext字段。

MAC 校验：防止密文被篡改的保险丝

仅加密还不够——如果攻击者篡改密文，用户可能解密出错误的私钥。token-core-android 用MAC（消息认证码）解决这一问题，实现在 Hash.java：

1. 取派生密钥的后 16 字节与密文拼接；
2. 用Keccak-256哈希生成 MAC；
3. 解密前重新计算 MAC 并与 keystore 中存储的 MAC 比对，不一致则直接判定口令错误或文件被篡改。

这套"派生密钥分两半：前一半加密、后一半做认证"的设计，正是 Web3 存储规范的精髓。

完整加解密流程：一张图看懂私钥安全存储原理

整个私钥安全存储原理可以浓缩为两条流程：

加密（创建钱包）生成随机盐 + 随机 IV → 口令经 PBKDF2/SCrypt 派生 32 字节密钥 → 取前 16 字节用 AES-128-CTR 加密私钥 → 用后 16 字节 + 密文计算 MAC → 全部参数（cipher、iv、kdf、salt、c、mac、ciphertext）序列化为 JSON keystore 落盘。

解密（导出/签名）从 keystore 读取参数 → 口令重新派生密钥 → 重算 MAC 并比对验证口令 → 用前 16 字节 AES 解密出私钥明文。

助记词与 HD 钱包的加密扩展

除了单私钥，token-core-android 还支持 HD（分层确定性）钱包。在 HDMnemonicKeystore.java 中：

• 主私钥（xprv）同样经 PBKDF2 加密存入crypto；
• 助记词通过deriveEncPair用同一派生密钥再次加密，存入encMnemonic（含encStr密文与nonceIV）；
• 扩展公钥 xpub 则用固定密钥做 CBC 加密，仅用于收款地址生成，不涉私密。

这样，一个口令即可同时保护助记词、主私钥和所有派生子钱包，真正实现"一套助记词、三条链通用"。

总结：私钥安全存储的四个关键经验

1. 绝不存明文：私钥、助记词只以密文形式落盘；
2. 口令必须加盐拉伸：PBKDF2 与 SCrypt 让弱口令也具备抗暴力破解能力，SCrypt 更抗硬件并行攻击；
3. 加密与认证分离：AES-128-CTR 负责机密性，Keccak MAC 负责完整性，双保险防篡改；
4. 随机性要足：盐与 IV 均由安全随机数生成，同一私钥每次加密结果均不同。

无论你是钱包开发者还是普通用户，理解这套 token-core-android 的私钥安全存储原理，都能帮你更放心地管理数字资产。核心源码就藏在foundation/crypto与wallet/keystore两个目录下，值得每一个区块链开发者细细研读。

【免费下载链接】token-core-androida blockchain private key management library on android项目地址: https://gitcode.com/gh_mirrors/to/token-core-android