Skip to content
Docs
This documentation is in beta, and we’re looking for feedback. See how you can contribute 🌟

ERC-1155

Overview

Pros

  • Allows for the creation of multiple types of tokens within a single contract.
  • Supports both fungible and non-fungible tokens.
  • More efficient and cost-effective for creating a wide range of NFTs.

Cons

  • Relatively new and complex standard.
  • Limited support from Ethereum wallets and exchanges.
  • Requires advanced development skills to implement.

🏁 Prerequisites

Tutorial

1. Write your ERC-1155 contract

We’ll use a contract based on the OpenZeppelin library’s ERC-1155 implementation.

a) First, install the Open Zeppelin library in order to inherit its classes:

Terminal window
npm install @openzeppelin/contracts

b) Next, create a file named NFT_1155.sol under the contracts folder.

c) Lastly, add the following smart contract to NFT_1155.sol file.

// SPDX-License-Identifier: MIT
pragma solidity 0.8.17;


import "@openzeppelin/contracts/token/ERC1155/ERC1155.sol";


contract NFT_1155 is ERC1155 {
    constructor(string memory uri) ERC1155(uri) {}
}

2. Install Hardhat Deploy

Terminal window
npm install -D hardhat-deploy

3. Install an Ethereum library

In this example, we will use Ether.js

Terminal window
npm install --save-dev @nomiclabs/hardhat-ethers ethers@^5.0.0

4. Set environment variables with dotenv

  • Install dotenv
Terminal window
npm install --save dotenv
  • Create a .gitignore file

A great example of a Solidity .gitignore file can be found here

PRIVATE_KEY = #The private key of the account you intend to use on the Palm network INFURA_API_KEY = #Your Infura API key

5. Edit hardhat.config.js with the following text:

require("dotenv").config()
require("@nomiclabs/hardhat-ethers")
require("hardhat-deploy")


const key = '';


module.exports = {
  solidity: "0.8.17",
  settings: {
    optimizer: {
      enabled: true,
      runs: 1000000,
    },
  },
  mocha: {
    timeout: 90000,
  },
  networks: {
    hardhat: {
      initialBaseFeePerGas: 0,
      blockGasLimit: 18800000,
    },
    palm_testnet: {
      url: `https://palm-testnet.infura.io/v3/${process.env.INFURA_API_KEY}`,
      accounts: [`0x` + process.env.PRIVATE_KEY],
      gasPrice: 1000,
      saveDeployments: true,
      deploy: ["scripts/"],
    },
    palm_mainnet: {
      url: `https://palm-mainnet.infura.io/v3/${process.env.INFURA_API_KEY}`,
      accounts: [`0x` + process.env.PRIVATE_KEY],
      gasPrice: 1000,
      saveDeployments: true,
      deploy: ["scripts/"],
    },
  },
  namedAccounts: {
    deployer: 0
  },
}

6. Compile your Contract

To make sure everything is working so far, let’s compile our contract:

Terminal window
npx hardhat compile

7. Write a deploy script

a) Navigate to the scripts folder and create a new file called deploy_NFT_1155.js

b) Add the below code

module.exports = async ({
    getNamedAccounts,
    deployments,
    }) => {
    const {deploy} = deployments;
    const {deployer} = await getNamedAccounts();


    console.log("Contract deployed to address:", deployer);


    // Deploy "NFT" if the contract was never deployed or if the code has changed since the last deployment
     await deploy('NFT_1155', {
        from: deployer,
        gasLimit: 4000000,
        args: ["https://NFT1155/{id}.json"],
        log: true
    });
};

8. Deploy to the target Palm network environment

Terminal window
npx hardhat --network palm_testnet deploy

  • TLDR; How This is Working

  • The task will execute the scripts in the scripts folder and saves the contract deployments to disk. Each deployment is saved into the deployments folder for the specific network.

9. Look Up Your Deployment on the Palm Network Block Explorer

TestnetMainnet
Explorer URLhttps://testnet.palm.chainlens.com/https://palm.chainlens.com/

Paste your contract address into the search bar.

You will see something like this upon successful deployment 👇

10. Verify via Sourcify

Terminal window
npx hardhat --network palm_testnet sourcify

Next Step 👉 Mint your NFT

Using the Smart Contract you just deployed you can now Mint NFTs with Hardhat