turtlecoin-crypto

TurtleCoin: Standalone Cryptography Library

Master Build Status

Development Build Status

This repository contains the necessary files to compile the cryptography library used within TurtleCoin as a standalone library that can be included in various other projects in a variety of development environments, including:

• Node.js >= 6.x
• C++
• C# (via C++ shared library & P/Invoke)
• Native Javascript
• WASM

Javascript Library

Note: We build prebuilds of the Node.js native addon module as well as the WASM/JS binaries that are included for distribution with the NPM installed version of this package to speed up your development efforts.

Dependencies

• Node.js >= +6.x LTS (or Node v11)

Windows (if not using prebuilds)

Prerequisites

Read very careful if you want this to work right the first time.

1. Open a Windows Powershell console as Administrator

2. Run the command: npm install -g windows-build-tools --vs2015 This will take a while. Sit tight.

Installation

npm install turtlecoin-crypto

Intialization

TypeScript

import { Crypto } from 'turtlecoin-crypto';
const TurtleCoinCrypto = new Crypto();

CommonJS

const Crypto = require('turtlecoin-crypto').Crypto
const TurtleCoinCrypto = new Crypto()

Documentation

You can find the full TypeScript/JS documentation for this library here.

C++ Library

How To Compile

Build Optimization

The CMake build system will, by default, create optimized native builds for your particular system type when you build the software. Using this method, the binaries created provide a better experience and all together faster performance.

However, if you wish to create portable binaries that can be shared between systems, specify -DARCH=default in your CMake arguments during the build process. Note that portable binaries will have a noticable difference in performance than native binaries. For this reason, it is always best to build for your particuar system if possible.

Linux

Ubuntu, using GCC

sudo add-apt-repository ppa:ubuntu-toolchain-r/test -y
sudo apt-get update
sudo apt-get install aptitude -y
sudo aptitude install -y build-essential git cmake
git clone -b master --single-branch https://github.com/turtlecoin/turtlecoin-crypto
cd turtlecoin-crypto
mkdir build
cd build
cmake ..
make -j

The static library will be built as libturtlecoin-crypto.a in the build folder.

Ubuntu, using Clang

sudo add-apt-repository ppa:ubuntu-toolchain-r/test -y
wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key | sudo apt-key add -

You need to modify the below command for your version of ubuntu - see https://apt.llvm.org/

• Ubuntu 14.04 (Trusty)

• sudo add-apt-repository "deb https://apt.llvm.org/trusty/ llvm-toolchain-trusty 6.0 main"

• Ubuntu 16.04 (Xenial)

• sudo add-apt-repository "deb https://apt.llvm.org/xenial/ llvm-toolchain-xenial 6.0 main"

• Ubuntu 18.04 (Bionic)

• sudo add-apt-repository "deb https://apt.llvm.org/bionic/ llvm-toolchain-bionic 6.0 main"

sudo apt-get update
sudo apt-get install aptitude -y
sudo aptitude install -y -o Aptitude::ProblemResolver::SolutionCost='100*canceled-actions,200*removals'
sudo aptitude install build-essential clang-6.0 libstdc++-7-dev git cmake
export CC=clang-6.0
export CXX=clang++-6.0
git clone -b master --single-branch https://github.com/turtlecoin/turtlecoin-crypto
cd turtlecoin-crypto
mkdir build
cd build
cmake ..
make -j

The following library files will be created in the build folder:

• libturtlecoin-crypto-static.a

Generic Linux

Ensure you have the dependencies listed above.

If you want to use clang, ensure you set the environment variables CC and CXX. See the ubuntu instructions for an example.

git clone -b master --single-branch https://github.com/turtlecoin/turtlecoin-crypto
cd turtlecoin-crypto
mkdir build
cd build
cmake ..
make -j

The following library files will be created in the build folder:

• libturtlecoin-crypto-static.a

OSX/Apple, using Clang

Prerequisites

• Install XCode and Developer Tools.

Building

which brew || /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install --force cmake boost llvm
export CC=/usr/local/opt/llvm/bin/clang
export CXX=/usr/local/opt/llvm/bin/clang++
git clone -b master --single-branch https://github.com/turtlecoin/turtlecoin-crypto
cd turtlecoin-crypto
mkdir build
cd build
cmake ..
make

The following library files will be created in the build folder:

• libturtlecoin-crypto-static.a

Windows

Prerequisites

• Install Visual Studio 2017 Community Edition
• When installing Visual Studio, it is required that you install Desktop development with C++

Building

• From the start menu, open 'x64 Native Tools Command Prompt for vs2017'.

cd <your_turtlecoin-crypto_directory>
mkdir build
cd build
set PATH="C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\CMake\CMake\bin";%PATH%
cmake -G "Visual Studio 15 2017 Win64" ..

Note: If you have errors on this step about not being able to find the some libraries, you may need to update your cmake. Open 'Visual Studio Installer' and click 'Update'.

MSBuild turtlecoin-crypto.sln /p:Configuration=Release /m

The following library files will be created in the build/Release folder:

• turtlecoin-crypto-static.lib
• turtlecoin-crypto-shared.lib
• turtlecoin-crypto-shared.dll

Native Javascript & WASM

Prerequisites

You will need the following packages:

• CMake (2.8 or higher), make, and git.

Compiling

git clone -b master --single-branch https://github.com/turtlecoin/turtlecoin-crypto
cd turtlecoin-crypto
source ./build_js.sh

This script will install the necessary dependencies on your machine and then proceed to compile the library to Native Javascript and WASM.

The following library files will be created in the jsbuild folder:

• Native Javascript
  • turtlecoin-crypto.js
• WASM
  • turtlecoin-crypto-wasm.js

Thanks

Cryptonote Developers, Bytecoin Developers, Monero Developers, Forknote Project, TurtleCoin Community

Copypasta for license when editing files

Hi TurtleCoin contributor, thanks for forking and sending back Pull Requests. Extensive docs about contributing are in the works or elsewhere. For now this is the bit we need to get into all the files we touch. Please add it to the top of the files.

// Copyright (c) 2012-2017, The CryptoNote developers, The Bytecoin developers
// Copyright (c) 2014-2018, The Monero Project
// Copyright (c) 2018-2019, The TurtleCoin Developers
//
// Please see the included LICENSE file for more information.