Skip to main content

Manual Setup

! NOTE !

If you have previously installed a Findora validator instance on your current machine, then you should first delete your all the contents from your /data directory.

Manual Setup#

If you don't wish to run the automated setup script above, you can manually download binary files and configure your validator following the instructions below:

Download Validator Binaries and Pull Image#

Download the following files and pull image:

  • findorad: the node of findora network.

    • docker pull findoranetwork/findorad:latest
  • fn: Findora Node Setup (fn) is CLI tool with sub-commands necessary to setup a validator node and stake/unstake FRA

  • You can (optionally) run a Linux node via Windows Subsystem for Linux

  • Check that binaries have executable permissions set correctly

    • ex) chmod +x fn
  • Check that binary files are placed into one of your PATH directories

    • ex) mv fn /usr/local/bin/

Configure Local Node#

Set Environment Path Variables#

# ex)# For testnet:# export ROOT_DIR=/data/findora/testnet# For mainnet:# export ROOT_DIR=/data/findora/mainnetexport ROOT_DIR=<The data path of your node>

Initialize Findora Node and Create a Node Key#

Initializing Tendermint will create a node key (stored in a newly created ${ROOT_DIR}/tendermint/config/priv_validator_key.json file). The node key will be used to identity your node, sign blocks and perform other tendermint consensus-related tasks.

# Clean up old data, and Create ledger data directory, for examplesudo rm -rf ${ROOT_DIR}sudo mkdir -p ${ROOT_DIR}# For testnetdocker run --rm -v ${ROOT_DIR}/tendermint:/root/.tendermint findoranetwork/findorad:latest init --testnet || exit 1# For mainnetdocker run --rm -v ${ROOT_DIR}/tendermint:/root/.tendermint findoranetwork/findorad:latest init --mainnet || exit 1# Set correct permissionsudo chown -R `id -u`:`id -g` ${ROOT_DIR}/tendermint/

get snapshot#

download latest link and get url

# Testnetexport NAMESPACE=testnet# Mainnetexport NAMESPACE=mainnetwget -O "${ROOT_DIR}/latest" "https://prod-${NAMESPACE}-us-west-2-chain-data-backup.s3.us-west-2.amazonaws.com/latest"export CHAINDATA_URL=$(cut -d , -f 1 "${ROOT_DIR}/latest")wget -O "${ROOT_DIR}/snapshot" "${CHAINDATA_URL}"mkdir "${ROOT_DIR}/snapshot_data"tar zxvf "${ROOT_DIR}/snapshot" -C "${ROOT_DIR}/snapshot_data"mv "${ROOT_DIR}/snapshot_data/data/ledger" "${ROOT_DIR}/findorad"mv "${ROOT_DIR}/snapshot_data/data/tendermint/mainnet/node0/data" "${ROOT_DIR}/tendermint/data"rm -rf ${ROOT_DIR}/snapshot_data

Tips:

  • If you encounter a security issue error when trying to initialize findora node, you may need to manually approve its security privileges in your OS first. Then re-run the command again.

Generate Staking Key#

Generate a new, random pair of public and private keys for your node which will be used for FRA staking:

fn genkey > ${ROOT_DIR}/tmp.gen.keypair

View the contents of your tmp.gen.keypair file via the command below: cat ${ROOT_DIR}/tmp.gen.keypair An example of the file's content is below. Note: the pub_key and sec_key below are examples. Do not use them in your own node.

Wallet Address: fra1955hpj2xzkp4esd5928yhtp0l78ku8fkztvwcypvr8mk6x8tkn6sjsajunMnemonic: repair drink action brass term blur fat doll spoon thumb raise squirrel tornado engine tumble picnic approve elegant tube urge ghost secret seminar blameKey: {  "pub_key": "LSlwyUYVg1zBtCqOS6wv_49uHTYS2OwQLBn3bRjrtPU=",  "sec_key": "b0MGhK7xaRQHuhzFkaBhQ1o4GwTumJEWt1NQ7FChNwA="}

Tip : For convenience, you can import the sec_key (aka private key) into any Findora wallet (Win/Mac wallet, mobile wallet, CLI wallet tool, etc.), to more conveniently check and manage your FRA balances or to view historical transaction data for this wallet address. The private key or the mnemonic should never be shared with anyone , even people from the Findora community or development team . Our mods will never ask for this information . It would be advisable to keep a backup of your mnemonic on a separate storage ,should you ever need to restore it .

Store security key#

# For Testnetecho ${ROOT_DIR}/tmp.gen.keypair > ${ROOT_DIR}/testnet_node.key# For Mainnetecho ${ROOT_DIR}/tmp.gen.keypair > ${ROOT_DIR}/mainnet_node.key

Store Mnemonic Words into ${ROOT_DIR}/node.mnemonic#

For convenience in setting up your node via the fn tool, store your 24 mnemonic keywords (located inside tmp.gen.keypair) into ${ROOT_DIR}/node.mnemonic. To accomplish this, open the tmp.gen.keypair file and copy all of the 24 mnemonic keywords specific to your node. Then paste these 24 mnemonic keywords into the command below. Note: the 24 mnemonic keywords in the example command below (repair, drink, action, brass...) are examples. Do not use them.

# ex)# echo "repair drink action brass term blur fat doll spoon thumb raise squirrel tornado engine tumble picnic approve elegant tube urge ghost secret seminar blame" > ${ROOT_DIR}/node.mnemonicecho <24 mnemonic keywords> > ${ROOT_DIR}/node.mnemonic

Configure your validator node to use your newly generated public and private keys:

# Link the fn client to the Findora address# For testnet:fn setup -S https://prod-testnet.prod.findora.org# For mainnet:fn setup -S https://prod-mainnet.prod.findora.org# Connect your staking key (now stored inside `node.mnemonic`)# to fn. This allows fn to sign transactions on your behalf# ex)#     fn setup -O ${ROOT_DIR}/node.mnemonicfn setup -O <Path to the mnemonic of your node> || exit 1# Connect your Node Key to fn# ex)#     fn setup -K ${ROOT_DIR}/tendermint/config/priv_validator_key.jsonfn setup -K <path to validator key> || exit 1

Start or Upgrade Local Node#

# Stop your local container if necessarydocker rm -f findorad || exit 1# Start your validator containerdocker run -d \    -v ${ROOT_DIR}/tendermint:/root/.tendermint \    -v ${ROOT_DIR}/findorad:/tmp/findora \    -p 8669:8669 \    -p 8668:8668 \    -p 8667:8667 \    -p 26657:26657 \    -e EVM_CHAIN_ID=2153 \    --name findorad \    findoranetwork/findorad:latest node \    --ledger-dir /tmp/findora \    --tendermint-host 0.0.0.0 \    --tendermint-node-key-config-path="/root/.tendermint/config/priv_validator_key.json" \    --enable-query-service    --enable-eth-api-service

Logging for Node#

docker logs -f findorad

Check Local Node Status#

If the following commands return status messages without any errors, then your node has been successfully configured and started:

curl 'http://localhost:26657/status'curl 'http://localhost:8669/version'curl 'http://localhost:8668/version' # Only if you set the 'ENABLE_LEDGER_SERVICE'curl 'http://localhost:8667/version' # Only if you set the 'ENABLE_QUERY_SERVICE'