FISCO BCOS 联盟链Air搭建

àì夳堔傛蜴生んèń 2024-03-24 12:34 38阅读 0赞

## FISCO BCOS Air版本 ##

### 版本说明 ###

Air版本FISCO BCOS主要包括创世块配置文件config.genesis和j节点配置文件config.ini

*  `config.ini`：节点配置文件，主要配置RPC、P2P、SSL证书、账本数据路径、落盘加密等信息;
 *  `config.genesis`：创世块配置文件，`须保证群组内所有节点的创世块配置一致, 创世块配置文件在链初始化后不可更改`, 链初始化后，即使更改了创世块配置，新的配置不会生效，系统仍然使用初始化链时的genesis配置。

### 1.Ubuntu20.04环境搭建 ###

#### 1.1 安装依赖 ####

root@fisco:~/fisco# sudo apt install -y curl openssl wget

#### 1.2 获取安装脚本 ####

root@fisco:~/fisco# curl -#LO https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/FISCO-BCOS/FISCO-BCOS/releases/v3.0.0/build_chain.sh && chmod u+x build_chain.sh

#### 1.3 生成四节点FISCO链 ####

确保机器的3030030303，2020020203，8545~8548端口没有被占用。

root@fisco:~/fisco# bash build_chain.sh -l 127.0.0.1:4 -p 30300,20200

> 其中-p选项指定起始端口，分别是p2p监听端口、rpc监听端口

命令成功后会输出All completed：

[INFO] Generate ca cert successfully!
    Processing IP:127.0.0.1 Total:4
    [INFO] Generate ./nodes/127.0.0.1/sdk cert successful!
    [INFO] Generate ./nodes/127.0.0.1/node0/conf cert successful!
    [INFO] Generate ./nodes/127.0.0.1/node1/conf cert successful!
    [INFO] Generate ./nodes/127.0.0.1/node2/conf cert successful!
    [INFO] Generate ./nodes/127.0.0.1/node3/conf cert successful!
    [INFO] Generate uuid success: 14502479-cf42-4713-b4ab-14e7d0cef92f
    [INFO] Generate uuid success: 22ff7b62-2f0a-46c7-819b-0766e159081e
    [INFO] Generate uuid success: 5ac7ad44-4fe7-46a6-9a84-ab844d25f64b
    [INFO] Generate uuid success: 10ab8efd-411c-42f2-a96c-0b7591f329bd
    ==============================================================
    [INFO] GroupID               : group0
    [INFO] ChainID               : chain0
    [INFO] fisco-bcos path      : bin/fisco-bcos
    [INFO] Auth mode            : false
    [INFO] Start port           : 30300 20200
    [INFO] Server IP            : 127.0.0.1:4
    [INFO] SM model             : false
    [INFO] Output dir           : ./nodes
    [INFO] All completed. Files in ./nodes

#### 1.4 启动所有的节点 ####

启动所有节点

root@fisco:~/fisco# bash nodes/127.0.0.1/start_all.sh 
    try to start node0
    try to start node1
    try to start node2
    try to start node3
     node3 start successfully pid=14403
     node1 start successfully pid=14405
     node2 start successfully pid=14399
     node0 start successfully pid=14400

### 2.配置和使用控制台 ###

控制台提供了向FISCO BCOS节点部署合约、发起合约调用、查询链状态等功能。

#### 2.1 安装控制台依赖 ####

控制台运行依赖java环境(推荐使用java 14)，安装命令如下：

# ubuntu系统安装java
    root@fisco:~/fisco# sudo apt install -y default-jdk
    
    // 可以不配置Java的home环境
    root@fisco:~/fisco#  cat /etc/profile
    export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
    export JRE_HOME=${JAVA_HOME}/jre
    export CLASSPATH=.:${JAVA_HOME}/lib:${JRE_HOME}/lib
    export PATH=${JAVA_HOME}/bin:${JRE_HOME}/bin:$PATH
    
    root@fisco:~/fisco# java -version
    openjdk version "11.0.16" 2022-07-19
    OpenJDK Runtime Environment (build 11.0.16+8-post-Ubuntu-0ubuntu120.04)
    OpenJDK 64-Bit Server VM (build 11.0.16+8-post-Ubuntu-0ubuntu120.04, mixed mode, sharing)

#### 2.2 下载控制台 ####

root@fisco:~/fisco# cd ~/fisco && curl -#LO https://gitee.com/FISCO-BCOS/console/raw/master/tools/download_console.sh
    
    root@fisco:~/fisco# chmod  +x download_console.sh  &&  bash download_console.sh

#### 2.3 配置控制台 ####

root@fisco:~/fisco# cp -n console/conf/config-example.toml console/conf/config.toml
    root@fisco:~/fisco# cp -r nodes/127.0.0.1/sdk/* console/conf

#### 2.4 启动并使用控制台 ####

root@fisco:~/fisco/console# ./start.sh 
    
    =============================================================================================
    Welcome to FISCO BCOS console(3.0.0)!
    Type 'help' or 'h' for help. Type 'quit' or 'q' to quit console.
     ________ ______  ______   ______   ______       _______   ______   ______   ______  
    |        |      \/      \ /      \ /      \     |       \ /      \ /      \ /      \ 
    | $$$$$$$$\$$$$$|  $$$$$$|  $$$$$$|  $$$$$$\    | $$$$$$$|  $$$$$$|  $$$$$$|  $$$$$$\
    | $$__     | $$ | $$___\$| $$   \$| $$  | $$    | $$__/ $| $$   \$| $$  | $| $$___\$$
    | $$  \    | $$  \$$    \| $$     | $$  | $$    | $$    $| $$     | $$  | $$\$$    \ 
    | $$$$$    | $$  _\$$$$$$| $$   __| $$  | $$    | $$$$$$$| $$   __| $$  | $$_\$$$$$$\
    | $$      _| $$_|  \__| $| $$__/  | $$__/ $$    | $$__/ $| $$__/  | $$__/ $|  \__| $$
    | $$     |   $$ \\$$    $$\$$    $$\$$    $$    | $$    $$\$$    $$\$$    $$\$$    $$
     \$$      \$$$$$$ \$$$$$$  \$$$$$$  \$$$$$$      \$$$$$$$  \$$$$$$  \$$$$$$  \$$$$$$
    
    =============================================================================================
    [group0]: /apps>

### 3.常用的控制台命令 ###

#### 3.1 编写和调用合约 ####

(1) 部署合约

[group:0]> deploy HelloWord

(2) 查看区块

[group:0]> getBlockNumber

(3) 调用合约

[group:0]> call HelloWorld 0x6849f21d1e455e9f0712b1e99fa4fcd23758e8f1 get

#### 3.2 控制台常用命令 ####

(1) 查看控制台命令列表

[group:0]> help

(2) 查看具体的命令说明

[group:0]> getBlockNumber -h

(3) 常用命令分类

(1)节点操作：addObserver、addSealer、getPeers、getNodldList
    (2)合约操作：call callByCNS、deploy、deployByCNS
    (3)区块操作：getBlockByHash.、getBlockByNumber
    (4)群组操作：switch、getGroupPeers、getroupList
    (5)交易操作：getTransactionByHash、getPendingTransaction、getPendingTxize、getTotalTansactionCount
    (6)权限操作：grantPermissionManager、revokePermissionManager
    (7)其他操作：getPbftView、getConsensusStatus、getSyncStatus