Skip to main content

How to mint a Collection on-chain

Prerequisites​

Before getting started, make sure you have the following ready:

  1. Create a Ternoa account with Alphanet CAPS
  2. Install and set up your editor of choice (we will use Visual Studio Code [VSC] in this tutorial)
  3. Install NodeJS v.14+ & NPM
  4. Install & initialize Ternoa-JS

Minting a Collection on-chain using Ternoa-JS​

In order to create a Collection on the Ternoa chain, Ternoa-JS provides you with a createCollection helper to do so. It returns an object promise containing the CollectionCreatedEvent returned by the Ternoa blockchain.

Replace IPFS_CID in the following code snippet with your CID hash previouly generated in "How to prepare Collection assets":

import {
  createCollection,
  initializeApi,
  getKeyringFromSeed,
  WaitUntil,
} from "ternoa-js";

const main = async () => {
  try {
    const keyring = await getKeyringFromSeed("//TernoaTestAccount");
    const collectionData = await createCollection(
      "IPFS_CID",
      undefined,
      keyring,
      WaitUntil.BlockInclusion
    );
    console.log("The on-chain Collection id is: ", collectionData.collectionId);
  } catch (e) {
    console.error(e);
  }
};
info

Use your own account by updating the //TernoaTestAccount with your account seed when retrieving the keyring from the example below.

Here are detailed the createCollection helper parameters:

`offchainData`: a string that can be IPFS CID hash that points to a JSON file, a plain text, a small JSON string, or a link to either a static or a dynamic file.
`limit`: (Optionnal) an amount of NFT that can be associated with this collection.
`keyring`: the provided keyring (containing the address) will be used to sign the transactio and pay the execution fee.
`waitUntil`: WaitUntil define at which point we want to get the results of the transaction execution: BlockInclusion or BlockFinalization.

The response returned includes all the informations below according to the parameters provided when creating the Collection.

`collectionId`: ID of the Collection.
`owner`: The owner of the Collection.
`offchainData`: The off-chain data provided for the Collection.
`limit`: The limit set for the Collection is defined.

Next​

Next step will be getting the Collection data from the Ternoa Indexer using the Collection id just generated. Keep it and continue on the "How to retrieve a Collection" guide.

Support​

If you face any trouble, feel free to reach out to our community engineers in our Discord.