Windows系统下以太坊Geth命令行指南,入门与常用操作

Geth核心命令详解

安装完成后,我们就可以开始使用Geth的各种命令了，以下是一些最常用和核心的命令：

初始化节点（创世区块）

当你第一次运行Geth时,需要创建一个数据目录并初始化一个创世区块文件（genesis.json）。

• 创建创世文件：你需要一个genesis.json文件，这是一个JSON格式的文件，定义了创世区块的各种参数，如链ID、难度限制、币基等，你可以从网上找到示例，或根据自己需求修改。 一个简单的genesis.json内容可能如下：

  {
    "config": {
      "chainId": 15, // 本地测试链ID，自定义
      "homesteadBlock": 0,
      "eip155Block": 0,
      "eip158Block": 0
    },
    "nonce": "0x0000000000000042",
    "timestamp": "0x0",
    "extraData": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "gasLimit": "0x8000000",
    "difficulty": "0x40000",
    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "coinbase": "0x3333333333333333333333333333333333333333",
    "alloc": {}
  }

• 初始化命令：

  geth --datadir "C:\geth\data" init C:\geth\genesis.json

  • --datadir：指定数据存储目录，用于存放区块链数据、密钥等。
  • init：初始化命令，后面跟着创世文件的路径。

执行后,Geth会在指定的datadir下创建必要的文件夹结构。

启动Geth节点

初始化完成后,就可以启动Geth节点了，启动时可以附带多种选项来控制节点的行为。

• 基本启动（连接到主网）：

  geth --datadir "C:\geth\data" console

  • console：启动后进入交互式JavaScript控制台，这是最常用的启动方式，可以实时执行命令。
  • 如果只是后台运行,可以使用 --http 开启HTTP-RPC服务，或直接 geth --datadir "C:\geth\data" 后台运行（Windows下可能需要配合其他方式管理进程）。

• 连接到测试网/私有网络：

  • 测试网（如Ropsten, Rinkeby, Goerli）：

    geth --datadir "C:\geth\data" --testnet console

    或者指定网络ID：

    geth --datadir "C:\geth\data" --networkid 3 console  # Ropsten网络ID为3

  • 私有网络：使用我们自定义的创世文件启动时，Geth默认会认为是私有网络，只需指定datadir和genesis.json（初始化时已指定），并可以自定义networkid。

• 常用启动选项：

  • --http：启用HTTP-RPC服务，默认端口8545，可以通过 --http.addr 和 --http.port 修改。
  • --ws：启用WebSocket-RPC服务，默认端口8546，可以通过 --ws.addr 和 --ws.port 修改。
  • --syncmode：同步模式，可选 full（全节点，默认）、fast（快速同步，只下载区块头和状态）、light（轻节点）。
  • --cache：设置缓存大小，--cache 4096，单位MB，有助于提高同步速度。
  • --maxpeers：设置最大连接节点数，--maxpeers 50。
  • --mine：开启挖矿，需要配置好账户（见下文）。
  • --miner.threads：设置挖矿使用的线程数。
  • --rpcapi：指定通过HTTP-RPC暴露的API，--rpcapi "eth,net,web3,personal"。

控制台（Console）常用命令

启动geth console后，你将进入一个JavaScript环境，可以执行以下命令：

• 查看节点信息：

  • eth.blockNumber：获取当前最新区块号。
  • net.version：获取当前网络ID。
  • net.peerCount：获取已连接的节点数量。
  • web3.clientVersion：获取Geth客户端版本。

• 账户管理：

  • personal.newPassword("account")：创建新账户（需要输入密码）。
  • personal.listAccounts：列出所有账户地址。
  • personal.unlockAccount(eth.accounts[0], "password")：解锁账户，用于发送交易或挖矿。
  • eth.getBalance(eth.accounts[0])：查询指定账户的余额（单位：Wei）。
  • web3.fromWei(eth.getBalance(eth.accounts[0]), "ether")：将余额从Wei转换为Ether。

• 交易相关：

  • eth.sendTransaction({from: eth.accounts[0], to: "0xRecipientAddress", value: web3.toWei(1, "ether")})：发送交易。
    • 需要先解锁发送方账户。
    • value的单位是Wei，可以使用web3.toWei()转换。
  • eth.getTransaction("transactionHash")：根据交易哈查询交易详情。
  • eth.getTransactionReceipt("transactionHash")：查询交易收据（包含是否成功、消耗的Gas等）。

• 挖矿（如果开启）：

  • miner.start(1)：启动挖矿，参数为线程数。
  • miner.stop()：停止挖矿。

• 合约交互（简述）：

  • 部署合约通常需要先编译Solidity代码,得到ABI和字节码，然后使用eth.contract().new()进行部署。
  • 与已部署的合约交互,需要创建合约实例，然后调用其方法。

其他实用命令

• 控制台外命令：

  `geth attach "C