๐ŸŽจMinting NFTs on EVM Chains

NFT Creation with Lighthouse: A Step-by-Step Guide

Introduction to NFTs, IPFS, and Lighthouse

What are NFTs?

NFTs, or Non-Fungible Tokens, are unique digital tokens representing ownership or proof of authenticity for specific items or content on the blockchain. They are unique, meaning no two NFTs are identical, each possessing distinct attributes or information.

A Glimpse into Lighthouse and IPFS

Lighthouse offers a perpetual file storage solution built atop IPFS and Filecoin. In this enhanced guide, we delve deeper into utilizing Lighthouse for NFT metadata storage, ensuring durability and accessibility.

A Comprehensive Guide to Creating and Minting an NFT

Step 1: Get the Tools

To kickstart the process, ensure the installation and accessibility of these essential tools:

  • Node.js installed for executing JavaScript code.

  • A cryptocurrency wallet like MetaMask for handling Ethereum transactions. Learn how to retrieve your private key from MetaMask here

  • To interact with the Ethereum blockchain, youโ€™ll need an API key from Infura. Hereโ€™s how to obtain it:

    1. Click on the โ€œSign Upโ€ button if you are a new user or โ€œLog Inโ€ if you already have an account.

    2. Once logged in, go to the Dashboard and click on โ€œCreate New Projectโ€.

    3. Enter a name for your project and click "Create".

    4. Upon creation, you'll be provided with the keys and endpoints. The keys include the PROJECT ID, PROJECT SECRET, and the endpoints for different Ethereum networks.

    Ensure to note down the PROJECT ID and PROJECT SECRET, and the endpoint URL you intend to use (for example, the Ropsten Testnet URL if you are deploying on the Ropsten network).

Step 2: Write Your Smart Contract

Craft a Solidity smart contract to define and manage your NFT. Here is a basic example using OpenZeppelin's libraries for an ERC721 token:

// NFT.sol

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "@openzeppelin/contracts/token/ERC721/extensions/ERC721URIStorage.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "@openzeppelin/contracts/utils/Counters.sol";

contract NFT is ERC721URIStorage, Ownable {
    using Counters for Counters.Counter;
    Counters.Counter private _tokenIds;

    constructor() ERC721("MyNFT", "NFT") Ownable() {

    function createNFT(
        string memory tokenURI
    ) public onlyOwner returns (uint256) {
        uint256 newTokenId = _tokenIds.current();
        _mint(msg.sender, newTokenId);
        _setTokenURI(newTokenId, tokenURI);
        return newTokenId;

Step 3: Compile the Contract

Use Solidity compiler (solc) to compile the contract. Install Solc and other dependecies via npm:

npm install -g solc npm install @openzeppelin/contracts@4.9.0

Compile the contract using the following command:

solcjs --bin --abi --include-path node_modules --base-path . NFT.sol

This will generate the binary and ABI needed to deploy the contract.

Step 4: Generate Your Lighthouse API Key

Before proceeding to upload your file to IPFS via Lighthouse, you need an API key. Follow these steps to generate one:

  1. Click on the โ€œGet Startedโ€ or โ€œLoginโ€ button.

  2. Once logged in, navigate to the "API" section in your account dashboard.

  3. Click on โ€œGenerate API Keyโ€. You might need to verify your email address if you havenโ€™t already.

  4. Label your API key for easy identification and click โ€œCreateโ€. Your new API key will be displayed.

  5. Make sure to copy and store your API key in a safe place, as it wonโ€™t be shown again.

Note: You can also generate the API key from CLI

Step 5: Upload Your File to IPFS using Lighthouse

Utilize the Lighthouse SDK to upload files to IPFS seamlessly. Remember to replace 'YOUR_API_KEY_HERE' with your actual Lighthouse API key.

// uploadToIPFS.js

import lighthouse from '@lighthouse-web3/sdk';

async function uploadFile() {
const apiKey = 'YOUR_API_KEY_HERE';
const filePath = './path/to/your/file.jpg';
const uploadResponse = await lighthouse.upload(filePath, apiKey);
console.log('File uploaded to IPFS via Lighthouse:', uploadResponse);


Step 6: Create Your NFT Metadata JSON File

Using the image URL from Step 5, you'll create a nft-metadata.json file containing your NFT's metadata.

Create nft-metadata.json with the following content:

    "name": "My NFT",
    "description": "A description of my NFT",
    "image": "IMAGE_URL",
    "attributes": [
        { "trait_type": "trait1", "value": "trait1_value" },
        { "trait_type": "trait2", "value": "trait2_value" }

Replace <YourImageIPFSHashHere> with the actual IPFS hash you received after uploading the image.

Step 7: Upload Your NFT Metadata JSON File to IPFS using Lighthouse

Now you will upload the nft-metadata.json file you created to IPFS using the Lighthouse SDK.

// uploadMetadataToIPFS.js

import lighthouse from '@lighthouse-web3/sdk';
import fs from 'fs';

async function uploadMetadata() {
    const apiKey = 'YOUR_API_KEY_HERE';
    const metadataFilePath = './path/to/your/nft-metadata.json';
    const metadata = fs.readFileSync(metadataFilePath);
    const metadataResponse = await lighthouse.upload(metadata, apiKey);
    console.log('Metadata uploaded to IPFS via Lighthouse:', metadataResponse);
    return metadataResponse;


Step 8: Deploy the Contract Using Ethers.js on the Mumbai Testnet

Hereโ€™s a detailed step using ethers.js to deploy your contract on the Mumbai testnet. Replace 'YOUR_INFURA_PROJECT_ENDPOINT' and 'YOUR_INFURA_PROJECT_ENDPOINT' appropriately.

// deployContract.js

import { ethers } from 'ethers';
import fs from 'fs';

const contractABI = JSON.parse(fs.readFileSync('.Path/to/the/NFT_sol_NFT.abi').toString());
const bytecode = fs.readFileSync('.Path/to/the/NFT_sol_NFT.bin').toString();
const infuraProjectEndpoint = "YOUR_INFURA_PROJECT_ENDPOINT"

async function deployContract() {
    try {
        const privateKey = 'WALLET_PRIVATE_KEY';
        const provider = new ethers.JsonRpcProvider(`https://polygon-mumbai.infura.io/v3/${infuraProjectEndpoint}`);
        const wallet = new ethers.Wallet(privateKey, provider);
        const ContractFactory = new ethers.ContractFactory(contractABI, bytecode, wallet);

        const deploymentTransaction = ContractFactory.getDeployTransaction();
        const txResponse = await wallet.sendTransaction(deploymentTransaction);

        console.log('Transaction Hash:', txResponse.hash);

        const receipt = await txResponse.wait();

        console.log('Contract deployed at:', receipt.contractAddress);
    } catch (error) {
        console.error("Deployment failed:", error);


Step 9: Mint Your NFT Using Ethers.js

This step provides an example code snippet to mint your NFT using ethers.js. Adapt the placeholders with actual values.

// mintNFT.js

import { ethers } from 'ethers';
import fs from 'fs';

const infuraProjectEndpoint = "YOUR_INFURA_PROJECT_ENDPOINT"

async function mintNFT() {
    const provider = new ethers.JsonRpcProvider(`https://polygon-mumbai.infura.io/v3/${infuraProjectEndpoint}`);
    const signer = new ethers.Wallet('YOUR_PRIVATE_KEY', provider);
    const contractAddress = 'YOUR_CONTRACT_ADDRESS';
    const contractABI = JSON.parse(fs.readFileSync('./path/to/ABI.json').toString());

    const contract = new ethers.Contract(contractAddress, contractABI, signer);
    const tokenId = await contract.createNFT('YOUR_METADATA_CID_LINK');
    console.log('NFT Minted, Token ID:', tokenId.toString());


Step 10: Verify Your NFT

To verify your NFT, use a blockchain explorer like Etherscan. Input your contract address, and explore the transactions and minted NFTs. Each NFT's distinct token ID and ownership records enhance transparency and authenticity.


This comprehensive guide aims to simplify the process of creating, minting, and verifying NFTs, spotlighting the Lighthouse and IPFS integration for metadata storage. Enjoy your NFT creation journey, exploring the endless possibilities within the digital collectible universe!

Last updated