Token

Token module allows you to manage assets on IRIS Hub

Available Commands

Name	Description
issue	Issue a new token
edit	Edit an existing token
transfer	Transfer the ownership of a token
mint	Mint tokens to a specified address
burn	Burn some tokens
swap-fee	Swap one token with another token
token	Query a token by symbol
tokens	Query tokens by owner
fee	Query the token related fees
params	Query the token related params
total-burn	Query the total amount of all burn tokens.

iris tx token issue

Issue a new token

iris tx token issue [flags]

Flags:

Name, shorthand	Type	Required	Default	Description
--name	string	Yes		Name of the newly issued token, limited to 32 unicode characters, e.g. "IRIS Network"
--symbol	string	Yes		The symbol of the token, length between 3 and 8, alphanumeric characters beginning with alpha, case insensitive
--initial-supply	uint64	Yes		The initial supply of this token. The amount before boosting should not exceed 100 billion.
--max-supply	uint64		1000000000000	The hard cap of this token, total supply can not exceed max supply. The amount before boosting should not exceed 1000 billion.
--min-unit	string			The alias of minimum uint
--scale	uint8	Yes		A token can have a maximum of 18 digits of decimal
--mintable	boolean		false	Whether this token could be minted(increased) after the initial issuing

Issue a token

iris tx token issue \
    --name="Kitty Token" \
    --symbol="kitty" \
    --min-unit="kitty" \
    --scale=0 \
    --initial-supply=100000000000 \
    --max-supply=1000000000000 \
    --mintable=true \
    --from=<key-name> \
    --chain-id=<chain-id> \
    --fees=<fee>

Send tokens

You can send any tokens you have just like sending iris

Send tokens

iris tx bank send [from_key_or_address] [to_address] [amount] [flags]

iris tx token edit

Edit an existing token

iris tx token edit [symbol] [flags]

Flags:

Name	Type	Required	Default	Description
--name	string			The token name, e.g. IRIS Network
--max-supply	uint64		0	The max supply of the token
--mintable	bool		false	Whether the token can be minted, default to false

max-supply should not be less than the current total supply

Edit Token

iris tx token edit <symbol> --name="Cat Token" --max-supply=100000000000 --mintable=true --from=<key-name> --chain-id=<chain-id> --fees=<fee>

iris tx token transfer

Transfer the ownership of a token

iris tx token transfer [symbol] [flags]

Flags:

Name	Type	Required	Default	Description
--to	string	Yes		The new owner address

Transfer Token Owner

iris tx token transfer <symbol> --to=<to> --from=<key-name> --chain-id=<chain-id> --fees=<fee>

iris tx token mint

Mint tokens to a specified address

iris tx token mint [symbol] [flags]

Flags:

Name	Type	Required	Default	Description
--to	string			Address to which the token will be minted, default to the owner address
--amount	uint64	Yes	0	Amount of the tokens to be minted

iris tx token swap-fee

Swap one token with another token. For example, this feature can be used to exchange IRIS for ERIS.

iris tx token swap-fee [fee_paid] --to [reciever]

Flags:

Name	Type	Required	Default	Description
--to	string	Yes		Address to which the token will be swaped

Mint Token

iris tx token mint <symbol> --amount=<amount> --to=<to> --from=<key-name> --chain-id=<chain-id> --fees=<fee>

iris tx token burn

Burn some tokens

iris tx token burn [symbol] [flags]

Flags:

Name	Type	Required	Default	Description
--amount	uint64	Yes	0	Amount of the tokens to burnt

Burn Token

iris tx token burn <symbol> --amount=<amount> --from=<key-name> --chain-id=<chain-id> --fees=<fee>

iris query token token

Query a token by symbol

iris query token token [denom] [flags]

Query a token

iris query token token <denom>

iris query token tokens

Query tokens by the owner which is optional

iris query token tokens [owner] [flags]

Query all tokens

iris query token tokens

Query tokens with the specified owner

iris query token tokens <owner>

iris query token fee

Query the token related fees, including token issuance and minting

iris query token fee [symbol] [flags]

Query fees of issuing and minting a token

iris query token fee kitty

iris query token params

Query token module params

iris query token params [flags]

Query token module params

iris query token params

iris query token total-burn

Query the total amount of all burn tokens

iris query token total-burn [flags]

Query the total amount of all burn tokens

iris query token total-burn