The token-unmint command in Mintlayer is used to 'unmint' existing tokens, effectively reducing the total supply. Unminting returns the specified amount of tokens to the issuer's control. Note that the wallet must own the tokens that are being unminted.
Note: To change the supply of tokens on the Mintlayer Blockchain, 50 ML tokens are required to be burned. This amount will be automatically subtracted from your balance by the wallet.
Note: To unmint new tokens, the token must have been issued with a non-fixed supply and must not be in a locked state.
token-unmint <TOKEN_ID> <AMOUNT>
<TOKEN_ID>: The identifier of the token for which tokens are to be unminted.<AMOUNT>: The amount of tokens to be unminted.-h, --help: Displays help information about the token-unmint command.Unminting Tokens:
To unmint 1,000 tokens of a token with ID tmltk1v6p95hcdft3fmg93kcp6k8r63mt769wh8huf3cmke2dvevyukckq0wcaqt, the command would be:
token-unmint tmltk1v6p95hcdft3fmg93kcp6k8r63mt769wh8huf3cmke2dvevyukckq0wcaqt 1000
This command reduces the total supply by 1,000 tokens, and these tokens are returned to the issuer's control.
This documentation explains how to use the token-unmint command to decrease the supply of a token. This function is crucial in managing the economics of the token, especially when adjustments in the total supply are necessary.