Mint a Collection

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);
	}
};

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 Retrieve a collection guide.

Support

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