4.5 KiB
| title | category |
|---|---|
| How do I setup an isolated regtest network to test LBRY? | developer |
Prerequisites
To begin setting up the network, there are a few things you need.
Note that you need a Linux distribution to run all this. A virtual machine is fine.
virtual environment
First up it's a good idea to create a Python virtual environment. This requires
you to have a functional python2.7 setup, with the Python package manager pip
installed. To create a new virtual environment in a folder lbry-env, run this:
virtualenv -p /usr/bin/python2.7 lbry-env To enter the environment, run
source lbry-env/bin/activate.
lbrycrd
You need to download a build of lbrycrd from here, no installation required.
To configure lbrycrd you to create a file at ~/.lbrycrd/lbrycrd.conf,
containing the following.
rpcuser=test
rpcpassword=test
rpcport=18332
rpcallowip=0.0.0.0/0
regtest=1
dnsseed=0
upnp=0
server=1
txindex=0
daemon=0
lbry
Download source from here, and run the following inside the environment.
cd lbry
pip2 install -r requirements.txt
pip2 install .
lbryum
To install lbryum, first download the source from here. To install it, run the following inside the virtual environment.
cd lbryum
pip2 install -r requirements.txt
pip2 install .
lbryum-server
To install lbryum-server you first need to install the package leveldb. After
that, download the source from here, and run the following inside the
environment.
cd lbryum-server
pip2 install -r requirements.txt
If you're not running debian/*buntu, or a derivative of those, you need to
edit the configure file a bit. On line 11, remove the apt-get line and
manually install the required packages. On line 48, change adduser to
useradd and on the same line, change --disabled-password to -p !.
sudo ./configure
sudo python2 setup.py install
When installed, append the following to the /etc/lbryum.conf file.
[lbrycrdd]
lbrycrdd_host = localhost
lbrycrdd_port = 18332
lbrycrdd_user = test
lbrycrdd_password = test
[network]
type = lbrycrd_regtest
Setup
Wallet backup
To start off with, if you've already used LBRY on your machine, you need to
backup the wallet by copying the folders ~/.lbrynet and ~/.lbryum, then
delete them to start from fresh. Run
mkdir ~/.lbryum; touch ~/.lbryum/blockchain_headers to create a new empty
file there. If you don't do this, it'll try downloading the current blockchain
headers from a server.
lbrycrd
To run the lbrycrd daemon, run the following in the lbrycrd folder.
./lbrycrdd
To generate blocks, run ./lbrycrd-cli generate <num_of_blocks>
You'll need to generate some blocks to get the network going.
Start off by generating 100.
lbryum
To run the server, run lbryum-server.
You also need to run the lbryum daemon, lbryum daemon start -v
After that, you need to setup lbryum. Run the following two commands to make it use the local server in regtest mode.
lbryum setconfig default_servers '{ "localhost": { "t": "50001" }}'
lbryum setconfig chain 'lbrycrd_regtest'
At this point it's a good idea to restart everything. Generate some more
blocks, get a wallet address by lbrynet-cli wallet_new_address, and then
send some credits to your wallet by doing
./lbrycrd-cli sendtoaddress <address> <num_of_credits>
lbry
You can now run lbrynet-daemon, and it should connect to the lbryum server.
If you want to publish a claim inside the regtest network, you need to edit
reflect_uploads on line 177 in lbry/lbrynet/conf.py from True to False.
Shutdown
To stop the network, run lbrynet-cli daemon_stop, lbryum daemon stop, and
kill the lbryum-server and lbrycrdd processes. If you want to use your
wallet and the official servers again, backup the new regtest wallet, and
replace it with your own.
Note
If something goes wrong and you get a "Block not found" error, remember to
delete /var/lbryum-server before trying again.
Cheatsheet
Required processes in the correct order
lbrycrdd -regtest -server -printtoconsole
lbryum-server
lbryum daemon start -v
lbrynet-daemon
Generate blocks
lbrycrd-cli generate 5
Get a wallet address
lbrynet-cli wallet_new_address
Send credits from lbrycrd to your wallet
lbryrd-cli sendtoaddress <address> <num_of_credits>