Local Testnet

This document provides instructions for running a single node network on your local machine and then submitting your first few transactions to that network using the command line.

Install qwoynd

If you have not already done so, first you'll need to install qwoynd.

Quickstart

If you would like to learn about the setup process and manually set up a single node network, skip to the next section. Alternatively, you can run the following quickstart script:

~/QWOYN/scripts/start_testnode.sh

The script provides two command-line options for specifying a keyring-backend (-k), and the name of the blockchain (-c). For example, to use the os keyring-backend with the name demo:

~/QWOYN/scripts/start_testnode.sh -k os -c demo

After running the quickstart script, you can skip to Start Node.

Create Accounts

In this section, you will create two test accounts. You will name the first account "validator" and the second account "delegator". You will create both accounts using the test backend, meaning both accounts will not be securely stored and should not be used in a production environment. When using the test backend, accounts are stored in the home directory (more on this in the next section).

Create the validator account:

qwoynd keys add validator --keyring-backend test

Create the delegator account:

qwoynd keys add delegator --keyring-backend test

After running each command, information about each account will be printed to the console. The next step will be to initialize the node.

Initialize Node

Initializing the node will create the config and data directories within the home directory. The config directory is where configuration files for the node are stored, and the data directory is where the data for the blockchain is stored. The default home directory is ~/.qwoyn.

Initialize the node:

qwoynd init node --chain-id test

In this case, "node" is the name (or "moniker") of the node, and "test" is the chain ID. Feel free to change these values, but make sure to use the same value for chain-id in the following steps.

Update Genesis

When the node was initialized, a genesis.json file was created within the config directory. In this section, you will be adding two genesis accounts (accounts with an initial token balance) and a genesis transaction (a transaction that registers the validator account in the validator set).

Update the native staking token to uqwoyn:

For Mac OS:

sed -i "" "s/stake/uqwoyn/g" ~/.qwoynd/config/genesis.json

For Linux variants:

sed -i "s/stake/uqwoyn/g" ~/.qwoynd/config/genesis.json

Add the validator account to genesis.json:

qwoynd add-genesis-account validator 5000000000uqwoyn --keyring-backend test

Add the delegator account to genesis.json:

qwoynd add-genesis-account delegator 2000000000uqwoyn --keyring-backend test

Create the genesis transaction:

qwoynd genesis gentx validator 1000000uqwoyn --chain-id test --keyring-backend test

Add the genesis transaction to genesis.json:

qwoynd genesis collect-gentxs

Now that you have updated the genesis.json file, you are ready to start the node. Starting a node with a new genesis file will create a new blockchain.

Set the minimum gas price

We need to update the minimum gas price before we can start the node. Open the ~/.qwoyn/config/app.toml file and set the value as:

minimum-gas-prices = "0uqwoyn"

Start Node

Well, what are you waiting for?

Start the node:

qwoynd start

You should see logs printed in your terminal with information about services starting up, followed by blocks being produced and committed to your local blockchain.

Test Commands

Now that you have a single node network running, you can open a new terminal window and interact with the node using the same qwoyn binary. Let's delegate some uqwoyn tokens to the validator and then collect the rewards.

Get the validator address for the validator account:

qwoynd keys show validator --bech val --keyring-backend test

Using the validator address, delegate some uqwoyn tokens:

qwoynd tx staking delegate [validator_address] 10000000uqwoyn --from delegator --keyring-backend test --chain-id test

In order to query all delegations, you'll need the address for the delegator account:

qwoynd keys show delegator --keyring-backend test

Using the address, query all delegations for the delegator account:

qwoynd q staking delegations [delegator_address]

Query the rewards using the delegator address and the validator address:

qwoynd q distribution rewards [delegator_address] [validator_address]

Withdraw the rewards:

qwoynd tx distribution withdraw-all-rewards --from delegator --keyring-backend test --chain-id test

Check the account balance:

qwoynd q bank balances [delegator_address]

You have successfully delegated uqwoyn tokens to the validator account from the delegator account and then collected the rewards.