Skip to content

Latest commit

 

History

History
120 lines (90 loc) · 5.2 KB

mint-a-token.md

File metadata and controls

120 lines (90 loc) · 5.2 KB

Mint a token

Minting fungible token allows you to increase the total supply of the token. Minting a non-fungible token creates an NFT with its unique metadata for the class of NFTs defined by the token ID. The Supply Key must sign the transaction.

  • If no Supply Key is defined, the transaction will resolve to TOKEN_HAS_NO_SUPPLY_KEY. The maximum total supply a token can have is 2^63-1.
  • The amount provided must be in the lowest denomination possible.
    • Example: Token A has 2 decimals. In order to mint 100 tokens, one must provide an amount of 10000. In order to mint 100.55 tokens, one must provide an amount of 10055.
  • The metadata field is specific to NFTs. Once an NFT is minted, the metadata cannot be changed and is immutable.
    • You can use the metadata field to add a URI that contains additional information about the token. You can view the metadata schema here. The metadata field has a 100-character limit.
  • The serial number for the NFT is returned in the receipt of the transaction.
  • When minting NFTs, do not set the amount. The amount is used for minting fungible tokens only.
  • This transaction accepts zero unit minting operations for fungible tokens (HIP-564)

Transaction Signing Requirements

  • Supply key
  • Transaction fee payer account key

Transaction Fees

  • Please see the transaction and query fees table for the base transaction fee.
  • Please use the Hedera fee estimator to estimate your transaction fee cost.

Methods

MethodTypeDescriptionRequirement
setTokenId(<tokenId>)TokenIdThe token ID for which to mint additional tokensRequired
setAmount(<amount>)longApplicable to tokens of type FUNGIBLE_COMMON.The amount to mint to the Treasury Account. The amount must be a positive non-zero number represented in the lowest denomination of the token. The new supply must be lower than 2^63-1.Optional
setMetadata(<metaDatas>)List<byte[]>Applicable to tokens of type NON_FUNGIBLE_UNIQUE. A list of metadata that are being created. The maximum allowed size of each metadata is 100 bytes and is immutable.Optional
addMetadata(<metaData>)byte []Applicable to tokens of type NON_FUNGIBLE_UNIQUE. A list of metadata that are being created. The maximum allowed size of each metadata is 100 bytes and is immutable.Optional

{% tabs %} {% tab title="Java" %}

//Mint another 1,000 tokens
TokenMintTransaction transaction = new TokenMintTransaction()
     .setTokenId(tokenId)
     .setMaxTransactionFee(new Hbar(20)) //Use when HBAR is under 10 cents
     .setAmount(1000);

//Freeze the unsigned transaction, sign with the supply private key of the token, submit the transaction to a Hedera network
TransactionResponse txResponse = transaction
     .freezeWith(client)
     .sign(supplyKey)
     .execute(client);

//Request the receipt of the transaction
TransactionReceipt receipt = txResponse.getReceipt(client);

//Obtain the transaction consensus status
Status transactionStatus = receipt.status;

System.out.println("The transaction consensus status is " +transactionStatus;

//v2.0.1

{% endtab %}

{% tab title="JavaScript" %}

//Mint another 1,000 tokens and freeze the unsigned transaction for manual signing
const transaction = await new TokenMintTransaction()
     .setTokenId(tokenId)
     .setAmount(1000)
     .setMaxTransactionFee(new Hbar(20)) //Use when HBAR is under 10 cents
     .freezeWith(client);

//Sign with the supply private key of the token 
const signTx = await transaction.sign(supplyKey);

//Submit the transaction to a Hedera network    
const txResponse = await signTx.execute(client);

//Request the receipt of the transaction
const receipt = await txResponse.getReceipt(client);
    
//Get the transaction consensus status
const transactionStatus = receipt.status;

console.log("The transaction consensus status " +transactionStatus.toString());

//v2.0.7

{% endtab %}

{% tab title="Go" %}

//Mint another 1,000 tokens and freeze the unsigned transaction for manual signing
transaction, err = hedera.NewTokenMintTransaction().
		SetTokenID(tokenId).
		SetAmount(1000).
		//Use when HBAR is under 10 cents
		SetMaxTransactionFee(hedera.HbarFrom(20, hedera.HbarUnits.Hbar)).
		FreezeWith(client)

if err != nil {
		panic(err)
}

//Sign with the supply private key of the token, submit the transaction to a Hedera network
txResponse, err := transaction.
		Sign(supplyKey).
		Execute(client)

if err != nil {
		panic(err)
}

//Request the receipt of the transaction
receipt, err = txResponse.GetReceipt(client)

if err != nil {
		panic(err)
}

//Get the transaction consensus status
status := receipt.Status

fmt.Printf("The transaction consensus status is %v\n", status)

//v2.1.0

{% endtab %} {% endtabs %}