💷💷
Token Aliases
Token Alases enable for defining friendly on-chain metadata for various cryptocurrencies created on and/or deposited to KIRA. Governance set of KIRA is responsible for associating metadata with tokens and thus guaranteeing integrity of information for various frontend applications.
Tokens Metadata
NAME
DEFINITION
symbol
The currency code or otherwise short abbreviation of a "single" token in its default denomination. For example: KEX, ETH, BTC, DOT, ATOM ....
name
Full, explicit name of the currency, for example: Bitcoin, Ethereum...
icon
URL to .SVG image (256kB max) representing currency or network logo
decimals
Number 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
denoms
Array of possible denomination names of the token, such as ukex, satoshi, cent ...
NOTE: Proposals can be raised using via CLI sekaid tx tokenscommand. The --help flag can be used to discover further options. To raise a certain proposal a dedicated permission is required. For example to submit UpsertTokenAliasmessage a PermCreateUpsertTokenAliasProposal (14) permission must be assigned to the account creating said proposal. For example to vote on the UpsertTokenAlias a PermCreateUpsertTokenAliasProposal (25) is needed. To find available proposal types and corresponding to them permissions required to submit or vote see Proposals documentation.
Commands Examples
Updating Token Alias
# Updating Token Aliases via proposal # CLI sekaid tx tokens proposal-upsert-alias --from validator --keyring-backend=test \ --symbol="TEST" \ --name="Test TestCoin" \ --icon="http://example.com/icon.svg" \ --decimals=8 \ --denoms="test" \ --title="Upsert Test TestCoin icon URL link" \ --description="Initial Setup From KIRA Manager" \ --chain-id=$NETWORK_NAME --fees=100ukex --yes --broadcast-mode=async --output=json
Bash
Query Token Aliases
# CLI sekaid query tokens all-aliases --output=json --home=$SEKAID_HOME | jq # KM showTokenAliases
Bash