# 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 |
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 |
# 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
← Tendermint Tx →