worm miner setup workflow

This is workflow to set up Shai-Hulud worm miner on fresh Ubuntu server

Ref (official guide): https://github.com/worm-privacy/shaihulud

preparation

• Use machine with 32+GB RAM (official guide suggests 16 but I've had miner fail generating proofs with less)
• Strong enough CPU, 4+ cores (I use Ryzen 7)
• Sepolia ETH (get from faucets or buy)

update and install basic dependencies & tools

apt update && apt upgrade -y
apt install -y htop sudo tmux curl wget vim git make build-essential unzip cmake bc

Install rust and cargo

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source $HOME/.cargo/env
echo 'source $HOME/.cargo/env' >> ~/.bashrc

Verify

rustc --version
cargo --version

Install pkg-config

apt install -y pkg-config

Verify

which pkg-config  # Should output /usr/bin/pkg-config
echo $PATH        # Ensure /usr/bin is included
pkg-config --version  # e.g., 1.8.1

Install rapidsnark dependencies

sudo apt install -y libgmp-dev libomp-dev libsodium-dev nasm m4 nlohmann-json3-dev

Verify

dpkg -l | grep -E 'libgmp-dev|libomp-dev|libsodium-dev|nasm|m4|nlohmann-json3-dev'

Install OpenSSL libraries

apt install -y libssl-dev

Set correct headers & env variables

export OPENSSL_DIR=/usr
export PKG_CONFIG_PATH=/usr/lib/pkgconfig:/usr/lib/x86_64-linux-gnu/pkgconfig:/usr/local/lib/pkgconfig
export OPENSSL_LIB_DIR=/usr/lib/x86_64-linux-gnu
export OPENSSL_INCLUDE_DIR=/usr/include/x86_64-linux-gnu/openssl
echo 'export OPENSSL_DIR=/usr' >> ~/.bashrc
echo 'export PKG_CONFIG_PATH=/usr/lib/pkgconfig:/usr/lib/x86_64-linux-gnu/pkgconfig:/usr/local/lib/pkgconfig' >> ~/.bashrc
echo 'export OPENSSL_LIB_DIR=/usr/lib/x86_64-linux-gnu' >> ~/.bashrc
echo 'export OPENSSL_INCLUDE_DIR=/usr/include/x86_64-linux-gnu/openssl' >> ~/.bashrc
source ~/.bashrc

Verify

pkg-config --modversion openssl  # e.g., 3.0.13
pkg-config --libs openssl        # e.g., -lssl -lcrypto
pkg-config --cflags openssl      # e.g., -I/usr/include/x86_64-linux-gnu/openssl

Install libclang and clang

apt install -y clang libclang-dev

Set env variables

export LIBCLANG_PATH=/usr/lib/llvm-18/lib
export CLANG_PATH=/usr/bin/clang-18
echo 'export LIBCLANG_PATH=/usr/lib/llvm-18/lib' >> ~/.bashrc
echo 'export CLANG_PATH=/usr/bin/clang-18' >> ~/.bashrc
source ~/.bashrc

Verify

clang --version  # e.g., Ubuntu clang version 18.1.3
ls $LIBCLANG_PATH/libclang.so  # Should exist
which $CLANG_PATH  # Should output /usr/bin/clang-18

Clone and download worm miner params

git clone https://github.com/worm-privacy/miner /miner
cd /miner
make download_params

Build and install worm

cargo install --path .

Finished! 🪱

Follow official guide for burn, participate and claim instructions.

worm-miner info --network sepolia --private-key 0x_YOUR_PRIV_KEY

BONUS 🪱🪱

Automatic sepolia ETH --> BETH burning

curl -sSL https://raw.githubusercontent.com/oxngon/worm-miner/main/auto-ethburner.sh -o auto-ethburner.sh && chmod +x auto-ethburner.sh

Usage

./auto-ethburner.sh <private_key> <eth_per_burn> <total_loops>

E.g.

./auto-ethburner.sh 0x_your_private_key_here 1 5