Commercio.network Documentation

# Becoming a validator

Once you've properly set up a full node, if you wish you can become a validator node and start in earning by validating the chain transactions.

Before you start, we recommend that you run the command

cncli config chain-id $CHAINID

In this way you can omit the flag --chain-id="$CHAINID" in every command of the cncli

# Requirements

If you want to become a Commercio.network validator you need to:

  1. Be a full node.
    If you are not, please follow the full node installation guide.

  2. Own enough tokens.
    To become a validator you need two wallets: one with at least one token to create the validator and another with 50,000 tokens to delegate to the validator node.

TIP

If you have any problems with the procedure try to read the section Common errors.

# 1. Add wallet key

Inside the testnet you can use the Ledger, but you can also use the wallet software with the cncli.
However, if you wish to use Ledger, please add the --ledger flat to any command.

WARNING

Please remember to copy the 24 words seed phrase in a secure place.
They are your mnemonic and if you loose them you lose all your tokens and the whole access to your validator.

Create the first wallet with the following command

cncli keys add $NODENAME
# Enter a password that you can remember

The output of the command will provide the 24 words that are the mnemonic.

If you are using the Ledger device you must first connect it to your computer, start the cosmos application and run the command

cncli keys add $NODENAME --ledger
# Enter a password that you can remember

In this case the 24 words are not provided because they have already been configured in the Ledger initialization

Copy your public address. It should have the format did:com:<data>.

The second wallet must be requested through a message on the Telegram group (opens new window). With a private message will be sent the information of the second wallet.

ATTENTION: from now on we will refer to the value of your public address of the first wallet as <your pub addr creator val> notation. We will refer to the second wallet as <your pub addr delegator> notation.

# 2. Get the tokens

To get your tokens inside our mainnet or testnet, you are required to purchase them using an exchange or having received a black card.
The black card is the wallet <your pub addr delegator>

Read Add wallet key to create your own <your pub addr creator val>.

Use the ledger or another hsm to make a recovery from 24 words for the second wallet <your pub addr delegator> with the black card.

Send one token to the <your pub addr creator val> wallet using the following command

WARNING

This transaction is expected to be done with an hsm as Ledger. If you are using a Ledger add the --ledger flag.

cncli tx send \
<your pub addr delegator> \
<your pub addr creator val> \
1110000ucommercio \
--fees=10000ucommercio  \
--chain-id="$CHAINID" \
-y

Once you've been confirmed the successful transaction, please check using the following command:

cncli query account <your pub addr creator val> --chain-id $CHAINID

The output should look like this:

- denom: ucommercio
  amount: "1000000"

# 3. Create a validator

Once you have the tokens, you can create a validator. If you want, while doing so you can also specify the following parameters

  • --moniker: the name you want to assign to your validator. Spaces and special characters are accepted
  • --details: a brief description about your node or your company
  • --identity: your Keybase (opens new window) identity
  • --website: a public website of your node or your company

The overall command to create a validator is the following:

# Testnet

export VALIDATOR_PUBKEY=$(cnd tendermint show-validator)

# Mainnet

If you have a kms you got the value of the public address in the node from the keys registered in your hsm. If you have it put that value in the pubkey transaction parameter for creating the validator

export VALIDATOR_PUBKEY="did:com:valconspub1zcjduepq592mn5xucyqvfrvjegruhnx15rruffkrfq0rryu809fzkgwg684qmetxxs"

WARNING

Warning: a did address can create one and only one validator and a validator can have one and only one creation address

cncli tx staking create-validator \
  --amount=1100000ucommercio \
  --pubkey=$VALIDATOR_PUBKEY \
  --moniker="$NODENAME" \
  --chain-id="$CHAINID" \
  --identity="" \
  --website="" \
  --details="" \
  --commission-rate="0.10" \
  --commission-max-rate="0.20" \
  --commission-max-change-rate="0.01" \
  --min-self-delegation="1" \
  --from=<your pub addr creator val> \
  --fees=10000ucommercio \
  -y
##Twice input password required

The output should look like this:

height: 0
txhash: C41B87615308550F867D42BB404B64343CB62D453A69F11302A68B02FAFB557C
codespace: ""
code: 0
data: ""
rawlog: '[]'
logs: []
info: ""
gaswanted: 0
gasused: 0
tx: null
timestamp: ""

# 4. Delegate tokens to the validator

# Confirm your validator is active

Please confirm that your validator is active by running the following command:

cncli query staking validators --chain-id $CHAINID | fgrep -B 1 $VALIDATOR_PUBKEY

The output should look like this:

  operatoraddress: did:com:valoper1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  conspubkey: did:com:valconspub1zcjduepq592mn5xucyqvfrvjegruhnx15rruffkrfq0rryu809fzkgwg684qmetxxs

Copy the value of operatoraddress.

You can also verify that the validator is active by browsing the

Commercio.network explorer Testnet (opens new window).
Commercio.network explorer Mainnet (opens new window).

If you see your validator in the list click on its name.
The validator tab should have the value Operator. That value is your operatoraddress

Register the value of operatoraddress.

export OPERATOR_ADDRESS="did:com:valoper1zcjx15rruffkrfq0rryu809fzkgwg684qmetxxs"

# Delegate tokens

Once received the second wallet must be loaded on the ledger or keyring through the command

cncli keys add <name of second wallet> --recover

where <name of second wallet> is an arbitrary name.
When requested, the 24 keywords must be entered

If you are using the Ledger device you must first connect it to your computer, start the cosmos application and run the command

cncli keys add <name of second wallet> --ledger
# Enter a password that you can remember

In this case the 24 words are not provided because they have already been configured in the Ledger initialization

Now you can delegate 50,000 tokens to the validator node

WARNING

This transaction is expected to be done with an hsm as a Ledger device . If you are using a Ledger add the --ledger flag.

cncli tx staking delegate \
  $OPERATOR_ADDRESS \
  50000000000ucommercio \
  --from <your pub addr delegator> \
  --chain-id="$CHAINID" \
  --fees=10000ucommercio \
  -y

The output should look like this:

height: 0
txhash: 027B85834DA5486085BC56FFD2759443EFD3101BD1023FA9A681262E5C85A845
codespace: ""
code: 0
data: ""
rawlog: '[]'
logs: []
info: ""
gaswanted: 0
gasused: 0
tx: null
timestamp: ""

Testnet You should now see your validator with 50001 staked tokens inside the Commercio.network explorer testnet (opens new window) Mainnet You should now see your validator with 50001 staked tokens inside the Commercio.network explorer mainnet (opens new window)

TIP

Congratulations, you are now a Commercio.network validator 🎉

# Note

If you want to make transactions with the Nano Ledger from another machine a full node must be created locally or a full node must be configured to accept remote connections.
Edit the .cnd/config/config.toml file by changing from

laddr = "tcp://127.0.0.1:26657"

to

laddr = "tcp://0.0.0.0:26657"

and restart your node

systemctl restart cnd

and use the transaction this way

cncli tx staking delegate \
  <validator-addr> \
  50000000000ucommercio \
  --from <your pub addr delegator> \
  --node tcp://<ip of your fulle node>:26657 \
  --chain-id="$CHAINID" \
  --fees=10000ucommercio \
  --ledger \
  -y

# Common errors

# Account does not exists

# Problem

If I try to search for my address with the command

cncli query account did:com:1sl4xupdgsgptr2nr7wdtygjp5cw2dr8ncmdsyp --chain-id $CHAINID

returns the message

ERROR: unknown address: account did:com:1sl4xupdgsgptr2nr7wdtygjp5cw2dr8ncmdsyp does not exist

# Solution

Check if your node has completed the sync. On https://testnet.commercio.network you can view the height of the chain at the current state

Use the command

journal -u cnd -f | egrep " cnd+.*Committed state"

to check the height that reach your node

# Failed validator creation

# Problem

I executed the validator creation transaction but I don't appear in validators explorer page.

# Solution

It may be that by failing one or more transactions the tokens are not sufficient to execute the transaction.

Send more funds to your <your pub addr creator val> and repeat the validator creation transaction

# DB errors

# Problem

Trying to start the rest server or query the chain I get this error

panic: Error initializing DB: resource temporarily unavailable

# Solution

Maybe cnd and/or cncli services have been left active. Use the following commands

systemctl stop cnd
systemctl stop cncli
pkill -9 cnd
pkill -9 cncli

and repeat the procedure

← Handling a validator →