创建以太坊钱包代码,从零开始掌握钱包开发核心技能

admin 发布于 2026-02-16 20:42 频道：默认分类阅读：1

在区块链世界中,以太坊钱包是用户与以太坊网络交互的核心工具，它不仅存储私钥、管理资产，还能通过签名交易参与智能合约调用、代币转账等操作，对于开发者而言，理解钱包背后的代码逻辑是进入以太坊开发的必修课，本文将详细介绍如何通过代码创建一个以太坊钱包，涵盖核心原理、实现步骤及安全注意事项，助你从零掌握钱包开发的核心技能。

以太坊钱包的核心原理

在动手写代码前,我们需要先明确以太坊钱包的核心构成，以太坊钱包本质上是一个密钥对管理系统，包含两个关键要素：

私钥（Private Key）：一个由32个随机字节组成的数字，相当于钱包的“密码”，拥有私钥即拥有钱包内资产的控制权，私钥必须严格保密，一旦泄露，资产将面临被盗风险。
公钥（Public Key）：由私钥通过椭圆曲线算法（SECP256K1）生成，64个字节，用于接收资产，但不会暴露私钥。
地址（Address）：由公钥通过哈希算法（Keccak-256）进一步计算得到，40个字符（以0x开头），相当于钱包的“账号”，可公开分享给他人转账。

钱包创建的过程,本质上就是生成随机私钥，并从私钥推导出公钥和地址的过程，我们将通过代码实现这一流程。

开发环境准备

在编写代码前,需确保安装以下工具：

Node.js：建议版本≥16（本文以Node.js 18为例），用于运行JavaScript代码。
以太坊开发库：我们选择ethers.js——一个轻量级且功能强大的以太坊交互库，它封装了钱包、签名、Provider等核心功能，适合快速开发。

安装ethers.js：

npm install ethers

创建以太坊钱包的完整代码实现

步骤1：生成随机私钥

私钥的核心是“随机性”，在ethers.js中，可通过crypto.randomBytes生成安全的随机私钥，或直接使用ethers.Wallet.createRandom()方法快速生成钱包（该方法内部已处理随机逻辑）。

示例代码：生成随机私钥

const ethers = require('ethers');
// 方法1：直接生成随机钱包（推荐）
const randomWallet = ethers.Wallet.createRandom();
console.log('随机生成的私钥:', randomWallet.privateKey);
console.log('对应的公钥:', randomWallet.publicKey);
console.log('对应的地址:', randomWallet.address);
// 方法2：手动生成私钥（需确保随机性足够）
const crypto = require('crypto');
const privateKeyBytes = crypto.randomBytes(32);
const privateKey = '0x' + privateKeyBytes.toString('hex');
console.log('手动生成的私钥:', privateKey);

输出示例：

随机生成的私钥: 0x4f3edf983ac636a65a842ce7c78d9aa706d3b113bce9c46f30d7d21715b23b1d
对应的公钥: 0x04b9eac5193366a2858290c9b3db3136c89e89a9b4a9bc8a7a2745995c8bde2b1e6e6d8a4e5a2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4
对应的地址: 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B

注意：私钥必须以0x开头，且长度为64个字符（32字节），手动生成时，务必使用密码学安全的随机数生成器（如Node.js的crypto.randomBytes），避免使用Math.random()等不安全的随机方法。

步骤2：从私钥导入钱包

生成钱包后,可能需要通过私钥重新加载钱包（例如从备份中恢复）。ethers.js提供了Wallet.fromPrivateKey()方法实现这一功能。

示例代码：从私钥导入钱包

const privateKey = '0x4f3edf983ac636a65a842ce7c78d9aa706d3b113bce9c46f30d7d21715b23b1d'; // 假设这是已存在的私钥
const walletFromPrivateKey = new ethers.Wallet(privateKey);
console.log('从私钥导入的地址:', walletFromPrivateKey.address);
console.log('钱包的签名器（Signer）:', walletFromPrivateKey.signer);

说明：ethers.Wallet类同时实现了Signer接口，支持签名交易、连接网络等操作，是后续交互的基础。

步骤3：连接以太坊网络

钱包需要与以太坊网络交互（如查询余额、发送交易），此时需要连接到节点（Node），节点可以是：

公共节点：如Infura、Alchemy（免费，适合开发测试）。
本地节点：如Geth（以太坊官方客户端）、Hardhat（开发框架）。

示例代码：连接到Infura公共节点

re class="brush:javascript;toolbar:false">// 替换为你的Infura项目ID const infuraUrl = 'https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID'; // 创建Provider（用于读取链上数据） const provider = new ethers.providers.JsonRpcProvider(infuraUrl); // 将钱包与Provider关联 const connectedWallet = walletFromPrivateKey.connect(provider); // 查询钱包的ETH余额 async function getBalance() { const balance = await connectedWallet.getBalance(); console.log('钱包余额(ETH):', ethers.utils.formatEther(balance)); } getBalance();

输出示例：

钱包余额(ETH): 1.23456789

说明：ethers.utils.formatEther()用于将 wei（以太坊最小单位）转换为ETH（1 ETH = 10^18 wei）。

步骤4：发送交易（核心功能）

钱包的核心价值在于“控制资产”，而发送交易是实现这一功能的关键，以转账ETH为例，需要以下步骤：

获取接收方地址。
设置转账金额（单位：wei）。
构建交易对象（包含to、value、gasLimit等字段）。
使用钱包签名交易。
发送交易到网络。

示例代码：发送ETH交易

const recipientAddress = '0x1234567890123456789012345678901234567890'; // 接收方地址
const amountToSend = ethers.utils.parseEther('0.1'); // 0.1 ETH（转换为wei）
// 构建交易对象
const transaction = {
    to: recipientAddress,
    value: amountToSend,
    gasLimit: 21000, // 转账ETH的固定gas消耗
    maxPriorityFeePerGas: ethers.utils.parseUnits('1', 'gwei'), // 优先费用（用于矿工）
    maxFeePerGas: ethers.utils.parseUnits('2', 'gwei'), // 最大总费用（包含基础费用）
};
// 签名并发送交易
async function sendTransaction() {
    console.log('准备发送交易...');
    const txResponse = await connectedWallet.sendTransaction(transaction);
    console.log('交易哈希:', txResponse.hash);
    // 等待交易被打包
    const txReceipt = await txResponse.wait();
    console.log('交易确认成功，区块号:', txReceipt.blockNumber);
}
sendTransaction();

关键参数说明：

gasLimit：交易允许消耗的gas上限，ETH转账固定为21000。
maxPriorityFeePerGas：优先费用（Priority Fee），用于激励矿工打包交易（EIP-1559后引入）。
maxFeePerGas：最大总费用，包含基础费用（Base Fee）和优先费用，避免网络拥堵时费用失控。

步骤5：管理钱包（备份、加密、恢复）

钱包的安全性至关重要,因此需要实现备份、加密、恢复功能。

示例代码：钱包加密与解密

// 1. 加密钱包（使用密码生成JSON格式的钱包文件）
const password = 'mySecretPassword';
const encryptedJson = await randomWallet.encrypt(password);
console.log('加密后的钱包JSON:', encryptedJson);
// 2. 从加密JSON恢复钱包
const decryptedWallet = await ethers.Wallet.fromEncryptedJson(encryptedJson, password);
console.log('