Skip to main content

Token Aliases Registrar

Overview

The Token Aliases enables the creation of friendly on-chain metadata for various cryptocurrencies on the KIRA network. The network governance is responsible for associating metadata with tokens, ensuring the integrity of this information for use in frontend applications. This makes it easier to identify and track different cryptocurrencies on the network.

Parameters

note

Removal of a token from the token aliases registry will automatically disable it by setting its Token Rates Registrar properties stake_token and fee_token properties to false.

NAMEDESCRIPTION
symbolThe currency code or otherwise short abbreviation of a "single" token in its default denomination. For example: KEX, ETH, BTC, DOT, ATOM ....
nameFull, explicit name of the currency, for example: Bitcoin, Ethereum...
iconURL to .SVG image (256kB max) representing currency or network logo
decimalsNumber of currency decimals in the base of 10. For example value 3 would imply that the smallest unit of currency in it's default denomination would be 0.001
denomsArray of possible denomination names of the token, such as satoshi, cent ...

CLI Syntax & Examples

note

Each CLI command and proposal process in KIRA requires specific permissions. These permissions must be added to the account's whitelist or obtained as sudo permissions for direct changes. Refer to the Roles & Permissions documentation for more details.

note

$SIGNER represents the transaction signer's account name or address. For instructions on setting common flags as environment variables, such as $FLAGS_TX and $FLAGS_QR, see the CLI Guide page.

Transactions

upsert-aliasCreate or modify token aliases with sudo permission.

Upsert Token Alias With Sudo Permission

The upsert-alias CLI command allows accounts with sudo permission to create or modify token aliases without a proposal.

Flags

  • $SYM: The symbol of the token.
  • $NAME: The name of the token alias.
  • $ICON: The icon URL of the token.
  • $DEC: The number of decimals of the token.
  • $DENOM: The denom values of the token.
sekaid tx tokens upsert-alias \
--from=$SIGNER $FLAGS_TX \
--symbol=$SYM --name=$NAME --icon=$ICON --decimals=$DEC --denoms=$DENOM