Starname Renew, Transfer and Delete
Once you have registered a starname, there are a few things you can do with it
Now that you can register your names and update your addresses, here are the advanced features of the names and domains.
Transfer
Starnames are transferrable. It means that when you own a starname on the IOV Name Service, you can transfer it to someone else (yes, you can sell it without going through an intermediary). Here is how to do it:
Starname transfer
I am the owner of superben*open_iov
. I can transfer any starname which I own to its --new-owner
with the command transfer-account
:
Domain transfer
If the starname is a domain, like *alpha
, I can transfer it with the command transfer-domain
In the case of a open domain, it has no effects on the starnames within the domain.
In the case of closed domain, it transfers all the starnames within it to the new-owner. However, the optional flag --transfer-flag
allows to select what happens to the starnames within a closed domain that is being transferred:
--transfer-flag value | Effect |
0 | TransferFlush: all starnames within the accounts are deleted |
1 | TransferOwned: Transfer ownership of the starnames of the domain's owner to the new-owner, All other starnames are unchanged |
2 (default value) | TransferResetNone: the starnames within the domain are unchanged |
Renewal
By registering starnames, you get their ownership for a period of time. The period can be checked in the configuration of the IOV Name Service
The periods are in nanoseconds (0.000000001 sec or 1e-9 sec), on the testnet it means
domain renewal: 300 sec = 5min
account renewal: 180 sec = 3min
After the starname valid_until date, the starname is expired and enters a grace period. When the starname is expired, the owner cannot replace targets or transfer the domain, the query does not return the associated addresses.
At any time, the owner still has the option to renew the starname to extend the valid_until date by the renewal period.
After the domain grace period is past, anyone can delete the domain and all the starnames within it.The grace period is also in the configuration, the exemple above we can see
domain grace period: 60 sec = 1min
account grace period: 60 sec = 1min
Renewal of closed domain and starnames within a closed domain
In the case of a Closed domain, renewing the domain renew all the starnames within it at the same time. The command is renew-domain
Renewal of open domain or starname within an open domain
In the case of open domain, renewing the domain does not renew the starnames within it. The renewal of the domain is the same as for a closed domain with the command renew-domain
To renew starnames within an open domain, the command is renew-account
The starname within an open domain can only be renewed if the open domain is still valid.
Removal
In the event the name owner wants to remove itself before the end of the grace period from the IOV Name Service, the name owner can delete their starname and all starnames within their closed domain.
Removal of a domain
The command is del-domain
. Before the end of the grace period of the domain, only the domain owner can do it. After the end of the grace period, anyone can do it. Deleting a domain delete all the starnames within it.
In the case of an open domain, the grace period of the domain is the latest grace period of all the starnames within it.
Removal of a starname
The owner of a starname which is not a domain (i.e. a starname with some string before the *) can delete their starname at any time. In the case of an open domain, anyone can delete a starname after the end of the grace period of the starname. The command is del-account
After removal, a starname is free to be registered again by anyone as if it was new.
Last updated