Hardhat Fund Me
This is a section of the Javascript Blockchain/Smart Contract FreeCodeCamp Course.
Video Coming soon...
This project is apart of the Hardhat FreeCodeCamp video.
Video coming soon...
Getting Started
Requirements
- Nodejs & npm
- You'll know you've installed nodejs right if you can run:
node --version
- And get an ouput like:
vx.x.x
- You'll know you've installed npm right if you can run:
npm --version
- And get an ouput like:
x.x.x
- You'll know you've installed nodejs right if you can run:
- Optional yarn instead of
npm
Quickstart
git clone https://github.com/PatrickAlphaC/hardhat-fund-me-fcc
cd hardhat-fund-me-fcc
npm install
Note: If you delete package-lock.json
it won't install correctly with just package.json
. You'll need to remove the line with @nomiclabs/hardhat-ethers
from package.json
, and then reinstall it with npm install --save-dev @nomiclabs/hardhat-ethers@npm:hardhat-deploy-ethers ethers
. Read more here
Typescript
For the typescript edition, run:
git checkout typescript
Useage
Deploy:
npx hardhat deploy
Testing
In this version, we run testing off a forked mainnet, so you'll need to set your MAINNET_RPC_URL
similar to how we set all our other environment variables.
npx hardhat test
Test Coverage
npx hardhat coverage
Deployment to a testnet or mainnet
- Setup environment variabltes
You'll want to set your KOVAN_RPC_URL
and PRIVATE_KEY
as environment variables. You can add them to a .env
file, similar to what you see in .env.example
.
PRIVATE_KEY
: The private key of your account (like from metamask). NOTE: FOR DEVELOPMENT, PLEASE USE A KEY THAT DOESN'T HAVE ANY REAL FUNDS ASSOCIATED WITH IT.- You can learn how to export it here.
KOVAN_RPC_URL
: This is url of the kovan testnet node you're working with. You can get setup with one for free from Alchemy
- Get testnet ETH
Head over to faucets.chain.link and get some tesnet ETH. You should see the ETH show up in your metamask.
- Deploy
npx hardhat deploy --network kovan
Estimate gas
You can estimate how much gas things cost by running:
npx hardhat test
And you'll see and output file called gas-report.txt
Estimate gas cost in USD
To get a USD estimation of gas cost, you'll need a COINMARKETCAP_API_KEY
environment variable. You can get one for free from CoinMarketCap.
Then, uncomment the line coinmarketcap: COINMARKETCAP_API_KEY,
in hardhat.config.js
to get the USD estimation. Just note, everytime you run your tests it will use an API call, so it might make sense to have using coinmarketcap disabled until you need it. You can disable it by just commenting the line back out.
Verify on etherscan
If you deploy to a testnet or mainnet, you can verify it if you get an API Key from Etherscan and set it as an environemnt variable named ETHERSCAN_API_KEY
. You can pop it into your .env
file as seen in the .env.example
.
In it's current state, if you have your api key set, it will auto verify kovan contracts!
However, you can manual verify with:
npx hardhat verify --constructor-args arguments.js DEPLOYED_CONTRACT_ADDRESS
Thank you!
If you appreciated this, feel free to follow me or donate!
ETH/Polygon/Avalanche/etc Address: 0x9680201d9c93d65a3603d2088d125e955c73BD65