Skip to content

Latest commit

 

History

History
184 lines (121 loc) · 7.35 KB

README.md

File metadata and controls

184 lines (121 loc) · 7.35 KB

Welcome to dapp-starter 👋

All Contributors

Version License: MIT Twitter: jellydn

Opinionated Dapp Starter Template

Demo

Screenshot

./screenshot.png

Connect to MetaMask

https://gyazo.com/6b8f75171de1fab24de552ff7930f4b8.gif

Wallet Connect

https://gyazo.com/2995c3a2c4bdbda806821839826449dc.gif

Show balance and sign message

https://gyazo.com/8e8ca7c89193d6f1463081bcd41c587e.gif

Features

  • ⚡️ The React Framework for Production NextJs
  • 📦 Hardhat - Ethereum development environment for professionals
  • 🦾 TypeChain Hardhat plugin - Automatically generate TypeScript bindings for smartcontracts while using Hardhat.
  • 🔥 web3-react - A simple, maximally extensible, dependency minimized framework for building modern Ethereum dApps
  • 🎨 daisyUI Tailwind CSS Components - clean HTML with component classes
  • 🎨 OpenZeppelin - standard for secure blockchain applications

Install

pnmm install

Usage

pnpm run dev

Run tests

pnpm run test

Pre-commit

This project uses Pre-commit to enforce code quality. To install pre-commit, run:

pre-commit install

Hardhat guideline

This project demonstrates an advanced Hardhat use case, integrating other tools commonly used alongside Hardhat in the ecosystem.

The project 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. It also comes with a variety of other tools, preconfigured to work with the project code.

Try running some of the following tasks:

npx hardhat accounts
npx hardhat compile --network localhost
npx hardhat clean
npx hardhat test
npx hardhat node
npx hardhat help
REPORT_GAS=true npx hardhat test
npx hardhat coverage
npx hardhat run scripts/deploy_greeter.ts --network localhost
node scripts/deploy.ts
npx eslint '**/*.ts'
npx eslint '**/*.ts' --fix
npx prettier '**/*.{json,sol,md}' --check
npx prettier '**/*.{json,sol,md}' --write
npx solhint 'contracts/**/*.sol'
npx solhint 'contracts/**/*.sol' --fix

Deploy to Ropsten Testnet

Etherscan verification

To try out Etherscan verification, you first need to deploy a contract to an Ethereum network that's supported by Etherscan, such as Ropsten.

In this project, copy the .env.example file to a file named .env, and then edit it to fill in the details. Enter your Etherscan API key, your Ropsten node URL (eg from Alchemy), and the private key of the account which will send the deployment transaction. With a valid .env file in place, first deploy your contract:

npx hardhat run --network ropsten scripts/deploy_greeter.ts

Then, copy the deployment address and paste it in to replace DEPLOYED_CONTRACT_ADDRESS in this command:

npx hardhat verify --network ropsten DEPLOYED_CONTRACT_ADDRESS "Hello, Hardhat!"

Contract upgrade

OpenZeppelin provides tooling for deploying and securing upgradeable smart contracts.

Smart contracts deployed using OpenZeppelin Upgrades Plugins can be upgraded to modify their code, while preserving their address, state, and balance. This allows you to iteratively add new features to your project, or fix any bugs you may find in production.

In this project, there are a 2 versions of contract: Box and BoxV2 which is improvement of Box. First deploy your contract:

npx hardhat run --network localhost scripts/deploy_upgradeable_box.ts

Then, deploy the upgrade smart contract

npx hardhat run --network localhost scripts/upgrade_box.ts

Examples

  • Simple Store App: counter-like smart contract, read/write value and listen to event from smart contract.
  • ICO Token App: How to create An ERC20 token and implement ICO smart contract (CrowdSale).
  • NFT App: How to create An ERC721 token.

Author

👤 Dung Huynh

Stargazers 🌟

Stargazers repo roster for jellydn/dapp-starter

Show your support

kofi paypal buymeacoffee

Give a ⭐️ if this project helped you!

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Dung Duc Huynh (Kaka)
Dung Duc Huynh (Kaka)

📖 💻
Waren Gonzaga
Waren Gonzaga

💵

This project follows the all-contributors specification. Contributions of any kind welcome!