https://github.com/mallory-jpg/nft-collection

Programmatic minting of NFTs & a web3 app to show them off. Built with @_buildspace
https://github.com/mallory-jpg/nft-collection

blockchain nft solidity web3

Last synced: 3 months ago
JSON representation

Programmatic minting of NFTs & a web3 app to show them off. Built with @_buildspace

• Host: GitHub
• URL: https://github.com/mallory-jpg/nft-collection
• Owner: mallory-jpg
• License: mit
• Created: 2021-11-20T18:53:54.000Z (almost 3 years ago)
• Default Branch: master
• Last Pushed: 2021-11-30T21:36:00.000Z (almost 3 years ago)
• Last Synced: 2024-04-19T21:55:14.080Z (7 months ago)
• Topics: blockchain, nft, solidity, web3
• Language: JavaScript
• Homepage:
• Size: 774 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-buildspace - nft-collection

README

        
# NFT Collection Web3 App

Built with @buildspace 🦄

#Verified: https://rinkeby.etherscan.io/address/0x0B39f1408e5948754f02611f80E988B403288d05#code



## Overview

* NFT metadata format:

  ```

  {

    "name":"Yeet Love",

    "description":"Some boomers are alright.",

    "image":"data:image/json;base64,"

  }

  ```

  

### How to Use

1. Go to the [game site](https://nft-collector.malloryculbert.repl.co/)

2. Connect your ETH wallet

3. Mint your NFT!

### A vocabulary refresher

* **Transaction**: an action that changes the blockchain, like deploying a smart contract or minting an NFT

* **Deployment**:

* **On-Chain Data**: data stored on the contract itself, rather than via a third party

* **SVG**: image built with code

* **base64**: encoding format 

* **Event**: in Solidity, messages that are emitted by smart contracts & captured in real-time by our client

## Setup 🛠️

1. Startup a sample HardHat project: `npx hardhat` 

2. Install project dependencies: `npm install --save-dev @nomiclabs/hardhat-waffle ethereum-waffle chai @nomiclabs/hardhat-ethers ethers`

3. Install OpenZeppelin library: `npm install @openzeppelin/contracts`

4. Test setup by deploying to local blockchain: `npx hardhat run scripts/sample-script.js` results in 👇



### Tools

* [Alchemy.io](https://dashboard.alchemyapi.io/)

* [JSON Keeper](https://jsonkeeper.com/) ➡️ the metadata's `image` URL has this format: `data:image/svg+xml;base64,`

### Bugs & Oddities 🐛

If using VSCode: 

* make sure ethers are not auto-imported into solidity contract

* imports might be unresolved if the compiler isn't globally installed on your system

### HardHat 🎩

"This project demonstrates a basic Hardhat use case. It comes with a sample contract, a test for that contract, a sample script that deploys that contract, and an example of a task implementation, which simply lists the available accounts.

Try running some of the following tasks:"

```shell

npx hardhat accounts

npx hardhat compile

npx hardhat clean

npx hardhat test

npx hardhat node

node scripts/sample-script.js

npx hardhat help

```

## Testing

1. Deploy contract (using command line) to Rinkeby Testnet to validate: `npx hardhat run scripts/deploy.js --network rinkeby`

2. Check contract address on [Etherscan](https://rinkeby.etherscan.io/) 

3. Search [OpenSea's TestNet](https://testnets.opensea.io/) site using the contract address 

### Tools

* Rinkeby testnet

* Metamask wallet