# NFT minting tutorial
NFT minting tutorial
*Estimated completion time: 15 mins*
This tutorial provides a step by step guide on how to mint an NFT on XpansionChain. It is designed for developers building on Web3 for the first time, so anyone can follow along regardless of prior experience. This has been simplified for educational purposes and we are working on expanding the content.
By the end of this tutorial you will have:
* Prepared an NFT collection
* Deployed a smart contract for your NFT collection
* Minted and listed an NFT
If you get stuck at any point, reach out on the dev-faq and dev-discussion channels in our Discord. Click here to provide feedback on the tutorial or let us know what topics you'd like to see in our documentation.
### Step 1: Prerequisites[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-1-prerequisites)
There are a few tools required for this tutorial:
**Homebrew**
INFO
Homebrew is only needed for Mac OS.
Homebrew installs the packages needed for this tutorial. Copy the command on the Homebrew website, then run in the terminal.
**Node.js**
Node.js allows us to use JavaScript to build and run applications.
NODE.JS VERSION
Ensure that you get the latest LTS version or you may experience issues following the turorial.
* Windows
* macOS
For **Windows** users, check that NodeJS is working by opening powershell or command line and executing the command:
```
npm -v
```
**Yarn**
Yarn is an open source package manager. Follow the steps below to install:
Run the following command in powershell.
```
npm install yarn -g
```
**Visual Studio Code**
Visual Studio Code is the code editor we will be using for this tutorial.
### Step 2: Setup MetaMask[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-2-setup-metamask)
To trade cryptocurrencies and NFTs, we need a wallet. For this tutorial, we will use Metamask.
1. Open metamask.io to install the browser extension
2. Follow the steps in the plugin to create a new wallet, then record and store your seed phrase in a safe location
3. Ensure you display test networks
4. Change the network selection from **Ethereum Mainnet** to **Goerli Test Network**
5. Note down your private key and public key
Changing the network enables us to deploy on a testnet where we can experiment using test Eth. To learn more about transactions on Ethereum work, check out this page from the Ethereum foundation.
### Step 3: Obtain GoerliETH[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-3-obtain-goerlieth)
To deploy our smart contract to the Goerli test network, we’ll need some test Eth. To get test Eth you can go to the Goerli faucet and enter your Goerli account address, then click “Send Me ETH.” It may take a few minutes for the goerliETH to arrive.
If this faucet doesn't work, try these alternative faucets:
* Faucet 1
* Faucet 2
### Step 4: Setup Pinata[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-4-setup-pinata)
Pinata is a service that allows users to host files on the InterPlanetary File System (IPFS) network. We use Pinata to store our NFT metadata as it ensures the authenticity of the file will be verifiable and the file will always be accessible. Follow the steps below to prepare your collection:
INFO
You can use the free version for this tutorial, however consider creating a paid account for your real collection to ensure your images can be loaded. Be aware that your images will be publicly hosted on IPFS.
CAUTION
We don't suggest using Pinata in production. Our systems will timeout after 5 seconds if your server does not respond; ensure your providers respond faster. For better performance, use services like AWS S3 to host metadata in production.
1. Sign up to Pinata
2. Prepare 3 images for your NFTs
3. Upload an image by pressing Upload and selecting the file
4. Upload the remaining 2 images
5. Note down the URL for each file
Your URLs should have the format `https://gateway.pinata.cloud/ipfs/QmWfjs6CVu4ENgXGNfdPhgaSdzEhCsCfB5XEFUosPFGsNV`
### Step 5: Create Metadata[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-5-create-metadata)
NFT Metadata contains information about the characteristics and properties of an NFT.
1. Open Visual Studio Code
2. Create New Folder (Open Folder --> New Folder)
3. Press the page icon 3x to create 3 files
4. Name the files **1,2 & 3**. These are our Token IDs.
DANGER
Ensure the files are named **1, 2 & 3** or you may run into errors later.
Populate each file with the metadata for the corresponding NFT. You can use the following metadata for your test collection, however make sure to replace each `image_URL` with the URLs that you created earlier to host your NFT images.
```
{
"name": "1st NFT",
"description": "This is your 1st nft",
"image_url": "",
"attack": 123,
"collectable": true,
"class": "EnumValue1"
}
```
```
{
"name": "2nd NFT",
"description": "This is your 2nd nft",
"image_url": "",
"attack": 223,
"collectable": true,
"class": "EnumValue2"
}
```
```
{
"name": "3rd NFT",
"description": "This is your 3rd nft",
"image_url": "",
"attack": 323,
"collectable": true,
"class": "EnumValue3"
}
```
Ensure you press **save** before uploading the folder into Pinata. Double check this by closing the file and re opening - make sure that the values have saved.
Click on the folder name to obtain your **metadata API URL**. This endpoint is used by the metadata crawler to add metadata to your NFTs when they are minted. Note this down.
The resulting URL should have the format `https://gateway.pinata.cloud/ipfs/QmWfKt2pXLnQ2AB5jfS2KYB9K2hxFtgcMNxyndkSGT3yuj`.
CHECK YOUR WORK
Click on your metadata API URL and ensure that there are 3 files named 1,2 & 3. Click into each file and confirm the data is correct. If any of them are empty, you will need to reupload your folder.
### Step 6: Create Etherscan API Key[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-6-create-etherscan-api-key)
An Etherscan API Key is necessary to verify that you're the owner of the smart contract that you're trying to publish. Follow the steps below:
1. Navigate to Etherscan
2. Sign in (or create a new account)
3. Navigate to `API-KEYS` and add a new key
4. Note down the generated API key
 
### Step 7: Create NFT contract[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-7-create-nft-contract)
Next we will need to update the variables for our smart contract.
1. Clone or download the imx-contracts code from github.
2. Unzip the file and open it in Visual Studio Code (File--> Open Folder)
3. Rename the `.env.example` to `.env`
4. Fill in the following details:
| Field Name | Description |
| ----------------------------------------------------------- | ------------------------------------------------------------- |
| `Etherscan API Key` | Etherscan API Key from previous step |
| `CONTRACT_OWNER_ADDRESS` | Metamask wallet address also known as public key |
| `DEPLOYER_TESTNET_PRIVATE_KEY DEPLOYER_MAINNET_PRIVATE_KEY` | Metamask wallet private key |
| `CONTRACT_NAME` | Name of your NFT collection eg "Spaghetti Adventures" |
| `CONTRACT_SYMBOL` | This is a shortened version of your collection name eg "SPAG" |
ALCHEMY API KEY
Note down the `ALCHEMY_API_KEY`. We do not need to update this value now, but we will use this value later.
### Step 8: Install Dev library[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-8-install-dev-library)
Next we will need to install packages needed for deploying our smart contract.
1. Right click on any file in the explorer
2. Select 'Open in Integrated Terminal'
3. Run `npm install --include=dev` and wait until the installation is completed
4. Save your work
### Step 9: Deploy Contract[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-9-deploy-contract)
Before we can mint on Layer 2, we need to deploy a smart contract on Layer 1 to ensure assets can be withdrawn to Layer 1. Click here to learn more about the differences between Layer 1 and Layer 2.
1. Run `yarn hardhat run deploy/asset.ts --network sandbox`
2. It will take \~5 minutes to deploy your contract to Goerli Etherscan
3. Copy the deployed contract address
CHECK YOUR WORK
Paste your contract address into Goerli Etherscan. It should say **contract** in the upper left. If this says address, ensure you are on the correct network
### Step 10: Add your NFT Collection to XpansionChain[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-10-add-your-nft-collection-to-immutable-x)
After deploying your contract to Layer 1, you will need to register it with XpansionChain by creating a project and a collection.
1. Download the imx-examples repo
2. Open the folder in Visual Studio Code
3. Rename `.env.example` to `.env` and save
4. Fill in the following:
| Field Name | Description |
| ----------------------------- | -------------------------------------------- |
| `ALCHEMY_API_KEY` | `AlCHEMY_API_KEY` from step 7 |
| `OWNER_ACCOUNT_PRIVATE_KEY` | Metamask private key from step 2 |
| `COLLECTION_CONTRACT_ADDRESS` | Deployed contract address from previous step |
1. Save
2. Run `npm install`
### Step 11: Register as a User[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-11-register-as-a-user)
Before you can create a project, you will need to register as a user. Registering as a user creates a Layer 2 wallet and enables us to make transactions on Layer 2.
1. Navigate to the Sandbox Test Marketplace
2. Press `Connect Wallet`
3. Follow the prompts
### Step 12: Register your Email Address[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-12-register-your-email-address)
Register with your email address at the XpansionChain Developer Hub to access the ability to create projects on XpansionChain via the Public API or the CLI in the imx-examples repo.
You must first have a project in order to create collections that you can mint assets from on XpansionChain (L2).
### Step 13: Create Project[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-13-create-project)
A project is an admin level entity associatied with an owner wallet address. This address is needed to make changes like creating or updating collections. Begin by navigating to **src/onboarding/2-create-project.ts**.
1. Fill in `name`, `company_name` and `contact_email`
2. Press save
3. Run `npm run onboarding:create-project`
4. Copy the Project ID from the output
5. Use this to populate the `COLLECTION_PROJECT_ID` in the .env file and press save
### Step 14: Register Collection[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-14-register-collection)
A collection is a group of NFTs that share a smart contract and each collection belongs to a project. Collections are displayed on the marketplace to end users, eg Gods Unchained.
Navigate to the ***src/onboarding/3-create-collections.ts*** file and populate the following values:
| Field Name | Description |
| ---------------------- | --------------------------------------------------------------------------- |
| `name` | Name of your collection on the marketplace |
| `description` | The description for your collection |
| `icon_url` | Icon that displays for your collection |
| `metadata_api_url` | Metadata API URL that we generated earlier (ensure there is no trailing /s) |
| `collection_image_url` | Image of your collection that displays on the marketplace |
To register the collection, run the command `npm run onboarding:create-collection`.
INFO
Remember to remove the prepending double slashes ”//” in relation to the fields described below as these comment out the code.
### Step 15: Create Metadata Schema[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-15-create-metadata-schema)
A collection's metadata schema describes the properties of the NFTs it can mint, as well as the potential values and types of those properties. These fields can be used as filters in the marketplace later on. Click here to learn more about Metadata Schema.
Navigate to **src/onboarding/4-add-metadata-schema.ts** and update metadata on line 43:
You can use the example metadata schema provided here, or use your own. Copy and paste the code below into line 43, as shown in the above image.
Example Metadata Schema
```
{
name : 'name' ,
type : MetadataTypes.Text
},
{
name : 'description' ,
type : MetadataTypes.Text
},
{
name : 'image_url' ,
type : MetadataTypes.Text
},
{
name : 'attack' ,
type : MetadataTypes.Discrete,
filterable : true
},
{
name : 'collectable' ,
type : MetadataTypes.Boolean,
filterable : true
},
{
name : 'class' ,
type : MetadataTypes.Enum ,
filterable : true
}
```
To add metadata schema to the collection, run the command `npm run onboarding:add-metadata-schema` in the integrated terminal.
### Step 16: Mint NFT[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-16-mint-nft)
Now that we have added our contract to XpansionChain, the final step is to add our assets to the blockchain by minting them.
1. Navigate to the .env file
2. Fill in the follow under the 'Bulk Minting' section
| Field name | Description |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `PRIVATE_KEY1` | MetaMask Private Key - Copy from 'Onboarding' section. |
| `TOKEN_ID` | Enter 1 as the `TOKEN_ID` if this is the first time you’re minting from your collection. If you have already minted a few NFTs, then take the TOKEN\_ID of the last minted NFT, and increment it by 1 and enter it here. |
| `TOKEN_ADDRESS` | Same as `COLLECTION_CONTRACT_ADDRESS` - Copy from 'Onboarding' section. |
| `BULK_MINT_MAX` | Enter 50 for this tutorial. This allows us to configure the maximum number of NFTs that can be minted in bulk in one go. |
SAVE
Don't forget to press save after updating the values
**To Mint**
1. Run `npm run bulk-mint -- -n -w ` where
* `` is the number of NFTs you wish to mint. In this tutorial, this number is 3.
* `` is the MetaMask wallet you’re minting your NFTs to. For each contract (in other words, for each TOKEN\_ADDRESS) you are minting tokens for, remember to set the TOKEN\_ID in .env to the latest incremented index.
### Step 17: List your NFT[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#step-17-list-your-nft)
Our assets will now be accessible in our Goerli Wallet. However, for other users to see them we will need to list them on the marketplace.
1. Visit the Sandbox IMX Marketplace
2. Click Connet Wallet and follow the prompts
3. Click My Assets --> Select an NFT
4. Press List for Sale
### Conclusion[](https://docs.x.immutable.com/docs/x/zero-to-hero-nft-minting#conclusion)
Congratulations on minting and listing an NFT on the Goerli test network!
FEEDBACK
This tutorial covered the simplest implementation of minting, however we are continuing to build out the workflow. Feel free to leave any feedback here.
If you'd like to reuse these steps for a mainnet launch, note the following changes:
| Step | Change |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Step 2 | Metamask Network should use Ethereum Mainnet |
| Step 9.1 | `yarn hardhat run deploy/asset.ts --network mainnet` |
| Step 10 | Set `ETH_NETWORK` to mainnet in the .env file |
| Step 10 | Remove \`sandbox\` from the URL in `PUBLIC_API_URL` in the .env file |
| N/A | Set `STARK_CONTRACT_ADDRESS` and `REGISTRATION_ADDRESS` to the mainnet addresses in the .env file |