LSK faucet is a web application that can be configured and deployed to get ETH and custom ERC20 tokens on any test network. The tokens can be used to test and troubleshoot your decentralized application or protocol before going live on the Mainnet.

• Allow to configure the funding account via private key or keystore
• Asynchronous processing Txs to achieve parallel execution of user requests
• Rate limiting by ETH address and IP address as a precaution against spam
• Prevent X-Forwarded-For spoofing by specifying the count of reverse proxies

• Go (1.22 or later)
• Node.js
• Solidity compiler (solc)
• Abigen

1. Clone the repository and navigate to the app’s directory

git clone https://github.com/LiskHQ/lsk-faucet.git
cd lsk-faucet

2. Bundle Frontend web with Vite

NOTE: Please make sure to update the token icon under web/public/ with the specific ERC20 token icon. The file must be named token.png. We recommend the image dimensions to be 128px x 128px.

make build-frontend

3. Generate Go binding for ERC20 token smart contract

make generate-binding ERC20_CONTRACT_FILE_PATH=<erc20-contract-file-path>

NOTE: Please make sure to generate the Go binding corresponding to your contract before building the project.

4. Build Go project

make build-backend

Use private key to fund users

make run FLAGS="-httpport 8080 -wallet.provider http://localhost:8545 -wallet.privkey privkey"

Use keystore to fund users

make run FLAGS="-httpport 8080 -wallet.provider http://localhost:8545 -wallet.keyjson keystore -wallet.keypass password.txt"

Below is a list of environment variables that can be configured.

• WEB3_PROVIDER: RPC Endpoint to connect with the network node.
• PRIVATE_KEY: Private key hex to fund user requests with.
• KEYSTORE: Keystore file to fund user requests with.
• HCAPTCHA_SITEKEY: hCaptcha sitekey.
• HCAPTCHA_SECRET: hCaptcha secret.
• ERC20_TOKEN_ADDRESS: Contract address of the ERC20 token on the configured network, defaults to contract address for Lisk ERC20 tokens on Lisk Sepolia.

You can configure the funder by setting any of the following environment variable instead of command-line flags:

export PRIVATE_KEY=<hex-private-key>

or

export KEYSTORE=<keystore-path>
echo "your keystore password" > `pwd`/password.txt

Then run the faucet application without the wallet command-line flags:

make run FLAGS="-httpport 8080"

Optional Flags

The following are the available command-line flags(excluding above wallet flags):

Run the following command to build docker image:

make build-image

Set the appropriate configuration in .env file and run the following command to start the application:

make docker-start

Distributed under the MIT License. See LICENSE for more information.