一、通过命令行体验长安链

  • 1 、概述
  • 2、环境依赖
    • 2.1、硬件依赖
    • 2.2、软件依赖
    • 2.3、git安装
    • 2.4、golang安装
    • 2.5、gcc
  • 3、环境搭建
    • 3.1、源码下载
    • 3.2、 源码编译
    • 3.3、编译及安装包制作
    • 3.4、启动节点集群
    • 3.5、查看节点启动使用正常
  • 4、使用CMC命令行工具部署、调用合约
    • 4.1、编译&配置
    • 4.2、部署示例合约
    • 4.3 查询链上数据
  • 5、长安链部署目录说明

官方文档
https://docs.chainmaker.org.cn/v2.3.1/html/quickstart/%E9%80%9A%E8%BF%87%E5%91%BD%E4%BB%A4%E8%A1%8C%E4%BD%93%E9%AA%8C%E9%93%BE.html#

本文是按照官方文档操作,做一个演示记录

1 、概述

通过本文你可以通过命令行和cmc工具搭建长安链多节点集群和部署智能合约,完成长安链的初步体验。

通过源码搭建长安链并且上链查数据需要以下步骤,本文将一一演示

  • 下载长安链及证书管理工具源码

  • 编译源码

  • 生成节点证书

  • 编译及安装包制作

  • 启动节点集群

  • 查看节点状态

  • 使用CMC工具安装、调用、查询一个合约

2、环境依赖

2.1、硬件依赖

这个大家参考就行了,如果配置不够,也就是卡点,问题不大,加油~

配置最低配置推荐配置
CPU1.5GHz2.4GHz
内存8GB16GB
核心4核8核
带宽2Mb10Mb

2.2、软件依赖

当前文档在centos7操作下完成,以下为本次演示所需的依赖 软件列表如下:

名称版本描述是否必须
git/源码管理
golang1.16-1.19编译环境(需修改国内代理)
gcc7.3+编译环境依赖
glibc2.18智能合约执行环境依赖
tmux/默认快速启动命令依赖
wasmer运行时库 libwasmer_runtime_c_api.so/https://git.chainmaker.org.cn/chainmaker/vm-wasmer/-/tree/master/wasmer-go/packaged/lib 目录下,找到对应链分支的库,将该库路径添加至系统PATH环境变量下启动脚本默认包含,单独启动需加上如下配置:
cd deployPath/lib
cp xxx/main/libwasmer_runtime_c_api.so libwasmer.so
export LD_LIBRARY_PATH=deployPath/lib:$LD_LIBRARY_PATH

2.3、git安装

# 使用yum命令安装yum install -y git# 验证查看版本号git --version

2.4、golang安装

推荐:版本为1.16-1.19

教程请移步: Linux 下安装 Golang

2.5、gcc

  • 检查 gcc 版本

    gcc --version

  • 显示结果若 < 7.3,则执行下面步骤升级

    sudo yum install centos-release-sclsudo yum install devtoolset-7-gcc*scl enable devtoolset-7 bash

    注意:第三条指令scl enable devtoolset-7 bash 只是在当前会话中升级了gcc,如果想每次登录gcc自动升级,可以把scl enable devtoolset-7 bash 放在 ~/.bash_profile 文件中。

    vim ~/.bash_profile

  • 如果没安装,执行命令安装即可

    yum install -y gcc

3、环境搭建

下面将介绍使用脚本搭建搭建环境。

适用于Linux、MacOS

3.1、源码下载

从长安链官网下载源码:https://git.chainmaker.org.cn/chainmaker/chainmaker-go

当前为私有仓库,需要先进行账号注册

我这里源码统一放在: /data目录下

下载chainmaker-go源码到本地

$ git clone -b v2.3.1 --depth=1 https://git.chainmaker.org.cn/chainmaker/chainmaker-go.git

下载证书生成工具源码到本地

$ git clone -b v2.3.0--depth=1 https://git.chainmaker.org.cn/chainmaker/chainmaker-cryptogen.git

3.2、 源码编译

  • 编译证书生成工具

    $ cd chainmaker-cryptogen$ make

    结果会生成 bin 和 release 目录

  • 配置文件生成
    将编译好的chainmaker-cryptogen,软连接到chainmaker-go/tools目录

    # 进入工具目录$ cd chainmaker-go/tools# 软连接chainmaker-cryptogen到tools目录下$ ln -s ../../chainmaker-cryptogen/ .


    2.1版本之后,ChainMaker支持多种身份模式,由于不同身份模式下,配置文件的目录结构和内容差异较大,在此我们选择身份模式PermissionedWithCert(详情见身份权限管理)作为示例。

  • PermissionedWithCert
    原始的身份模式,即证书模式
    进入chainmaker-go/scripts目录,执行prepare.sh脚本生成单链4节点集群配置,存于路径chainmaker-go/build中

    prepare.sh脚本支持生成solo模式节点证书和配置,以及4/7/10/13/16节点的证书和配置

    # 进入脚本目录$ cd ../scripts# 查看脚本帮助$ ./prepare.sh -hUsage:prepare.sh node_cnt(1/4/7/10/13/16) chain_cnt(1-4) p2p_port(default:11301) rpc_port(default:12301)eg1: prepare.sh 4 1eg2: prepare.sh 4 1 11301 12301# 生成单链4节点集群的证书和配置$ ./prepare.sh 4 1begin check params...begin generate certs, cnt: 4input consensus type (0-SOLO,1-TBFT(default),3-HOTSTUFF,4-RAFT,5-DPOS):input log level (DEBUG|INFO(default)|WARN|ERROR):enable docker vm (YES|NO(default))begin generate node1 config...begin generate node2 config...begin generate node3 config...begin generate node4 config...# 查看生成好的节点证书和配置$ tree -L 3 ../build/../build/├── config│ ├── node1│ │ ├── certs│ │ ├── chainconfig│ │ ├── chainmaker.yml│ │ └── log.yml│ ├── node2│ │ ├── certs│ │ ├── chainconfig│ │ ├── chainmaker.yml│ │ └── log.yml│ ├── node3│ │ ├── certs│ │ ├── chainconfig│ │ ├── chainmaker.yml│ │ └── log.yml│ └── node4│ ├── certs│ ├── chainconfig│ ├── chainmaker.yml│ └── log.yml├── crypto-config│ ├── wx-org1.chainmaker.org│ │ ├── ca│ │ ├── node│ │ └── user│ ├── wx-org2.chainmaker.org│ │ ├── ca│ │ ├── node│ │ └── user│ ├── wx-org3.chainmaker.org│ │ ├── ca│ │ ├── node│ │ └── user│ └── wx-org4.chainmaker.org│ ├── ca│ ├── node│ └── user└── crypto_config.yml

    关于自动生成的端口说明

    通过prepare.sh脚本生成的配置,默认是在单台服务器上部署,故自动生成的端口号,是从一个起始端口号开始依次递增,可以通过命令行参数修改起始端口号。

    主要有2个端口,p2p端口(用于节点互联)和rpc端口(用于客户端与节点通信),p2p起始端口为11301,rpc起始端口为12301。

    如果生成4个节点的配置,p2p端口分别为:11301、11302、11303、11304,rpc端口分别为:12301、12302、12303、12304

    如果是在多机部署,希望生成固定的端口号,请参考:【多机部署】

3.3、编译及安装包制作

生成证书(prepare.sh脚本)后执行build_release.sh脚本,将编译chainmaker-go模块,并打包生成安装,存于路径chainmaker-go/build/release中

$ ./build_release.sh$ tree ../build/release/../build/release/├── chainmaker-v2.0.0-wx-org1.chainmaker.org-20210406194833-x86_64.tar.gz├── chainmaker-v2.0.0-wx-org2.chainmaker.org-20210406194833-x86_64.tar.gz├── chainmaker-v2.0.0-wx-org3.chainmaker.org-20210406194833-x86_64.tar.gz├── chainmaker-v2.0.0-wx-org4.chainmaker.org-20210406194833-x86_64.tar.gz└── crypto-config-20210406194833.tar.gz

3.4、启动节点集群

  • 执行cluster_quick_start.sh脚本,会解压各个安装包,调用bin目录中的start.sh脚本,启动chainmaker节点

    $ ./cluster_quick_start.sh normal

  • 启动成功后,将*.tar.gz备份,以免下次启动再次解压缩时文件被覆盖

    $ mkdir -p ../build/bak$ mv ../build/release/*.tar.gz ../build/bak

    若需要关闭集群,使用脚本:
    $ ./cluster_quick_stop.sh

3.5、查看节点启动使用正常

  • 查看进程是否存在

    $ ps -ef|grep chainmaker | grep -v grep

  • 查看端口是否监听

    $ netstat -lptn | grep 1230

  • 检查节点是否有ERROR日志

    $ cat ../build/release/*/bin/panic.log$ cat ../build/release/*/log/system.log$ cat ../build/release/*/log/system.log |grep "ERROR\|put block\|all necessary"//若看到all necessary peers connected则表示节点已经准备就绪。

4、使用CMC命令行工具部署、调用合约

为了验证所搭建的链功能是否正常,可以通过cmc命令行工具来进行验证。

4.1、编译&配置

# 编译cmc$ cd /data/chainmaker-go/tools/cmc$ go build# 配置测试数据$ cp -rf ../../build/crypto-config ../../tools/cmc/testdata/ # 使用chainmaker-cryptogen生成的测试链的证书# 查看help$ ./cmc --help

4.2、部署示例合约

  • 创建wasm合约

    ./cmc client contract user create \--contract-name=fact \--runtime-type=WASMER \--byte-code-path=./testdata/claim-wasm-demo/rust-fact-2.0.0.wasm \--version=1.0 \--sdk-conf-path=./testdata/sdk_config.yml \--admin-key-file-paths=./testdata/crypto-config/wx-org1.chainmaker.org/user/admin1/admin1.sign.key,./testdata/crypto-config/wx-org2.chainmaker.org/user/admin1/admin1.sign.key,./testdata/crypto-config/wx-org3.chainmaker.org/user/admin1/admin1.sign.key \--admin-crt-file-paths=./testdata/crypto-config/wx-org1.chainmaker.org/user/admin1/admin1.sign.crt,./testdata/crypto-config/wx-org2.chainmaker.org/user/admin1/admin1.sign.crt,./testdata/crypto-config/wx-org3.chainmaker.org/user/admin1/admin1.sign.crt \--sync-result=true \--params="{}"

    注:智能合约编写参见:智能合约开发

  • 调用wasm合约

    ./cmc client contract user invoke \--contract-name=fact \--method=save \--sdk-conf-path=./testdata/sdk_config.yml \--params="{\"file_name\":\"name007\",\"file_hash\":\"ab3456df5799b87c77e7f88\",\"time\":\"6543234\"}" \--sync-result=true

  • 查询合约

    ./cmc client contract user get \--contract-name=fact \--method=find_by_file_hash \--sdk-conf-path=./testdata/sdk_config.yml \--params="{\"file_hash\":\"ab3456df5799b87c77e7f88\"}"

4.3 查询链上数据

查询链上block和transaction 主要参数说明如下:

--sdk-conf-path:指定cmc使用sdk的配置文件路径--chain-id:指定链Id
  • 根据区块高度查询链上未归档区块
    ./cmc query block-by-height [blockheight] \--chain-id=chain1 \--sdk-conf-path=./testdata/sdk_config.yml
  • 根据区块hash查询链上未归档区块
    ./cmc query block-by-hash [blockhash] \--chain-id=chain1 \--sdk-conf-path=./testdata/sdk_config.yml
  • 根据txid查询链上未归档区块
    ./cmc query block-by-txid [txid] \--chain-id=chain1 \--sdk-conf-path=./testdata/sdk_config.yml
  • 根据txid查询链上未归档tx
    ./cmc query tx [txid] \--chain-id=chain1 \--sdk-conf-path=./testdata/sdk_config.yml

查询链配置

./cmc client chainconfig query \--sdk-conf-path=./testdata/sdk_config.yml

5、长安链部署目录说明

此目录为使用: chainmaker-go/scripts/cluster_quick_start.sh启动后的的目录结构说明。

[root@sw build]# tree.├── backup # 下次重新prepare.sh时,此次的备份。├── config # 使用 prepare.sh 生成的节点配置信息│ ├── node1 # 节点1-4│ ├── node2│ ├── node3│ └── node4├── crypto-config # 使用 prepare.sh 生成的组织证书信息│ ├── wx-org1.chainmaker.org # 组织名称1-4│ │ ├── ca # 该组织的根证书 ca│ │ ├── node # 由该组织的根证书签发的节点证书 common/consensus│ │ └── user # 由该组织的根证书签发的用户证书 admin/client/light│ ├── wx-org2.chainmaker.org│ │ ├── ca│ │ ├── node│ │ └── user│ ├── wx-org3.chainmaker.org│ │ ├── ca│ │ ├── node│ │ └── user│ └── wx-org4.chainmaker.org│ ├── ca│ ├── node│ └── user├── crypto_config.yml # 使用 prepare.sh 生成以上证书的配置文件(扩展组织、证书可使用到)├── pkcs11_keys.yml # 使用 prepare.sh 生成的硬件加密机相关配置└── release # 使用 build_release.sh 生成的打包好的部署文件夹├── crypto-config-20220720141039.tar.gz # 证书集 即上面的crypto-config文件夹的压缩包├── chainmaker-v2.3.0-wx-org2.chainmaker.org # 使用 cluster_quick_start.sh 启动链后,解压缩后的部署文件│ ├── bin# 操作管理脚本目录│ ├── config # 配置文件目录│ ├── data # 数据目录│ ├── lib # 依赖目录│ └── log # 日志目录├── chainmaker-v2.3.0-wx-org2.chainmaker.org-20220720141039-x86_64.tar.gz # 使用 build_release.sh 生成的打包好的部署文件├── chainmaker-v2.3.0-wx-org3.chainmaker.org│ ├── bin│ ├── config│ ├── data│ ├── lib│ └── log├── chainmaker-v2.3.0-wx-org3.chainmaker.org-20220720141039-x86_64.tar.gz├── chainmaker-v2.3.0-wx-org4.chainmaker.org│ ├── bin│ ├── config│ ├── data│ ├── lib│ └── log│── chainmaker-v2.3.0-wx-org4.chainmaker.org-20220720141039-x86_64.tar.gz||| # 以下为部署节点文件详情├── chainmaker-v2.3.0-wx-org1.chainmaker.org # 解压缩后的部署文件│ ├── bin# 操作管理脚本目录│ │ ├── chainmaker # 二进制文件│ │ ├── chainmaker.service # 基于 linux 系统的 systemd 自拉起服务│ │ ├── docker-vm-standalone-start.sh # 独立启动 docker 虚拟机引擎脚本│ │ ├── docker-vm-standalone-stop.sh # 独立停止 docker 虚拟机引擎脚本│ │ ├── init.sh # 基于 linux 系统的 systemd 自拉起服务部署脚本│ │ ├── panic.log # 异常日志输出及控制台输出日志文件│ │ ├── restart.sh # 重启节点脚本│ │ ├── run.sh # 基于 linux 系统的 systemd 自拉起服务管理脚本│ │ ├── start.sh # 启动节点脚本│ │ └── stop.sh # 停止节点脚本│ ├── config # 配置文件目录│ │ └── wx-org1.chainmaker.org│ │ ├── certs # 证书│ │ │ ├── ca│ │ │ │ ├── wx-org1.chainmaker.org│ │ │ │ │ └── ca.crt│ │ │ ├── node │ │ │ │ |── common1 # 同步节点证书(通过chainmaker.yml配置为节点证书,表示只可同步)│ │ │ │ └── consensus1 # 共识节点证书(通过chainmaker.yml配置为节点证书不代表就可以参与共识,共识管理是在链配置bc.yml中)│ │ │ │ ├── consensus1.nodeid # xxx.sign.crt生成的节点id│ │ │ │ ├── consensus1.sign.crt # 签名证书│ │ │ │ ├── consensus1.sign.key # 签名key│ │ │ │ ├── consensus1.tls.crt # tls连接证书│ │ │ │ └── consensus1.tls.key # tls连接key│ │ │ └── user # 用户证书│ │ │ ├── admin1 # 管理员│ │ │ │ ├── admin1.sign.crt│ │ │ │ ├── admin1.sign.key│ │ │ │ ├── admin1.tls.crt│ │ │ │ └── admin1.tls.key│ │ │ ├── client1 # 普通客户端│ │ │ │ ├── client1.addr│ │ │ │ ├── client1.sign.crt│ │ │ │ ├── client1.sign.key│ │ │ │ ├── client1.tls.crt│ │ │ │ └── client1.tls.key│ │ │ └── light1 # 轻节点,只可同步当前组织的数据(区块、交易)│ │ │ ├── light1.sign.crt│ │ │ ├── light1.sign.key│ │ │ ├── light1.tls.crt│ │ │ └── light1.tls.key│ │ ├── chainconfig # 链配置│ │ │ │── bc1.yml # 第一条链配置│ │ │ └── bc2.yml # 第二条链配置│ │ ├── chainmaker.yml # 节点配置│ │ └── log.yml # 日志配置│ ├── data # 数据目录│ │ └── wx-org1.chainmaker.org│ │ ├── block # 区块数据/索引(必须)│ │ │ └── chain1│ │ │ └── store_block│ │ │ ├── 000001.log│ │ │ ├── CURRENT│ │ │ ├── LOCK│ │ │ ├── LOG│ │ │ └── MANIFEST-000000│ │ ├── history # 历史数据│ │ │ └── chain1│ │ │ └── store_history│ │ │ ├── 000001.log│ │ │ ├── CURRENT│ │ │ ├── LOCK│ │ │ ├── LOG│ │ │ └── MANIFEST-000000│ │ ├── ledgerData1 # 中间数据(必须)│ │ │ └── chain1 # 链ID│ │ │ ├── bfdb # 区块实际存储数据(文件存储方式)│ │ │ │ └── 00000000000000000001.fdb.END│ │ │ ├── localdb # 中间状态数据│ │ │ │ ├── 000001.log│ │ │ │ ├── CURRENT│ │ │ │ ├── LOCK│ │ │ │ ├── LOG│ │ │ │ └── MANIFEST-000000│ │ │ └── wal_QmSQeH1SV65YkafQG6y7uqabF4Xwzn5VoXniFBXrzy4Eqn # 异常恢复临时数据│ │ │ └── 00001_1.wal│ │ ├── result # 结果集数据│ │ │ └── chain1│ │ │ └── store_result│ │ │ ├── 000001.log│ │ │ ├── CURRENT│ │ │ ├── LOCK│ │ │ ├── LOG│ │ │ └── MANIFEST-000000│ │ └── state # 状态数据(必须)│ │ └── chain1│ │ └── store_state│ │ ├── 000001.log│ │ ├── CURRENT│ │ ├── LOCK│ │ ├── LOG│ │ └── MANIFEST-000000│ ├── lib # 依赖目录│ │ ├── libwasmer.so # wasmer(rust)运行引擎│ │ └── wxdec # wxvm(c++)运行引擎│ └── log # 日志目录│ ├── system.log # 当前1小时的日志│ └── system.log.2022072014 # 历史日志└── chainmaker-v2.3.0-wx-org1.chainmaker.org-20220720141039-x86_64.tar.gz # 使用 build_release.sh 生成的打包好的部署文件