fuels-ts钱包体系深度解析助记词、HD推导路径与加密存储安全管好你的Fuel资产【免费下载链接】fuels-tsFuel Network Typescript SDK项目地址: https://gitcode.com/GitHub_Trending/fu/fuels-tsfuels-ts 是 Fuel Network 官方的 TypeScript SDK是开发者在 Fuel 链上创建钱包、签名交易、管理资产的“瑞士军刀”。这篇文章带你深入它的钱包体系——从一句话就能恢复所有资产的助记词Mnemonic到一条推导路径生成多个地址的HD 钱包再到用 scrypt AES 加密私钥的Keystore 加密存储帮你安全管好每一笔 Fuel 资产。一、fuels-ts 钱包体系一张图看懂核心组件fuels-ts 的钱包能力集中在 packages/account/ 包中。对新手来说记住下面这张“家族谱”就够了组件作用对应源码MnemonicBIP-39 助记词生成、校验、转种子mnemonic.tsHDWalletBIP-32/44 层级确定钱包按路径派生地址hdwallet.tsWallet钱包门面类一把钥匙开所有“锁”wallet.tsKeystore把私钥加密成 JSON 文件安全保存keystore-wallet.tsWalletManager管理多个账户的“保险库”整体加密wallet-manager.ts 简单理解助记词是“总钥匙”HD 路径决定“开哪把锁”Keystore 是给钥匙上的“密码锁”WalletManager 则是装所有钥匙的“保险箱”。二、助记词24个单词恢复你全部Fuel资产1. 什么是助记词为什么选 BIP-39fuels-ts 的助记词实现遵循BIP-39行业标准见 mnemonic.ts使用内置的2048 个英文单词词表english.ts支持12、15、18、21、24 个单词五种规格MNEMONIC_SIZESmnemonic.ts#L20默认用 256 位熵生成24 词短语Mnemonic.generate()内部调用加密安全的随机数还可传入extraEntropy增加随机性mnemonic.ts#L243-L248。2. 助记词 → 种子PBKDF2 加一道锁助记词本身不是私钥它要经过PBKDF2sha5122048 次迭代变成 64 字节的种子mnemonicToSeedL117-L124你可以加一个**密码短语passphrase**作为第二重防护——忘了它从该助记词派生的所有钱包都会“失联”所以务必记牢Mnemonic.isMnemonicValid()可以校验助记词合法性避免打错一个词导致地址对不上。新手必知助记词 私钥 资产。离线手写保存绝不截图、绝不上传网盘。三、HD推导路径一条助记词派生一整排钱包1. 什么是 HD 推导路径fuels-ts 的 HDWallet 实现了BIP-32 / BIP-44Multi-Account Hierarchy for Deterministic Wallets从一个种子出发像“树枝”一样按路径逐层派生出无限个互不相关的钱包。Fuel 的默认推导路径定义在 base-wallet-unlocked.ts#L28m/44/1179993420/0/0/044BIP-44 标准1179993420Fuel 的链注册 ID保证 Fuel 钱包和以太坊等钱包路径不冲突后面的0/0/0依次是账户、change、索引。带的叫硬派生hierarchical hardened见 parsePathL41-L55必须有私钥才能向下派生更安全。2. 实战一行代码从助记词创建钱包Wallet.fromMnemonicwallets.ts#L89-L100 把整条链路封装成一步助记词 → 种子 → 主钱包 → 按路径派生 → 返回可用的WalletUnlocked。不传路径就自动用上面的默认路径换成m/44/1179993420/0/0/1就得到“第二个钱包”。Wallet还提供了一整套工厂方法wallet.ts#L11-L81对应不同钥匙形态方法输入典型场景fromMnemonic助记词 路径从恢复短语开钱包fromSeed原始种子已有 BIP-39 种子fromExtendedKey扩展公/私钥跨钱包导入Base58Check 编码toExtendedKeyfromPrivateKey私钥直接解锁generate无随机生成新钱包fromEncryptedJsonKeystore 密码从加密文件恢复确定性是 HD 的核心福利同一个助记词 同一条路径在任何设备上派生的地址都完全一致——这就是“钱包恢复”的原理。四、加密存储把私钥锁进 Keystore JSON1. 为什么不能明文存私钥明文私钥一旦泄露资产瞬间归零。fuels-ts 的 Keystore 实现keystore-wallet.ts 采用与以太坊兼容的V3 格式并且参数与 Fuel Rust SDK 完全对齐默认参数L41-L45保证跨语言互通。加密链路是三步scrypt 密钥派生用你的密码 随机 saltn8192、r8、p1派生出 32 字节密钥——scrypt 是内存硬函数专为抵抗暴力破解设计AES-128-CTR 加密随机 IV 下加密私钥产出密文Keccak-256 MAC 校验用密钥后半段 密文算 MAC密码错误时解密会立刻报错而不是解出一堆乱码decryptKeystoreWalletL115-L163。最终得到一段 JSON包含id、version、address、ciphertext、mac、kdfparams……里面没有任何可用私钥你可以放心备份到任何地方——前提是你没忘密码。2. 加密与解密各只要一行加密拿到解锁钱包后调用wallet.encrypt(密码)base-wallet-unlocked.ts#L162-L164解密Wallet.fromEncryptedJson(json, 密码)直接恢复可用钱包。五、WalletManager多账户“保险箱”实战当你管理的不止一个钱包比如一个助记词派生 10 个账户 几个独立私钥钱包WalletManager 就是为这种场景设计的保险库Vault机制内置 MnemonicVault 和 PrivateKeyVault。助记词库用m/44/1179993420/{}/0/0模板路径批量派生账户addAccount()一下就能按序长出下一个地址mnemonic-vault.ts#L20-L36整体加密所有 Vault 的状态序列化成 JSON 后用你设置的passphrase 整体加密再落存储默认MemoryStorage可换成 localStorage 等自定义存储loadState/saveStateL246-L267锁/解锁生命周期unlock(密码)加载全部账户lock()会立刻清空内存中的密码和密钥并触发lock事件L191-L222密码可更换updatePassphrase(旧密码, 新密码)原地重新加密不暴露任何明文。️ 安全设计点睛导出私钥exportPrivateKey必须处于解锁状态——锁着就绝对拿不到明文。六、安全管好 Fuel 资产5 条最佳实践助记词离线保存手写或刻金属片一份备份 异地一份永远不要进云端善用 passphrase给助记词加密码短语即使短语泄露攻击者没有 passphrase 也推导出你的地址备份用 Keystore 而不是裸私钥wallet.encrypt()生成的 JSON 可以放心异地备份密码另记用完即锁DApp 里用lock()/WalletManager.lock()清掉内存密钥降低被内存dump的风险路径别乱改换推导路径 ≠ 换新钱包地址资金会“去别处”。跨应用导入前先确认对方默认路径是否也是m/44/1179993420/0/0/0。结语fuels-ts 的钱包体系 BIP-39 助记词可记忆的根密钥BIP-32/44 HD 推导一条路径派生多地址scrypt/AES Keystore私钥加密落盘WalletManager多账户整体加密保管。理解了这四层你就同时拿下了“怎么创建、怎么恢复、怎么备份、怎么防护”四个核心问题——安全管好你的 Fuel 资产从今天开始。【免费下载链接】fuels-tsFuel Network Typescript SDK项目地址: https://gitcode.com/GitHub_Trending/fu/fuels-ts创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考