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​

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 previously 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 an 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`: (Optional) an amount of NFT that can be associated with this collection.
`keyring`: the provided keyring (containing the address) will be used to sign the transaction and pay the execution fee.
`waitUntil`: WaitUntil defines at which point we want to get the results of the transaction execution: BlockInclusion or BlockFinalization.

The response returned includes all the information 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​

The 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.