Documentation revision underway: please report issues on Discord or via GitHub.
Skip to content

Mac Install

This page contains instructions for installing the QRL 2.0 Testnet V2 on Mac.

NOTES

Tested on macOS Tahoe (Apple Silicon)

Install prerequisites

Ensure Xcode command line tools are installed:

bash
xcode-select --install

Install gobrew

bash
curl -sL https://raw.githubusercontent.com/kevincobain2000/gobrew/master/git.io.sh | bash

TIP

Be sure to add the installation path to your ~/.zshrc as instructed at the end and source ~/.zshrc or start a new terminal session.

Setup the environment

Make your QRL 2.0 directory. This is where the QRL 2.0 Testnet V2 repos, binaries, and data will be held.

bash
mkdir ~/zond-testnet/ && cd ~/zond-testnet/

Clone the go-qrl and qrysm GitHub repositories inside of the ~/zond-testnet/ directory, which we'll build from.

bash
git clone https://github.com/theQRL/go-qrl.git
git clone https://github.com/theQRL/qrysm.git

Build QRL 2.0 binaries

First, make sure you're using golang 1.25

bash
gobrew use 1.25

gqrl (Execution Layer)

gqrl is the official Golang execution layer implementation of the QRL 2.0 protocol.

bash
cd go-qrl/
make all
cp build/bin/gqrl ../
cd ..

Qrysm (Consensus Engine)

Qrysm is a Golang implementation of the QRL 2.0 Consensus specification, developed by The QRL and based on the Prysmatic Labs implementation of the Eth2 consensus specification.

bash
cd qrysm
go build -o=../qrysmctl ./cmd/qrysmctl
go build -o=../beacon-chain ./cmd/beacon-chain
go build -o=../validator ./cmd/validator

Next steps

After building the binaries, you'll want to run them, so head to our Running page.

Troubleshooting

While the instructions above are tested on fresh macOS installs, there will be a variety of system configurations that may cause issues.

If you encounter any other problems (or the solutions don't work for you), please open an issue.

Released under the MIT License.