Awesome Open Source
Awesome Open Source

πŸ— scaffold-eth

is everything you need to get started building decentralized applications powered by Ethereum

πŸƒβ€β™€οΈ Quick Start

πŸ”­ Learning Solidity

πŸ“‘ Deploy

πŸ“Ί Frontend

🚩 Challenges

πŸ‘©β€πŸ’» Examples & Tutorials

Built with πŸ— scaffold-eth

πŸŒ‰ Infrastructure

|- πŸ“  Legacy Content - | - πŸ’¬ Support Chat -|

Gitpod ready-to-code


πŸƒβ€β™€οΈ Quick Start

required: Node plus Yarn and Git

git clone

cd scaffold-eth
yarn install

yarn start

in a second terminal window:

cd scaffold-eth
yarn chain

in a third terminal window:

cd scaffold-eth
yarn deploy

πŸ” Edit your smart contract YourContract.sol in packages/hardhat/contracts

πŸ“ Edit your frontend App.jsx in packages/react-app/src

πŸ’Ό Edit your deployment script deploy.js in packages/hardhat/scripts

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

πŸ— scaffold-eth is a hackthon stack for quick product prototyping on Ethereum.

πŸ‘©β€πŸ”¬ This scaffolding leverages state of the art tooling from the ecosystem.

πŸ§ͺ It is a free standing dapp so you can learn by making small changes.

After installing, your dev environment should look like this:


React dev server, HardHat blockchain, deploy terminal, code IDE, and frontend browser.

✏️ Make small changes to YourContract.sol and watch your app auto update!

πŸ” You can yarn deploy any time and get a fresh new contract in the frontend:


πŸ’΅ Each browser has an account in the top right and you can use the faucet (bottom left) to get ⛽️ testnet eth for gas:


πŸ”¨Once you have funds, you can call setPurpose on your contract and "write" to the purpose storage:


Look for the HardHat console.log() output in the yarn chain terminal:


βš—οΈ Spend some time tinkering with YourContract.sol

===================================================== ⏫ back to the top ⏫

πŸ”­ Learning Solidity

πŸ“• Read the docs:

πŸ“š Go through each topic from solidity by example editing YourContract.sol in πŸ— scaffold-eth

πŸ“§ Learn all the Solidity globals and units

πŸ‘¨β€πŸ« Start super simple with a counter: uint8 public count = 1;

⬇️ Then a function dec() public {} that does a count = count - 1;


πŸ”¬ What happens when you subtract 1 from 0? Try it out in the app to see what happens!


🚽 UNDERFLOW!?! (πŸš‘ Solidity >0.8.0 will catch this!)

🧫 You can iterate and learn as you go. Test your assumptions!

πŸ” Global variables like msg.sender and msg.value are cryptographically backed and can be used to make rules

πŸ“ Keep this cheat sheet handy

⏳ Maybe we could use block.timestamp or block.number to track time in our contract

πŸ” Or maybe keep track of an address public owner; then make a rule like require( msg.sender == owner ); for an important function

🧾 Maybe create a smart contract that keeps track of a mapping ( address => uint256 ) public balance;

🏦 It could be like a decentralized bank that you function deposit() public payable {} and withdraw()

πŸ“Ÿ Events are really handy for signaling to the frontend. Read more about events here.

πŸ“² Spend some time in App.jsx in packages/react-app/src and learn about the πŸ›° Providers

⚠️ Big numbers are stored as objects: formatEther and parseEther (ethers.js) will help with WEI->ETH and ETH->WEI.

🧳 The single page (searchable) ethers.js docs are pretty great too.

🐜 The UI framework Ant Design has a bunch of great components.

πŸ“ƒ Check the console log for your app to see some extra output from hooks like useContractReader and useEventListener.

πŸ— You'll notice the <Contract /> component that displays the dynamic form as scaffolding for interacting with your contract.

πŸ”² Try making a <Button/> that calls writeContracts.YourContract.setPurpose("πŸ‘‹ Hello World") to explore how your UI might work...

πŸ’¬ Wrap the call to writeContracts with a tx() helper that uses BlockNative's Notify.js.

🧬 Next learn about structs in Solidity.

πŸ—³ Maybe an make an array YourStructName[] public proposals; that could call be voted on with function vote() public {}

πŸ”­ Your dev environment is perfect for testing assumptions and learning by prototyping.

πŸ“ Next learn about the fallback function

πŸ’Έ Maybe add a receive() external payable {} so your contract will accept ETH?

🚁 OH! Programming decentralized money! 😎 So rad!

===================================================== ⏫ back to the top ⏫

πŸ“‘ Deploy

πŸ›° Ready to deploy to a testnet? Change the defaultNetwork in packages/hardhat/hardhat.config.js

πŸ” Generate a deploy account with yarn generate and view it with yarn account

πŸ’΅ Fund your deployer account (pro tip: use an instant wallet to send funds to the QR code from yarn account)

Deploy your contract:

yarn deploy

===================================================== ⏫ back to the top ⏫

πŸ“Ί Frontend

Edit your frontend App.jsx in packages/react-app/src

πŸ“‘ Make sure your targetNetwork is the same as πŸ‘·β€β™€οΈ HardHat's defaultNetwork (where you deployed your contracts).


🀑 Adjust your debugging settings as needed:


πŸ” Providers:

Providers are your connections to different blockchains.

The frontend has three different providers that provide different levels of access to different chains:

mainnetProvider: (read only) Alchemy or Infura connection to main Ethereum network (and contracts already deployed like DAI or Uniswap).

localProvider: local HardHat accounts, used to read from your contracts (.env file points you at testnet or mainnet)

injectedProvider: your personal MetaMask, WalletConnect via Argent, or other injected wallet (generates burner-provider on page load)


πŸ–‡ Hooks:


Commonly used Ethereum hooks located in packages/react-app/src/:

usePoller(fn, delay): runs a function on app load and then on a custom interval

usePoller(() => {
  //do something cool at start and then every three seconds
}, 3000);

useBalance(address, provider, [pollTime]): poll for the balance of an address from a provider

const localBalance = useBalance(address, localProvider);

useBlockNumber(provider,[pollTime]): get current block number from a provider

const blockNumber = useBlockNumber(props.provider);

useGasPrice([speed]): gets current "fast" price from ethgasstation

const gasPrice = useGasPrice();

useExchangePrice(mainnetProvider, [pollTime]): gets current price of Ethereum on the Uniswap exchange

const price = useExchangePrice(mainnetProvider);

useContractLoader(provider): loads your smart contract interface

const readContracts = useContractLoader(localProvider);
const writeContracts = useContractLoader(injectedProvider);

useContractReader(contracts, contractName, variableName, [pollTime]): reads a variable from your contract and keeps it in the state

const title = useContractReader(props.readContracts, contractName, "title");
const owner = useContractReader(props.readContracts, contractName, "owner");

useEventListener(contracts, contractName, eventName, [provider], [startBlock]): listens for events from a smart contract and keeps them in the state

const ownerUpdates = useEventListener(

πŸ“¦ Components:


Your commonly used React Ethereum components located in packages/react-app/src/:

πŸ“¬ <Address />: A simple display for an Ethereum address that uses a Blockie, lets you copy, and links to Etherescan.

  <Address value={address} />
  <Address value={address} size="short" />
  <Address value={address} size="long" blockexplorer=""/>
  <Address value={address} ensProvider={mainnetProvider}/>


πŸ–‹ <AddressInput />: An input box you control with useState for an Ethereum address that uses a Blockie and ENS lookup/display.

  const [ address, setAddress ] = useState("")

πŸ’΅ <Balance />: Displays the balance of an address in either dollars or decimal.



πŸ‘€ <Account />: Allows your users to start with an Ethereum address on page load but upgrade to a more secure, injected provider, using Web3Modal. It will track your address and localProvider in your app's state:

const [address, setAddress] = useState();
const [injectedProvider, setInjectedProvider] = useState();
const price = useExchangePrice(mainnetProvider);


πŸ’‘ Notice: the <Account /> component will call setAddress and setInjectedProvider for you.

===================================================== ⏫ back to the top ⏫

πŸ–² UI Library

🐜 is a fantastic UI library with components like the grids, menus, dates, times, buttons, etc.

β›‘ Helpers:

Transactor: The transactor returns a tx() function to make running and tracking transactions as simple and standardized as possible. We will bring in BlockNative's Notify library to track our testnet and mainnet transactions.

const tx = Transactor(props.injectedProvider, props.gasPrice);

Then you can use the tx() function to send funds and write to your smart contracts:

  to: readContracts[contractName].address,
  value: parseEther("0.001"),

☒️ Warning: You will need to update the configuration for react-app/src/helpers/Transactor.js to use your BlockNative dappId

🎚 Extras:

πŸ”‘ Create wallet links to your app with yarn wallet and yarn fundedwallet

⬇️ Installing a new package to your frontend? You need to cd packages/react-app and then yarn add PACKAGE

⬇️ Installing a new package to your backend? You need to cd packages/harthat and then yarn add PACKAGE

πŸ›³ Ship it!

You can deploy your app with:

# packge up the static site:

yarn build

# ship it!

yarn surge


yarn s3


yarn ipfs

πŸš€ Good luck!

===================================================== ⏫ back to the top ⏫

🚩 Challenges

  1. πŸ₯© Decentralized Staking App

  2. 🏡 Token Vendor

===================================================== ⏫ back to the top ⏫

πŸ“‘ Examples and Tutorials

(todo: insert all the cool active branches)


^^^ ⛏ PR your πŸ— scaffold-eth branch!!! πŸ™πŸ™πŸ™ ^^^

===================================================== ⏫ back to the top ⏫

πŸ”¨ Built with πŸ— scaffold-eth:

πŸ‘©β€πŸŽ¨ Nifty Ink

Paintings come to life as you "ink" new creations and trade them on Ethereum. A deep dive into πŸ–Ό NFTs, 🐳 OpenSea, πŸ– react-canvas-draw, 🎨 react-color, and πŸ›¬ onboarding user experience.

πŸƒβ€β™‚οΈ SpeedRun πŸ“Ή (TODO)

πŸ’Ύ Source Code

πŸ§™β€β™‚οΈ Instant Wallet

An instant wallet running on xDAI insired by

πŸ’Ύ Source Code

πŸ—³ Personal Token Voting

Poll your holders! Build an example emoji voting system with πŸ— scaffold-eth. πŸ” Cryptographically signed votes but tracked off-chain with πŸ“‘ Zapier and πŸ“‘ Google Sheets.

πŸƒβ€β™‚οΈ SpeedRun πŸ“Ή

πŸ’Ύ Source Code

^^^ ⛏ PLEASE PR your πŸ— scaffold-eth project in above!!! πŸ™πŸ™πŸ™ ^^^

===================================================== ⏫ back to the top ⏫

πŸ“Ÿ Infrastructure

πŸ›° Using The Graph


πŸŽ₯ here is another Graph speed run tutorial video

πŸ”¬ Using Tenderly

Tenderly is a platform for monitoring, alerting and trouble-shooting smart contracts. They also have a hardhat plugin and CLI tool that can be helpful for local development!

Hardhat Tenderly announcement blog for reference.

Verifying contracts on Tenderly

scaffold-eth includes the hardhat-tenderly plugin. When deploying to any of the following networks:


You can verify contracts as part of the deploy.js script. We have created a tenderlyVerify() helper function, which takes your contract name and its deployed address:

await tenderlyVerify(
  {contractName: "YourContract",
   contractAddress: yourContract.address

Make sure your target network is present in the hardhat networks config, then either update the default network in hardhat.config.js to your network of choice or run:

yarn deploy --network NETWORK_OF_CHOICE

Once verified, they will then be available to view on Tenderly!


Exporting local Transactions

One of Tenderly's best features for builders is the ability to upload local transactions so that you can use all of Tenderly's tools for analysis and debugging. You will need to create a tenderly account if you haven't already.

Exporting local transactions can be done using the Tenderly CLI. Installing the Tenderly CLI:

brew tap tenderly/tenderly
brew install tenderly

See alternative installation steps here

You need to log in and configure for your local chain (including any forking information) - this can be done from any directory, but it probably makes sense to do under /packages/hardhat to ensure that local contracts are also uploaded with the local transaction (see more below!)

cd packages/hardhat
tenderly login
tenderly export init

You can then take transaction hashes from your local chain and run the following from the packages/hardhat directory:

tenderly export <transactionHash>

Which will upload them to!

Tenderly also allows users to debug smart contracts deployed to a local fork of some network (see yarn fork). To let Tenderly know that we are dealing with a fork, run the following command:

tenderly export init

CLI will ask you for your network's name and whether you are forking a public network. After choosing the right fork, your exporting will look something like this:

tenderly export <transactionHash> --export-network <networkName>

Note that tenderly.yaml file stores information about all networks that you initialized for exporting transactions. There can be multiple of them in a single file. You only need the --export-network if you have more than one network in your tenderly.yaml config!

A quick note on local contracts: if your local contracts are persisted in a place that Tenderly can find them, then they will also be uploaded as part of the local transaction export, which is one of the freshest features! We have added a call to tenderly.persistArtifacts() as part of the scaffold-eth deploy() script, which stores the contracts & meta-information in a deployments folder, so this should work out of the box.

Another pitfall when dealing with a local network (fork or not) is that you will not see the transaction hash if it fails. This happens because the hardhat detects an error while eth_estimateGas is executed. To prevent such behaviour, you can skip this estimation by passing a gasLimit override when making a call - an example of this is demonstrated in the FunctionForm.jsx file of the Contract component:

let overrides = {}
// Uncomment the next line if you want to skip the gas estimation for each transaction
// overrides.gasLimit = hexlify(1200000);
const returned = await tx(contractFunction(...args, overrides));

One gotcha - Tenderly does not (currently) support yarn workspaces, so any imported solidity contracts need to be local to packages/hardhat for your contracts to be exported. You can achieve this by using nohoist - this has been done for hardhat so that we can export console.sol - see the top-level package.json to see how!

"workspaces": {
  "packages": [
  "nohoist": [

🌐 Etherscan

Hardhat has a truly wonderful hardhat-etherscan plugin that takes care of contract verification after deployment. You need to add the following to your hardhat.config.js imports:


Then add your etherscan API key to the module.exports:

etherscan: {
  // Your API key for Etherscan
  // Obtain one at

Verifying is simple, assuming you are verifying a contract that you have just deployed from your hardhat setup - you just need to run the verify script, passing constructor arguments as an array if necessary (there is an example commented out in the deploy.js):

await run("verify:verify", {
  address: yourContract.address,
  // constructorArguments: args // If your contract has constructor arguments, you can pass them as an array

You only have to pass the contract because the plugin figures out which of the locally compiled contracts is the right one to verify. Pretty cool stuff!

πŸ”Ά Using Infura

You will need to update the constants.js in packages/react-app/src with your own Infura ID.

πŸŸͺ Blocknative

update the BLOCKNATIVE_DAPPID in packages/react-app/src/constants.js with your own Blocknative DappID

===================================================== ⏫ back to the top ⏫

πŸ“  Legacy Content

🧫 Building on Ethereum in 2020 (research for this repo)


Tutorial 1: πŸ›  Programming Decentralized Money

Learn the basics of πŸ— scaffold-eth and building on Ethereum. πŸ‘·β€β™‚οΈ HardHat, πŸ“¦ create-eth-app, πŸ”₯ hot reloading smart contracts, πŸ›° providers, πŸ”— hooks, πŸŽ› components, and building a decentralized application. πŸŽ₯ Guided Tutorial

Tutorial 2: 🏡 The Token

Learn about tokens. [coming soon] What is a token? Why is it cool? How can I deploy one? Exotic mechanisms? (todo)

Tutorial 3: βš–οΈ Minimum Viable Decentralized Exchange

Learn the basics of Automated Market Makers like πŸ¦„ Uniswap. Learn how πŸ’°Reserves affect the πŸ“‰ price, βš–οΈ trading, and πŸ’¦ slippage from low liquidity.

πŸƒβ€β™€οΈ SpeedRun πŸ“Ή

Tutorial 4: πŸš€ Connecting ETH to IPFS

Build a simple IPFS application in πŸ— scaffold-eth to learn more about distributed file storage and content addressing. πŸŽ₯ Live Tutorial

Tutorial 5: ⛽️GSN and Meta Transactions

Learn about to provide your users with better UX by abstracting away gas fees and blockchain mechanics. (todo)

Tutorial 6: πŸ›° Decentralized Deployment

Learn how to deploy your smart contract to a production blockchain. Then deploy your applicaton to Surge, S3, and IPFS. Finally, register an ENS and point it at the decentralized content! πŸŽ₯ Live Tutorial

πŸ’¬ Support Chat

Join the telegram support chat πŸ’¬ to ask questions and find others building with πŸ— scaffold-eth!

===================================================== ⏫ back to the top ⏫

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
javascript (68,711)Β 
react (5,295)Β 
ethereum (714)Β 
graph (391)Β 
create-react-app (132)Β 
scaffolding (40)Β 
eth (35)Β 

Find Open Source By Browsing 7,000 Topics Across 59 Categories

Advertising πŸ“¦Β 10
All Projects
Application Programming Interfaces πŸ“¦Β 124
Applications πŸ“¦Β 192
Artificial Intelligence πŸ“¦Β 78
Blockchain πŸ“¦Β 73
Build Tools πŸ“¦Β 113
Cloud Computing πŸ“¦Β 80
Code Quality πŸ“¦Β 28
Collaboration πŸ“¦Β 32
Command Line Interface πŸ“¦Β 49
Community πŸ“¦Β 83
Companies πŸ“¦Β 60
Compilers πŸ“¦Β 63
Computer Science πŸ“¦Β 80
Configuration Management πŸ“¦Β 42
Content Management πŸ“¦Β 175
Control Flow πŸ“¦Β 213
Data Formats πŸ“¦Β 78
Data Processing πŸ“¦Β 276
Data Storage πŸ“¦Β 135
Economics πŸ“¦Β 64
Frameworks πŸ“¦Β 215
Games πŸ“¦Β 129
Graphics πŸ“¦Β 110
Hardware πŸ“¦Β 152
Integrated Development Environments πŸ“¦Β 49
Learning Resources πŸ“¦Β 166
Legal πŸ“¦Β 29
Libraries πŸ“¦Β 129
Lists Of Projects πŸ“¦Β 22
Machine Learning πŸ“¦Β 347
Mapping πŸ“¦Β 64
Marketing πŸ“¦Β 15
Mathematics πŸ“¦Β 55
Media πŸ“¦Β 239
Messaging πŸ“¦Β 98
Networking πŸ“¦Β 315
Operating Systems πŸ“¦Β 89
Operations πŸ“¦Β 121
Package Managers πŸ“¦Β 55
Programming Languages πŸ“¦Β 245
Runtime Environments πŸ“¦Β 100
Science πŸ“¦Β 42
Security πŸ“¦Β 396
Social Media πŸ“¦Β 27
Software Architecture πŸ“¦Β 72
Software Development πŸ“¦Β 72
Software Performance πŸ“¦Β 58
Software Quality πŸ“¦Β 133
Text Editors πŸ“¦Β 49
Text Processing πŸ“¦Β 136
User Interface πŸ“¦Β 330
User Interface Components πŸ“¦Β 514
Version Control πŸ“¦Β 30
Virtualization πŸ“¦Β 71
Web Browsers πŸ“¦Β 42
Web Servers πŸ“¦Β 26
Web User Interface πŸ“¦Β 210