Registering a domain
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}$"}}
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.
