Stake fake coins to yield fake rewards!
This is my capstone project from Patrick Collins' amazing freeCodeCamp + ChainLink's full course
With this app, you can interact with a Typescript React UI which allows you to:
stakeTokens: Add any approved token to the farming contract for yeild farming, collateral, or whatever you want to do.unStakeTokens: Remove your tokens from the contract.getUserTotalValue: Get the total value that users have supplied based on calculations from the Chainlink Price Feeds.issueTokens: Issue a reward to the users staking on your platform!
The admin of the deployed contract can execute the issueTokens function to pay out a "reward" for staking your tokens within this app.
If you are playing with the deployed version of this app at link, I can send you your reward if you tweet at me!
Please install or have installed the following:
This app uses Brownie. Brownie is a Python-based development and testing framework for smart contracts targeting the Ethereum Virtual Machine.
- Install Brownie, if you haven't already. Here is a simple way to install brownie. *NB: There is a breaking change within Python 3.10 and cytoolz that prevents a clean install of eth-brownie. I recommend downgrading to Python 3.9
pip install --user pipx
pipx ensurepath
# restart your terminal
pipx install eth-brownieOr if you can't get pipx to work, via pip (it's recommended to use pipx)
pip install eth-brownienpm install -g ganache-cliIf you want to be able to deploy to testnets, do the following.
- Set your environment variables
Set your WEB3_INFURA_PROJECT_ID, and PRIVATE_KEY environment variables.
You can get a WEB3_INFURA_PROJECT_ID by getting a free trial of Infura. At the moment, it does need to be infura with brownie. You can find your PRIVATE_KEY from your ethereum wallet like metamask.
You'll also need testnet rinkeby or Kovan ETH and LINK. You can get LINK and ETH into your wallet by using the rinkeby faucets located here. If you're new to this, watch this video.
You'll also want an Etherscan API Key to verify your smart contracts.
You can add your environment variables to the .env file:
export WEB3_INFURA_PROJECT_ID=<PROJECT_ID>
export PRIVATE_KEY=<PRIVATE_KEY>
export ETHERSCAN_TOKEN=<YOUR_TOKEN>DO NOT SEND YOUR KEYS TO GITHUB If you do that, people can steal all your funds. Ideally use an account with no real money in it.
brownie run scripts/deploy.pyThis will deploy the contracts, depoly some mock Chainlink contracts for you to interact with.
brownie run scripts/deploy.py --network kovanThis will do the same thing... but on Kovan.
cd front_end
yarn
yarn startand you'll be able to interact with the UI
brownie test
pip install black
pip install autoflake
autoflake --in-place --remove-unused-variables -r .
black .
The app allows for three mock tokens:
- The custom minted MATT token, which you can pay yourself after deploying the ERC20 token contract
- FAU token, which you can get from this faucet
- WETH token, which you can get from this Kovan ETH faucet THEN by calling the deposit function from this contract
To get started with Brownie:
- Chainlink Documentation
- Check out the Chainlink documentation to get started from any level of smart contract engineering.
- Check out the other Brownie mixes that can be used as a starting point for your own contracts. They also provide example code to help you get started.
- "Getting Started with Brownie" is a good tutorial to help you familiarize yourself with Brownie.
- For more in-depth information, read the Brownie documentation.
- Create React App for front end fun
- Materials-UI
- useDApp
Any questions? Open an issue or tweet at me
This project is licensed under the MIT license.