从零开始,Web3钱包开发全指南

本文将主要聚焦于非托管的用户自控钱包 (Self-Custodial Wallet) 的开发。

开发前必备的基础知识与技术栈

开发Web3钱包并非易事,需要你具备以下基础知识和技能：

1. 区块链基础知识：

   • 公钥密码学：理解非对称加密、椭圆曲线算法（如secp256k1）、哈希函数（如SHA-256）。
   • 区块链原理：了解区块、交易、网络共识、地址生成等基本概念。
   • 智能合约：熟悉Solidity语言（如果需要与智能合约交互）。

2. 核心技术栈：

   • 编程语言：
     • 前端：JavaScript/TypeScript (主流)，配合React/Vue/Angular等框架。
     • 后端：Node.js (JavaScript/TypeScript), Go, Python, Rust等（取决于钱包架构，纯前端钱包可省略后端）。
     • 移动端：React Native, Flutter, Swift (iOS), Kotlin (Android)。
   • Web3库：
     • ethers.js：功能强大，易于使用，支持以太坊及EVM兼容链。
     • web3.js：老牌库，功能全面，但相对复杂。
     • Web3Auth：提供简化钱包创建、社交登录等解决方案，适合快速开发。
   • 钱包标准：
     • BIP39 / BIP32 / BIP44：助记词和分层确定性钱包（HD Wallet）标准，允许从单个种子生成多个地址，是现代钱包的基础。
     • EIP-712：用于结构化数据签名，提升交易签名的可读性和安全性。
     • CAIP-10：跨链账户标识符标准，方便管理多链资产。
   • 加密库：
     • crypto-js (JavaScript)
     • libsodium (多语言支持)
     • ethers 内置的加密功能。

3. 开发工具：

   • 代码编辑器 (VS Code)
   • 版本控制 (Git)
   • 浏览器开发者工具
   • 区块链浏览器 (Etherscan, Polygonscan等)
   • 测试网络节点 (如Infura, Alchemy, 或本地Ganache)

Web3钱包开发的核心步骤

开发一个功能完善的Web3钱包通常包括以下几个核心步骤：

钱包创建与密钥管理

这是钱包最核心的部分。

1. 生成助记词 (Mnemonic Phrase)：

   • 遵循BIP39标准,通常生成12或24个单词的助记词。
   • 助记词是用户钱包的“根”，必须安全存储，建议离线记录。
   • 可以使用bip39库来生成助记词。

2. 从助记词生成种子 (Seed)：

   使用PBKDF2算法配合盐值（通常为"mnemonic" + 密钥拉伸迭代次数）将助记词转换为固定长度的二进制种子。

3. 生成主私钥 (Master Private Key) 和主公钥 (Master Public Key)：

   使用BIP32标准,从种子生成主私钥和主公钥，主私钥可以派生出无限的子私钥。

4. 派生路径 (Derivation Path)：

   • 遵循BIP44标准,通过特定的派生路径（如m/44'/coin_type'/account'/change/address_index）从主私钥派生具体的私钥和公钥。
   • coin_type：代表不同的区块链（如60代表以太坊，1代表比特币）。
   • account：账户索引，通常为0。
   • change：0代表外部链（接收地址），1代表内部链（找零地址）。
   • address_index：地址索引，用于生成多个地址。

5. 生成地址：

   从派生出的公钥,通过Keccak-256哈希算法（以太坊）等生成最终的区块链地址。

用户界面 (UI/UX) 设计

钱包的UI/UX至关重要，直接影响用户体验。

1. 创建/导入钱包：

   • 新钱包：显示生成的助记词，并强制用户确认已安全备份（通常通过输入助记词的特定单词）。
   • 导入钱包：提供输入助记词或私钥的功能。

2. 资产概览：

   • 显示各条链上的资产余额（ETH, ERC-20代币等）。
   • 实时更新价格和总价值。

3. 交易历史：

   展示发送、接收交易记录。

4. 发送/接收功能：

   • 发送：输入接收地址、金额、选择代币、设置Gas费（Gas Price, Gas Limit）、预览交易、签名广播。
   • 接收：显示当前地址、二维码，方便他人扫描。

5. 设置：

   • 网络切换（主网/测试网）。
   • 安全设置（修改密码、显示私钥/助记词 - 需谨慎）。
   • 主题切换等。

与区块链节点交互

钱包需要与区块链网络通信,以查询余额、广播交易等。

1. 连接节点：

   • 可以使用第三方节点服务商（如Infura, Alchemy）或自建节点。
   • ethers.js等库提供了方便的连接方式。

2. 查询余额：

   • 通过地址调用区块链节点或智能合约（如ERC-20代币的balanceOf方法）获取余额。

3. 构建交易：

   根据用户输入（接收地址、金额、Gas参数）构建原始交易（Raw Transaction）。

4. 签名交易：

   • 使用用户钱包的私钥对交易进行签名,这是钱包的核心安全操作，必须确保私钥不被泄露。
   • ethers.js的Wallet或Signer提供了签名功能。

5. 广播交易：

   将签名后的交易发送到区块链节点,由网络进行广播和打包。

安全性与最佳实践

Web3钱包的安全是重中之重,任何疏忽都可能导致用户资产损失。

1. 私钥安全：

   • 绝对禁止将私钥或助记词明文存储在服务器或云端（非托管钱包原则）。
   • 优先使用浏览器提供的SubtleCrypto API或专门的加密库进行安全存储。
   • 考虑使用硬件安全模块 (HSM) 或操作系统级别的密钥库（如iOS Keychain, Android Keystore）。

2. 防范常见攻击：

   • 钓鱼攻击：通过明确的UI设计和用户教育，帮助用户识别钓鱼网站。
   • 恶意软件：提醒用户从官方渠道下载钱包，保持系统安全。
   • 重放攻击：在跨链交易时注意添加nonce或chainId等防重放机制。
   • 社会工程学：对助记词、私钥等重要信息进行二次确认和风险提示。

3. 代码审计：

   在钱包正式上线前,务必进行专业的