Registering a domain

This the the domain type by default.

To register a domain, simply use the domain register-domain command:
iovnscli tx starname register-domain --domain alpha --from benkeys --fees 200000uiov
Flag
Value
--domain
the name of the domain you want to register
--from
the star address of the owner of the domain
--fees
the amount of IOV token paid for the gas fees (in uIOV = 1e-6 IOV)
Optional Flag
Value
--fee-payer
the star address of the payer of the transaction fee. By default, it is the --from address
--type
open or closed. By default, closed
You can check that your starname has been properly registered to you by resolving it
iovnscli query starname resolve --starname *alpha
You may also query your domain with domain-info
iovnscli query starname domain-info --domain alpha
you will see something like
{
  "domain": {
    "name": "alpha",
    "admin": "star10lalxx8ml63hs86j64nk76kucf72dsucluexz8",
    "valid_until": 1592500822,
    "type": "closed",
    "broker": ""
  }
}
Field
Description
name
the domain name of the starname
admin
the star address of the owner of the domain
valid_until
the expiry date of the domain, in seconds from 1jan1970
type
open or closed
broker
the reference of the broker of the registration of the starname
​
The valid format for domain name can be checked with the configuration get-config command
iovnscli query configuration get-config
{
  "configuration": {
    "valid_domain_name": "^[-a-z0-9]{4,32}$"
  }
}
​
​
Registration price
The register-domain 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_domain_1": "1000.000000000000000000",
    "register_domain_2": "500.000000000000000000",
    "register_domain_3": "200.000000000000000000",
    "register_domain_4": "100.000000000000000000",
    "register_domain_5": "50.000000000000000000",
    "register_domain_default": "7.000000000000000000",
    "register_open_domain_multiplier": "3.000000000000000000",
  }
​
This means that to register a closed domain of length <n>, you look at the field register_domain_<n>. The price in token is then calculated by the formula
price = register_domain_<n> * 1000000 / fee_coin_price
For exemple, a domain registration price of a domain of size 3 when the fee_coin_price is 0.0000001 (Eur per uIOV) is 200 * 1000000 / 0.0000001 = 2000 IOV token.
If the domain size is 6 or more, then the parameter to use is register_domain_default.
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 domain registration stable vs a stable currency.
The registration price of an open domain is the registration price of a closed domain multiplied by register_open_domain_multiplier.
In addition of the registration price, the usual transaction gas fees need to be applied.
​
​

Registering a Starname

Registering an account

Last modified 2yr ago

Flag	Value
--domain	the name of the domain you want to register
--from	the star address of the owner of the domain
--fees	the amount of IOV token paid for the gas fees (in uIOV = 1e-6 IOV)

Optional Flag	Value
--fee-payer	the star address of the payer of the transaction fee. By default, it is the --from address
--type	open or closed. By default, closed

Field	Description
name	the domain name of the starname
admin	the star address of the owner of the domain
valid_until	the expiry date of the domain, in seconds from 1jan1970
type	open or closed
broker	the reference of the broker of the registration of the starname