Web3j入门，如何使用Java开发以太坊钱包

2026-01-25 币界百科

在区块链和加密货币的世界里,拥有一个自己的以太坊钱包是进行资产管理和交互的基础，对于Java开发者而言，利用Web3j库可以便捷地与以太坊区块链进行交互，包括创建和管理以太坊钱包，本文将详细介绍如何使用Web3j来创建一个以太坊钱包，并探讨相关的基本概念和操作。

什么是Web3j？

Web3j是一个轻量级、高度模块化且响应式的Java库，用于与以太坊节点进行交互，它提供了以太坊JSON-RPC API的Java封装，使得Java开发者可以方便地集成以太坊功能到他们的应用程序中，例如创建钱包、发送交易、查询余额、智能合约交互等，Web3j不依赖任何完整的以太坊节点客户端（如Geth或Parity），它可以通过连接到远程节点（如Infura或Alchemy）或本地运行的节点来工作。

准备工作：环境搭建

在开始之前,请确保你已经准备好以下环境：

Java开发环境：安装JDK 8或更高版本，并配置好JAVA_HOME环境变量。
Maven或Gradle：用于项目依赖管理，本文以Maven为例。
IDE：如IntelliJ IDEA或Eclipse，用于编写和调试代码。
以太坊节点（可选）：你可以选择连接到远程公共节点（如Infura），或本地运行一个以太坊节点（如Geth），对于初学者，使用远程节点更为便捷。

创建Maven项目并添加Web3j依赖

创建一个Maven项目,在pom.xml文件中添加Web3j的依赖：

<dependencies>
    <!-- Web3j Core -->
    <dependency>
        <groupId>org.web3j</groupId>
        <artifactId>core</artifactId>
        <version>4.9.8</version> <!-- 请使用最新版本 -->
    </dependency>
    <!-- 其他可选依赖，如用于日志等 -->
</dependencies>

添加依赖后,Maven会自动下载所需的库文件。

使用Web3j创建以太坊钱包

创建以太坊钱包的核心是生成一个新的密钥对,然后从中导出钱包文件（通常是UTC/JSON格式）和获取地址。

Web3j提供了WalletUtils类来简化钱包的创建过程。

示例代码：创建新钱包

import org.web3j.crypto.WalletUtils;
import java.io.File;
import java.math.BigInteger;
import java.security.InvalidAlgorithmParameterException;
import java.security.NoSuchAlgorithmException;
import java.security.NoSuchProviderException;
public class EthereumWalletCreator {
    // 钱钥文件存储目录（请确保该目录存在或有权限创建）
    private static final String WALLET_DIR = "wallets";
    public static void main(String[] args) {
        try {
            // 1. 确保钱包目录存在
            File directory = new File(WALLET_DIR);
            if (!directory.exists()) {
                directory.mkdirs();
            }
            // 2. 创建新钱包
            // generateNewWalletFile方法会生成一个随机密码的钱包，并返回文件名
            // 也可以指定密码，WalletUtils.generateNewWalletFile("your-password", directory, true);
            String walletFileName = WalletUtils.generateFullNewWalletFile(
                    "your-secure-password", // 钱包密码，务必妥善保存！
                    directory
            );
            System.out.println("钱包创建成功！");
            System.out.println("钱包文件名: "   walletFileName);
            System.out.println("钱包文件路径: "   directory.getAbsolutePath()   File.separator   walletFileName);
            // 3. 加载钱包，获取钱包文件信息和地址
            File walletFile = new File(directory, walletFileName);
            String walletAddress = WalletUtils.loadCredentials(
                    "your-secure-password", // 输入密码
                    walletFile
            ).getAddress();
            System.out.println("钱包地址: "   walletAddress);
        } catch (NoSuchAlgorithmException | NoSuchProviderException | InvalidAlgorithmParameterException | IOException e) {
            System.err.println("创建钱包时发生错误: "   e.getMessage());
            e.printStackTrace();
        }
    }
}

代码解释：

WALLET_DIR：指定钱包文件存储的目录，你可以根据需要修改这个路径。
WalletUtils.generateFullNewWalletFile(password, directory)：
- 这是创建新钱包的主要方法。
- password：你为钱包设置的密码。非常重要！ 这个密码将用于加密钱包文件，丢失密码意味着无法访问钱包中的资产，请务必安全保存。
- directory：钱包文件存储的目录。
- 该方法会返回一个字符串,即生成钱包文件的文件名（例如UTC--2023-10-27T10-00-00.000000000Z--0x1234...abcd.json）。
- 钱包文件是以UTC/JSON格式存储的，包含了加密的私钥和相关信息。
WalletUtils.loadCredentials(password, walletFile)：
- 这个方法用于使用密码加载钱包文件,并返回一个Credentials对象。
- Credentials对象包含了钱包的地址和私钥（解密后），可以用于后续的交易签名等操作。
- .getAddress()：获取钱包的以太坊地址。

钱包文件的结构与安全

钱包文件：创建后得到的是一个JSON文件，它包含了加密的私钥、地址、版本信息等，这个文件就是你的钱包“本体”。
密码：钱包文件本身是加密的，没有密码无法打开，密码是控制钱包访问的关键。
私钥：私钥是控制钱包中资产的最高权限，一旦泄露，资产将面临被盗风险。切勿泄露私钥或密码！
备份：务必将钱包文件和密码（如果允许）进行多重备份，并存储在安全的地方，建议使用离线冷钱包存储大额资产。

使用创建的钱包进行简单操作（如查询余额）

创建钱包后,你可能需要查询钱包的以太坊余额，这需要连接到以太坊节点。

import org.web3j.protocol.Web3j;
import org.web3j.protocol.http.HttpService;
import org.web3j.utils.Convert;
import java.io.IOException;
import java.math.BigDecimal;
public class WalletBalanceChecker {
    // 替换为你的以太坊节点URL，例如Infura或Alchemy提供的URL
    private static final String INFURA_URL = "https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID";
    // 替换为你刚才创建的钱包地址
    private static final String WALLET_ADDRESS = "0xYourWalletAddressHere";
    public static void main(String[] args) {
        // 1. 连接到以太坊节点
        Web3j web3j = Web3j.build(new HttpService(INFURA_URL));
        try {
            // 2. 获取余额
            // getBalance方法返回的是以Wei为单位的余额
            BigInteger balanceWei = web3j.ethGetBalance(WALLET_ADDRESS, org.web3j.protocol.core.DefaultBlockParameterName.LATEST).send().getBalance();
            // 3. 将Wei转换为Ether
            BigDecimal balanceEth = Convert.fromWei(new BigDecimal(balanceWei), Convert.Unit.ETHER);
            System.out.println("钱包地址: "   WALLET_ADDRESS);
            System.out.println("余额: "   balanceEth.toPlainString()   " ETH");
        } catch (IOException e) {
            System.err.println("查询余额时发生错误: "   e.getMessage());
            e.printStackTrace();
        } finally {
            // 4. 关闭Web3j连接
            web3j.shutdown();
        }
    }
}

注意：你需要将INFURA_URL替换为你自己从Infura或Alchemy等服务提供商获取的实际节点URL，并替换WALLET_ADDRESS为你创建的钱包地址。