This project aims to create a new ERC-20 token named KaseiCoin (KCOIN) and provide a time period and goal for crowdsale of the token. The writing of the contracts is done using Remix. The testing of the contract via a blockchain is done using Ganache. The wallet used to purchase tokens and sign transactions is MetaMask.
The first step is to create a test network in MetaMask. Once this is complete, we want to add to accounts that will be able to interact with this test network. This is done by importing accounts into MetaMask via private keys from Ganache. Once this is complete, you should have something that looks like the following image (default ETH value is usually 100 ETH):
Once this is complete, we now need to test our contracts. The first contract KaseiCoin is compiled and we can see it successfully compiles with no errors:
Next, we want to ensure our KaseiCoinCrowdsale contract compiles successfully, which is shown below:
Next, we want to ensure our KaseiCoinCrowdsaleDeployer contract compiles successfully, which is shown below:
Once this has been completed, we want to deploy our KaseiCoinCrowdsaleDeployer contract, which will create our two other contracts along with it. We do so by navigating to the Deploy and run transcations tab in Remix and selecting Injected Provider - MetaMask from the list of dropdown options under Environment. When selected, MetaMask should automatically open and the window should look like this:
After selecting confirm in MetaMask, you can navigate to Ganache and the contract creation should appear in your Transactions tab, as shown below:
We are now ready to test and interact with our contract! During this crowdfunding phase, we are able to buy tokens, check the balance of different addresses (addresses that bought tokens), see how much Wei has been raised, view total supply, etc. After many transactions, we can see the total supply below:
We're able to see the full process of some of these functions described above in the Gif below:
If you would like to clone the repository, type git clone https://github.com/kheller18/kasei-coin.git. Refer to the Usage section for required packages
After cloning the repository locally, you'll need to have the packages listed in Installation installed on your machine. To do so, you'll need to activate your conda dev environment and running the following commands:
- There are no additional packages that need to be installed.
After all of these are installed, please refer to the Deployment section for instructions on how to view or edit the notebook.
MIT License
Copyright (c) 2023 Keenan Heller
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
- There are currently no tests associated with this project.
- There is currently no live deployment of this app on a common server. To be able to run this app, upload the
KaseiCoin.solandKaseiCoinCrowdsale.solfiles into the Remix IDE. Next, compile the contract and deploy it using Ganache and MetaMask. Upon successful deployment, you will be able to test the functions of the contract.