Setting Starname info

Once you have registered a starname, you can associate address to it so that others can know how to reach you.

The command to associate info to your starname is replace-resources
iovnscli tx starname replace-resources --domain iov --name benji --from benkeys --fees 2000000uvoi --src ~/my_targets.json
Flags
Description
--domain
the domain part of the starname to edit
--name
the name part of the starname to edit (if not empty)
--src
the json file with the data to associate. The json needs to be in the format of a list of pairs of [{"uri":..., "resource":...}]. The max number of addresses per starname is set in the configuration resources_max and is 10 at launch. More details below.
--from
the signer of the transaction, which needs to be the owner of the starname
--fees
the gas fees for the transaction
The --src file might typically look like this:
[
       {
         "uri": "asset:btc",
         "resource": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq"
       },
       {
         "uri": "asset:eth",
         "resource": "0xd5af805d5429ec16b4059d76854d25a4bb1b7ba9"
       },
       {
         "uri": "asset:atom",
         "resource": "cosmos1y6yvdel7zys8x60gz9067fjpcpygsn62ae9x46"
       }
]
You can check that the info has been correctly updated by resolving the starname
iovnscli query starname resolve --starname benji*delta
{
  "account": {
     "domain": "delta",
     "name": "benji",
     "owner": "star10lalxx8ml63hs86j64nk76kucf72dsucluexz8",
     "valid_until": 4746278435,
     "targets": [
       {
         "uri": "asset:btc",
         "resource": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq"
       },
       {
         "uri": "asset:eth",
         "resource": "0xd5af805d5429ec16b4059d76854d25a4bb1b7ba9"
       },
       {
         "uri": "asset:atom",
         "resource": "cosmos1y6yvdel7zys8x60gz9067fjpcpygsn62ae9x46"
       }
     ],
     "broker": "",
     "metadata_uri": ""
   }
} 
Targets format
For the resolver to work, the target for a coin or asset needs to be composed of two parts:
the URI: a string type and an stringidentifier separated by a :, type:identifier.The first string is the type of identifier provided by the second string. At launch, the IOV Name Service resolves only the type asset but you can input any type in the URI. A URI of type asset is expecting an identifier within the Symbol list​
the resource: this is the string returned by the resolver when asked for this specific URI. This is typically an address working with the coin identified in the URI.
The valid format for targets can be checked with the configuration get-config command
iovnscli query configuration get-config
{
  "configuration": {
    "valid_uri": "^[-a-z0-9A-Z:]+$",
    "valid_resource": "^[a-z0-9A-Z]+$",
    "resources_max": 10,
  }
}
​

Registering an account

Next - FOR DEVELOPERS

Starname Renew, Transfer and Delete

Last updated 8 months ago

Flags	Description
--domain	the domain part of the starname to edit
--name	the name part of the starname to edit (if not empty)
--src	the json file with the data to associate. The json needs to be in the format of a list of pairs of [{"uri":..., "resource":...}]. The max number of addresses per starname is set in the configuration `resources_max` and is 10 at launch. More details below.
--from	the signer of the transaction, which needs to be the owner of the starname
--fees	the gas fees for the transaction