Skip to content

ping-pub/faucet

main
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Files

Permalink
Failed to load latest commit information.

faucet

General Faucet for Cosmos SDK testnet. There are two versions: Cosmos and Evmos

preview

Prerequisite

node -v
v16.15.0

Installation

  • clone code:
git clone https://github.com/ping-pub/faucet.git
  • setup configs, you have to change everything you need in ./config.js
{
   "port": 80,  // http port 
   "db": {
       "path": "~/.faucet.db" // db for frequency checker(WIP)
   }, 
   "blockchain": {
       "rpc_endpoint": "https://rpc.sentry-02.theta-testnet.polypore.xyz"
   },
   "sender": {
       "mnemonic": "surround miss nominee dream gap cross assault thank captain prosper drop duty group candy wealth weather scale put",
       "option": {
           "hdPaths": ["m/44'/118'/0'/0/0"],
           "prefix": "cosmos"  //address prefix
       }
   },
   "tx": {
       "amount": {
           "denom": "uatom",
           "amount": "10000" // how many does tx send for each request.
         },
       "fee": {
           "amount": [
               {
                 "amount": "1000",
                 "denom":  "uatom"
               }
           ],
           "gas": "200000"
       },
       "frequency_in_24h": "1"
   },
   "project": {
       "testnet": "Ping Testnet", // What ever you want, recommend: chain-id, 
       "logo": "https://ping.pub/logo.svg",
       "deployer": ""
   },
   // request limitation
   limit: {
       // how many times each wallet address is allowed in a window(24h)
       address: 1, 
       // how many times each ip is allowed in a window(24h),
       // if you use proxy, double check if the req.ip is return client's ip.
       ip: 10 
   }
}
  • Run faucet
node --es-module-specifier-resolution=node faucet.js

Test

visit http://localhost:80

80 is default, you can edit it in the config.json

Donation

Your donation will help us make better products. Thanks in advance.

  • Address for ERC20: USDC, USDT, ETH
0x88BFec573Dd3E4b7d2E6BfD4D0D6B11F843F8aa1
  • You can donate any token in the Cosmos ecosystem: here

About

General Faucet for Cosmos SDK testnet.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published