eth-faucet: A TypeScript repository from bxlkm

The eth-faucet is a developer tool to get testnet Ether (ETH) in order to test and troubleshoot your decentralized application (DApp) before going live on Ethereum mainnet, where you must use real ETH.

Live version: eth-faucet-alpha.vercel.app

Getting Started

First, create a new Ethereum wallet:

yarn create-wallet

You should receive wallet credentials printed to your console:

export WALLET_ADDRESS=0x0000000000000000000000000000000000000000
export WALLET_MNEMONIC_PHRASE=fluffy kitten hates cats although it is a cat
export WALLET_PRIVATE_KEY=0x0000000000000000000000000000000000000000000000000000000000000000

Write those credentials down, you will need it!

Now, you need to find the Ethereum API for Görli network. I’m using Infura and you can use it as well. Just create a free account and generate API keys for Görli network.
Once you have your API keys, create a .env.local file, and specify the following variables:

WALLET_PRIVATE_KEY=0x0000000000000000000000000000000000000000000000000000000000000000
NEXT_PUBLIC_ETH_API_URL=https://goerli.infura.io/v3/00000000000000000000000000000000
NEXT_PUBLIC_DEFAULT_WALLET_ETH_AMOUNT=0.25 # Optional
NEXT_PUBLIC_PRIVILEGED_WALLET_ETH_AMOUNT=1 # Optional

Finally, we can run our app:

yarn dev

Open http://localhost:3000 with your browser to see it.

How to top up the wallet with Görli ETH?

You can use this faucet to request some testnet Ethereum.

How to change amount of distributed Görli ETH?

Set the NEXT_PUBLIC_DEFAULT_WALLET_ETH_AMOUNT variable in your .env file. For example:

NEXT_PUBLIC_DEFAULT_WALLET_ETH_AMOUNT=5 # 5 ETH per claim

Restricting users to claim Görli ETH once per day

If you want to restrict users from draining your wallet, you should enable transaction checks. You can do it by setting ENABLE_TRANSACTION_CHECKS in your .env file. The supported transaction history scanners you can find here:

Parameter	Type	Description
`ENABLE_TRANSACTION_CHECKS`	`none` (default), `etherscan`, `redis`	Enables transaction checks to prevent users from draining your wallet

Etherscan

To scan blockchain history for transactions you should use Etherscan History API. Just set ENABLE_TRANSACTION_CHECKS to etherscan and add ETHERSCAN_API_KEY in your .env file.

Parameter	Type	Description
`ETHERSCAN_API_KEY`	`string`	Required. Etherscan API key for Görli testnet

ENABLE_TRANSACTION_CHECKS=etherscan
ETHERSCAN_API_KEY=00000000000000000000000000000000

You can create a new API Key on Etherscan. It’s free of charge.

Redis

If you want to record transaction history in database I recommend to use Redis. Just set ENABLE_TRANSACTION_CHECKS to redis and add REDIS_URL in your .env file.

Parameter	Type	Description
`REDIS_URL`	`string`	Required. Redis connection string

ENABLE_TRANSACTION_CHECKS=redis
REDIS_URL=rediss://user:password@redis:6379

You can create a Redis database on Upstash.com. It’s free for the first 10.000 requests per month.

Privileged wallets

From now on, the faucet supports priviledged wallets. The riviledged wallet can receive higher amounts of tokens per request and the limits are not apply to them.

How to define amount of distributed Görli ETH to privileged wallets?

Set the NEXT_PUBLIC_PRIVILEGED_WALLET_ETH_AMOUNT variable in your .env file. For example:

NEXT_PUBLIC_PRIVILEGED_WALLET_ETH_AMOUNT=64 # 64 ETH per claim

How to define privileged wallets?

At the current moment, you will need to fork this repository and add wallet addresses into consts/wallets.ts file.

# Example
export const privilegedWallets = [
  "0x0000000000000000000000000000000000000000000000000000000000000001",
  "0x0000000000000000000000000000000000000000000000000000000000000002",
  "0x0000000000000000000000000000000000000000000000000000000000000003",
  ...,
  "0x0000000000000000000000000000000000000000000000000000000000009999"
]

bxlkm/eth-faucet