ileskov/technoirclub-marketplace

A collection of NFT mutant robots with their frontend and marketplace. Robots can be modified and create new robots from their parts. Over 999 trillion combinations of different robots available!

TechNoir Club

ERC721 collection of Robot-Mutants with integrated NFT marketplace and modifying features Video explanation here.

📁 Table of Contents

• General Info
• Test Already Deployed Contract And Frontend
• Set Up Goeli Test Network
• Technologies Used
• Features
• Screenshots
• Requirements For Initial Setup
• Setup
• Room for Improvement
• Contact

🚩 General Information

• Users can mint their unique robots
• Users can modify and create new robots from parts of 2 another robots
• Users can buy / sell robots from other users from integrated marketplace

🧪 Test Already Deployed Contract And Frontend

Try already deployed contract and frontend here

⚠️ IMPORTANT ⚠️

It's required to use a Goerli test network in order to interact with this page, if you do not know how to do this, follow the instructions below

🌐 Set Up Goerli Test Network

1. 💾 Download Metamask Wallet Extension

If you don't know how to do this just follow this guide (Only install and save your backup phrase)

2. 😎 In Metamask advanced settings make sure u have "Show test networks" button ON

3. 🛰️ Now switch your network to Goerli TestNet

4. 🚰 Now you need to get some test ETH from Goerli faucet

You can use this or choose any other given on this forum

💻 Technologies Used🌐

• hardhat - version 2.10.1
• node - version 16.15.0
• HTML, CSS and ES6 JS
• hh coverage
• slither
• solhint
• docgen

🌟 Features

List the ready features here:

• Awesome Frontend
• Trillions of different robots combination. Every robot is totally unique!
• Modyfying feature. User can create new generation robot from two another robots!
• Build-in marketplace

🎦 Screenshots

👀 Requirements For Initial Setup

• Install NodeJS, should work with any node version below 16.16.0
• Install Hardhat

📟 Setup

1. 💾 Clone/Download the Repository

2. 📦 Install Dependencies:

$ cd technoir_directory
$ npm install

3. 🔍 .env environment variables required to set up

Create .env file inside project folder

• You can get your ethereum or testnet API key here,here or any other service that allow you to connect to the nodes
• You can get your private key from your wallet ( ⚠️ Don't share your private key with untrusted parties ⚠️ )
• You can get your etherscan API -key here.
• GEN_0_LIMIT specify by yourself

MUMBAI_API = <Mumbai API key>
MAINNET_API = <Mainnet API key>
PRIVATE_KEY = <Private key of your wallet u want to deploy contracts from>
ETHERSCAN_KEY = <Etherscan API key in order to verify your contracts>
GEN_0_LIMIT = <Limit of gen 0 robots to be created>

4. ⚠️ Run Tests

$ npm run test

$ npm run coverage

5. 🚀 Deploy to Mumbai or Mainnet

(🧐 Remember to have ether in your wallet to deploy contracts 🙄)

$ npm run mumbai

$ npm run mainnet

6. ✏️ Insert current contract address and constructor argument you're used while deployment into package.json

"mumbai:verify": "npx hardhat verify --network mumbai --contract contracts/RobotCore.sol:RobotCore [RobotCore.sol address] <Gen 0 limit>",
"mainnet:verify": "npx hardhat verify --network ethereum --contract contracts/RobotCore.sol:RobotCore [RobotCore.sol address] <Gen 0 limit>"

7. 📜 Verify contracts

$ npm run mumbai:verify

or for mainnet

$ npm run mainnet:verify

📈 Room for Improvement

Room for improvement:

• Go live Ethereum network
• Make great marketing
• Go OpenSea and other NFT marketplaces

💬 Contact

Created by @LESKOV - feel free to contact me!