Swan Faucet is a pretty minimalistic faucet for Ethereum-based ERC20 tokens. It's based on a simple smart contract that will allow you to withdraw some tokens every couple of minutes. The amount of tokens and the waiting period can be defined upon deployment of the smart contract.
Technology Stack: node + react.js + web3
Running Swan Faucet as a container is the recommended way of using it.
https://docs.docker.com/compose/install/
Before deploying, you need to set environment variables in a .env file inside the backend directory, an
example .env.example file is provided
WALLET_ADDRESSthe address of signer that will be calling the function on the server-sidePRIVATE_KEYthe private key of this wallet addressFAUCET_ADDRESS_MUMBAIfaucet contract addressRPC_URL_MUMBAIthe url of the RPC server/node (defaults tohttps://matic-mumbai.chainstacklabs.com)PORTthe localhost port the server is running on (defaults to 5000)REDIS_HOSTthe localhost port of the redis databaseFAUCET_ADDRESS_BINANCE_TESTNETfaucet contract addressRPC_URL_BINANCE_TESTNETthe url of the RPC server/node
For the frontend, you need to set environment variables inside the vue-frontend/config directory
NODE_ENVproduction or development,BASE_APIthe base API for the UIBASE_NETWORKthe base RPC networkTOKEN_ADDRESSthe token addressFAUCET_ADDRESSthe address of the faucet contractMATIC_TOKEN_ADDRESSnative token addressGOOGLE_KEYkey for google recaptcha service
Run the following command to run the latest stable image of Swan Faucet
docker-compose upYou can check the service at:
Install npm. (Version v14.18.1 of Node was used for this project) Both the front
and backend use npm as the package manager.
Install redis.io The backend uses a redis server to provide API rate limiting.
cd backendnpm installcd ..
cd vue-frontendnpm installcd ..
npm run build should build the project. The build artifacts will be stored in the build/ directory
redis-server
node server