Skip to content

Multi-chain faucet server for cosmos based blockchain.

Notifications You must be signed in to change notification settings

celestiaorg/cosmfaucet

 
 

Repository files navigation

Cosmfaucet

Cosmfaucet is a self-hosted faucet service for cosmos based blockchain.

Homescreen

Supported Features

  • Multi-chain support

End-to-end Test Environment

To launch a e2e environment, please follow below steps.

  1. Visit to the e2e directory.
  2. Run docker-compose up to launch 2 chains, a relayer and the faucet service.
  3. Visit to the http://localhost:8080 with your browser.

Run faucet server manually

$ make build
$ ./bin/server --config-file config.yml

Run from docker

Please check e2e/docker-compose.yml file.

Configuration

You can add supported chains as many as possible.

# config.yml
server:
  allow_cors: false
  http:
    port: 8081
  grpc:
    port: 9092
  limit:
    enabled: true
    period: 86400
chains:
  - name: "cosmos"
    key_name: "cosmos"
    chain_id: "testchain"
    rpc_endpoint: "http://localhost:26657/"
    account_prefix: "cosmos"
    sender: "cosmos1u9vn33qs6jdr3wwq4u2l9p349n9c95uxz2lew0"
    key: "reopen throw concert garment wash slab jump company habit father below stage float attitude achieve net charge bulb mouse mind fat net hello vague"
    gas_adjustment: 1.2
    gas_price: "0.01uatom"
    drop_coin: "10000000uatom"
  - name: "osmosis"
    ...
option description default
server.allow_cors Allow CORS Policy false
server.http.port HTTP Server Port 8081
server.grpc.port GRPC Server Port 9092
server.limit.enabled Enable the faucet limit to prevent the fund from being drained from the single user true
server.limit.period The period of the faucet limit in seconds, any user cannot run the request more than once within this period 86400
chains[].name The name of the chain
chains[].key_name The name of the keyfile, the key is stored on {name}.info file in the keys folder
chains[].chain_id The chain id of the chain, all chain ids must be unique for each other
chains[].rpc_endpoint The RPC endpoint of the chain, it must be accessible from the faucet server
chains[].account_prefix The account prefix of the chain, it is used to check wether the given address is valid or not
chains[].sender The address of the sender
chains[].key The private key of the sender,
it is used to sign the transaction
Please do not use this key for important business, it must be only used for faucet service
chains[].gas_adjustment It's used to avoid underestimating amount of gas needed to send transaction
chains[].gas_price The gas price of the chain
chains[].drop_coin The amount of the coin to be dropped, it must be in the format of {amount}{denom}

Contribution

Please feel free to open an issue or a pull request.

About

Multi-chain faucet server for cosmos based blockchain.

Resources

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages

  • Go 50.4%
  • JavaScript 35.4%
  • HTML 6.5%
  • Shell 5.0%
  • Makefile 1.4%
  • Dockerfile 1.1%
  • CSS 0.2%