Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jellydn/dapp-token-ico
How to do your first ICO smart contract
https://github.com/jellydn/dapp-token-ico
crowdsale dapp dapp-starter erc20 hardhat openzeppelin react solidity typescript vitejs web3-react
Last synced: 1 day ago
JSON representation
How to do your first ICO smart contract
- Host: GitHub
- URL: https://github.com/jellydn/dapp-token-ico
- Owner: jellydn
- License: mit
- Created: 2021-09-02T14:13:30.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-12-17T20:19:36.000Z (4 days ago)
- Last Synced: 2024-12-17T21:25:35.116Z (4 days ago)
- Topics: crowdsale, dapp, dapp-starter, erc20, hardhat, openzeppelin, react, solidity, typescript, vitejs, web3-react
- Language: TypeScript
- Homepage: https://dapp-token-ico.productsway.com/
- Size: 5.58 MB
- Stars: 128
- Watchers: 9
- Forks: 63
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Welcome to dapp-token-ico 👋
[](#)
[](https://twitter.com/jellydn)
> Opinionated Dapp Starter Template
## 🏠 [Homepage](https://dapp-token-ico.productsway.com)
## ✨ [Demo](https://token-ico-demo.productsway.com)
[](https://www.youtube.com/watch?v=9fmViThaMGk)
## One click deployment
[](https://railway.app/new/template/f6mr8o?referralCode=-GINmA)
## Screenshot
### Connect to MetaMask
### Buy tokens
Place an order
Buy with MetaMask and wait for confirmation.
## Features
- ⚡️ React TypeScript template with [Vite 2](https://vitejs.dev/)
- 📦 [Hardhat](https://hardhat.org/) - Ethereum development environment for professionals
- 🦾 [TypeChain Hardhat plugin](https://github.com/ethereum-ts/TypeChain/tree/master/packages/hardhat) - Automatically generate TypeScript bindings for smartcontracts while using Hardhat.
- 🔥 [web3-react](https://github.com/NoahZinsmeister/web3-react/) - A simple, maximally extensible, dependency minimized framework for building modern Ethereum dApps
- 🎨 [daisyUI Tailwind CSS Components](https://daisyui.com/) - clean HTML with component classes
- 🎨 [OpenZeppelin](https://docs.openzeppelin.com/contracts/4.x/) - standard for secure blockchain applications
## Install
```sh
yarn install
```
## Usage
```sh
yarn dev
```
## Run tests
```sh
yarn test
```
## ICO Token
- Sign up and earn [$100 in credit](https://alchemy.com/?r=9ae3d9f1-56c4-476e-9f7e-23387e0e166a) on alchemy. More detail [here](https://docs.alchemy.com/alchemy/introduction/referral-program).
- Send some ETH to your wallet https://faucet.dimensions.network/
Create .env from .env.example from root directory. Remember to fill the value for deployed addresses.
```
ETHERSCAN_API_KEY=ABC123ABC123ABC123ABC123ABC123ABC1
ROPSTEN_PROVIDER_URL=https://eth-ropsten.alchemyapi.io/v2/
PRIVATE_KEY=
VITE_CROWDSALE_ADDRESS=
VITE_PROVIDER_URL=https://eth-ropsten.alchemyapi.io/v2/
```
Then deploy to specific network, e.g: Ropsten
```sh
npx hardhat run scripts/deploy_itmantokencrowdsale.js --network ropsten
```
Output:
```sh
Generating typings for: 0 artifacts in dir: src/types for target: ethers-v5
Successfully generated 3 typings!
Successfully generated 3 typings for external artifacts!
ITManToken deployed to: 0x58f0A11F8B2bD7c5D9251b620dcF502D3A40FCF2
Name ITManToken
Symbol ITM
Decimals 18
Total Supply BigNumber { _hex: '0xd3c21bcecceda1000000', _isBigNumber: true }
Owner 0x096cd10D7BEF8D5923b18b18E9f79CA230ee2285
openingTime 1630780077
closeTime 1631384877
ITManTokenCrowdsale deployed to: 0x304c476c4521B6d352E76a950581A59Fe2032437
```
Next step is verifying the IT Man Token
```sh
npx hardhat verify --network ropsten 0x58f0A11F8B2bD7c5D9251b620dcF502D3A40FCF2
```
Output:
```sh
Nothing to compile
Generating typings for: 0 artifacts in dir: src/types for target: ethers-v5
Successfully generated 3 typings!
Successfully generated 3 typings for external artifacts!
Compiling 1 file with 0.8.4
Successfully submitted source code for contract
contracts/ITManToken.sol:ITManToken at 0x58f0A11F8B2bD7c5D9251b620dcF502D3A40FCF2
for verification on Etherscan. Waiting for verification result...
Successfully verified contract ITManToken on Etherscan.
https://ropsten.etherscan.io/address/0x58f0A11F8B2bD7c5D9251b620dcF502D3A40FCF2#code
```
Finally, verify the IT Man Token Crowdsale
```sh
npx hardhat verify --network ropsten 0x304c476c4521B6d352E76a950581A59Fe2032437 500 0x096cd10D7BEF8D5923b18b18E9f79CA230ee2285 0x58f0A11F8B2bD7c5D9251b620dcF502D3A40FCF2 0x096cd10D7BEF8D5923b18b18E9f79CA230ee2285 1630780077 1631384877
```
Output:
```sh
Nothing to compile
Generating typings for: 0 artifacts in dir: src/types for target: ethers-v5
Successfully generated 3 typings!
Successfully generated 3 typings for external artifacts!
Compiling 1 file with 0.8.4
... some warnings
Successfully submitted source code for contract
contracts/ITManTokenCrowdsale.sol:ITManTokenCrowdsale at 0x304c476c4521B6d352E76a950581A59Fe2032437
for verification on Etherscan. Waiting for verification result...
Successfully verified contract ITManTokenCrowdsale on Etherscan.
https://ropsten.etherscan.io/address/0x304c476c4521B6d352E76a950581A59Fe2032437#code
```
## 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:
```shell
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.js --network localhost
node scripts/deploy.js
npx eslint '**/*.js'
npx eslint '**/*.js' --fix
npx prettier '**/*.{json,sol,md}' --check
npx prettier '**/*.{json,sol,md}' --write
npx solhint 'contracts/**/*.sol'
npx solhint 'contracts/**/*.sol' --fix
```
## 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:
```shell
npx hardhat run --network ropsten scripts/deploy_greeter.js
```
Then, copy the deployment address and paste it in to replace `DEPLOYED_CONTRACT_ADDRESS` in this command:
```shell
npx hardhat verify --network ropsten DEPLOYED_CONTRACT_ADDRESS "Hello, Hardhat!"
```
## Contract upgrade
OpenZeppelin provides tooling for deploying and securing [upgradeable smart contracts](https://docs.openzeppelin.com/learn/upgrading-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:
```shell
npx hardhat run --network localhost scripts/deploy_upgradeable_box.js
```
Then, deploy the upgrade smart contract
```shell
npx hardhat run --network localhost scripts/upgrade_box.js
```
## Examples
- [Simple Store App](https://github.com/jellydn/dapp-starter/pull/20): counter-like smart contract, read/write value and listen to event from smart contract.
## Author
👤 **Dung Huynh**
- Website: https://productsway.com/
- Twitter: [@jellydn](https://twitter.com/jellydn)
- Github: [@jellydn](https://github.com/jellydn)
## Stargazers 🌟
[](https://github.com/jellydn/dapp-token-ico/stargazers)
## Show your support
[](https://ko-fi.com/dunghd)
[](https://paypal.me/dunghd)
[](https://www.buymeacoffee.com/dunghd)
Give a ⭐️ if this project helped you!