Ultimate Commands Guide V2

Ultimate cyberd CLI guide. Testnet: Euler-3

If something wrong…

First of all I would like to encourage you to use --help feature if you want to get better experience of using cyberdcli. This is really easy way to find all necessary commands with options and flags.

For example you can enter:

  docker exec cyberd cyberdcli --help

You should see this message:

  Command line interface for interacting with cyberd

  Usage:
    cyberdcli [command]

  Available Commands:
    status      Query remote node for status
    query       Querying subcommands
    tx          Transactions subcommands

    keys        Add or view local private keys

    rest-server Start LCD (light-client daemon), a local REST server

    version     Print the app version
    link        Create and sign a link tx
    help        Help about any command

  Flags:
        --chain-id string   Chain Id of cyberd node
    -e, --encoding string   Binary encoding (hex|b64|btc) (default "hex")
    -h, --help              help for cyberdcli
        --home string       directory for config and data (default "/root/.cyberdcli")
    -o, --output string     Output format (text|json) (default "text")
        --trace             print out full stack trace on errors

Help feature working as a stairs - you can use it with any command to find available options, subcommands and flags. For example lets explore query subcommands:

  docker exec cyberd cyberdcli query --help

now, you can see subcommand structure:

  Usage:
  cyberdcli query [command]

and available subcommands and flags:

  Available Commands:
  tendermint-validator-set Get the full tendermint validator set at given height
  block                    Get verified data for a the block at given height
  txs                      Search for all transactions that match the given tags.
  tx                       Matches this txhash over all committed blocks

  account                  Query account balance
  gov                      Querying commands for the governance module
  distr                    Querying commands for the distribution module
  staking                  Querying commands for the staking module
  slashing                 Querying commands for the slashing module

  Flags:
    -h, --help   help for query

  Global Flags:
        --chain-id string   Chain Id of cyberd node
    -e, --encoding string   Binary encoding (hex|b64|btc) (default "hex")
        --home string       directory for config and data (default "/root/.cyberdcli")
    -o, --output string     Output format (text|json) (default "text")
        --trace             print out full stack trace on errors

Alright, lets explore account subcommand:

  docker exec cyberd cyberdcli query account --help

Now we see all options available at this subcommands, namely, account address and flags:

  Usage:
  cyberdcli query account [address] [flags]

In most cases you need just two extra flags:

  --from=<your_key_name> \
  --chain-id=<testnet_chain_id>

That it. This is very useful ability for using cyberdcli and troubleshooting.

Glossary

Bandwidth - The recovered unit of your account. Used to complete transactions in the cyberd blockchain. The amount of your bandwidth calculates like:

your_cyb_tokens / all_cyb_tokens_in_cyberd * 2000*1000*100.

Messages cost is 500 (exclude link). Transaction consists of one or more messages m_1, m_2, ..., m_n. Transaction cost is 300 + c_1 + c_2 ... + c_n, where c_i - cost of m_i message. Full bandwidth regeneration time is 86400 blocks (24 hours)

commission - tokens that you’ve earned with validation. You can take them at any time.

illiquid tokens - non-transferable tokens that you’ve delegated to the validator. Delegation process duration - 1 block. Unbonding process, or taking back share - 3 weeks.

link - reference between CID key and CID value. Link message cost is 100*n, where n is quantity of links in message. Link finalization time is 1 block. New rank for CIDs of link will be recalculated at period from 100 to 200 blocks (from 100 to 200 seconds).

liquid tokens - transferable tokens in cyberd blockchain

local keystore - store with keys in you local machine

rewards - tokens that you’ve earned with the delegation. To reduce network loads all rewards storing in a pool. You can take your part of bounty at any time by commands at delegator section.

- the commission that validator get for the work. Must be fraction >0 and <=1

- delegator address. Starts with cyber most often coinciding with

- account address. Starts with cyber

- name of account in cybercli

- validator address. Starts with cybervaloper

- the part of illiquid tokens that you want to unbonding or redelegate. Must be fraction >0 and <=1

- version of testnet.

General commands

Show all validators

Return set of all active and jailed validators.

docker exec cyberd cyberdcli query staking validators --trust-node
Show chain status

Return general chain information

docker exec cyberd cyberdcli status --indent
Distribution params
docker exec cyberd cyberdcli query distr params --trust-node
The amount of outstanding rewards

Return the sum of rewards in a pool

docker exec cyberd cyberdcli query distr outstanding-rewards --trust-node
Staking params

Chain staking info

docker exec cyberd cyberdcli query staking params --trust-node
Staking pool
docker exec cyberd cyberdcli query staking pool --trust-node

Account management

Import an account by seed phrase and store it in local keystore
docker exec -ti cyberd cyberdcli keys add <your_key_name> --recover
Import an account by private key and store it in local keystore (private key could be your ETH private key)
docker exec -ti cyberd cyberdcli keys add import_private <your_key_name>
Create a new account
docker exec -ti cyberd cyberdcli keys add <your_key_name>
Show account information

Name, address and public key of current account

docker exec cyberd cyberdcli keys show <your_key_name>
Show account balance.

Return account number, balance, public key in 16 and sequence. >Don’t work if from current account no outgoing transactions. Issue in progress

docker exec cyberd cyberdcli query account <your_key_address>
List existing keys

Return all keys in cyberdcli

docker exec cyberd cyberdcli keys list
Delete account from cybercli
docker exec -ti cyberd cyberdcli keys delete <deleting_key_name>
Update account password
docker exec -ti cyberd cyberdcli keys update <your_key_name>
Send tokens
docker exec -ti cyberd cyberdcli tx send <to_address> <amount_cyb> \
  --from=<your_key_name> \
  --chain-id=<testnet_chain_id>
Linking content

Just ipfs hashes available as a CID

docker exec -ti cyberd cyberdcli link \
  --from=<your_key_name> \
  --cid-from=<key_phrase_to_link> \
  --cid-to=<content_that_you_want_to_link> \
  --chain-id=<testnet_chain_id>

Validator commands

Get all validators
docker exec cyberd cyberdcli query staking validators \
    --trust-node
The amount of commission

Available to withdraw validator commission.

docker exec cyberd cyberdcli query distr commission <operator_address>
State of current validator
docker exec cyberd cyberdcli query staking validator <operator_address>
Return all delegations to validator
docker exec cyberd cyberdcli query staking delegations-to <operator_address>
Edit commission in existing validator account
docker exec -ti cyberd cyberdcli tx staking edit-validator \
  --from=<your_key_name> \
  --commission-rate=<new_comission_rate_percentage> \
  --chain-id=<testnet_chain_id>
Withdraw commission for either a delegation
docker exec -ti cyberd cyberdcli tx distr withdraw-rewards <operator_address> \
  --from=<your_key_name> \
  --chain-id=<testnet_chain_id> \
  --commission
Edit site and description in existing validator account

Will be available at description section

docker exec -ti cyberd cyberdcli tx staking edit-validator \
  --from=<your_key_name> \
  --details="<description>" \
  --website=<your_website> \
  --chain-id=<testnet_chain_id>
Unjail validator previously jailed for downtime
docker exec -ti cyberd cyberdcli tx slashing unjail \
  --from=<your_key_name> \
  --chain-id=<testnet_chain_id>
Get info about redelegation process from validator
docker exec -ti cyberd cyberdcli query staking redelegations-from <operator_address>

Delegator commands

Return distribution delegator rewards according current validator
docker exec -ti cyberd cyberdcli query distr rewards <delegator_address> <operator_address>
Return delegator shares with current validator
docker exec -ti cyberd cyberdcli query staking delegation <delegator_address> <operator_address>
Return all delegations made from one delegator
docker exec -ti cyberd cyberdcli query staking delegations <delegator_address>
Return all unbonding delegatations from a validator
docker exec -ti cyberd cyberdcli query staking unbonding-delegations-from <operator_address>
Withdraw rewards for either a delegation
docker exec -ti cyberd cyberdcli tx distr withdraw-rewards <operator_address> \
  --from=<your_key_name> \
  --chain-id=<testnet_chain_id>
Withdraw all delegation rewards
docker exec -ti cyberd cyberdcli tx distr withdraw-all-rewards \
  --from=<your_key_name> \
  --chain-id=<testnet_chain_id>
Change the default withdraw address for rewards associated with an address
docker exec -ti cyberd cyberdcli tx distr set-withdraw-addr <your_new_address> \
  --from=<your_key_name> \
  --chain-id=<testnet_chain_id>
Delegate liquid tokens to a validator
docker exec -ti cyberd cyberdcli tx staking delegate <operator_address> <amount_cyb> \
  --from=<your_key_name> \
  --chain-id=<testnet_chain_id>
Redelegate illiquid tokens from one validator to another in absolute cyb value

3 weeks for redelegation. Amount must be less than already delegated.

docker exec -ti cyberd cyberdcli tx staking redelegate <old_operator_address> <new_operator_address> <amount_cyb>
  --from=<your_key_name> \
  --chain-id=<testnet_chain_id>
Redelegate illiquid tokens from one validator to another in percentages

3 weeks for redelegation.

docker exec -ti cyberd cyberdcli tx staking redelegate <old_operator_address> <new_operator_address> <shares_percentage>
  --from=<your_key_name> \
  --chain-id=<testnet_chain_id>
Unbond shares from a validator in absolute cyb value

3 weeks unbonding.

docker exec -ti cyberd cyberdcli tx staking unbond <operator_address> <amount_cyb>
  --from=<your_key_name> \
  --chain-id=<testnet_chain_id>
Unbond shares from a validator in percentages

3 weeks unbonding.

docker exec -ti cyberd cyberdcli tx staking unbond <operator_address> <shares_percentage>
  --from=<your_key_name> \
  --chain-id=<testnet_chain_id>
Get info about unbonding delegation process to current validator
docker exec -ti cyberd cyberdcli query staking unbonding-delegation <delegator_address> <operator_address>
Get info about unbonding delegation process to all unbonded validators
docker exec -ti cyberd cyberdcli query staking unbonding-delegation <delegator_address>
Get info about redelegation process from to current validator
docker exec -ti cyberd cyberdcli query staking redelegation <delegator_address> <old_operator_address> <new_operator_address>
Get info about all redelegation processes by one delegator
docker exec -ti cyberd cyberdcli query staking redelegations <delegator_address>