How to Mint an NFT on Solana Using Candy Machine

January 17, 2022

DEPRECATED

NOTE: This guide is based off of the V1 of Candy Machine. V1 has been deprecated. You can catch an up-to-date guide on V2 here

Overview

Hello reader! We have had a lot of requests for another Solana NFT guide where we show you how to Mint a 1-of-1 token, or NFT on Solana. In the previous guide we did not quite get to where the juicy stuff is. That is the actual linking of the picture/metadata to the token. In order to do this we will use a program called Candy Machine. Candy Machine is a tool that allows you set up your own Solana NFT shop in your own little corner of the internet. In this guide we will walkthrough how to setup this one-stop-shop for Solana NFT minting.

NOTE: this guide is meant to show you the workflow and process for how to create and mint your own NFTs on Solana. Not teach you the underlying technologies.

There is much to learn about in the Solana ecosystem, and if you intend to do more than this happy path that we provide, you will need to dig in and learn these individual pieces! Cheers :)

These prerequisites will need to be installed before going forward, and we will be linking to the installation docs/guides for each one, as they will do a better job explaining how to install it than we would.

Prerequisites:

Candy Machine Overview

Candy Machine is a tool that utilizes the Metaplex CLI to generate an NFT, link a picture and relevant metadata to the NFT token, and setup a "fair auction." A "fair auction" really consists of two separate pieces. The first of which is that it starts at the same time for everyone. No pre-sales! The second component is that it will not send the transaction if there are no more NFTs to be minted.

No more throwing your SOL into the void, unsure if there are any more editions to be minted. While there is a LOT that you can dig into here as far as the internals go, the best way to learn is by building!

Forking the Repository

There are two different repositories that you can use. One of which is built by the candy-machine maintainers and another one that a community member built on top of to abstract a few things and create easier workflows. We will be using the latter in this tutorial. If you need to deviate from the happy path however, you will need the underlying knowledge of how Metaplex works.

To fork the repo you want to go to the community member's repo and fork it by clicking the fork button at the top

after you have it forked you will want to clone the repository:

forking the repository

Copy 
git clone https://github.com/<YourUsernameHere>/solana-candy-factory

With the projects successfully forked you can now begin the project setup.

Project Setup

With all of the code pulled down to your local machine, you should open the solana-candy-factory folder in your code editor of choice.

Installing dependencies

With that done we now need to begin setting the project up for development.

The first thing to do will be to install the dependencies for the project by running the command:

project setup

Copy 
yarn

Spinning up the database

After installing your dependencies, you will want to start the postgres database in docker that will hold your nfts before they are deployed on the network.

project setup

Copy 
yarn start-nft-manager-db
This will spin up your database and allow Strapi, which is a headless CMS that will hold all of our NFT information, to connect to the docker container.

NFT Manager

This is the real beauty of this repository. You are able to use a headless CMS to upload and manage all of your NFTs before blasting them online to be minted. To get this setup you will run the following command:

project setup

Copy 
yarn nft-manager
You can then navigate yourself to http://localhost:1337/admin. You first need to create a free Strapi account and log in. Then, you need to create a "user"; to do so, click on the appropriate tab as shown below.



Your user will need to have the following fields:

Role: Authenticated (This is super important!)



All that is left is to save your newly created User. Having done that, we can now move on to creating a collection.

A collection has a one-to-many relationship with NFTs. One collection will have many NFTs pointing to it. The process is very similar to creating a User. Go to the "Collections" tab to create a new collection. There are only two fields here. "Name" and "Family" are the only fields that relate to "collections", because the fields we are filling out in Strappi need to match the json attributes defined in the Solana NFT Metadata Standard.

"Name" should be the name of the specific project you are launching, whereas "Family" can be part of a larger theme.

I will be naming the fields by their name for the sake of transparency.

Name will be "Collection_Name", and Family will be "Collection_Family." You can now save the collection, and move to the "NFTs" tab to create your individual NFTs.

I will show you what mine looks like, and explain what each field means:

Format for the following information --> FieldName: Value --- Explanation.
  • Name: CoolNFTName --- The Name of your NFT
  • Symbol: CNN --- This is the "Ticker" for your NFT, like DAPE for the Degenerate Ape Academy.
  • Description: This is the description of my Super Cool NFT --- The description for the individual NFT.
  • Seller_fee_basis_points: 500 --- This is the % of royalties the creator of the NFT will receive on each purchase. (500 equates to 5%). You don't need to worry about this too much with this framework as we will set this using the CLI, but its always good to verify your data and ensure that this is set to what you would want it to be, regardless of the CLI implementation.
  • Image: Image.png --- Name of the image file. Leave this as Image.png (Regardless of the uploaded photo's name) as this will be dynamically changed. It MUST match the Properties -> Files -> Uri json field below.
  • Animation URL: n/a --- URL to a multi-media attachment of the asset. The supported file formats are MP4 and MOV for video, MP3, FLAC and WAV for audio and GLB for AR/3D assets. You may use the ?ext={file_extension} query to provide information on the file type.
  • External URL: https://Quicknode.com/ --- This is typically another link to view the asset on a centralized website such as imgur. You can however, leave it blank. (blank == "")
  • Traits:

project setup

Copy 
{
  "attributes": [
    {
      "value": "Solana",
      "trait_type": "Chain"
    },
    {
      "value": "QuickNode",
      "trait_type": "Company"
    },
    {
      "value": "Tutorial",
      "trait_type": "Category"
    },
    {
      "value": "Degen",
      "trait_type": "Status"
    }
  ]
}

This will be the "attributes" of your NFT. You do not have to have these, and they are completely arbitrary. However, if you do set an attribute, it must have both a value, and a trait_type field. Value can be a string or a number.

  • Properties:

project setup

Copy 
{
  "files": [
    {
      "uri": "image.png",
      "type": "image/png"
    }
  ],
  "category": "image",
  "creators": [
    {
      "share": 100,
      "address": "7K6XCSwVh3YZAh7GhARZ9pQ7gWkFNuWQ77U5CbV3PcF3"
    }
  ]
}

Properties contains much of the information around what exactly is being shown. It will link to the type (see supported types here), point to the uri (uploaded on arweave), and then a link to the creators of the NFT. There can be multiple creators so long as the "share" totals up to 100.

  • Content: This is where you can upload your image. This is the one I chose! 



Note: Your image must be in .png format!
After filling out all of this information with the values that suit you personally, you are all ready to mint an NFT!

Deploying the Candy Machine

With everything in place there are just a few commands to run. Due to the framework we are building on top of this is only a few commands.

First we will want to ensure that all of the funds the NFTs generate are going to go to you! Use the following command:

deploying the candy machine

Copy 
yarn update-creator-all-rows
It will then ask you to paste in the correct address. Put your Solana address here. This is the creators address from before!

Then you can put in the % of royalties you should make off of future sales of the artwork. This is the Seller_fee_basis_points field.

With those double-checked, we can now generate the NFT data.

deploying the candy machine

Copy 
yarn generate-nfts-sources
It will ask if you want to shuffle. This will randomize the order in which people mint nfts. If you are doing a large drop of 5-10k NFTs, you probably don't want them going in order! This will randomize it for you. For the purposes of this tutorial it does not matter since there is only one.

After running the previous command you should see two files in the nft-manager/nfts-sources folder, 0.json, and 0.png.

If those are there, you are ready to deploy!

Since we are using devnet things will be slightly different than if you were to deploy on mainnet, however the repository's README covers the differences quite nicely. You can run the following command, and accept all of the default values by pressing the "Enter" key without any other input.

deploying the candy machine

Copy 
yarn setup-dev
If you would like to learn about the internals of what this command is doing, it is available in the readme for you! Just know that this is setting up the program that is responsible for minting the NFTs you just generated previously.

That is everything for the deployment process!

Minting your NFT

With the program up, all we need to do is interact with it! To set up the website, run the following command.

deploying the candy machine

Copy 
yarn dev
This will spinup a webpage at http://localhost:3000. You can connect your wallet, and click on the "Mint" button as shown below.



You can see on the one in the picture there are no more available as we have already minted the only one. If you try to mint while there are none available, it will ask you to confirm the transaction; then the program denies it as there are none left to give you. This goes back to the "fair auction" that we spoke of earlier.

If everything went accordingly you should now have an NFT in your Phantom wallet. This is what mine looks like!

Conclusion

Congratulations! You just minted your first NFT on Solana! There is a lot going on under the hood that we didn't go over. If you are trying to do a larger NFT launch on the mainnet I would recommend doing a deep dive on Metaplex to see how each different command works, as things do not always go smoothly, and you want to be able to fix your problem should something go awry. That being said, you still learned a bunch!

Subscribe to our newsletter for more articles and guides on Ethereum. If you have any feedback, feel free to reach out to us via Twitter. You can always chat with us on our Discord community server, featuring some of the coolest developers you'll ever meet :)

Related articles 54

How to Send a Transaction On Solana Using JavaScript
Apr 13, 2022

Hello reader! Today is an exhilarating day because we are going on an expedition to the Solana Blockchain. Solana is an up-and-coming blockchain seeking to improve upon the current ecosystem's solutions to the complex problem of providing a secure, scalable, decentralized...

Continue reading
How to do a non-custodial transaction with QuickNode
Apr 12, 2022

Private keys are one of the most sensitive pieces of data when it comes to cryptography and the blockchain. However, there has always been debate/confusion about choosing between custodial wallets (where the wallet provider has custody of the user’s private key) and...

Continue reading
How to connect to Ethereum using .NET (Nethereum)
Apr 12, 2022

Dotnet or .NET is very popular for the development of desktop applications, most Windows desktop applications are built using .NET, and it also contributes largely to web application’s tech stack. In this guide, let’s see how we can connect to Ethereum using .NET and

Continue reading
How to Set Up a Near Project from Scratch
Jan 27, 2022

In this tutorial we will look at how we can setup a basic NEAR project from scratch, installing and configuring dependencies and customizing the project to work well with AssemblyScript.We will first start by initializing our project with a package.json file using...

Continue reading
Como crear y lanzar un ERC-721 (NFT)
Dec 29, 2021

Coleccionables digitales que son compatibles con ERC-721 se han vuelto muy populares desde el lanzamiento de Cryptokitties y han ganado adopción masiva en los últimos meses. Esta guía cubrirá la parte de creación y lanzamiento...

Continue reading
How to connect to Ethereum network using Java / Web3j
Apr 12, 2022

We can say that Java is one of the most versatile languages out there, and it continues to be relevant in today's time. Java is so popular because of its massive user base and use cases. In this guide/tutorial, we'll learn how to connect to the Ethereum Blockchain network...

Continue reading
How to integrate IPFS with Ethereum
Apr 12, 2022

It can be costly to store massive files on a blockchain mainnet, and this is where decentralized file storing systems like IPFS can come in handy. Sometimes, NFTs use IPFS as well. In this guide, we’ll cover how we can integrate IPFS with...

Continue reading
How to Connect to the Ethereum Network using Ruby
Jun 13, 2022

The Ruby programming language has a huge fanbase. Ruby was developed by its creator with an intention to invent a language developers can enjoy learning and using. Ruby has been largely accepted by developers all around the world since its launch, in fact, the biggest...

Continue reading
How to connect to Ethereum network with ethers.js
Apr 12, 2022

When someone thinks of developing a dApp the first tool that comes to their mind is web3.js which is pretty common because of its popularity in the community and wide use cases, dApp development has been consistently growing and there are a lot of developers who want to...

Continue reading
How to Mint an NFT on Solana
Apr 12, 2022

Updated at: April 10, 2022Welcome to another QuickNode guide on Solana - the up-and-coming blockchain that seeks to solve the scalability issues of Ethereum. We will be walking through step-by-step how to create an NFT on Solana. NFT, short for Non Fungible Token,...

Continue reading
The Web3 Developer Stack
Apr 12, 2022

A developer stack is a bag of technologies a developer possesses. For example, MEAN (MongoDB, Express.js, AngularJS/Angular, and Node.js) and MERN (MongoDB, Express.js, React, and Node.js) are common web developer stacks. Similarly, today we will learn more about the web3...

Continue reading
How to deploy a smart contract with Brownie
Apr 12, 2022

Python is one of the most versatile programming languages; from researchers running their test models to developers using it in heavy production environments, it has use cases in every possible technical field. In today's guide, we will learn about Brownie, a Python-based...

Continue reading
How to Get All Tokens Held by a Wallet in Solana
Jun 24, 2022

Hello readers! To kick off Solana Summer and the current whitelist meta, we thought it would be helpful to dig into all of the token accounts you and your users have using the getParsedProgramAccounts method. This tool is convenient for querying different...

Continue reading
Introduction to Scaffold-ETH 🏗
Dec 29, 2021

Developing applications involves juggling several moving pieces like front-ends, back-ends, and databases. But developing a decentralized application on a blockchain adds a few more elements like smart contracts and nodes that allow you to connect to the...

Continue reading
Como crear un NFT en SOLANA
Dec 29, 2021

¡Hola querido lector! Bienvenidos a una nueva guía de Solana.Solana es una blockchain que promete mucho a la hora de intentar resolver los problemas de escalabilidad que podemos apreciar en otras blockchains, como Ethereum por...

Continue reading
How to Get Transaction Logs on Solana
Jun 28, 2022

Ever need to pull all the transactions associated with a Wallet? Want to see all of the mint transactions associated with a Candy Machine? Or maybe see transaction history of an NFT? Solana's getSignaturesForAddress method is a versatile tool that makes...

Continue reading
How to Send an EIP-1559 Transaction
Apr 12, 2022

While Ethereum has been trying to scale, it has encountered some gas price issues. Many layer 2 solutions and sidechains sprang into existence to solve this problem, but Ethereum is the main chain, and at some point, it has to be improved. EIP-1559 was introduced to...

Continue reading
How to Create an Address in Solana using JavaScript
Apr 12, 2022

Hello reader! Welcome to QuickNode's first Solana guide. Solana is an up-and-coming blockchain that seeks to solve the scalability issues that Ethereum has been handling. You will walk through step-by-step how to create a Solana address using the @solana/web3.js...

Continue reading
How to create your own DAO with Aragon
Apr 12, 2022

Blockchain provides us with the power of decentralization. Decentralization means the transfer of power to users/members rather than having a single centralized authority governing everything; it enables various use cases in finance, governance, voting, fundraising, etc....

Continue reading
How to Connect to Terra with JavaScript using Terra.js
Apr 12, 2022

Stablecoins have been bridging the gap between traditional currencies and blockchains. Stablecoins offer stable price tokens pegged by a reserve asset which is often a fiat current like USD, EUR, GBP. The Terra protocol provides a framework to work with stablecoins. This...

Continue reading
How to connect to Ethereum network using Go
Apr 12, 2022

Go helps you make faster scalable backends and this guide will show you how to connect your backend to Ethereum (and make it even faster, more reliable, and globally accessible, all thanks to QuickNode’s global infrastructure). What is...

Continue reading
How To Fork Ethereum Mainnet with Hardhat
Apr 12, 2022

Forking the chain at an older block of the blockchain is helpful if you want to simulate the blockchain’s state at that block; Hardhat has this functionality built in. In this guide, let’s go through the process of forking the Ethereum Mainnet at an older...

Continue reading
How to connect to Ethereum using PHP
Apr 12, 2022

PHP is a very popular choice among developers and has a vast community due to its long presence in web development. In this guide, we’ll cover how to connect to Ethereum with PHP using the web3.php...

Continue reading
How to use Subspace with QuickNode
Apr 12, 2022

In this guide, we'll understand a bit about reactive development and how to use Subspace with QuickNode.JavaScript is the programming language behind most of the internet apps and websites. JavaScript today has become one of the most used programming languages,...

Continue reading
How to Connect Your Dapp With MetaMask Using Ethers.js
Dec 29, 2021

In our dApp, we will have a simple react user interface that has a material button asking the user to connect to MetaMask. And if they do not have an account, they can create one or log in to their account. They will then view their wallet balance and address displayed on...

Continue reading
How to generate a new Ethereum address in Go
Dec 29, 2021

Golang is very popular among backend developers for building infrastructures and microservices. Go is a procedural programming language. Developed in 2007 by Robert Griesemer, Rob Pike, and Ken Thompson at Google, then launched in 2009 as...

Continue reading
How to generate a new Ethereum address in Python
Dec 29, 2021

Python is one of the most versatile programming languages out there with an abundance of use cases; We can build many applications with Python from client-side to back end. In this guide, we will cover creating an Ethereum address in Python using the

Continue reading
How to Lazy Mint an NFT on Rarible with Rarepress
Apr 12, 2022

NFTs are great for creators to monetize their artwork and for people to get ownership of an item. But since gas prices are usually high given the highly in-demand space on Ethereum, minting an NFT or an NFT collection can become costly for a creator. Lazy minting solves...

Continue reading