The token-issue-new command in Mintlayer is used to issue a new fungible token from scratch. Issuing a token establishes the total supply as per the issuer's settings. To make these tokens spendable, the issuer must "mint" the tokens, distributing them from the total supply.
Note: In order to issue a new Fungible Token on the Mintlayer Blockchain, 100 ML tokens are required to be burned. This amount will be automatically subtracted from your balance by the wallet.
After issuing a token, you must mint its supply using the
token-mintcommand.
token-issue-new <TOKEN_TICKER> <NUMBER_OF_DECIMALS> <METADATA_URI> <DESTINATION_ADDRESS> <TOKEN_SUPPLY> <IS_FREEZABLE>
<TOKEN_TICKER>: The ticker or symbol of the token being created.<NUMBER_OF_DECIMALS>: The maximum number of decimal places for the token.<METADATA_URI>: A URI with data related to the token, such as a website or media.<DESTINATION_ADDRESS>: The address that will receive the newly issued token.<TOKEN_SUPPLY>: The total supply of the token. This can be fixed, unlimited, or lockable.
fixed(amount): A specific, unchangeable total supply.unlimited: No limit to the amount of issuable tokens.lockable: The total supply can be altered until it is permanently locked.<IS_FREEZABLE>: Specifies whether the token can be centrally frozen for all users, useful for scenarios like migration. Possible values are not-freezable and freezable.-h, --help: Displays help information about the token-issue-new command.Issuing a New Token:
token-issue-new KLC 11 https://www.example.com/koalacoin.html tmt1qx8lr7fp7mehn6vgt5vuqytpy5c97fds6u89xhe5 fixed(42) freezable
This command issues a new token with the ticker 'KLC', having 11 decimal places, and associated with the provided metadata URI. The token has a fixed total supply of 42 and is freezable. It is issued to the address tmt1qx8lr7fp7mehn6vgt5vuqytpy5c97fds6u89xhe5.
Upon successful issuance, the wallet will display:
A new token has been issued with ID: tmltk1rfd7gmcr4sat9fgfuxj2qrxys3kqwzjtghczap42km347cc57hps8hgnvm
Note: The
TOKEN_SUPPLYargument offers flexibility in defining the supply model of the token. The optionsfixed,unlimited, andlockablecater to different issuance strategies and control mechanisms.