Witness Server for XRPL Sidechains

Table of contents

• Documentation
• Build guide
  • Dependencies
    • Conan inclusion
    • Other dependencies
  • Build steps

Documentation

• XRPL Sidechains concept
• Cross bridge transactions
• XRPL-Standards documentation

Build guide

Dependencies

Conan inclusion

This project depends on conan (v1.5 and higher, v2.0 not supported) to build it's dependencies. See conan doc to install conan.

Other dependencies

• C++20 compiler (gcc >=11, clang >=13)
• cmake - at least 3.20

Build and run

1. Create a build directory. For example: build
2. Change to that directory.
3. Configure conan (once before very 1st build)

conan profile update settings.cppstd=20 default
conan profile update settings.compiler.libcxx=libstdc++11 default
conan profile update settings.arch=x86_64 default

4. Run conan. The command is:

conan install -b missing -s build_type=Release --output-folder . ..

5. Create a build file (replace .. with the appropriate directory). 2 pckage system supported - deb and rpm:

• 5.1 Default. If you have rippled installed by your packet manager - cmake will try to find it. If nothing found - this setup will download rippled and build it.

cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=build/generators/conan_toolchain.cmake -DPKG=deb ..

• 5.2 If you have rippled build from source you can use it

cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=build/generators/conan_toolchain.cmake -DRIPPLE_SRC_DIR=/home/user/repo/rippled -DRIPPLE_BIN_DIR=/home/user/repo/rippled/build-release -DPKG=deb ..

6. Build the project:

make -j $(nproc)

7. Run

./xbridge_witnessd --conf /home/user/repo/config.json

Check for config examples in documenation