search
Learn Build

Mint a Capsule NFT

hashtag
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+arrow-up-right & NPM

  4. Install & initialize Ternoa-JS

hashtag
Minting a Capsule NFT on-chain using Ternoa-JS

In order to create a Capsule NFT on the Ternoa chain, Ternoa-JS provides you with a mintCapsuleNFT helper to do so.

circle-info

Please note that an api-key is needed to store data on those gateways. Visit IPFS Keymanagerarrow-up-right to obtain your API Key. After being generated, the key may need a few minutes to become effective for use with the Ternoa client. Learn about the Ternoa IPFS client here.

import fs from "fs";
import {
  encryptFile,
  getKeyringFromSeed,
  mintCapsuleNFT,
  File,
  TernoaIPFS,
  WaitUntil,
} from "ternoa-js";

const main = async () => {
  try {
    const SEED = "//TernoaTestAccount"; // The owner seed phrase.
    const IPFS_NODE_URL = "IPFS_NODE_URL"; // The IPFS node used.
    const IPFS_API_KEY = "IPFS_API_KEY"; // The IPFS node API KEY if required.
    const CLUSTER_ID = 0; // The cluster of TEE enclaves used to store private key shares.
    const CAPSULE_NFT_ROYALTY = 10; // Percentage of all second sales that the capsule NFT creator will receive - 10%.
    const COLLECTION_ID = undefined; // The collection to which the capsule NFT belongs. Optional Parameter: Default is undefined.
    const IS_SOULBOUND = false; // If true, makes the Capsule NFT a Soulbound token. Default is false.

    const ipfsClient = new TernoaIPFS(new URL(IPFS_NODE_URL), IPFS_API_KEY);
    const keyring = await getKeyringFromSeed(SEED);

    const keys = {
      privateKey: "PRIVATE_PGP_KEY",
      publicKey: "PUBLIC_PGP_KEY",
    };

    const NFTFile = new File(
      [await fs.promises.readFile("FILE_NAME")],
      "FILE_NAME",
      {
        type: "FILE_TYPE",
      }
    );

    const nftMetadata = {
      title: "Nice souvenir",
      description: "This is my first Capsule NFT on Ternoa.",
    };

    const file1 = new File(
      [await fs.promises.readFile("FILE_NAME_1")],
      "FILE_NAME_1",
      {
        type: "FILE_TYPE_1",
      }
    );
    const file2 = new File(
      [await fs.promises.readFile("FILE_NAME_2")],
      "FILE_NAME_2",
      {
        type: "FILE_TYPE_2",
      }
    );

    const encryptedFile1 = await encryptFile(file1, "PUBLIC_PGP_KEY");
    const encryptedFile2 = await encryptFile(file2, "PUBLIC_PGP_KEY");

    const capsuleMetadata = {
      title: "(OPTIONAL) A secret stash.",
      description: "(OPTIONAL) This is my first Capsule NFT on Ternoa.",
    };

    const capsuleNftData = await mintCapsuleNFT(
      keyring,
      ipfsClient,
      keys,
      NFTFile,
      nftMetadata,
      [
        {
          encryptedFile: encryptedFile1,
          type: file1.type,
        },
        {
          encryptedFile: encryptedFile2,
          type: file2.type,
        },
      ],
      capsuleMetadata,
      CLUSTER_ID,
      CAPSULE_NFT_ROYALTY,
      COLLECTION_ID,
      IS_SOULBOUND,
      WaitUntil.BlockInclusion
    );
    console.log("The on-chain Capsule NFT id is: ", capsuleNftData.event.nftId);
  } catch (e) {
    console.error(e);
  }
};

This program uses the Ternoa-js library to mint a new Capsule NFT on the Ternoa blockchain. The function first sets several constants, including the owner's seed phrase, an IPFS node URL, an IPFS API key, a TEE enclave cluster ID, and various metadata about the NFT and capsule. It then creates an instance of the TernoaIPFS class, which provides access to the IPFS node, and generates a keyring from the seed phrase. The function reads two files from the file system, encrypts them with a given PGP key, and creates a new Capsule NFT with the mintCapsuleNFT function. The mintCapsuleNFT function takes several parameters, including the keyring, IPFS client, NFT and capsule metadata, and the encrypted files, and returns an object containing information about the newly created NFT, including its ID. The function logs this ID to the console upon successful completion. If any errors occur during the execution of the function, they are caught and logged to the console as well.

circle-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 mintCapsuleNFT helper parameters:

The response returned is an object promise containing:

  • event - the Capsule NFT creation event (a combinaison of the NFTCreatedEvent & the NFTConvertedToCapsuleEvent returned by the Ternoa blockchain) with the following data:

  • clusterResponse - the response of the TEE cluster which is an array of enclaves responses that are objects with the following data:

hashtag
Next

Next step will be getting the NFT data from the Ternoa Indexer using the NFT id just generated. Keep it and continue on the Retrieve a Capsule NFT guide.

hashtag
Support

If you face any trouble, feel free to reach out to our community engineers in our Discordarrow-up-right.

Last updated