Repository files navigation

Faucet for EVM chains

I had a lot of problems with existing simple faucets (the ones that do not force you to use some centralized service like twitter) and had the urge to create one that does not suffer from these problems for a while.Thena tweet of pari in context of faucet problems for the kintsugi merge testnet gave the spark to finally code the faucet.

This faucet uses hCaptcha instead of reCaptcha to not feed the google.You can deeplink to a cain with the url parameterchain that contains a chain-id.And you can pass an address with the url parameteraddress that will then be pre-filled.

docker run -p 8080:8080 ghcr.io/komputing/fauceth:release

Either download the tar from the release then after untar run:

./bin/fauceth

you can also build the tar via:

./gradlew distTar

or directly run tha app from within the repo via:

./gradlew run

You can set properties of FaucETH via a file calledfauceth.properties, via environment variables or system properties.

You should setapp.chains with a comma separated list of chain-ids and alsohcaptcha.secret andhcaptcha.sitekey so you are protected by hcaptcha from faucet drainage.

Optional properties you can set areapp.title,app.imageURL,app.amount,app.logging,app.port,app.keywords,app.footer orapp.ethkeyInapp.title you can use%CHAINNAME,%CHAINTITLE,%CHAINSHORTNAME - this is especially useful if you support multiple chains.If your chains use infura RPCs please also setinfura.projectid

After you started the app you can see the address by accessinglocahost:8080/address - this way you can initially fund it.There is a status dashboard onlocahost:8080/status.

What would be real nice would be a web3 faucet - if anyone has ideas how to realize it please contact me. The problem I cannot overcome is how to validate a captcha without a backend.

Yea you could use a PoH blockchain like idena or a dapp like Proof of Humanity or brightId - but often you need the faucet to get started with crypto - so there is a hen and egg problem here.

AGPLv3