pastel-lite

Build Setup

0. Clone the repository

git clone git@github.com:pastelnetwork/pastel-lite.git
cd pastel-lite

Get submodules

git submodule update --init --recursive

1. Install cmake, if not already installed

Linux

sudo apt install cmake

Mac

brew install cmake

Windows

choco install cmake

2. Install vcpkg

git clone https://github.com/Microsoft/vcpkg.git

Linux or Mac

cd vcpkg
./bootstrap-vcpkg.sh

Windows

cd vcpkg
bootstrap-vcpkg.bat

The last command output will be similar to:

CMake projects should use: "-DCMAKE_TOOLCHAIN_FILE=/Users/name/vcpkg/scripts/buildsystems/vcpkg.cmake"

Remember that line, you will need it later.

Add vcpkg to your PATH environment variable.

export PATH=$PATH:/Users/name/vcpkg

3. Install Emscripten

Linux or Mac

git clone https://github.com/emscripten-core/emsdk.git
cd emsdk
./emsdk install latest
./emsdk activate latest

Windows

git clone https://github.com/emscripten-core/emsdk.git
cd emsdk
emsdk install latest
emsdk activate latest

Add Emscripten to your PATH environment variable.

export PATH=$PATH:/Users/name/emsdk/upstream/emscripten/

4. Install 3rd party packages with vcpkg - for native build ONLY

cd pastel-light
vcpkg install

vcpkg uses packages described in the vcpkg.json Currently they are:

• libsodium

5. Build native library libpastel and test tool pastel_lite

mkdir build-native-debug
cd build-native-debug
cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_TOOLCHAIN_FILE=<path-to-vcpkg>/scripts/buildsystems/vcpkg.cmake
cmake --build .

Replace <path-to-vcpkg> with the path from step 2.

6. Build WebAssembly library libpastel-wasm

mkdir build-wasm-debug
cd build-wasm-debug
emcmake cmake .. -DCMAKE_BUILD_TYPE=Debug
emmake cmake --build .

7. Build python bindings

7.1 Build the docker image

docker build -t pastel_python_build -f Dockerfile.python_build .

7.2 Build the python bindings

docker run pastel_python_build /src/build_python_package_in_docker.sh

7.3 Copy the python package to the host

docker cp pastel_python_build_container:/src/python_bindings/wheelhouse/libpastelid-0.3.2-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl . 

7.4 Upload the python package to pypi

twine upload libpastelid-0.3.2-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Appendix

Install Clang/LLVM/libc++ 18

sudo add-apt-repository "deb http://apt.llvm.org/jammy/ llvm-toolchain-jammy-18 main"
sudo add-apt-repository "deb-src http://apt.llvm.org/jammy/ llvm-toolchain-jammy-18 main"
sudo apt-get install libllvm-18-ocaml-dev libllvm18 llvm-18 llvm-18-dev llvm-18-doc llvm-18-examples llvm-18-runtime
sudo apt-get install libc++-18-dev libc++abi-18-dev
sudo apt-get install clang-18 clang-tools-18 clang-18-doc libclang-common-18-dev libclang-18-dev libclang1-18 clang-format-18 python3-clang-18 clangd-18 clang-tidy-18