build.md

Building and running the application

Building the band application

If you want to build the band application in this repo to see the functionalities, Go 1.13.0+ is required .

Add some parameters to environment is necessary if you have never used the go mod before.

mkdir -p $HOME/go/bin
echo "export GOPATH=$HOME/go" >> ~/.bash_profile
echo "export GOBIN=\$GOPATH/bin" >> ~/.bash_profile
echo "export PATH=\$PATH:\$GOBIN" >> ~/.bash_profile
echo "export GO111MODULE=on" >> ~/.bash_profile
source ~/.bash_profile

Now, you can install and run the application.

# Clone the source of the tutorial repository
git clone https://github.com/bandprotocol/bandchain.git
cd bandchain/chain/

# Install the app into your $GOBIN
make install

# Now you should be able to run the following commands:
bandd help
bandcli help

Running test application locally

You can use the following script to generate a test environment to run BandChain locally. This will create the default genesis file with one validator, as well as some test accounts.

./scripts/generate_genesis.sh
cp ./docker-config/single-validator/priv_validator_key.json ~/.bandd/config/priv_validator_key.json
cp ./docker-config/single-validator/node_key.json ~/.bandd/config/node_key.json

Once done, you can optionally add data sources or oracle scripts to the genesis file using bandd.

bandd add-data-source ...
bandd add-oracle-script ...

You can now start the chain with bandd.

bandd start

On a separate tab, you should run the oracle daemon script to ensure your validator responds to oracle requests.

./scripts/start_yoda.sh validator

To send an oracle request to the chain, use bandcli.

bandcli tx oracle request [ORACLE_SCRIPT_ID] [ASK_COUNT] [MIN_COUNT] -c [CALLDATA] --from requester --gas auto --keyring-backend test --from requester