万纳链(Venachain)是万向区块链基于PlatONE底层开源平台,针对企业级客户和开发者在数字化转型过程中的实际需求,推出的自主可控的高性能联盟链,已通过中国电子标准化研究院的功能与性能双项测试。依托万向区块链丰富的技术与生态资源,万纳链具备出色的关联技术耦合能力,通过与隐私计算、物联网、知识图谱等技术融合,引航分布式认知技术的创新和实践。同时,结合团队出色的机制设计能力,万纳链旨在为实体经济的数字化转型打造可信数字底座,为企业级客户和开发者提供隐私安全、性能优越、一键部署、功能丰富的综合解决方案。
我们将通过一系列技术科普文章,帮助大家了解万纳链的技术特点和操作方法。今天我们一起来了解万纳链-CDT的功能和使用方式。
本文作者:万向区块链通用架构技术部
Venachain-CDT是WebAssembly(WASM)工具链和Venachain平台智能合约开发工具集。主要功能如下:
-
创建C++合约模版;
-
将C++合约编译为wasm格式文件,并生成对应合约的ABI文件。
安装或使用过程中遇到问题可以阅读 Q&A 部分进行排查。
Windows用户在安装与使用的过程中,建议使用 Git Bash 进行操作。
安装
两种安装方式:
-
方式一:使用已编译版本。将本工具对应操作系统的release包解压到
${指定安装目录}
下。Linux与MacOS操作系统用户的${指定安装目录}
为/usr/local/
,Windows用户的${指定安装目录}
为C:/
。 -
方式二:手动编译安装。按照下文编译步骤进行手动编译安装。
由于方式二的编译时间可能较长,推荐使用方式一。
在安装完成后,将 ${指定安装目录}/venachain.cdt
添加至环境变量中。如果是windows系统,还需要将 ${指定安装目录}/venachain.cdt/bin
添加至环境变量中。
编译
编译要求
Linux
-
Git
-
Python
-
CMake 3.17+
-
gcc&g++ 7.4+ 或 Clang 7.0+
MacOS
-
Git
-
Python
-
CMake 3.17+
-
gcc&g++ 7.4+ 或 Clang 7.0+
Windows
-
Git
-
Python
-
CMake 3.5+
-
MinGW-W64 GCC-8.1.0 (注:安装路径不能含有空格,即不能安装在
Program Files
或Program Files(x86)目录
,否则可能导致编译失败。)
编译流程
linux
安装依赖
-
Ubuntu:
sudo apt install build-essential cmake libz-dev libtinfo-dev libncurses5-dev
-
CentOS:
sudo yum install gcc g++ make ncurses-devel zlib-devel
获取源码
git clone https://git-c.i.wxblockchain.com/vena/src/Venachain-CDT.git
执行编译
cd Venachain-CDT
mkdir build && cd build
cmake ..
make && make install
MacOS
获取源码
git clone https://git-c.i.wxblockchain.com/vena/src/Venachain-CDT.git
执行编译
cd Venachain-CDT
mkdir build && cd build
cmake ..
make && make install
Windows
获取源码
git clone https://git-c.i.wxblockchain.com/vena/src/Venachain-CDT.git
执行编译
cd Venachain-CDT
mkdir build && cd build
cmake -G "MinGW Makefiles" .. -DCMAKE_INSTALL_PREFIX="C:/venachain.cdt" -DCMAKE_MAKE_PROGRAM=mingw32-make
mingw32-make && mingw32-make install
使用
在使用Venachain-CDT之前,须将 ${指定安装目录}/venachain.cdt
添加至环境变量中。
C++合约项目分为两种类型:
-
单文件项目:即合约项目中只包含一个C++合约文件。
-
多文件项目:若合约文件涉及引用其他多个C++文件,则需要使用该类型。该类型项目采用
makefile
方式将合约编译为wasm文件。
单文件项目
初始化项目
venachain-init -project=${PROJECT_NAME} -bare
## 例
venachain-init -project=example -bare
编译WASM文件
cd ${PROJECT_NAME}
venachain-cpp -o ${WASM_NAME}.wasm ${CPP_NAME}.cpp -abigen
## 例
cd example
venachain-cpp -o example.wasm example.cpp -abigen
多文件项目
初始化项目
venachain-init -project=${PROJECT_NAME}
# 例
venachain-init -project=cmake_example
编译WASM文件
-
Linux
cd ${PROJECT_NAME}/build
cmake ..
make
-
MacOS
cd ${PROJECT_NAME}/build
cmake ..
make
-
Windows
cd ${PROJECT_NAME}/build
cmake .. -G "MinGW Makefiles" -DVENACHAIN_CDT_ROOT="C:/venachain.cdt"
mingw32-make
编译流程说明
clang 7.0版本以后支持将c++代码直接编译为wasm字节码,大大简化了编译流程。
Q&A
-
遇到以下问题:
venachain-init: /lib64/libstdc++.so.6: version `GLIBCXX_3.4.20' not found (required by venachain-init) venachain-init: /lib64/libstdc++.so.6: version `CXXABI_1.3.9' not found (required by venachain-init) venachain-init: /lib64/libstdc++.so.6: version `GLIBCXX_3.4.21' not found (required by venachain-init)
原因与解决方法:gcc&g++版本太低导致,请升级版本
-
遇到以下问题:
can not find libtinfo/ can not fond libncurses
原因与解决方法:首先确认有没有安装
libncurses
,在/usr/lib64/
下:-
如果没有,执行
## Ubuntu apt -y install lib32ncurses5 ## CentOS yum -y install libncurses.so.5
-
若有,则执行
ln -s libncurses.so libncurses.so.5.9
-
-
MacOS系统版本比较高时,需要升级boost。
例如 macOS Big Sur 版本 11.6.1,将
CMakeModules/BoostExternalProject.txt
的ExternalProject_Add
模块的内容改为ExternalProject_Add( boost URL https://sourceforge.net/projects/boost/files/boost/1.77.0/boost_1_77_0.tar.bz2/download URL_MD5 09dc857466718f27237144c6f2432d86 CONFIGURE_COMMAND ./bootstrap.sh --with-toolset=clang --with-libraries=filesystem,system,log,thread,random,exception BUILD_COMMAND ./b2 link=static ${BUILD_COMMAND_EXTRA} BUILD_IN_SOURCE 1 INSTALL_COMMAND "" BUILD_ALWAYS 1 )
-
编译项目时,出现
boost_1_69_0.tar.bz2
下载慢或者下载失败的情况。解决方法:先停止当前
make
流程,然后手动在官网下载boost_1_69_0.tar.bz2
,放到项目build/thirdparty/Download/boost/
目录下,然后继续执行make
。 -
编译项目时,出现
file cannot create directory
或cannot copy file
报错的情况,如:Install the project... -- Install configuration: "" CMake Error at cmake_install.cmake:44 (file): file cannot create directory: /usr/local/venachain.cdt/lib/cmake/venachain.cdt. Maybe need administrative privileges.
原因与解决方法:用户权限不足,请尝试使用更高权限,比如:
su root make install