EOSIO.CDT (Contract Development Toolkit)
Version : 1.7.0
EOSIO.CDT is a toolchain for WebAssembly (WASM) and set of tools to facilitate smart contract development for the EOSIO platform. In addition to being a general purpose WebAssembly toolchain, EOSIO specific optimizations are available to support building EOSIO smart contracts. This new toolchain is built around Clang 7, which means that EOSIO.CDT has the most currently available optimizations and analyses from LLVM, but as the WASM target is still considered experimental, some optimizations are incomplete or not available.
New Introductions
As of this release two new repositories are under the suite of tools provided by EOSIO.CDT. These are the Ricardian Template Toolkit and the Ricardian Specification. The Ricardian Template Toolkit is a set of libraries to facilitate smart contract writers in crafting their Ricardian contracts. The Ricardian specification is the working specification for the above mentioned toolkit. Please note that both projects are alpha releases and are subject to change.
Attention
- Please see the Upgrading Guide 1.2 to 1.3 and Upgrading Guide 1.5 to 1.6 to be aware of any breaking changes.
- There is currently a known issue that a minimum of 2 CPU cores is required for using EOSIO.CDT
Binary Releases
EOSIO.CDT currently supports Mac OS X brew, Linux x86_64 Debian packages, and Linux x86_64 RPM packages.
If you have previously installed EOSIO.CDT, run the uninstall script (it is in the directory where you cloned EOSIO.CDT) before downloading and using the binary releases.
Mac OS X Brew Install
brew tap eosio/eosio.cdt
brew install eosio.cdt
Mac OS X Brew Uninstall
brew remove eosio.cdt
Debian Package Install
$ wget https://github.com/eosio/eosio.cdt/releases/download/v1.7.0/eosio.cdt_1.7.0-1-ubuntu-18.04_amd64.deb
$ sudo apt install ./eosio.cdt_1.7.0-1-ubuntu-18.04_amd64.deb
Debian Package Uninstall
sudo apt remove eosio.cdt
RPM Package Install
$ wget https://github.com/eosio/eosio.cdt/releases/download/v1.7.0/eosio.cdt-1.7.0-1.el7.x86_64.rpm
$ sudo yum install ./eosio.cdt-1.7.0-1.el7.x86_64.rpm
RPM Package Uninstall
sudo yum remove eosio.cdt
Guided Installation or Building from Scratch
git clone --recursive https://github.com/eosio/eosio.cdt
cd eosio.cdt
mkdir build
cd build
cmake ..
make -j8
From here onward you can build your contracts code by simply exporting the build directory to your path, so you don't have to install globally (makes things cleaner).
Or you can install globally by running this command:
sudo make install
Uninstall after manual installation
sudo rm -fr /usr/local/eosio.cdt
sudo rm -fr /usr/local/lib/cmake/eosio.cdt
sudo rm /usr/local/bin/eosio-*
Installed Tools
- eosio-cpp
- eosio-cc
- eosio-ld
- eosio-init
- eosio-abidiff
- eosio-wasm2wast
- eosio-wast2wasm
- eosio-ranlib
- eosio-ar
- eosio-objdump
- eosio-readelf
Below tools are not installed after brew install, you get them only by building the repository and installing from scracth, see here
eosio-abidiff
eosio-ranlib
eosio-ar
eosio-objdump
eosio-readelf
Contributing
License
Important
See LICENSE for copyright and license terms.
All repositories and other materials are provided subject to the terms of this IMPORTANT notice and you must familiarize yourself with its terms. The notice contains important information, limitations and restrictions relating to our software, publications, trademarks, third-party resources, and forward-looking statements. By accessing any of our repositories and other materials, you accept and agree to the terms of the notice.