【技术科普】万纳链-CDT (Contract Development Toolkit)使用指南

万纳链（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

1. 遇到以下问题：

   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++版本太低导致，请升级版本

2. 遇到以下问题：

   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

3. 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
   )

4. 编译项目时，出现 boost_1_69_0.tar.bz2 下载慢或者下载失败的情况。

   解决方法：先停止当前 make 流程，然后手动在官网下载 boost_1_69_0.tar.bz2 ，放到项目 build/thirdparty/Download/boost/ 目录下，然后继续执行 make 。

5. 编译项目时，出现 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