• Stars
    star
    2,833
  • Rank 16,053 (Top 0.4 %)
  • Language
    TypeScript
  • License
    GNU Affero Genera...
  • Created over 2 years ago
  • Updated 9 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Modularized faucet for EVM chains with different protection methods (Captcha, Mining, IP, Mainnet Balance, Gitcoin Passport and more)

PoWFaucet

GitHub release (latest by date) codecov

Modularized faucet for EVM chains with different protection methods (Captcha, Mining, IP, Mainnet Balance, Gitcoin Passport and more)

Warning: The master branch of this repository is now pointing to the new modularized v2 version of the faucet.

The v2 version is not compatible with the pow-only v1 configuration or database schema! When upgrading a v1 instance, you need to delete the old database file and recreate the configuration. Read through the Faucet Operator Wiki to see the installation and configuration instructions.

The latest version of the v1 faucet can be fetched via the v1 branch. I'll keep it updated in case any issues come up on v1, but don't expect any new features :)

Why

Faucets for ETH Testnets are spammed by bots. This faucet tries to reduce the efficiency of these automated requests by various protection methods.

This faucet is mostly known for its proof-of-work based protection, which is currently the best and most reliable way to distribute funds on a network that got low on fund reserves.

For clarification: This faucet does NOT generate new coins with the "mining" process. It's just one of the protection methods the faucet uses 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 funds you want to distribute to the faucet wallet yourself!

For a more detailed description, take a look into the Project Wiki

Instances

Testnet Link
Goerli Testnet https://goerli-faucet.pk910.de Faucet Version Uptime Robot ratio (30 days) Faucet Balance
Sepolia Testnet https://sepolia-faucet.pk910.de Faucet Version Uptime Robot ratio (30 days) Faucet Balance
Ephemery Testnet https://ephemery-faucet.pk910.de Faucet Version Uptime Robot ratio (30 days) Faucet Balance

Run Yourself

Read the Faucet Operator Wiki to see the installation and configuration instructions.

You can also find some demo instances with different module combinations here: Demo Instances

Bugs & Features

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

Thanks To

This faucet contains parts of code from the following projects:

pow-captcha - faucet-wasm build script

FaucETH - faucet page design

License

License: AGPL v3