Local Development Network Setup
This guide walks through how to deploy a local blockchain instance for software development and testing purposes. Alternatively, developers can also develop and test on Anvil Testnet.
#first command needs to be run as root, rest as your normal user
wget https://go.dev/dl/go1.18.3.linux-amd64.tar.gz
sudo su
rm -rf /usr/local/go && tar -C /usr/local -xzf go1.18.3.linux-amd64.tar.gz
#exit root now
exit
#add to path. For more permanent you should add this line to bottom of your ~/.profile
export PATH=$PATH:/usr/local/go/bin
#check go version
go version
If already installed, please update to 1.59 or newer
rustup update
Ubuntu
MacOS
sudo apt update && \
sudo apt upgrade -y && \
sudo apt install -y build-essential libleveldb-dev libssl-dev pkg-config clang libclang-dev librocksdb-dev
brew install openssl leveldb
Findora blockchain can run on both MacOS or Linux. The commands below will build all required binaries to start a local Findora blockchain.
git clone -b v0.3.19-release https://github.com/FindoraNetwork/platform &&
cd platform &&
make build_release
Please make sure to add all below 3 binaries to your
$PATH
. By default, they will be copied to ~/.cargo/bin/
which should already be in your $PATH
.stt
: The tool to initialize Findora blockchain.abcid
: Findora core protocol.tendermint
: Tendermint consensus engine.
Findora devnet tools are written in Python3 and use
toml-cli
to manipulate configuration files. Install Python3 if not already installed. Also, install toml-cli
using the command below:pip3 install toml-cli
and then copy newly installed
toml
cli tool to /usr/local/bin
to make it visiblecp /Library/Python/3.x/site-packages/toml /usr/local/bin
Inside your
platform
directory, execute make devnet
in the terminal.
Name | Description |
---|---|
node0 | The validator |
node1 | The fullnode |
Faucet | The key pair that holds FRA |
The local blockchain can be stopped and restarted anytime during development and tests.
- Stop Blockchain:
./tools/devnet/stopnodes.sh
- Restart Blockchain:
./tools/devnet/startnodes.sh
- Start Over:
make devnet
again.

URL | Purpose |
---|---|
connects to Web3 HTTP | |
connects to Web3 WebSocket |
- Problem 1
- Error Message:
make build_release fails with go:linkname must refer to declared function or variable
- Solution
- Update your golang.org/x/sys# go to platform/tools/tendermint run following to updatego get -u golang.org/x/sys
- Problem 2
.findora
file is missing
- Solution
- manually add
.findora
to your home directory (i.e. directory~
)
Last modified 6mo ago