深度解析 token-core-android 的 Keystore 体系V3、HD、EOS 版本号背后的设计【免费下载链接】token-core-androida blockchain private key management library on android项目地址: https://gitcode.com/gh_mirrors/to/token-core-androidtoken-core-android 是一款面向 Android 平台的区块链私钥管理库它为 ETH、BTC、EOS 等主流公链提供了统一的私钥生成、加密存储与签名能力。在这套体系的底层每一个钱包都对应一份 JSON 格式的 Keystore 文件而决定这份文件是什么类型、怎么解析、如何恢复的关键正是那个不起眼的version字段。本文将带你从零看懂 V3、44、10000、10001 这些版本号背后的设计智慧掌握区块链钱包私钥管理的基础原理。为什么 Keystore 是区块链钱包的保险箱 在区块链世界里私钥就是资产本身。无论 ETH 地址、BTC 地址还是 EOS 账户谁能持有对应私钥谁就能支配链上资产。因此钱包应用的核心任务只有一个把私钥安全地存起来又能在需要签名时凭密码取出来。token-core-android 的做法是把私钥或助记词、派生密钥用用户密码加密后连同算法参数一起序列化到本地文件这个文件就是 Keystore。它不能明文暴露私钥必须支持密码错误就解不开、密码正确就能还原的完整流程。所有 Keystore 都继承自抽象基类Keystore核心字段只有三个id钱包唯一标识、version格式版本、crypto加密数据体。你在app/src/main/java/org/consenlabs/tokencore/wallet/keystore/Keystore.java中就能看到这个最精简的骨架。一图看懂版本号家族全家福 先给出全景表再逐一拆解version 值对应 Keystore 类适用链设计含义1V3Keystore兼容解析BTC / ETH早期旧格式兼容性兜底3V3Keystore / V3MnemonicKeystore / LegacyEOSKeystoreBTC / ETH / EOS对齐以太坊 V3 标准44HDMnemonicKeystoreBTC 等呼应 BIP44 分层推导路径10000IdentityKeystore多链身份钱包自动备份体系10001EOSKeystoreEOS严格等于 Identity 版本 1这些类全部集中在app/src/main/java/org/consenlabs/tokencore/wallet/keystore/目录下命名清晰非常适合对照源码学习。版本号 3单私钥钱包的标准答案 V3Keystore的VERSION 3这个数字并非随意取的它对齐的是以太坊社区广泛使用的Web3 Secret Storage 规范V3 格式。在该规范下Keystore 通过kdf密钥派生函数从密码生成密钥再用 AES 算法加密私钥并附带mac做完整性校验。在V3Keystore.java中你可以看到两条核心逻辑BTC 链私钥以 WIF 格式校验后直接加密地址由BitcoinAddressCreator或SegWitBitcoinAddressCreator生成ETH 链私钥先做 hex 转字节通过PrivateKeyValidator校验再交由EthereumAddressCreator计算地址。它默认使用Crypto.createPBKDF2Crypto()也就是 PBKDF2 派生密钥加密算法是aes-128-ctr。同一个 3三种钱包如何区分有趣的是版本号同为 3 的其实有三个类V3Keystore、V3MnemonicKeystore私钥换成助记词多了encMnemonic字段和已废弃的LegacyEOSKeystore。那系统怎么知道该用哪个类反序列化答案在WalletManager.scanWallets()里——它先读version如果是 3再做字段探测JSON 里包含encMnemonic→ 反序列化为V3MnemonicKeystoreimTokenMeta.chainType是 EOS → 反序列化为LegacyEOSKeystore否则 →V3Keystore。这说明版本号负责大的分类而细粒度类型要靠特征字段 链类型二次判定这种设计保证了格式的向后兼容。版本号 44HD 分层确定性钱包 HDMnemonicKeystore的VERSION 44一眼就能联想到BIP44——比特币社区定义的 HDHierarchical Deterministic钱包路径规范。HD 钱包的核心魅力是只需一份助记词就能通过路径推导出无数子密钥比如m/44/0/0/0/0表示第一条收款地址。阅读HDMnemonicKeystore.java你会发现它的几个关键点用DeterministicSeedDeterministicKeyChain从助记词构建密钥树按 BIP44 路径取出父密钥序列化出xpub扩展公钥存入 Keystore私钥与助记词分别加密crypto加密 xprvencMnemonicEncPair 结构加密助记词明文通过newReceiveAddress(nextIdx)可以只凭 xpub 离线生成新地址无需触碰私钥这是 HD 钱包的核心安全优势。版本号 44 在这里既是格式标识也是一种语义注释见到 44就知道这份 Keystore 与 BIP44 绑定。版本号 10000 与 10001身份体系与 EOS 的专属区 当版本号跳到五位数说明进入了 imToken 家族的自有扩展区。IdentityKeystoreversion 10000是身份钱包一份助记词派生备份密钥、认证密钥与加密密钥产生一个以im开头的 Base58 标识符identifier用于多链资产统一管理。它的注释很有意思——EOSKeystore里写着the version IdentityVersion 1也就是说10001 严格跟随 10000 演进体现了一种版本号派生的设计思路。EOSKeystoreversion 10001是 EOS 链的专属钱包它的复杂度远超 V3一份 Keystore 可容纳多把私钥mKeyPathPrivates列表对应 EOS 的 owner / active 多权限模型每把私钥用KeyPathPrivate记录含encPrivate加密私钥、publicKey、derivedModeIMPORTED/PATH_DIRECTLY/HD_SHA256支持从助记词按路径批量派生密钥也支持直接导入 WIF 私钥setAccountName()会校验 EOS 账户名格式1-12 位[1-5a-z.]且账户名只能绑定一次。正是这些差异让 EOS 需要独立版本号避免与 V3 单私钥格式混淆。版本号背后的三大设计哲学 1. 兼容性优先。version 1的老文件仍会被解析成V3Keystore老用户升级 App 后资产不受影响LegacyEOSKeystore虽已标记Deprecated但只要 JSON 里 chainType 是 EOS旧文件依旧能读出来。2. 版本号 字段探测双保险。版本号负责粗粒度分类特征字段负责细粒度识别两者配合让格式演进更灵活。3. 数字即文档。3 呼应以太坊 V3 标准44 呼应 BIP4410001 等于 100001——每个数字背后都有一段可追溯的设计脉络这比随意的枚举值更易维护。加密内核version 之外的安全支柱 版本号决定了怎么存而安全真正依赖的是Crypto类。在app/src/main/java/org/consenlabs/tokencore/foundation/crypto/Crypto.java中可以看到完整机制KDF 可选pbkdf2或scrypt通过 JSON 的kdf字段自动反序列化JsonSubTypes注解对称加密默认aes-128-ctr也支持aes-128-cbcMAC 校验派生密钥 密文生成mac密码错误时校验失败直接拒绝解密EncPair 结构encStr nonce的配对专用于加密助记词、EOS 私钥等多段敏感数据派生密钥缓存CachedDerivedKey让同一密码多次解密不用重复跑 KDF性能与安全兼得。此外Crypto.createPBKDF2CryptoWithKDFCached()这类带缓存的方法是 HD 与 EOS 钱包的标配——因为它们一次要加密多份数据助记词 多把私钥。总结读懂版本号就读懂了钱包的进化史 从 version1 的原始格式到 version3 对齐以太坊标准再到 44 拥抱 BIP44、10000/10001 承载身份与 EOS 多权限体系——token-core-android 的版本号设计本质上是一部区块链私钥管理库的演进史。对开发者来说理解这些版本号意味着拿到任意 Keystore JSON一眼判断类型与解析方式修改或新增钱包格式时知道该选哪个版本区间排查钱包导入失败时能快速定位是格式问题还是密码问题。如果你正在开发钱包类 App或者想深入理解区块链私钥管理原理不妨直接阅读wallet/keystore/目录下的源码配合本文的版本号地图很快就能建立完整的知识体系。【免费下载链接】token-core-androida blockchain private key management library on android项目地址: https://gitcode.com/gh_mirrors/to/token-core-android创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 深度解析 token-core-android 的 Keystore 体系：V3、HD、EOS 版本号背后的设计
深度解析 token-core-android 的 Keystore 体系V3、HD、EOS 版本号背后的设计【免费下载链接】token-core-androida blockchain private key management library on android项目地址: https://gitcode.com/gh_mirrors/to/token-core-androidtoken-core-android 是一款面向 Android 平台的区块链私钥管理库它为 ETH、BTC、EOS 等主流公链提供了统一的私钥生成、加密存储与签名能力。在这套体系的底层每一个钱包都对应一份 JSON 格式的 Keystore 文件而决定这份文件是什么类型、怎么解析、如何恢复的关键正是那个不起眼的version字段。本文将带你从零看懂 V3、44、10000、10001 这些版本号背后的设计智慧掌握区块链钱包私钥管理的基础原理。为什么 Keystore 是区块链钱包的保险箱 在区块链世界里私钥就是资产本身。无论 ETH 地址、BTC 地址还是 EOS 账户谁能持有对应私钥谁就能支配链上资产。因此钱包应用的核心任务只有一个把私钥安全地存起来又能在需要签名时凭密码取出来。token-core-android 的做法是把私钥或助记词、派生密钥用用户密码加密后连同算法参数一起序列化到本地文件这个文件就是 Keystore。它不能明文暴露私钥必须支持密码错误就解不开、密码正确就能还原的完整流程。所有 Keystore 都继承自抽象基类Keystore核心字段只有三个id钱包唯一标识、version格式版本、crypto加密数据体。你在app/src/main/java/org/consenlabs/tokencore/wallet/keystore/Keystore.java中就能看到这个最精简的骨架。一图看懂版本号家族全家福 先给出全景表再逐一拆解version 值对应 Keystore 类适用链设计含义1V3Keystore兼容解析BTC / ETH早期旧格式兼容性兜底3V3Keystore / V3MnemonicKeystore / LegacyEOSKeystoreBTC / ETH / EOS对齐以太坊 V3 标准44HDMnemonicKeystoreBTC 等呼应 BIP44 分层推导路径10000IdentityKeystore多链身份钱包自动备份体系10001EOSKeystoreEOS严格等于 Identity 版本 1这些类全部集中在app/src/main/java/org/consenlabs/tokencore/wallet/keystore/目录下命名清晰非常适合对照源码学习。版本号 3单私钥钱包的标准答案 V3Keystore的VERSION 3这个数字并非随意取的它对齐的是以太坊社区广泛使用的Web3 Secret Storage 规范V3 格式。在该规范下Keystore 通过kdf密钥派生函数从密码生成密钥再用 AES 算法加密私钥并附带mac做完整性校验。在V3Keystore.java中你可以看到两条核心逻辑BTC 链私钥以 WIF 格式校验后直接加密地址由BitcoinAddressCreator或SegWitBitcoinAddressCreator生成ETH 链私钥先做 hex 转字节通过PrivateKeyValidator校验再交由EthereumAddressCreator计算地址。它默认使用Crypto.createPBKDF2Crypto()也就是 PBKDF2 派生密钥加密算法是aes-128-ctr。同一个 3三种钱包如何区分有趣的是版本号同为 3 的其实有三个类V3Keystore、V3MnemonicKeystore私钥换成助记词多了encMnemonic字段和已废弃的LegacyEOSKeystore。那系统怎么知道该用哪个类反序列化答案在WalletManager.scanWallets()里——它先读version如果是 3再做字段探测JSON 里包含encMnemonic→ 反序列化为V3MnemonicKeystoreimTokenMeta.chainType是 EOS → 反序列化为LegacyEOSKeystore否则 →V3Keystore。这说明版本号负责大的分类而细粒度类型要靠特征字段 链类型二次判定这种设计保证了格式的向后兼容。版本号 44HD 分层确定性钱包 HDMnemonicKeystore的VERSION 44一眼就能联想到BIP44——比特币社区定义的 HDHierarchical Deterministic钱包路径规范。HD 钱包的核心魅力是只需一份助记词就能通过路径推导出无数子密钥比如m/44/0/0/0/0表示第一条收款地址。阅读HDMnemonicKeystore.java你会发现它的几个关键点用DeterministicSeedDeterministicKeyChain从助记词构建密钥树按 BIP44 路径取出父密钥序列化出xpub扩展公钥存入 Keystore私钥与助记词分别加密crypto加密 xprvencMnemonicEncPair 结构加密助记词明文通过newReceiveAddress(nextIdx)可以只凭 xpub 离线生成新地址无需触碰私钥这是 HD 钱包的核心安全优势。版本号 44 在这里既是格式标识也是一种语义注释见到 44就知道这份 Keystore 与 BIP44 绑定。版本号 10000 与 10001身份体系与 EOS 的专属区 当版本号跳到五位数说明进入了 imToken 家族的自有扩展区。IdentityKeystoreversion 10000是身份钱包一份助记词派生备份密钥、认证密钥与加密密钥产生一个以im开头的 Base58 标识符identifier用于多链资产统一管理。它的注释很有意思——EOSKeystore里写着the version IdentityVersion 1也就是说10001 严格跟随 10000 演进体现了一种版本号派生的设计思路。EOSKeystoreversion 10001是 EOS 链的专属钱包它的复杂度远超 V3一份 Keystore 可容纳多把私钥mKeyPathPrivates列表对应 EOS 的 owner / active 多权限模型每把私钥用KeyPathPrivate记录含encPrivate加密私钥、publicKey、derivedModeIMPORTED/PATH_DIRECTLY/HD_SHA256支持从助记词按路径批量派生密钥也支持直接导入 WIF 私钥setAccountName()会校验 EOS 账户名格式1-12 位[1-5a-z.]且账户名只能绑定一次。正是这些差异让 EOS 需要独立版本号避免与 V3 单私钥格式混淆。版本号背后的三大设计哲学 1. 兼容性优先。version 1的老文件仍会被解析成V3Keystore老用户升级 App 后资产不受影响LegacyEOSKeystore虽已标记Deprecated但只要 JSON 里 chainType 是 EOS旧文件依旧能读出来。2. 版本号 字段探测双保险。版本号负责粗粒度分类特征字段负责细粒度识别两者配合让格式演进更灵活。3. 数字即文档。3 呼应以太坊 V3 标准44 呼应 BIP4410001 等于 100001——每个数字背后都有一段可追溯的设计脉络这比随意的枚举值更易维护。加密内核version 之外的安全支柱 版本号决定了怎么存而安全真正依赖的是Crypto类。在app/src/main/java/org/consenlabs/tokencore/foundation/crypto/Crypto.java中可以看到完整机制KDF 可选pbkdf2或scrypt通过 JSON 的kdf字段自动反序列化JsonSubTypes注解对称加密默认aes-128-ctr也支持aes-128-cbcMAC 校验派生密钥 密文生成mac密码错误时校验失败直接拒绝解密EncPair 结构encStr nonce的配对专用于加密助记词、EOS 私钥等多段敏感数据派生密钥缓存CachedDerivedKey让同一密码多次解密不用重复跑 KDF性能与安全兼得。此外Crypto.createPBKDF2CryptoWithKDFCached()这类带缓存的方法是 HD 与 EOS 钱包的标配——因为它们一次要加密多份数据助记词 多把私钥。总结读懂版本号就读懂了钱包的进化史 从 version1 的原始格式到 version3 对齐以太坊标准再到 44 拥抱 BIP44、10000/10001 承载身份与 EOS 多权限体系——token-core-android 的版本号设计本质上是一部区块链私钥管理库的演进史。对开发者来说理解这些版本号意味着拿到任意 Keystore JSON一眼判断类型与解析方式修改或新增钱包格式时知道该选哪个版本区间排查钱包导入失败时能快速定位是格式问题还是密码问题。如果你正在开发钱包类 App或者想深入理解区块链私钥管理原理不妨直接阅读wallet/keystore/目录下的源码配合本文的版本号地图很快就能建立完整的知识体系。【免费下载链接】token-core-androida blockchain private key management library on android项目地址: https://gitcode.com/gh_mirrors/to/token-core-android创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考