Skip to content

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!

Notifications You must be signed in to change notification settings

ILESKOV/TechnoirClub-Marketplace

Repository files navigation

24135679

TechNoir Club

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

πŸ“ Table of Contents

🚩 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

Example screenshot Example screenshot Example screenshot

πŸ‘€ 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>"

Example screenshot

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!