An open API service indexing awesome lists of open source software.

https://github.com/lndgalante/faucy

🚰 Get ethers from any testnet easily
https://github.com/lndgalante/faucy

blockchain eth ethereum ethers faucet goerli goerli-faucet goerli-network kovan kovan-faucet kovan-network rinkeby rinkeby-faucet rinkeby-network ropsten ropsten-faucet ropsten-network

Last synced: 10 months ago
JSON representation

🚰 Get ethers from any testnet easily

Awesome Lists containing this project

README

          

Faucy 🚰

Get ETH from any testnet easily

---





Chat on Telegram

## Introduction

Are you tired of:

- looking how to get ethers on testnets?
- trying to understand how Faucets works?
- looking on Faucets that are properly working?
- looking on Faucets that doesn't block your IP by 24hs?

We've got you covered! Now with [Faucy](https://faucy.dev/) you can easily get ethers from any testnet.

## Features

- 🔋 PWA Support
- 🐙 100% Open Source
- ⏰ Displays transaction status (using [Notify.js](https://docs.blocknative.com/notify))
- 🔗 Address and Network in-sync with your Web3 Provider (using [Ethers.js](https://github.com/ethers-io/ethers.js))
- 🚰 No IP blockage, only by address for 24hs, switching addresses you can keep requesting eth

## Goodies

- 🦮 Accessibility First
- 🌚 Dark Mode Support
- ☁️ Redundancy service per testnet
- 🔗 Available with ENS domain at [faucy.eth](https://faucy.eth.link)
- 📊 GDPR complaint analytics (using [GoatCounter](https://www.gatsbyjs.org/packages/gatsby-plugin-matomo/))
- 📦 Distributed over fast, performant and secure IPFS (using [Fleek](https://fleek.co))

## Supported Networks

| Network | Status | Ethers |
| ------- | ------ | ------ |
| Ropsten | ✅ | 1 |
| Kovan | ✅ | 0.1 |
| Rinkeby | ✅ | 0.2 |
| Goerli | ✅ | 0.05 |

## Redundancy Networks

| Network | Status | Ethers |
| ------- | ------ | ------ |
| Ropsten | 🚧 | 0 |
| Kovan | 🚧 | 0 |
| Rinkeby | 🚧 | 0 |
| Goerli | 🚧 | 0 |

## Development

1. Install all dependencies

```bash
> npm install && npm run install:all:deps
```

2. Run ngrok command

```bash
> ngrok http 8080
```

3. Copy HTTPS url from ngrok to Gatsby environment variable

```bash
GATSBY_FAUCY_API_URL=https://a5ee9cd4.ngrok.io
```

4. Run both projects in parallel

```bash
> npm run dev:all
```

## Design

Take a look at our [Figma](https://www.figma.com/file/e2ki1kz4pSTsXX6KAuyuaI/Faucy_UI?node-id=0%3A1) implementation, comments and feedback are welcome.
We follow [Rimble Guides](https://rimble.consensys.design/guides) to create user-friendly blockchain experiences.

## Stack

| Frontend | Backend | Services |
| --------------------------------------------------- | -------------------------------------------------------------- | ----------------------------------------- |
| [Gatsby](https://www.gatsbyjs.org) | [Express](https://expressjs.com) | [Fleek](https://fleek.co) |
| [Chakra](https://chakra-ui.com) | [Puppeteer](https://pptr.dev) | [2Captcha](https://2captcha.com) |
| [Ethers.js](https://github.com/ethers-io/ethers.js) | [Puppeteer Extra](https://github.com/berstend/puppeteer-extra) | [Browserless](https://www.browserless.io) |

## Who's using it?

- [DappHero](https://www.dapphero.io)

## How to Contribute

Take a look at [Project Guidelines](https://github.com/elsewhencode/project-guidelines) in order to follow best practices.

## Contributors

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):



Leonardo Galante

💻 📖 📆

Emilia Bagliani

🎨 ️️️️♿️

Agustin Lavarello

💻

Francisco Delgado

💻📆

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

## Information

- [Ethereum Development with Go - Faucets](https://goethereumbook.org/faucets/)
- [HedgeTrade - What is an Ethereum Faucet?](https://hedgetrade.com/what-is-ethereum-faucet/)
- [Bitfalls - What Is an Ethereum Testnet and How Is It Used?](https://bitfalls.com/2018/05/31/what-is-an-ethereum-testnet-and-how-is-it-used/)

### License

MIT ©