EthRiver

EthRiver is a test ether faucet that users can collect ether from and donate ether to.

MLH's Web3 Global Hack Week Hackathon

I created this project for Major League Hacking's Web3 Global Hack Week Hackathon! The challenge was to hack with Web3 APIs. This project uses the below Web3 APIs:

Infura API: interacts with the faucet smart contract on the ethereum testnet so users can execute transactions with their ether wallets
Etherscan API: interacts with live ether price, gas, and smart contract so users can observe live blockchain metrics they may be interested in

Follow these steps to set up and run EthRiver on your local machine. You can also visit EthRiver on the live web!

Before you begin, ensure you have the following installed on your computer:

IMPORTANT!!! This project requires the three environment variables below to be generated in order to run locally!!!

Go to the Etherscan website at https://etherscan.io/
Sign up for an Etherscan account by clicking "Create Account" or "Sign Up."
Provide the necessary information and complete the registration process.
After logging in, go to the Etherscan Dashboard.
Find the "API-KEYs" section in the dashboard or navigate to https://etherscan.io/myapikey.
Click the "Create" button to generate a new API key.
You may need to provide additional information or agree to their terms of use. Follow the on-screen instructions.
Once generated, your Etherscan API key will be displayed.Copy and securely store this API key.

Go to the Infura website at https://infura.io/
Sign up for an Infura account by clicking the "Get Started for Free" or "Sign Up" button.
Provide the required information and follow the registration process.
Once you've registered and logged in, go to the Infura Dashboard.
Create a new Ethereum project by clicking the "Create New Project" button. 6.Give your project a name and select the 'Sepolia' Ethereum network to generate the URL from.
Your Infura API key will be generated. Copy and securely store this API key.

Go to the MetaMask website at https://metamask.io/
Click on the "Get Chrome Extension" or "Get Firefox Extension" button, depending on your browser.
Follow the on-screen instructions to add the MetaMask extension to your browser. You may need to confirm the installation.
After installation, you'll see the MetaMask icon in your browser's extensions bar. Click on it.
Click the "Get Started" button to begin setting up your wallet.
Choose the option to "Create a Wallet."
Enter a strong and secure password for your MetaMask wallet. Confirm the password.
You will be presented with a 12-word mnemonic phrase. These words are crucial for accessing your wallet and funds. Write down these words in the exact order provided. Ensure you store them securely and offline. Do not share them with anyone.
MetaMask will ask you to confirm your mnemonic phrase by selecting the words in the correct order. This step ensures that you've recorded the phrase accurately.
Once you've confirmed the mnemonic phrase, your MetaMask wallet setup is complete.
To access your wallet in the future, simply click the MetaMask icon in your browser, enter your password, and you'll be able to manage your Ethereum assets.
1. Node.js: Download and install Node.JS

Download the project repository by either downloading the zip file or using Git to clone the repository (green "<>Code" button > Clone with HTTPS, SSH or GitHub CLI)
Enter the Infura API key, Etherscan API key and MetaMask 12 word MetaMask mnemonic to the suggested.env file:
1. Enter the keys into the suggested.env file in the root folder of the ethriver-main directory.
2. Save and rename the suggested.env file from "suggested.env" to ".env" only.
Navigate to the project directory in your terminal: cd ethriver-main
Install the project dependencies: npm install