Skip to content

scaffold-eth/scaffold-eth-challenges

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ— scaffold-eth | 🏰 BuidlGuidl

🚩 Challenge 0: 🎟 Simple NFT Example πŸ€“

🎫 Create a simple NFT to learn basics of πŸ— scaffold-eth. You'll use πŸ‘·β€β™€οΈ HardHat to compile and deploy smart contracts. Then, you'll use a template React app full of important Ethereum components and hooks. Finally, you'll deploy an NFT to a public network to share with friends! πŸš€

🌟 The final deliverable is an app that lets users purchase and transfer NFTs. Deploy your contracts to a testnet then build and upload your app to a public web server. Submit the url on SpeedRunEthereum.com!

πŸ’¬ Meet other builders working on this challenge and get help in the Challenge 0 Telegram or our Challenge 0 Discord


Checkpoint 0: πŸ“¦ Install πŸ“š

Want a fresh cloud environment? Click this to open a gitpod workspace, then skip to Checkpoint 1 after the tasks are complete.

Open in Gitpod

Required:

(⚠️ Don't install the linux package yarn make sure you install yarn with npm i -g yarn or even sudo npm i -g yarn!)

git clone https://github.com/scaffold-eth/scaffold-eth-challenges.git challenge-0-simple-nft
cd challenge-0-simple-nft
git checkout challenge-0-simple-nft
yarn install
yarn chain

in a second terminal window, start your πŸ“± frontend:

cd challenge-0-simple-nft
yarn start

in a third terminal window, πŸ›° deploy your contract:

cd challenge-0-simple-nft
yarn deploy 

You can yarn deploy --reset to deploy a new contract any time.

πŸ“± Open http:https://localhost:3000 to see the app


Checkpoint 1: ⛽️ Gas & Wallets πŸ‘›

⛽️ You'll need to get some funds from the faucet for gas.

image

🦊 At first, please don't connect MetaMask. If you already connected, please click logout:

image

πŸ”₯ We'll use burner wallets on localhost...

πŸ‘› Explore how burner wallets work in πŸ— scaffold-eth by opening a new incognito window and navigate it to http:https://localhost:3000. You'll notice it has a new wallet address in the top right. Copy the incognito browsers' address and send localhost test funds to it from your first browser:

image

πŸ‘¨πŸ»β€πŸš’ When you close the incognito window, the account is gone forever. Burner wallets are great for local development but you'll move to more permanent wallets when you interact with public networks.


Checkpoint 2: πŸ–¨ Minting

✏️ Mint some NFTs! Click the MINT NFT button in the YourCollectables tab.

MintNFT

πŸ‘€ You should see your collectibles start to show up:

nft3

πŸ‘› Open an incognito window and navigate to http:https://localhost:3000

🎟 Transfer an NFT to the incognito window address using the UI:

nft5

πŸ‘› Try to mint an NFT from the incognito window.

Can you mint an NFT with no funds in this address? You might need to grab funds from the faucet to pay the gas!

πŸ•΅πŸ»β€β™‚οΈ Inspect the Debug Contracts tab to figure out what address is the owner of YourCollectible?

πŸ” You can also check out your smart contract YourCollectible.sol in packages/hardhat/contracts.

πŸ’Ό Take a quick look at your deploy script 00_deploy_your_contract.js in packages/hardhat/deploy.

πŸ“ If you want to make frontend edits, open App.jsx in packages/react-app/src.


Checkpoint 3: πŸ’Ύ Deploy it! πŸ›°

πŸ›° Ready to deploy to a public testnet?!?

Change the defaultNetwork in packages/hardhat/hardhat.config.js to sepolia

Challenge-0-sepolia

πŸ” Generate a deployer address with yarn generate

nft7

πŸ‘› View your deployer address using yarn account

nft8

⛽️ Use a faucet like allthatnode.com/faucet/ethereum.dsrv or web.getlaika.app/faucets to fund your deployer address.

βš”οΈ Side Quest: Keep a πŸ§‘β€πŸŽ€ punkwallet.io on your phone's home screen and keep it loaded with testnet eth. πŸ§™β€β™‚οΈ You'll look like a wizard when you can fund your deployer address from your phone in seconds.

πŸš€ Deploy your NFT smart contract:

yarn deploy

πŸ’¬ Hint: You can set the defaultNetwork in hardhat.config.js to sepolia OR you can yarn deploy --network sepolia.


Checkpoint 4: 🚒 Ship it! 🚁

✏️ Edit your frontend App.jsx in packages/react-app/src to change the targetNetwork to NETWORKS.sepolia:

Challenge-0-sepolia-app

You should see the correct network in the frontend (http:https://localhost:3000):

challenge-0-sepolia-wallet

🦊 At this point, you will need to connect to your dapp using a browser extension wallet where you have some ether available to mint tokens. Again, you can use a faucet like allthatnode.com/faucet/ethereum.dsrv. Keep in mind that the address you generated in the previous step to deploy the contract will be different from the one you have configured in your wallet.

🎫 Ready to mint a batch of NFTs for reals? Use the MINT NFT button.

MintNFT2

πŸ“¦ Build your frontend:

yarn build

πŸ’½ Upload your app to surge:

yarn surge

(You could also yarn s3 or maybe even yarn ipfs?)

😬 Windows users beware! You may have to change the surge code in packages/react-app/package.json to just "surge": "surge ./build",

βš™ If you get a permissions error yarn surge again until you get a unique URL, or customize it in the command line.

⚠️ Run the automated testing function to make sure your app passes

yarn test

testOutput


Checkpoint 5: πŸ“œ Contract Verification

Update the api-key in packages/hardhat/package.json file. You can get your key here.

Screen Shot 2021-11-30 at 10 21 01 AM

Now you are ready to run the yarn verify --network your_network command to verify your contracts on etherscan πŸ›°

It is okay if it says your contract is already verified. Copy the address of YourCollectable.sol and search it on sepolia Etherscan to find the correct URL you need to submit this challenge.


Checkpoint 6: πŸ’ͺ Flex!

πŸ‘©β€β€οΈβ€πŸ‘¨ Share your public url with a friend and ask them for their address to send them a collectible :)

nft15


βš”οΈ Side Quests

🐟 Open Sea

πŸƒ Want to see your new NFTs on Opensea? Head to Testnets Opensea

🎫 Make sure you have minted some NFTs on your Surge page, then connect to Opensea using that same wallet.

nft14

You can see your collection of shiny new NFTs on a testnet!

(It can take a while before they show up, but here is an example:) https://testnets.opensea.io/assets/0xc2839329166d3d004aaedb94dde4173651babccf/1

πŸ”Ά Infura

You will need to get a key from infura.io and paste it into constants.js in packages/react-app/src:

nft13


πŸƒ Head to your next challenge here.

πŸ’¬ Meet other builders working on this challenge in the Challenge 0 telegram channel!!!

πŸ‘‰ Problems, questions, comments on the stack? Post them to the πŸ— scaffold-eth developers chat