Skip to content

Latest commit

 

History

History
63 lines (41 loc) · 1.83 KB

README.md

File metadata and controls

63 lines (41 loc) · 1.83 KB

devnet

Runs a Lotus daemon and miner, ready to be used for dealbot's integration tests.

To run it locally, install ./cmd/devnet and the lotus binaries into your $PATH, and simply run one of the integration tests - it should start devnet automatically.

Building and installing Lotus

git clone https://github.com/filecoin-project/lotus
cd lotus
git checkout master # or whichever version
make debug
sudo make install # or "cp lotus lotus-*" into your $PATH

Running devnet on a remote host

The instructions below set up devnet on an Ubuntu machine. For example, we followed them for [email protected].

As root:

# disable and stop the existing lotus services
systemctl disable lotus-daemon lotus-miner
systemctl stop lotus-daemon lotus-miner

# this is owned by another user possibly; delete it
sudo rm -rf /var/tmp/filecoin-*

# build-essential plus the list from filecoin docs
apt install build-essential mesa-opencl-icd ocl-icd-opencl-dev gcc git bzr jq pkg-config curl clang build-essential hwloc libhwloc-dev wget
snap install --classic go # apt has older versions

Then, as the regular user, build and install lotus as per the instructions above.

Finally:

git clone https://github.com/filecoin-project/dealbot
cd dealbot
go install ./cmd/devnet
cd ..

export LOTUS_PATH=/tmp/devnet-lotus
export LOTUS_MINER_PATH=/tmp/devnet-miner
mkdir -p $LOTUS_PATH $LOTUS_MINER_PATH

Finally, to run devnet, we run the command below inside the default tmux session:

devnet

You can attach to it via tmux a, or create it via just tmux.

Note that, when restarting devnet, you probably have to empty the directories to avoid errors:

rm -rf $LOTUS_PATH/* $LOTUS_MINER_PATH/* localnet.json

When running, you can simply:

source devnet/tunnel.sh

and then run the dealbot, e.g. via the integration tests.