Keryx Node

A lightweight and high-performance node implementation for the Keryx network, running at 10 blocks per second (10 BPS).

Keryx is the first BlockDAG ecosystem purpose-built for decentralized AI inference.

By combining high-throughput GHOSTDAG architecture with optimistic verifiability, we are building a sovereign, censorship-resistant intelligence infrastructure.

KeryxHash: Unique Proof-of-Work

Keryx utilizes KeryxHash, a specialized PoW algorithm evolved from kHeavyHash, specifically optimized for GPU efficiency and network security:

ASIC Isolation: Implementation of KERYX_MATRIX_SALT, a 32-byte domain-specific salt that isolates the network from existing Kaspa ASICs.

WaveMix Technology: A 4-round ARX (Add-Rotate-Xor) post-processing step designed to increase GPU register pressure, favoring consumer hardware.

Security Mutation: Re-engineered consensus validation layers to ensure unique block signing.

---

Installation

Building on Linux

1. Install general prerequisites

   sudo apt install curl git build-essential libssl-dev pkg-config

2. Install Protobuf (required for gRPC)

   sudo apt install protobuf-compiler libprotobuf-dev #Required for gRPC

3. Install the clang toolchain (required for RocksDB and WASM secp256k1 builds)

   sudo apt-get install clang-format clang-tidy \
   clang-tools clang clangd libc++-dev \
   libc++1 libc++abi-dev libc++abi1 \
   libclang-dev libclang1 liblldb-dev \
   libllvm-ocaml-dev libomp-dev libomp5 \
   lld lldb llvm-dev llvm-runtime \
   llvm python3-clang

4. Install the rust toolchain

   If you already have rust installed, update it by running: rustup update

5. Install wasm-pack

   cargo install wasm-pack

6. Install wasm32 target

   rustup target add wasm32-unknown-unknown

7. Clone the repo

   git clone https://github.com/Keryx-labs/keryx-node
   cd keryx-node

8. Build the node

   cargo build --release

Building on Windows

1. Install Git for Windows or an alternative Git distribution.

2. Install Protocol Buffers and add the bin directory to your Path

3. Install LLVM-15.0.6-win64.exe

   Add the bin directory of the LLVM installation (C:\Program Files\LLVM\bin) to PATH

   set LIBCLANG_PATH environment variable to point to the bin directory as well

   IMPORTANT: Due to C++ dependency configuration issues, LLVM AR installation on Windows may not function correctly when switching between WASM and native C++ code compilation (native RocksDB+secp256k1 vs WASM32 builds of secp256k1). Unfortunately, manually setting AR environment variable also confuses C++ build toolchain (it should not be set for native but should be set for WASM32 targets). Currently, the best way to address this, is as follows: after installing LLVM on Windows, go to the target bin installation directory and copy or rename LLVM_AR.exe to AR.exe.

4. Install the rust toolchain

   If you already have rust installed, update it by running: rustup update

5. Install wasm-pack

   cargo install wasm-pack

6. Install wasm32 target

   rustup target add wasm32-unknown-unknown

7. Clone the repo

   git clone https://github.com/Keryx-labs/keryx-node
   cd keryx-node

8. Build the node

   cargo build --release

Building on Mac OS

1. Install Protobuf (required for gRPC)

   brew install protobuf

2. Install llvm.

   The default XCode installation of llvm does not support WASM build targets. To build WASM on MacOS you need to install llvm from homebrew (at the time of writing, the llvm version for MacOS is 16.0.1).

   brew install llvm

   NOTE: Homebrew can use different keg installation locations depending on your configuration. For example:

   • /opt/homebrew/opt/llvm -> /opt/homebrew/Cellar/llvm/16.0.1
   • /usr/local/Cellar/llvm/16.0.1

   To determine the installation location you can use brew list llvm command and then modify the paths below accordingly:

   % brew list llvm
   /usr/local/Cellar/llvm/16.0.1/bin/FileCheck
   /usr/local/Cellar/llvm/16.0.1/bin/UnicodeNameMappingGenerator
   ...

   If you have /opt/homebrew/Cellar, then you should be able to use /opt/homebrew/opt/llvm.

   Add the following to your ~/.zshrc file:

   export PATH="/opt/homebrew/opt/llvm/bin:$PATH"
   export LDFLAGS="-L/opt/homebrew/opt/llvm/lib"
   export CPPFLAGS="-I/opt/homebrew/opt/llvm/include"
   export AR=/opt/homebrew/opt/llvm/bin/llvm-ar

   Reload the ~/.zshrc file

   source ~/.zshrc

3. Install the rust toolchain

   If you already have rust installed, update it by running: rustup update

4. Install wasm-pack

   cargo install wasm-pack

5. Install wasm32 target

   rustup target add wasm32-unknown-unknown

6. Clone the repo

   git clone https://github.com/Keryx-labs/keryx-node
   cd keryx-node

7. Build the node

   cargo build --release

Running the Node

Start a node

./target/release/keryxd

Common options

./target/release/keryxd --help

Connect with us

• Website: keryx-labs.com
• X (Twitter): @Keryx_Labs
• Discord: Join the Community

---

"Intelligence is the message. Keryx is the messenger."