以太坊C客户端eth命令使用指南，从基础到实践

xwhb 2026-10-15

在以太坊生态中,客户端是与区块链网络交互的核心工具，虽然Go语言实现的geth是目前最主流的以太坊客户端，但基于C语言开发的客户端（如cpp-ethereum，又称“以太坊C++客户端”）因其轻量级、高性能和对资源受限环境的友好性，仍被广泛应用于特定场景，本文将以cpp-ethereum为例，详细介绍其eth命令的使用方法，帮助开发者快速掌握通过C客户端与以太坊网络交互的核心技能。

以太坊C客户端概述

cpp-ethereum是以太坊官方参考客户端之一，采用C++开发，遵循以太坊黄皮书规范，支持完整的以太坊协议实现（包括以太坊虚拟机EVM、共识机制等），与geth相比，cpp-ethereum更注重轻量化部署，适合对内存和CPU资源敏感的环境（如嵌入式设备、IoT场景），同时提供了与geth兼容的JSON-RPC接口和命令行工具。

eth命令是cpp-ethereum的核心交互接口，通过命令行控制台（基于JavaScript引擎）提供了账户管理、交易操作、区块查询、合约交互等功能，是开发者直接与以太坊区块链对话的“瑞士军刀”。

环境准备：安装与启动C客户端

安装cpp-ethereum

以Ubuntu系统为例,通过包管理器安装：

sudo apt update
sudo apt install ethereum -y

安装完成后,可通过eth --version验证安装是否成功：

eth version
# 输出示例：Ethereum C++ Client v1.10.0

启动客户端并进入控制台

cpp-ethereum启动后默认进入JavaScript交互式控制台，支持eth命令调用，常用启动参数包括：

--testnet：连接到以太坊测试网（如Ropsten）。
--rpc：启用HTTP-RPC服务，方便外部工具（如Postman、web3.js）接入。
--rpcaddr "0.0.0.0"：允许RPC接口被局域网访问。
--rpcport "8545"：指定RPC端口（默认8545）。

示例启动命令：

# 启动并连接到测试网，同时启用RPC服务
eth --testnet --rpc --rpcaddr "0.0.0.0" --rpcport "8545"

启动成功后,会显示类似以下信息，并进入>命令提示符：

Ethereum C++ Client v1.10.0
Network: Testnet
RPC server started on 0.0.0.0:8545
>

此时即可输入eth命令进行操作。

eth命令基础：核心功能与常用操作

账户管理

账户是以太坊资产和交易的基础,eth命令提供了完整的账户管理功能。

（1）查看账户列表

eth.accounts

输出当前节点管理的所有账户地址列表（初始为空，需手动创建）。

（2）创建新账户

eth.newAccount("your_password")

参数your_password为账户密码，执行后返回新账户地址（如"0x1234...5678"），账户信息会加密存储在本地，后续操作需输入密码解锁。

（3）解锁账户

执行交易前需解锁账户（避免密码明文暴露，也可通过--unlock参数启动时解锁）：

eth.unlock("0x_account_address", "password")

（4）查询账户余额

eth.getBalance("0x_account_address")

返回账户余额,单位为wei（1 ETH = 10^18 wei），可通过web3.fromWei()转换为ETH：

web3.fromWei(eth.getBalance("0x_account_address"), "ether")
# 输出示例：1.5

交易操作

交易是以太网络上价值转移的核心,eth.sendTransaction是发送交易的命令。

（1）发送ETH转账

eth.sendTransaction({
    from: "0x_sender_address",
    to: "0x_receiver_address",
    value: web3.toWei(0.1, "ether"), // 转账0.1 ETH
    gas: 21000, // 标准转账gas限制
    gasPrice: web3.toWei(20, "gwei") // gas价格，20 Gwei
})

参数说明：