Registering an account

This is to register a starname within an existing domain.

To register a starname within a domain which is already registered, the command is register-account :

iovnscli tx starname register-account --domain iov --name benji --from benkeys --fees 200000uiov

Value
--domain	the domain within which to register the starname
--name	the name of the starname before the *
--from	the address of the owner of the starname. For closed domain, it has to be the same address as the owner of the domain.
--fees	the iov tokens to be paid for the gas fees (in uIOV = 1e-6)

You can check that your starname has been properly registered to you account by resolving it:

iovnscli query starname resolve --starname benji*iov

{
  "account": {
    "domain": "iov",
    "name": "benji",
    "owner": "star10lalxx8ml63hs86j64nk76kucf72dsucluexz8",
    "valid_until": 1592556099,
    "resources": null,
    "broker": "",
    "metadata_uri": ""
  }
}

The valid format for account name can be checked with the configuration get-config command

iovnscli query configuration get-config
{
  "configuration": {
    "valid_account_name": "^[-_.a-z0-9]{1,64}$",
  }
}

Registration price

The register-account transaction cost depends on the length of the domain you want to register. You can see all the transaction cost parameters in

iovnscli query configuration get-fees | jq

where you will the the domain registration parameters:

  "fees": {
    "fee_coin_denom": "uiov",
    "fee_coin_price": "0.000000100000000000",
    "register_account_closed": "0.100000000000000000",
    "register_account_open": "0.100000000000000000",
  }

This means that to register an account in a closed domain, you look at the field register_account_closed. The price in token is then calculated by the formula

price = register_account_closed * 1000000 / fee_coin_price

For exemple, the account registration price in a closed when the fee_coin_price is 0.0000001 (Eur per uIOV) is 0.1 * 1000000 / 0.0000001 = 1 IOV token.

If the account is register within an open domain, then the parameter to use is register_account_open.

This is dynamically updated as the fee_coin_price will be updated to reflect the market value of the IOV token. The intent is to keep the price of the account registration stable vs a stable currency.

In addition of the registration price, the usual transaction gas fees need to be applied.