Skip to content
/ faucet Public
forked from cosmos/faucet

Token faucet web app for the Cosmos Hub and Gaia testnets.

Notifications You must be signed in to change notification settings

ccamel/faucet

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

79 Commits
 
 
 
 
 
 
 
 

Repository files navigation

This repo is archived as of June 29, 2020 but made available for historical record.

Cosmos Testnet Faucet

This faucet app allows anyone who passes a captcha to request tokens for a Cosmos account address. This app needs to be deployed on a Cosmos testnet full node, because it relies on using the gaiacli command to send tokens.

Prerequisites

reCAPTCHA

If you don't have a reCAPTCHA site setup for the faucet, now is the time to get one. Go to the Google reCAPTCHA Admin and create a new reCAPTCHA site. For the version of captcha, choose reCAPTCHA v2.

Checkout Code

The backend requires Go and the dep dependency tool to be installed. For the frontend, you also need to have node.js and the yarn dependency tool installed.

go get git@github.com:cosmos/faucet

Backend Setup

Production

First, set the environment variables for the backend, using ./backend/.env as a template:

cd $GOPATH/src/github.com/cosmos/faucet/backend
cp .env .env.local
vi .env.local

Then build the backend.

dep ensure
go build faucet.go

The following executable will run the faucet on port 8080.

./faucet

WARNING: It's highly recommended to run a reverse proxy with rate limiting in front of this app. Included in this repo is an example Caddyfile that lets you run an TLS secured faucet that is rate limited to 1 claim per IP per day.

Development

Run go run faucet,.go in the backend directory to serve the backend.

Frontend Setup

Production

First, set the environment variables for the frontend, using ./frontend/.env as a template:

cd $GOPATH/src/github.com/cosmos/faucet/frontend
cp .env .env.local
vi .env.local

Then build the frontend.

yarn
yarn build

Lastly, serve the ./frontend/dist directory with the web server of your choice.

Development

Run yarn serve in the frontend directory to serve the frontend with hot reload.

About

Token faucet web app for the Cosmos Hub and Gaia testnets.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Vue 57.4%
  • JavaScript 19.9%
  • Go 11.7%
  • CSS 8.2%
  • HTML 2.8%