Skip to main content

Joining Testnets

In this section we will explain how to join testnets, where to find testnet configurations, and some scripts to make the process faster.


Oysternet validators is run by confio and not open for external validators. Musselnet is up as 2021/05/26 so it will become obsolote. The documentation here is for reference and will be updated when long living CosmWasm network is released. If you want to start practicing validator operation skills, join upcoming CosmWasm testnets. But they are very far from production environments. For near mainnet conditions, try validating in 30+ node networks, where network load is high.

Try Terra:

Or Juno:

Both Terra and Juno integrates CosmWasm smart contract engine.

Select Your Network#

You can find active and in-active testnet information such as configs and endpoints on CosmWasm/testnets.


Let's start rolling your node and start producing blocks in testnet environment.

Before starting, you can use CosmWasm/tesnets/devops that contains easy setup scripts for wasmd node, faucet, block explorer, lcd, nginx etc. Scripts below does the some thing as devops repo in essence, just more manual and excludes nginx and system supervisor. Feel free to use them. We use cosmovisor upgrade manager to handle network upgrades. Our installation scripts can help you with both setting up cosmovisor and wasmd: wasmd w/cosmovisor setup scripts

Manual Setup#

First of all make sure you followed the installation steps in build requirements section. You should have the required binaries. If you just want to copy and execute the scripts below, make sure to set up environment variables:

Below is the oysternet configuration.

export CHAIN_ID="oysternet-1"export TESTNET_NAME="oysternet-1"export WASMD_VERSION="v0.16.0"export CONFIG_DIR=".wasmd"export BINARY="wasmd"
export COSMJS_VERSION="v0.24.0"export GENESIS_URL=""export APP_CONFIG_URL=""export CONFIG_URL=""
export RPC=""export LCD=""export FAUCET=""
export COSMOVISOR_VERSION=v0.42.0export COSMOVISOR_HOME=/root/.wasmdexport COSMOVISOR_NAME=wasmd
# export SEED_NODE="c065c5ac440d1a9ba484a9a8b25c24d264b0a1a6@"

For running these scripts seamlessly, We recommend you to create a directory for CosmWasm tooling: mkdir CosmWasm && cd CosmWasm && export CW_DIR=$(pwd)

cd $CW_DIRgit clone wasmd# Check which version to use on 02-testnets repogit checkout $WASMD_VERSION# build wasmdmake build# add the executables to pathexport PATH="${PATH}:$(pwd)/build"

Initialize wallet using command:

# create walletwasmd keys add mywallet

Joining Live Testnets#

Run wasmd Full Node#

export MONIKER=new_validator# initialize wasmd configurationwasmd init $MONIKER
# get the 02-testnets genesis filecurl -sSL $GENESIS_URL > ~/.wasmd/config/genesis.json
# get app.toml. Minimum gas prices must be 0.025uspongecurl -sSL $APP_CONFIG_URL > ~/.wasmd/config/app.toml
# You need to configure p2p seeds# Either you can insert the seed addresses in $HOME/.wasmd/config/config.toml to "seeds"# For simplicity we will pass the seed ID and domain as argument# You can get the seed it using command:## Start wasmdwasmd start --p2p.seeds $SEED_NODE

Now you should be seeing blocks being replayed and your node is catching up with the testnet. This could take a while.

Become A Validator(optional)#


Command below is for demonstration, oysternet is not open for external validators.

In order to join the network as validator, you need some staking tokens. Please ask some in discord testnets channel

If you want to participate in active block building, you need some coins staked to your validators address.

For those interested in validator stack, here is a good reading source on validator architectures: certus one blog

Note: make sure your validator is synced before upgrading to validator

wasmd tx staking create-validator \  --amount=1000000ustar \  --pubkey=$(wasmd tendermint show-validator) \  --moniker=$MONIKER \  --chain-id=$CHAIN_ID \  --commission-rate="0.10" \  --commission-max-rate="0.20" \  --commission-max-change-rate="0.01" \  --min-self-delegation="1" \  --node $RPC \  --fees=5000usponge \  --from=mywallet

Run the Light Client Daemon#

With wasmd version v0.13 lcd client and node merged. To enable light client, change app.toml/api value to true.

Joining To Be Launched Testnets#


You need to have your address and informations defined in networks genesis file to join not yet launched testnets. Here is the script you can run to take care of it automatically.

cd $CW_DIR## Fork to your account and clone.## You cannot push directly to CosmWasm/02-testnets repogit clone<your-name>/02-testnetscd 02-testnetsgit checkout -b add-gen-acc-<validator-name>cd $TESTNET_NAME
wasmd keys add validator
wasmd add-genesis-account --home . $(wasmd keys show -a validator) 100000000ustar,100000000usponge
# please sort the genesis file, so the diff makes senseSORTED=$(jq -S . < ./config/genesis.json) && echo "$SORTED" > ./config/genesis.json
git add ./config/genesis.jsongit commit -m "Add <myvalidator> account to network genesis"git push
# Open PR to CosmWasm/02-testnets:master (

After the network is launched you can follow Joining Live Testnets.

Deploying Contracts to Testnet#

Getting Started section is the best reading source that teaches you the process of compiling and deploying contracts using a basic smart contract. If you are interested in developing your own contracts, after reading getting started tutorials head to Hijacking Escrow where you play around with the example escrow contract.