Ethereum-faucet-testnet

Tech stacks

• NextJS
• Typescript
• EthersJS

Rate

• Daily rate: 0.1ETH/wallet/IP
• Daily rate limiter options by IP/ wallet address: once every 24 hours
• Check current wallet balance/activity (number of transactions): at least 5 transactions (either on mainnet/sepolia)
• Check wallet age (from first transaction-request date): the oldest transaction needs to be at least 1 month ago (either mainnet/sepolia)
• ReCaptcha (Only goes live when the domain is finalized)

Getting Started

1. First, create a new Ethereum wallet to get the private key for faucet or put your own private key on the env:

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

2. Get API key for Ethereum RPC (Infura, Alchemy).

3. Once you have your API keys, create a .env.local file, and specify the following variables:

WALLET_PRIVATE_KEY=0x0000000000000000000000000000000000000000000000000000000000000000
<!-- NEXT_PUBLIC_ALCHEMY_GOERLI=https://goerli.infura.io/v3/00000000000000000000000000000000 -->
NEXT_PUBLIC_DEFAULT_WALLET_ETH_AMOUNT=0.25 //Amount for each claim
NEXT_PUBLIC_PRIVILEGED_WALLET_ETH_AMOUNT=1 ////Amount for each claim by whitelisted user

4. Finally, we can run our app:

yarn dev

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

Use captcha

Prevent bots from draining your wallet: setting NEXT_PUBLIC_ENABLE_CAPTCHA in .env file. Support only Google ReCaptcha v3.

Parameter	Type	Description
NEXT_PUBLIC_ENABLE_CAPTCHA	none (default), recaptcha_v3	Enables captcha verification

Google ReCaptcha v3

Set NEXT_PUBLIC_ENABLE_CAPTCHA to recaptcha_v3

Add NEXT_PUBLIC_RECAPTCHA_SITE_KEY and RECAPTCHA_SECRET_KEY in .env file.

Parameter	Type	Description
NEXT_PUBLIC_RECAPTCHA_SITE_KEY	string	Required. Front-end API key
RECAPTCHA_SECRET_KEY	string	Required. Back-end API key

NEXT_PUBLIC_ENABLE_CAPTCHA=recaptcha_v3
NEXT_PUBLIC_RECAPTCHA_SITE_KEY=0000000000000000000000000000000000000000
RECAPTCHA_SECRET_KEY=0000000000000000000000000000000000000000

You can create a new API Key here. It’s free of charge (there are some limits though).

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:port

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?

Add wallet addresses into consts/wallets.ts file.

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