Proof of Work Faucet for EVM chains

Faucets for ETH Testnets are spammed by bots. This faucet tries to reduce the efficiency of these automated requests by requiring some mining work to be done in exchange for ETH.

For clarification: This faucet does NOT generate new coins with the "mining" process. It's just a protection method to prevent anyone from requesting big amount of funds and draining the faucet wallet. If you want to run your own instance you need to transfer the mineable funds to the faucet wallet yourself!

Goerli Testnet: https://goerli-faucet.pk910.de

Sepolia Testnet: https://sepolia-faucet.pk910.de

Zhejiang Testnet: https://zhejiang-faucet.pk910.de

npm install

cp faucet-config.example.yaml faucet-config.yaml

edit faucet-config.yaml

npm run start

access the faucet via https://localhost:8080

see faucet-config.example.yaml

For productive setups I'd suggest using a more complex webserver that supports SSL, caching and other stuff.

See docs/apache-config.md for more.

create a data directory

create a copy of faucet-config.example.yaml and save as faucet-config.yaml

edit faucet-config.yaml and prepend /config/ to faucetStore, faucetDBFile & faucetLogFile (ensure they're not lost on updates)

faucetStore: "/config/faucet-store.json"
faucetDBFile: "/config/faucet-store.db"
faucetLogFile: "/config/faucet-events.log"

start the container: (change /home/powfaucet to your datadir)

docker run -d --restart unless-stopped --name=powfaucet -v /home/powfaucet:/config -p 8080:8080 -it pk910/powfaucet:latest --config=/config/faucet-config.yaml

You should now be able to access the faucet via https://localhost:8080

read logs:

docker logs powfaucet --follow

stop container:

docker rm -f powfaucet

Please feel free to report bugs and add new features via PRs if you like.

This faucet contains parts of code from the following projects:

pow-captcha - faucet-wasm build script

FaucETH - faucet page design

AGPLv3