Registering a domain
This the the domain type by default.
To register a domain, simply use the domain register-domain command:
1
iovnscli tx starname register-domain --domain alpha --from benkeys --fees 200000uiov
Copied!
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
1
iovnscli query starname resolve --starname *alpha
Copied!
You may also query your domain with domain-info
1
iovnscli query starname domain-info --domain alpha
Copied!
you will see something like
1
{
2
"domain": {
3
"name": "alpha",
4
"admin": "star10lalxx8ml63hs86j64nk76kucf72dsucluexz8",
5
"valid_until": 1592500822,
6
"type": "closed",
7
"broker": ""
8
}
9
}
Copied!
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
1
iovnscli query configuration get-config
2
{
3
"configuration": {
4
"valid_domain_name": "^[-a-z0-9]{4,32}quot;
5
}
6
}
7
8
Copied!

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
1
iovnscli query configuration get-fees | jq
Copied!
where you will the the domain registration parameters:
1
"fees": {
2
"fee_coin_denom": "uiov",
3
"fee_coin_price": "0.000000100000000000",
4
"register_domain_1": "1000.000000000000000000",
5
"register_domain_2": "500.000000000000000000",
6
"register_domain_3": "200.000000000000000000",
7
"register_domain_4": "100.000000000000000000",
8
"register_domain_5": "50.000000000000000000",
9
"register_domain_default": "7.000000000000000000",
10
"register_open_domain_multiplier": "3.000000000000000000",
11
}
12
Copied!
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.
Last modified 1yr ago
Copy link