Hyperledger Besu企业以太坊快速教程

发表于 | 分类于

Besu是Hyperledger中的企业以太坊产品，其最大优势在于兼容以太坊主网。 本教程介绍如何使用Hyperledger Besu快速启动一个企业以太坊网络并利用 JSON RPC进行数据查询和交易提交，以及如何使用Truffle开发企业以太坊 DApp并使用内置的工具进行数据调试和运维监控。

1、启动企业以太坊网络

首先克隆Besu的quickstart仓库的源代码：

1
git clone https://github.com/PegaSysEng/besu-quickstart.git

然后进入besu-quickstart目录，执行如下命令构建besu的docker镜像：

1
./run.sh

上面的命令会构建docker镜像并启动4个容器来模拟一个 包含6个besu节点的企业以太坊网络。当脚本执行完成后，你可以看到如下 输出信息：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
*************************************
Besu Quickstart <version>
*************************************
List endpoints and services
----------------------------------
              Name                            Command               State               Ports
---------------------------------------------------------------------------------------------------------
besu-quickstart_bootnode_1     /opt/besu/bootnode_sta ...   Up      30303/tcp, 8545/tcp, 8546/tcp
besu-quickstart_explorer_1     nginx -g daemon off;             Up      0.0.0.0:32768->80/tcp
besu-quickstart_grafana_1      /run.sh                          Up      3000/tcp
besu-quickstart_minernode_1    /opt/besu/node_start.s ...   Up      30303/tcp, 8545/tcp, 8546/tcp
besu-quickstart_node_1         /opt/besu/node_start.s ...   Up      30303/tcp, 8545/tcp, 8546/tcp
besu-quickstart_node_2         /opt/besu/node_start.s ...   Up      30303/tcp, 8545/tcp, 8546/tcp
besu-quickstart_node_3         /opt/besu/node_start.s ...   Up      30303/tcp, 8545/tcp, 8546/tcp
besu-quickstart_node_4         /opt/besu/node_start.s ...   Up      30303/tcp, 8545/tcp, 8546/tcp
besu-quickstart_prometheus_1   /bin/prometheus --config.f ...   Up      9090/tcp
besu-quickstart_rpcnode_1      /opt/besu/node_start.s ...   Up      30303/tcp, 8545/tcp, 8546/tcp

以及访问端结点列表：

1
2
3
4
5
6
7
8
****************************************************************
JSON-RPC HTTP service endpoint      : http://localhost:32768/jsonrpc
JSON-RPC WebSocket service endpoint : ws://localhost:32768/jsonws
GraphQL HTTP service endpoint       : http://localhost:32768/graphql
Web block explorer address          : http://localhost:32768
Prometheus address                  : http://localhost:32768/prometheus/graph
Grafana address                     : http://localhost:32768/grafana-dashboard                                                                        
****************************************************************
  • JSON-RPC HTTP服务用于DApp或Metamask钱包的访问
  • JSON-RPC WebSocket服务用于DApp通过websocket访问节点
  • GraphQL HTTP服务用于DApp或Metamask钱包的访问节点的GraphQL服务
  • Web区块浏览服务用于浏览区块，在你的浏览器中输入该地址即可
  • Prometheus服务用于为Prometheus仪表盘提供指标数据
  • Grafana服务用于为Grafana仪表盘提供数据

要再次显示访问端结点，可以使用如下命令：

1
./list.sh

2、使用企业以太坊区块浏览器

在本教程中我们使用Alethio轻量级以太坊浏览器，你也可以使用EthScan。

在你的浏览器中打开前面提到的web block explorer endpoint列出的地址，就可以 查看企业以太坊网络中的区块数据了。

可以在区块浏览器中看到有6个besu节点：4个普通节点、1个出块节点和一个引导节点。

点击 Best Block 右侧的区块号就可以显示该区块的详细数据：

点击左上角的放大镜，就可以搜索区块、交易哈希、或以太坊地址：

3、监视Besu节点的运行状况

可以使用Prometheus和Grafana这些运维监视工具来可视化节点的健康状态 和运行情况。参考前面给出的访问端结点，可以在你的浏览器中直接访问这些工具。 例如使用Grafana：

4、使用JSON-RPC访问Besu节点

Besu支持标准的以太坊JSON-RPC API接口。例如使用curl调用web3_clientVersion 命令来查看节点的版本：

1
2
3
4
5
6
curl -X POST --data '{
	"jsonrpc":"2.0",
	"method":"web3_clientVersion",
	"params":[],
	"id":1
}' <http-rpc-endpoint>

其中<http-rpc-endpoint>表示前面列出的访问端结点的地址，你需要 根据自己的实际情况替换，例如http://localhost:32768/jsonrpc。 上面命令的返回结果类似如下：

1
2
3
4
5
{
   "jsonrpc" : "2.0",
   "id" : 1,
   "result" : "besu/<version number>"
}

或者使用net_peerCount命令 查看节点已连接的Peer数量：

1
2
3
4
5
6
curl -X POST --data '{
	"jsonrpc":"2.0",
	"method":"net_peerCount",
	"params":[],
	"id":1
}' <http-rpc-endpoint>

结果如下：

1
2
3
4
5
{
  "jsonrpc" : "2.0",
  "id" : 1,
  "result" : "0x6"
}

或者使用eth_blockNumber查看 最新的区块号：

1
2
3
4
5
6
curl -X POST --data '{
	"jsonrpc":"2.0",
	"method":"eth_blockNumber",
	"params":[],
	"id":1
}' <http-rpc-endpoint>

结果如下：

1
2
3
4
5
{
  "jsonrpc" : "2.0",
  "id" : 1,
  "result" : "0x8b8"
}

5、使用MetaMask创建企业以太坊交易

在发送企业以太坊交易之前，我们需要先创建一个账号，或者使用这个私有网络的 创世配置中已经声明的几个账号：

账号1 ：同时也是币基地址

1
2
3
Address: 0xfe3b557e8fb62b89f4916b721be55ceb828dbd73
Private key : 0x8f2a55949038a9610f50fb23b5883af3b4ecb3c3bb792cbcefbd1542c692be63
Initial balance : 0xad78ebc5ac6200000 (200000000000000000000 in decimal)

账号2：

1
2
3
Address: 0x627306090abaB3A6e1400e9345bC60c78a8BEf57
Private key : 0xc87509a1c067bbde78beb793e6fa76530b6382a4c0241e5e4a9ec0a0f44dc0d3
Initial balance : 0x90000000000000000000000 (2785365088392105618523029504 in decimal)

账号3：

1
2
3
Address: 0xf17f52151EbEF6C7334FAD080c5704D77216b732
Private key : 0xae6ae8e5ccbfb04590405997ee2d52d2b330726137b875053c36d94e974d162f
Initial balance : 0x90000000000000000000000 (2785365088392105618523029504 in decimal

在登录进MetaMask之后，链接到我们建立的Besu网络的某个节点，然后你就可以 创建交易了。

6、基于Besu网络的Truffle宠物商店演示

要运行Truffle的Pet Shop演示，首先我们需要安装truffle及pet-shop模板， 然后还需要针对Besu的企业以太坊网络进行一些简单的调整。

首先安装truffle：

1
npm install -g truffle

然后创建pet-shop-tutorial目录并进入该目录：

1
2
mkdir pet-shop-tutorial
cd pet-shop-tutorial

然后解压Truffle的pet-shop box：

1
truffle unbox pet-shop

安装truffle-wallet：

1
npm install --save @truffle/hdwallet-provider

接下来修改pet-shop-tutorial目录中的truffle-config.js文件，以便 添加我们的钱包提供器。请参考以下内容进行修改：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
const PrivateKeyProvider = require("truffle-hdwallet-provider");
const privateKey = "8f2a55949038a9610f50fb23b5883af3b4ecb3c3bb792cbcefbd1542c692be63";

module.exports = {
  // See <http://truffleframework.com/docs/advanced/configuration>
  // for more about customizing your Truffle configuration!
  networks: {
    development: {
      host: "127.0.0.1",
      port: 7545,
      network_id: "*" // Match any network id
    },
    quickstartWallet: {
      provider: () => new PrivateKeyProvider(privateKey, "<YOUR HTTP RPC NODE ENDPOINT>"),
      network_id: "*"
    },
  }
};

将 <YOUR HTTP RPC NODE ENDPOINT>替换为你的HTTP RPC访问端结点， 例如 http://localhost:32770/jsonrpc 。

将privateKey替换为前面的账户1，即币基地址，其中有以太币。

由于我们使用企业以太坊网络而不是Ganache仿真器，因此在执行合约 部署时，需要指定网络：

1
truffle migrate --network quickstartWallet

输出结果类似如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
sing network 'quickstartWallet'.

Running migration: 1_initial_migration.js
  Deploying Migrations...
  ... 0xfc1dbc1eaa14fa283c2c4415364579da0d195b3f2f2fefd7e0edb600a6235bdb
  Migrations: 0x9a3dbca554e9f6b9257aaa24010da8377c57c17e
Saving successful migration to network...
  ... 0x77cc6e9966b886fb74268f118b3ff44cf973d32b616ed4f050b3eabf0a31a30e
Saving artifacts...
Running migration: 2_deploy_contracts.js
  Deploying Adoption...
  ... 0x5035fe3ea7dab1d81482acc1259450b8bf8fefecfbe1749212aca86dc765660a
  Adoption: 0x2e1f232a9439c3d459fceca0beef13acc8259dd8
Saving successful migration to network...
  ... 0xa7b5a36e0ebc9c25445ce29ff1339a19082d0dda516e5b72c06ee6b99a901ec0
Saving artifacts...

你可以在区块浏览器中查看上述输出中的合约地址。

同样，在执行测试时也要指定使用我们的企业以太坊网络：

1
truffle test --network quickstartWallet

输出结果如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Using network 'quickstartWallet'.

Compiling ./contracts/Adoption.sol...
Compiling ./test/TestAdoption.sol...
Compiling truffle/Assert.sol...
Compiling truffle/DeployedAddresses.sol...


  TestAdoption
    ✓ testUserCanAdoptPet (2071ms)
    ✓ testGetAdopterAddressByPetId (6070ms)
    ✓ testGetAdopterAddressByPetIdInArray (6077ms)


  3 passing (37s)

7、企业以太坊网络的停止/重启/清理

使用如下脚本停止Besu构成的企业以太坊网络，但不删除dockers容器：

1
./stop.sh

使用如下命令重新启动企业以太坊网络：

1
./resume.sh

如果要停止网络并删除相应的docker容器，使用如下命令：

1
./remove.sh

原文链接：Private Network Quickstart Tutorial

汇智网翻译整理，转载请标明出处