{"id":27874671,"url":"https://github.com/camerodev/dapp-token-ico","last_synced_at":"2025-09-01T08:34:59.193Z","repository":{"id":231525117,"uuid":"774969342","full_name":"camerodev/dapp-token-ico","owner":"camerodev","description":null,"archived":false,"fork":false,"pushed_at":"2024-03-20T14:29:16.000Z","size":4699,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-07T16:43:30.532Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/camerodev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null},"funding":{"github":["jellydn"],"ko_fi":"dunghd"}},"created_at":"2024-03-20T14:28:36.000Z","updated_at":"2024-03-29T17:35:39.000Z","dependencies_parsed_at":"2024-04-04T13:17:58.935Z","dependency_job_id":"9691c864-154a-4930-be58-89c020b4d997","html_url":"https://github.com/camerodev/dapp-token-ico","commit_stats":null,"previous_names":["slickcharmer/dapp-token-ico","camerodev/dapp-token-ico"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/camerodev%2Fdapp-token-ico","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/camerodev%2Fdapp-token-ico/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/camerodev%2Fdapp-token-ico/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/camerodev%2Fdapp-token-ico/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/camerodev","download_url":"https://codeload.github.com/camerodev/dapp-token-ico/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252424895,"owners_count":21745833,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-05T01:37:13.902Z","updated_at":"2025-05-05T01:37:14.554Z","avatar_url":"https://github.com/camerodev.png","language":"TypeScript","funding_links":["https://github.com/sponsors/jellydn","https://ko-fi.com/dunghd","https://paypal.me/dunghd","https://www.buymeacoffee.com/dunghd"],"categories":[],"sub_categories":[],"readme":"# Welcome to dapp-token-ico 👋\n\n![Version](https://img.shields.io/badge/version-0.0.1-blue.svg?cacheSeconds=2592000)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](#)\n[![Twitter: jellydn](https://img.shields.io/twitter/follow/jellydn.svg?style=social)](https://twitter.com/jellydn)\n\n\u003e Opinionated Dapp Starter Template\n\n## 🏠 [Homepage](https://dapp-token-ico.productsway.com)\n\n## ✨ [Demo](https://token-ico-demo.productsway.com)\n\n[![Blockchain - DApp 101 - ICO Smart Contract](https://img.youtube.com/vi/9fmViThaMGk/0.jpg)](https://www.youtube.com/watch?v=9fmViThaMGk)\n\n## One click deployment\n\n[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/new/template/f6mr8o?referralCode=-GINmA)\n\n## Screenshot\n\n![./screenshot.png](./screenshot.png)\n\n### Connect to MetaMask\n\n![https://gyazo.com/73e88806e52c1b70211dd4911bf5a4af.gif](https://gyazo.com/73e88806e52c1b70211dd4911bf5a4af.gif)\n\n### Buy tokens\n\nPlace an order\n![https://gyazo.com/d6361cc2a18ca3140f2aa9b09fc385ca.gif](https://gyazo.com/d6361cc2a18ca3140f2aa9b09fc385ca.gif)\nBuy with MetaMask and wait for confirmation.\n![https://gyazo.com/924565f84487b15f6c391f7a6378de57.gif](https://gyazo.com/924565f84487b15f6c391f7a6378de57.gif)\n\n## Features\n\n- ⚡️ React TypeScript template with [Vite 2](https://vitejs.dev/)\n- 📦 [Hardhat](https://hardhat.org/) - Ethereum development environment for professionals\n- 🦾 [TypeChain Hardhat plugin](https://github.com/ethereum-ts/TypeChain/tree/master/packages/hardhat) - Automatically generate TypeScript bindings for smartcontracts while using Hardhat.\n- 🔥 [web3-react](https://github.com/NoahZinsmeister/web3-react/) - A simple, maximally extensible, dependency minimized framework for building modern Ethereum dApps\n- 🎨 [daisyUI Tailwind CSS Components](https://daisyui.com/) - clean HTML with component classes\n- 🎨 [OpenZeppelin](https://docs.openzeppelin.com/contracts/4.x/) - standard for secure blockchain applications\n\n## Install\n\n```sh\nyarn install\n```\n\n## Usage\n\n```sh\nyarn dev\n```\n\n## Run tests\n\n```sh\nyarn test\n```\n\n## ICO Token\n\n- 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).\n\n- Send some ETH to your wallet https://faucet.dimensions.network/\n\nCreate .env from .env.example from root directory. Remember to fill the value for deployed addresses.\n\n```\nETHERSCAN_API_KEY=ABC123ABC123ABC123ABC123ABC123ABC1\nROPSTEN_PROVIDER_URL=https://eth-ropsten.alchemyapi.io/v2/\u003cYOUR ALCHEMY KEY\u003e\nPRIVATE_KEY=\u003cYOUR PRIVATE KEY\u003e\nVITE_CROWDSALE_ADDRESS=\u003cYOUR DEPLOYED SMART CONTRACT ADDRESS\u003e\nVITE_PROVIDER_URL=https://eth-ropsten.alchemyapi.io/v2/\u003cYOUR ALCHEMY KEY\u003e\n```\n\nThen deploy to specific network, e.g: Ropsten\n\n```sh\nnpx hardhat run scripts/deploy_itmantokencrowdsale.js --network ropsten\n```\n\nOutput:\n\n```sh\nGenerating typings for: 0 artifacts in dir: src/types for target: ethers-v5\nSuccessfully generated 3 typings!\nSuccessfully generated 3 typings for external artifacts!\nITManToken deployed to: 0x58f0A11F8B2bD7c5D9251b620dcF502D3A40FCF2\nName ITManToken\nSymbol ITM\nDecimals 18\nTotal Supply BigNumber { _hex: '0xd3c21bcecceda1000000', _isBigNumber: true }\nOwner 0x096cd10D7BEF8D5923b18b18E9f79CA230ee2285\nopeningTime 1630780077\ncloseTime 1631384877\nITManTokenCrowdsale deployed to: 0x304c476c4521B6d352E76a950581A59Fe2032437\n```\n\nNext step is verifying the IT Man Token\n\n```sh\nnpx hardhat verify --network ropsten 0x58f0A11F8B2bD7c5D9251b620dcF502D3A40FCF2\n```\n\nOutput:\n\n```sh\nNothing to compile\nGenerating typings for: 0 artifacts in dir: src/types for target: ethers-v5\nSuccessfully generated 3 typings!\nSuccessfully generated 3 typings for external artifacts!\nCompiling 1 file with 0.8.4\nSuccessfully submitted source code for contract\ncontracts/ITManToken.sol:ITManToken at 0x58f0A11F8B2bD7c5D9251b620dcF502D3A40FCF2\nfor verification on Etherscan. Waiting for verification result...\n\nSuccessfully verified contract ITManToken on Etherscan.\nhttps://ropsten.etherscan.io/address/0x58f0A11F8B2bD7c5D9251b620dcF502D3A40FCF2#code\n```\n\nFinally, verify the IT Man Token Crowdsale\n\n```sh\nnpx hardhat verify --network ropsten 0x304c476c4521B6d352E76a950581A59Fe2032437 500 0x096cd10D7BEF8D5923b18b18E9f79CA230ee2285 0x58f0A11F8B2bD7c5D9251b620dcF502D3A40FCF2 0x096cd10D7BEF8D5923b18b18E9f79CA230ee2285 1630780077 1631384877\n```\n\nOutput:\n\n```sh\nNothing to compile\nGenerating typings for: 0 artifacts in dir: src/types for target: ethers-v5\nSuccessfully generated 3 typings!\nSuccessfully generated 3 typings for external artifacts!\nCompiling 1 file with 0.8.4\n\n... some warnings\n\nSuccessfully submitted source code for contract\ncontracts/ITManTokenCrowdsale.sol:ITManTokenCrowdsale at 0x304c476c4521B6d352E76a950581A59Fe2032437\nfor verification on Etherscan. Waiting for verification result...\n\nSuccessfully verified contract ITManTokenCrowdsale on Etherscan.\nhttps://ropsten.etherscan.io/address/0x304c476c4521B6d352E76a950581A59Fe2032437#code\n```\n\n## Hardhat guideline\n\nThis project demonstrates an advanced Hardhat use case, integrating other tools commonly used alongside Hardhat in the ecosystem.\n\nThe 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.\n\nTry running some of the following tasks:\n\n```shell\nnpx hardhat accounts\nnpx hardhat compile --network localhost\nnpx hardhat clean\nnpx hardhat test\nnpx hardhat node\nnpx hardhat help\nREPORT_GAS=true npx hardhat test\nnpx hardhat coverage\nnpx hardhat run scripts/deploy_greeter.js --network localhost\nnode scripts/deploy.js\nnpx eslint '**/*.js'\nnpx eslint '**/*.js' --fix\nnpx prettier '**/*.{json,sol,md}' --check\nnpx prettier '**/*.{json,sol,md}' --write\nnpx solhint 'contracts/**/*.sol'\nnpx solhint 'contracts/**/*.sol' --fix\n```\n\n## Etherscan verification\n\nTo try out Etherscan verification, you first need to deploy a contract to an Ethereum network that's supported by Etherscan, such as Ropsten.\n\nIn 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:\n\n```shell\nnpx hardhat run --network ropsten scripts/deploy_greeter.js\n```\n\nThen, copy the deployment address and paste it in to replace `DEPLOYED_CONTRACT_ADDRESS` in this command:\n\n```shell\nnpx hardhat verify --network ropsten DEPLOYED_CONTRACT_ADDRESS \"Hello, Hardhat!\"\n```\n\n## Contract upgrade\n\nOpenZeppelin provides tooling for deploying and securing [upgradeable smart contracts](https://docs.openzeppelin.com/learn/upgrading-smart-contracts).\n\nSmart 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.\n\nIn this project, there are a 2 versions of contract: Box and BoxV2 which is improvement of Box. First deploy your contract:\n\n```shell\nnpx hardhat run --network localhost scripts/deploy_upgradeable_box.js\n```\n\nThen, deploy the upgrade smart contract\n\n```shell\nnpx hardhat run --network localhost scripts/upgrade_box.js\n```\n\n## Examples\n\n- [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.\n\n## Author\n\n👤 **Dung Huynh**\n\n- Website: https://productsway.com/\n- Twitter: [@jellydn](https://twitter.com/jellydn)\n- Github: [@jellydn](https://github.com/jellydn)\n\n## Stargazers 🌟\n\n[![Stargazers repo roster for jellydn/dapp-token-ico](https://reporoster.com/stars/jellydn/dapp-token-ico)](https://github.com/jellydn/dapp-token-ico/stargazers)\n\n## Show your support\n\n[![kofi](https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge\u0026logo=ko-fi\u0026logoColor=white)](https://ko-fi.com/dunghd)\n[![paypal](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge\u0026logo=paypal\u0026logoColor=white)](https://paypal.me/dunghd)\n[![buymeacoffee](https://img.shields.io/badge/Buy_Me_A_Coffee-FFDD00?style=for-the-badge\u0026logo=buy-me-a-coffee\u0026logoColor=black)](https://www.buymeacoffee.com/dunghd)\n\nGive a ⭐️ if this project helped you!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcamerodev%2Fdapp-token-ico","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcamerodev%2Fdapp-token-ico","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcamerodev%2Fdapp-token-ico/lists"}