pk910 /PoWFaucet

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

★ 5,655⑂ 2,054👁 56⑃ 417● 146▤ 37
TypeScriptAGPL-3.0Created 2022-03-21
下载:v2.6.0v2.6.0 ↓2.6.02026-11-11
+0
日增长
5,655
stars
2,054
forks
56
watchers
417
prs
146
issues
37
releases

README

PoWFaucet






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

 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
      
    
  
  
    
      Sepolia Testnet
      https://sepolia-faucet.pk910.de
      
        
        
        
      
    
    
      Hoodi Testnet
      https://hoodi-faucet.pk910.de
      
        
        
        
      
    
    
      Ephemery Testnet
      https://ephemery-faucet.pk910.de
      
        
        
        
      
    
  


 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

Secrets can also be injected at runtime instead of being stored in faucet-config.yaml. The local examples document FAUCET_SECRET, FAUCET_ETH_WALLET_KEY, FAUCET_CAPTCHA_SECRET, FAUCET_GITHUB_APP_SECRET, and FAUCET_PASSPORT_SCORER_API_KEY.

 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

Top issues

Latest release

v2.6.0 v2.6.0 2026-11-11
Major Changes
 Replaced web3.js with viem, added EIP-7702 claim batching and fixed contract calls (refill vaults work again)
 Added yespower PoW algorithm, a CPU-friendly hash for the PoW module; fixed failed hashes being accepted as valid shares
 Farming hardening: idle sessions are closed, hashrate is limited per connected time, IP-change restrictions, Zupass limits now apply per ticket
 Modernized faucet UI, added Devcon 8 ticket-proof module, NodeJS 24 executables, dependency updates

 Release Artifacts
| Release File  | Description |
| ------------- | ------------- |
| powfaucet-

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON