Join Chiado

:::important Chiado is our new and improved testnet. Please make sure to transition all your testing and development processes here. Also note that on Chiado we've changed the denomination to award. :::

Overview

This tutorial explains how to run the Warden binary, wardend, and join the Chiado testnet.

Prerequisites

Before you start, complete the following prerequisites:

• We recommend running public testnet nodes on machines with the following characteristics:

  • at least 4 cores

  • 16GB of RAM

  • 300GB of disk space

• Install Go 1.22.3 or later.

• If you wish to build the binary from the source code, install just 1.34.0 or later.

1. Install

To be able to interact with the node, install wardend (the Warden binary) using the script below. There are two ways to do it:

Option 1: Use the prebuilt binary

1. Download the binary for your platform from the release page and unzip it. The archive contains the wardend binary.

2. Navigate to the directory containing the binary and initialize the node:

   ./wardend init my-chain-moniker

   :::tip When interacting with the node, you should add the path to the binary before wardend commands. :::

Option 2: Use the source code

1. Clone the repository and navigate to the root directory:

   git clone --depth 1 --branch v0.5.2 https://github.com/warden-protocol/wardenprotocol
   cd wardenprotocol

   The binary is located in /wardenprotocol/build.

2. Use our just script to build the wardend binary and install it to the $GOPATH/bin directory. Then initialize the node.

   just wardend build
   just wardend install
   wardend init my-chain-moniker

   Alternatively, you can skip installation to $GOPATH/bin:

   just wardend build
   build/wardend init my-chain-moniker

   :::tip When interacting with the node, you should add the path to the binary before wardend commands. If you install the binary to $GOPATH/bin, it's not required. :::

2. Configure

To configure wardend, do the following:

1. Prepare the genesis.json file:

   cd $HOME/.warden/config
   rm genesis.json
   wget https://raw.githubusercontent.com/warden-protocol/networks/main/testnets/chiado/genesis.json

   These commands will remove the $HOME/.warden/genesis.json file and replace it with the correct version.

2. In the app.toml file, set the mandatory options: the minimum gas price and a list of seeds nodes.

   sed -i 's/minimum-gas-prices = ""/minimum-gas-prices = "250000000000000award"/' app.toml

   sed -i 's/seeds = ""/seeds = "2d2c7af1c2d28408f437aef3d034087f40b85401@52.51.132.79:26656"/' config.toml

   These commands will update the minimum-gas-prices and seeds fields in $HOME/.warden/app.toml. Alternatively, you can adjust the file manually.

3. Set up the state sync

:::tip This step is recommended but optional. :::

To speed up the initial sync, you can use the state sync feature. This will allow you to download the state at a specific height from a trusted node and after that only download the blocks from the network.

You'll need to use a trusted RPC endpoint – for example, the following:

https://rpc.chiado.wardenprotocol.org

1. From this RPC endpoint, you can get the trusted block height and hash:

   export SNAP_RPC_SERVERS="https://rpc.chiado.wardenprotocol.org:443,https://rpc.chiado.wardenprotocol.org:443"
   export LATEST_HEIGHT=$(curl -s "https://rpc.chiado.wardenprotocol.org/block" | jq -r .result.block.header.height)
   export BLOCK_HEIGHT=$((LATEST_HEIGHT - 2000))
   export TRUST_HASH=$(curl -s "https://rpc.chiado.wardenprotocol.org/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash)

2. Check that all variables have been set correctly:

   echo $LATEST_HEIGHT $BLOCK_HEIGHT $TRUST_HASH

   The output should be similar to this:

   70694 68694 6AF4938885598EA10C0BD493D267EF363B067101B6F81D1210B27EBE0B32FA2A

3. Add the state sync configuration to the config.toml file:

   sed -i.bak -E "s|^(enable[[:space:]]+=[[:space:]]+).*$|\1true| ; \
   s|^(rpc_servers[[:space:]]+=[[:space:]]+).*$|\1\"$SNAP_RPC_SERVERS\"| ; \
   s|^(trust_height[[:space:]]+=[[:space:]]+).*$|\1$BLOCK_HEIGHT| ; \
   s|^(trust_hash[[:space:]]+=[[:space:]]+).*$|\1\"$TRUST_HASH\"|" $HOME/.warden/config/config.toml

   These commands will update the [statesync] section in $HOME/.warden/config.toml. Alternatively, you can adjust the file manually.

4. Start the node

Now you can start the node using the following command:

wardend start

If needed, add the path to the binary before the command:

path-to-binary/wardend start

It'll connect to persistent peers provided and start downloading blocks. You can check the logs to see the progress.

Next steps

After joining Chiado, you can take these steps:

• If you want to create a validator, follow the instructions in the Create a validator section.

• To learn more about wardend commands for interacting with the node, see Node commands.

• Don't forget to join our community in Discord.