# PrivateEthNetwork

**Repository Path**: rsl-learn/PrivateEthNetwork

## Basic Information

- **Project Name**: PrivateEthNetwork
- **Description**: 基于Docker的私有以太坊网络搭建
- **Primary Language**: Go
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2022-06-19
- **Last Updated**: 2022-06-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 私有以太坊网络

## 部署

```sh
docker-compose up -d --build
```

如果有节点异常卡住，使用`docker restart 容器名`即可。

## 说明

### 网络结构

本区块链网络共有6个节点：

- 1个`boot-node`，即启动节点，用于对等网络发现
- 3个`mining-node`，即挖矿节点
- 2个`member-node`，即普通记账节点，不挖矿

共识算法使用`Clique`权威证明，只有经过授权的“签名者”才能创建新块。

每15秒出一个新块。

### 创世区块

`genesis.json`描述了创世区块。

可以使用`puppeth`工具来创建此json文件。

本创世区块中设定由`eth-miner1`、`eth-miner2`、`eth-miner3`节点负责打包。

如果需要加入新的挖矿节点，则需要进入`geth console`，运行：

```js
clique.propose('0x地址', true)
```

以提名新的挖矿节点（至少需要一半的节点提名才行）。

## 监控

除了以太坊网络，还部署了`Ethereum Network Status`页面以可视化展现网络状态。

部署好之后，打开 http://localhost:8080 即可查看。

## 踩坑

- `win10`和`Linux`的换行符不同，`win10`是`\r\n`，`Linux`是`\n`。
- `bootnode`节点中输出的`enode`不太对，要改对应的`ip`。
- 成员节点也需要有账户，不然会报`err="etherbase must be explicitly specified"`错误。
- 每个节点都有一个`nodekey`，存储在`data/geth/nodekey`中，用于区分不同节点，不能相同。
- `Clique`系统中，挖矿节点必须`unlock`账户才能打包区块。
- `genesis.json`中的`extraData`记录了初始的可记账节点，必须把对应的账户填入。
- 挖矿节点必须至少存在一个，这样创世区块才能打包，不然会报`Dropping unsynced node during sync`错误。
- `PoA`共识机制中没有矿工奖励。

## 参考资料

- https://github.com/ethereum/go-ethereum/blob/master/README.md
- https://geth.ethereum.org/docs/interface/managing-your-accounts
- https://luckylh.github.io/post/ethereum-puppeth-to-create-private-chain/
- https://medium.com/coinmonks/how-to-build-ethereum-dashboard-and-to-monitor-your-ethereum-network-status-9f1941beac08

## 使用的其它代码

- https://github.com/ethereum/go-ethereum
- https://github.com/ethereum/eth-net-intelligence-api
- https://github.com/ethereum/eth-netstats