Hedera Mint Token Tool

Introduction

The Hedera Mint Token Tool is a process tool plugin that allows you to mint fungible and non-fungible tokens (NFTs) on the Hedera Distributed Ledger Technology (DLT).

Get started

Prerequisites

• Ensure you have a minter account with sufficient balance to cover transaction fees.
• Understand the difference between fungible and non-fungible tokens (NFTs).

Where to get the plugin

Download the Hedera Mint Token Tool from the JogetOSS GitHub repository.

How to install

1. Click Download on this plugin screen (It will be a .jar file).
2. Go to your Joget localhost or server. In the Joget Console, go to Admin Bar > Systems Settings > Manage Plugins and click the Upload Plugins button.
3. Under Upload Plugin, select the plugin .jar file you downloaded and click Upload.
4. Depending on the plugin type, you can now view your new plugin in your form, List, or UI Builder.
5. Remember to uninstall the old plugin before uploading a new version.
6. The Joget Knowledge Base has more information on managing and developing plugins.

Configure hedera mint token tool properties

You must configure several properties to use the Hedera Mint Token Tool effectively. Below is a breakdown of the properties you must set:

• Operator ID: This corresponds to your Hedera Operator ID. For further details, see the Hedera Default Backend Configuration.
• Operator Key: Enter your Hedera Operator Key to create an account.
• Network Type: Choose Previewnet, Testnet, or Mainnet based on your environment.

Token properties

• Form: Select a form from which to retrieve minting data.

  All fields from the selected form will be available for field mapping in the below sections.

Minting account

• Account ID: The account to mint the token.
  This account is set as the treasury account by default.
• Account Mnemonic Phrase: This is the minter account's secret key, which is required to perform actions with the account. Only accepts a Hash Variable that points to the minter's encrypted stored mnemonic phrase.
  
  Caution: Ensure that the Account Mnemonic Phrase is always kept secure. Anyone with access to this phrase has complete control over the account and can cause irreparable damage.

Minting configuration

• Token ID Handling: Select the action to perform:
  • Create New Token
  • Mint More Token

Token ID handling (create new token)

This configuration tab will only appear when Token ID Handling property is Create New Token.

• Mint Type: Select the type of token to mint:
  • Fungible Token
  • Non-fungible Token
• Token Name: Specify a name for the token (e.g., MyFirstToken).
• Token Symbol: Typical 3 to 5 characters long, and all letters in UPPERCASE.
• Token Memo: A short publicly visible description about the token.
• Amount to Mint: This property will only appear when Mint Type is a Fungible Token.
  Amount of fungible tokens to mint.
  Based on the Token Decimals configured, this amount will be automatically adjusted, so there is no need to input the lowest denomination amount.
  For example, for 2 token decimal points & to mint 500.50 tokens, there is no need to input "50050"; you can input "500.50".
• Token Decimals: This property will only appear when the Mint Type is a Fungible Token.

  The number of decimal places a token is divisible by.
  If Amount To Mint has decimal places exceeding the configured token decimals, the exceeded numbers are ignored.

• IPFS Content ID: This property will only appear when Mint Type is Non-fungible Token.
  After uploading your file to IPFS, the IPFS content ID will be attached as the NFT metadata.
  
  Example: QmeRdF1aybs9VKMYKM8E5tFPW96ngJ8i76Lia763wVtNX6
• Token Max Supply: For Fungible Token, this defines the maximum number of tokens that can ever be in circulation.

  For Non-fungible tokens, this defines the maximum number of NFTs (serial numbers) that can ever be minted.
  This value can never be changed after mint.

  For Fungible tokens, this amount will be automatically adjusted based on the token decimals configured, so there is no need to input the lowest denomination amount.
  For example, for 2 token decimal points & to set a max supply of 999.12 tokens, there is no need to input "99912"; you can input "999.12".
  
  

Token ID handling (mint more token)

This configuration tab will only appear when Token ID Handling property is Mint More Token.

• Mint Type: Select the type of token to mint more of:
  • Fungible Token
  • Non-fungible Token
• Token ID: Specify the ID of the token to mint more of.
• Additional Amount to Mint: 
  This property will only appear when Mint Type is a Fungible Token.
  Amount of fungible tokens to mint and add to the existing supply.
  If Additional Amount To Mint value's decimal points exceed the token's set decimals, the exceeded numbers are ignored.
• IPFS Content ID: This property will only appear when Mint Type is a Non-fungible Token.
  The IPFS content ID of the file after uploading your file to IPFS. This value will be attached as the NFT metadata.

Token keys configuration

This configuration tab will only appear when Token ID Handling property is Create New Token.

• Treasury Account: This account will receive the specified initial supply and any additional minted tokens.

  If tokens are burned, the supply of the treasury account will decrease. Defaults to Minter.

• Admin Key: The key that performs the token update and deletes operations on the token.
  The admin key has the authority to change:
  
  • Freeze key
  • Wipe key
  • KYC key
  • Pause key
  • Supply key

  It can also update the token's treasury account.

  Selections available are:

  • Disabled
  • Operator
  • Minter (Default)
    If Admin Key is disabled, token properties & supply & keys are PERMANENT upon mint.
• Freeze Key: The key which can freeze or unfreeze any accounts from transacting with this token.

  If disabled, no one can freeze token transactions for any account.

  Selections available are:

  • Disabled
  • Operator
  • Minter (Default)
• Wipe Key: The key that can wipe an account's token balance.

  If disabled, no one can wipe the token's balance for any account.

  Selections available are:

  • Disabled
  • Operator
  • Minter (Default)
• KYC Key: The key which can grant or revoke KYC to any account to participate in any interactions with this token.

  If disabled, KYC is not required, and KYC grant or revoke operations are impossible.

  Selections available are:

  • Disabled (Default)
  • Operator
  • Minter
    If the KYC Key is enabled, token receivers must be associated with the token and explicitly granted KYC before transacting with it.
• Pause Key: The key with the authority to pause or unpause overall interactions with this token.

  Pausing a token prevents the token from participating in all transactions.
  If disabled, pausing is not possible.

  Selections available are:

  • Disabled
  • Operator
  • Minter (Default)
• Supply Key: The key that can change a token's total supply.

  This key is used to authorize token mint and burn transactions.
  If disabled, minting/burning tokens is not possible.

  Selections available are:

  • Disabled
  • Operator
  • Minter (Default)
• Fee Schedule Key: The key which can change the token's custom fee schedule.

  If disabled, changing the token's custom fee is not possible.

  Selections available are:

  • Disabled
  • Operator
  • Minter (Default)

Store token data to form

This configuration tab will only appear when the Token ID Handling property is Create New Token.

• Form: Select a form to store the token data to.

  All fields from the selected form will be available for field mapping in the section below.

Field mapping

• Token ID: The unique identifier of a token.
  This value will be stored as the record ID of the chosen form.
• Token Type: Indicates if this is a Fungible Token or Non-fungible Token.
• Token Name: The token name.
• Token Symbol: The token symbol.
• Minting Account: The account that minted this token.
• Is Testnet Flag: To indicate if this minted token belongs to the mainnet or testnet.

Store NFT data to form

This configuration tab will only appear when the Mint Type property is a Non-fungible Token.

• Form: Select a form to store the NFT data to.

  All fields from the selected form will be made available for field mapping in the section below.

Field mapping

• NFT Serial Number: The unique serial number of the minted NFT.
• Associated Token ID: The token ID to which this NFT belongs.
• Minting Account: The account that minted this NFT.
• Is Testnet Flag: To indicate if this NFT belongs to the mainnet or testnet.

Store response to workflow variables

The plugin allows you to store transaction responses in workflow variables:

• Is Transaction Validated: To indicate if this transaction has been successfully validated.
• Consensus Timestamp: To store the timestamp of when the majority of the network members received the transaction. At this point, the transaction becomes final and verifiable.
• Transaction ID: To store the transaction ID of the transaction performed.
• Transaction Explorer URL: To store an auto-generated URL to see transaction details on a public ledger explorer. Default is Hashscan.

Download plugin

• Hedera Ledger Pack