Registering an account

To register a starname within a domain which is already registered, the command is register-account :
1
iovnscli tx starname register-account --domain iov --name benji --from benkeys --fees 200000uiov
Copied!
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:
1
iovnscli query starname resolve --starname benji*iov
2
​
3
{
4
  "account": {
5
    "domain": "iov",
6
    "name": "benji",
7
    "owner": "star10lalxx8ml63hs86j64nk76kucf72dsucluexz8",
8
    "valid_until": 1592556099,
9
    "resources": null,
10
    "broker": "",
11
    "metadata_uri": ""
12
  }
13
}
Copied!
​
The valid format for account name can be checked with the configuration get-config command
1
iovnscli query configuration get-config
2
{
3
  "configuration": {
4
    "valid_account_name": "^[-_.a-z0-9]{1,64}quot;,
5
  }
6
}
7
​
Copied!
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 
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_account_closed": "0.100000000000000000",
5
    "register_account_open": "0.100000000000000000",
6
  }
7
​
8
​
Copied!
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.
​

Registering a domain

Setting Starname info

Last modified 1yr ago

Copy link

Contents

Registration price