LUKSO Wagyu KeyGen

LUKSO Wagyu KeyGen is a GUI application providing the functionality from the LUKSO-deposit-cli in a user friendly way. It is a React app running in Electron. See src/electron/ for the simple electron app and src/react/ for where the magic happens.

This GUI is a fork of the Wagyu Key-Generation Tool

Download LUKSO Wagyu KeyGen on the release page

Wagyu Audit by HashCloak Original Wagyu Key Gen Audit Report

Environment Configuration & Dependencies

Prior to running LUKSO Wagyu KeyGen a few dependencies need to be installed.

Init the submodule.

NOTE: after the submodule is initialized, please always use

git pull --recurse-submodules

to pull in changes, otherwise the submodule will not be updated but worse yet will get committed and built with the wrong version.

git submodule init
git submodule update

Ubuntu 20.04 and later

Execute all those commands in your terminal to setup your dev environment.

sudo apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

sudo apt install -y build-essential nodejs git python3-distutils python3-dev

PATH="$HOME/.local/bin:$PATH"

curl -sSL https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python3 get-pip.py
pip3 install pyinstaller

sudo npm install -g yarn

git clone https://github.com/stake-house/wagyu-key-gen
cd wagyu-key-gen

yarn install
yarn buildcli

Ubuntu 22.04

Execute all those commands in your terminal to build a distribution for release.

sudo apt update && sudo apt -y upgrade

sudo add-apt-repository -y ppa:deadsnakes/ppa
sudo apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

sudo apt install -y python3.10-dev python3.10-distutils zlib1g-dev build-essential nodejs git

PATH="$HOME/.local/bin:$PATH"

curl -sSL https://bootstrap.pypa.io/get-pip.py -o get-pip.py
alias python3=python3.10
echo -e "\nalias python3=python3.10" >> ~/.bash_aliases
python3 get-pip.py
pip3 install pyinstaller

sudo corepack enable

git clone https://github.com/stake-house/wagyu-key-gen
cd wagyu-key-gen

yarn install
yarn build
yarn buildcli
yarn dist

Windows 10/11

• Download and install Node.js and npm from https://nodejs.org/en/download/ (Use LTS version and 64-bit .msi Installer).
  • At the screen named Tools for Native Modules, make sure to check the option named Automatically install the necessary tools.. It will install chocolatey, Python 3 and VS build tools. Follow the instructions until the end.
• Open a command prompt window as admin (Press ⊞ Win+R, type cmd, hold Ctrl + Shift and press ↵ Enter)
  • Execute this command to install git. Follow the instructions on screen.

choco install git.install

• Open a normal command prompt window (Press ⊞ Win+R, type cmd and press ↵ Enter).
  • Execute those commands to upgrade pip, install pyinstaller, Cython, install yarn, clone the repository and install the required packages.

python -m pip install --upgrade --user pip
python -m pip install --user pyinstaller
python -m pip install --user Cython
set PATH=%APPDATA%\python\Python310\Scripts;%PATH%

npm install -g yarn

git clone https://github.com/stake-house/wagyu-key-gen
cd wagyu-key-gen

yarn install
yarn buildcliwin

macOS 10.15.1 and later

Execute all those commands in your terminal to setup your dev environment. You may be prompted to install "command line developer tools" at some point and please do it.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/$USER/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

git --version

// If git is not found, run the following
brew install git

python3 --version
pip3 --version

// If either python3 or pip3 are not found, run the following
brew install python3

brew install node
pip3 install pyinstaller
npm install -g yarn

git clone https://github.com/stake-house/wagyu-key-gen
cd wagyu-key-gen

yarn install
yarn buildcli

Start Wagyu Key Gen

Run the following commands in the repository directory:

• yarn build
  • yarn build:watch (will reload build on changes)
  • In order to get them to show in the app press ctrl+r or cmd+r once the app is started.
• yarn start

To run diagnostics

To open dev tools when in Wagyu Key Gen use Ctrl + Shift + I

Bundling

We use electron-builder to create executable bundles for Wagyu Key Gen. Run the following to create a bundle:

• yarn run build
• yarn run buildcli (or yarn run buildcliwin on Windows)
• yarn run dist

Your assets will be in the dist/ folder.

Design

Current designs: https://www.figma.com/file/jcF78fVjndvM2hOPvifl0N/Wagyu-Key?node-id=1%3A4

Funding

If you would like to help us with funding this project, you can donate with our Gitcoin grant or you can send your funds directly to wagyutools.eth.

Support

Reach out to the EthStaker community:

• on discord
• on reddit

License

GPL