4

Let’s Build an End-to-End NFT Project Using Truffle Suite

 1 year ago
source link: https://dzone.com/articles/lets-build-an-end-to-end-nft-project-using-truffle
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
neoserver,ios ssh client

Let’s Build an End-to-End NFT Project Using Truffle Suite

Learn about the Truffle Suite and how they fit in the web3 dev lifecycle. Then we'll create an end-to-end NFT project and verify a successful launch on OpenSea/Rarible.

by

CORE ·

Nov. 23, 22 · Tutorial

Non-fungible tokens (NFTs) are one of the biggest (and most popular) innovations to come out of Web3 so far. Although their capabilities are still being explored, both the art industry and the gaming world have benefited from the technology. This is because NFTs create an indisputable record of digital ownership.

Building NFTs isn’t as complicated as you think, especially with tool suites such as Truffle Suite. This article will introduce you to the Truffle Suite of tools and teach you how to use them to build an end-to-end NFT project and include the following: 

  • Project setup and installation using the Truffle NFT Box
  • Introduction to the Truffle VS Code extension
  • How to build and deploy the NFT smart contract using the Truffle Dashboard
  • Instructions for minting an NFT from the built-in React client with the Truffle NFT Box
  • Verification on the block explorer and OpenSea/Rarible

Introduction to the Truffle Suite

To make life easier for Ethereum developers, Truffle provides a development environment, testing framework, and asset pipeline.

It has several features that make it appealing to both experienced and new-to-Web3 devs, and it enables developers to build and deploy dapps for many use cases. The Truffle Suite of tools has several components, including: 

  • A programmable build pipeline used to build console and web applications
  • Instant asset rebuilding while in development (truffle watch
  • A console that makes it simple to use your compiled contracts (truffle console)
  • Contract compilation and deployment with built-in support for JavaScript, CoffeeScript, ES6, and JSX utilizing the RPC client of your choice

Truffle Suite

Truffle comprises essential tools to help anyone quickly build and deploy Web3 projects. The tools in the stack include:

  • Truffle - The development environment and testing framework
  • Ganache - A personal blockchain for Ethereum development
  • Truffle For VS Code Extension - An extension that makes creating and managing Truffle projects easier
  • Truffle Dashboard - An easy way to use your existing MetaMask wallet for your deployments and other transactions you need to send from a command line context
  • Truffle Boxes - Boilerplate projects to get up and running quickly

Although not part of the Truffle Suite of tools, the following tools pair nicely with the stack to make development and deployment even more streamlined:

  • Infura - A Web3 backend and Infrastructure-as-a-Service (IaaS) provider, offering various services and tools to blockchain developers
  • MetaMask - A crypto wallet and gateway to blockchain applications

How To Launch an End-to-End NFT Project Using the Truffle Stack

Now that you’ve got an idea of the tools involved, let’s put them together to create an NFT project.

Prerequisites

Before getting started, we need the following prerequisites:

  • Node.js and its package manager NPM
    • Verify we have Node.js installed by using the following terminal command:
node -v && npm -v

Create an Infura Account to Access the Network

Visit the Infura website to sign up for a new account or log in if you already have one.

Infura home

After successfully signing up, the page redirects to our dashboard, where we can create a new key, as shown below.

Create a new key

Click the "Create a New Key" button and fill in the required information.

Fill in data to create a new key

After creating your key, your project ID will be visible on your dashboard under the API Key section, as shown below. Copy and keep it somewhere; you will need it later in this tutorial.

API key

Set Up MetaMask with Infura RPC

We will need to configure and set up a Goerli test network on MetaMask using the Infura RPC endpoint since you will build and deploy your application via the Truffle Dashboard.

Head over to metamask.io and download the extension for your browser. Understanding wallet safety is essential when using a crypto wallet like MetaMask.

Ethereum Mainnet
Add Network
Add a network manually

Click on Add a Network Manually as shown in the image above, then enter the following information:

Network Name: Goerli Testnet - Infura
New RPC URL: https://goerli.infura.io/v3/<Paste-your-project-id-here>
Chain ID: 5
Currency Symbol: ETH
Block Explorer URL: https://goerli.etherscan.io/

Congratulations, you have successfully configured the Goerli Testnet with Infura RPC.

End-to-End NFT Project Setup with the Truffle NFT Box and Truffle for VS Code Extension

In this section, you will set up an NFT project with the Truffle NFT Box and the Truffle for VS Code extension. Open VS Code from the folder you wish to work out of, navigate to the extensions tab, and search “Truffle for VS Code.”

Truffle for VS Code

With the extension installed, you can easily create a new Truffle project from a Truffle Box. Press ctrl+shift+P to open the command dialogue and type “truffle.” This will display a list of available Truffle commands.

List of available Truffle commands

Select New Solidity Project and then Create project from Truffle Box. Next, a list of available Truffle Boxes will be displayed. Choose nft-box to create the project.

Choose nft-box

Alternatively, if you are not using VS Code as your main editor, you can still follow along. Create an NFT project from a Truffle Box in any directory of your choice using the following commands:

mkdir nft-project-demo && cd nft-project-demo
npx truffle unbox nft-box

Or you can install Truffle globally and run the unbox command.

npm install -g truffle
truffle unbox nft-box

This command should download and unbox the Truffle NFT Box.

Command to download and unbox the Truffle box

Next, cdinto the new directory and download all project dependencies by running npm install

Finally, open the project in your preferred code editor. Regardless of how you created the project, you should have a project structure similar to what is shown below.

Project structure

Upload NFT Metadata on IPFS

Our NFT image and metadata will be stored using IPFS. Head over to your Infura Dashboard and create another project, this time selecting IPFS as shown below. 

Create new key

Next, click Manage Key to view the project details.

Click Manage Key
Project details

You'll need the Project ID, Project Secret, and Endpoint URL for the following tasks.

Using the following command, let's upload the image to IPFS. To upload the image, cd into the folder where the image is saved.

curl -X POST -F file=@yourfile -u "PROJECT_ID:PROJECT_SECRET" 
"https://ipfs.infura.io:5001/api/v0/add"
  • Replace @yourfile with the name of the image file in the current folder, e.g., image-name.jpeg.
  • Replace "PROJECT_ID:PROJECT_SECRET" with your project id and secret in that order.

The output from the command should look similar to what is shown below. 

Output from command used to upload the image to IPFS

You can verify the image was uploaded successfully by pasting that Hash into the following URL: https://ipfs.io/ipfs/YOUR_HASH_HERE.

Note: When trying to access the image via the URL for the first time, it might take a few minutes to load.

Access the image

Let's get the metadata stored on IPFS now that the image is there. To comply with OpenSea requirements, you will need your metadata to be in the following JSON format:

{ 
  "name": "My Nature NFT",     
  "description": "Amazing nature NFT deployed to the Goerli Network using Infura RPC",
  "image": "ipfs://YOUR_HASH_HERE" 
}

You will use the command similar to what you used earlier to upload the image in the previous step with this command.

curl -X POST -F file=@yourjsonfile -u "PROJECT_ID:PROJECT_SECRET" 
"https://ipfs.infura.io:5001/api/v0/add"
  • Replace @yourjsonfile with the name of the json file in the current folder, e.g., nft-metadata.json.
  • Replace "PROJECT_ID:PROJECT_SECRET" with your project id and secret in that order.
Replace

You can verify the JSON file was uploaded successfully by pasting that Hash into the following URL: https://ipfs.io/ipfs/YOUR_HASH_HERE

Verify the JSON file was uploaded succsessfully

You have entirely set up all the tools we need to build and deploy a smart contract with the Truffle Dashboard. Let's do that in the following step.

Build and Deploy Smart Contracts with the Truffle Dashboard

Head over to the NFT project with the Truffle NFT Box we installed earlier; you will build and deploy the smart contract in this section.

Inside the 1_deploy_contracts.js file in the migrations folder, update it with the following code snippet.

var NFTCollection = artifacts.require("./NFTCollection.sol");

module.exports = function (deployer) {
  deployer.deploy(
    NFTCollection,
    "https://ipfs.io/ipfs/YOUR_IPFS_HASH_HERE",
    "NFT DEMO",
    "NFTD"
  );
};

In the code snippet above, we added the URL to the hosted JSON file on IPFS, the token name, and the symbol as the parameter to the deployer.deploy() function.

Next, you will build and compile using the Truffle Dashboard, which removes the need to interact manually with your wallet's mnemonic phrase or private keys throughout the development lifecycle.

In a separate terminal window, type the following command:

truffle dashboard

The command will automatically start Truffle Dashboard at http://localhost:24012 and open a new tab in your existing browser session.

Truffle Dashboard

After connecting your wallet, make sure you switch to the Goerli testnet we set up and configured earlier using the Infura RPC. You should have something similar to what is shown below after successfully connecting.

Truffle Dashboard: Confirm network

Next, compile and deploy the smart contracts using the following command:

truffle migrate --network dashboard
Waiting for transaction signature

Approve the transaction via the Truffle Dashboard on your browser as prompted on the terminal.

Truffle Dashboard: Approve Transaction
Confirm new address

After successful deployment, you should have something similar to what is shown below on your terminal.

Terminal output after successful deployment

Verify Contract Creation on Goerli Testnet Block Explorer

In this section, verify the contract creation on the Goerli Testnet Block Explorer via the testnet URL by pasting the contract address or confirming from MetaMask, which will redirect to the Goerli Testnet Block Explorer as shown below.

Contract deployment
View on block explorer
Etherscan Transaction Details

Configure the Frontend Client and Mint an NFT

Open a separate terminal and run the following command to configure the front-end client. This will allow us to mint the NFT from the smart contract we just deployed.

cd client
npm install
npm start
Configure the front-end client

If you encounter an error similar to what is shown above, create a .env file in the client folder, add SKIP_PREFLIGHT_CHECK=true, then run the following command.

npm start

The React server will automatically start on the browser at http://localhost:3000/, showing something similar to the image below:

Mint NFT

Test the End-to-End NFT Project

In this section, let's test the application to see if you can successfully mint the NFT by clicking on the Mint NFT button.

After pressing the button, you will see a MetaMask pop-up similar to what is shown below.

MetaMask pop-up

By clicking on the transaction below, you can confirm whether the minting is successful on MetaMask.

Mint NFT successful
Contract deployment details
Etherscan Transaction Details Updated

Verify Minted NFT on OpenSea and Rarible

We successfully built and deployed an end-to-end NFT project using the Truffle stack in the previous steps. In this section, let's verify our minted NFT on OpenSea and Rarible.

Copy the contract address as shown below.

Contract address

Paste your contract address into the search bar at testnets.opensea.io to check out your new NFT on OpenSea. If your metadata was entered correctly, your NFT should display properly.

Note: OpenSea can sometimes be slow to show your NFT metadata and image.

OpenSea dashboard showing NFT metadata and image

You can paste your contract address and check it out on Rarible, as they retrieve NFT metadata faster than OpenSea, as shown below.

Rarible

As you can see that our NFT properly displays on both OpenSea and Rarible testnet platforms, thus verifying a successful deployment.

That's it! You can find the complete code on this GitHub repository.

Conclusion 

This article introduced you to the Truffle Suite of tools and how they can be used with Infura and MetaMask to create an end-to-end NFT project. You also learned that Truffle Boxes are an easy way to build projects quickly. 

Development in Web3 does not need to be difficult, especially when there are tools you can use in every step of the process. To learn more about the Truffle stack or to continue building, check out their docs.

Have a really great day!


About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK