万纳链（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 git-c.i.wxblockchain.com/vena/src/Ve… 执行编译

cd Venachain-CDT mkdir build && cd build cmake .. make && make install MacOS

获取源码

git clone git-c.i.wxblockchain.com/vena/src/Ve… 执行编译

cd Venachain-CDT mkdir build && cd build cmake .. make && make install Windows

获取源码

git clone git-c.i.wxblockchain.com/vena/src/Ve… 执行编译

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

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

例

例

例

Ubuntu

CentOS