This faucet app allows anyone to request tokens for a Cosmos account address, either in command line or in service mode, with optional ReCaptcha security.
The faucet app supports any Cosmos based blockchain and is intended to be configured on testnet networks.
go install github.com/okp4/cosmos-faucet@latest
cosmos-faucet --helpConfiguration can be passed as CLI argument, configuration file (config.yml) or by environment variable prefixed by FAUCET (i.e.: FAUCET_MNEMONIC).
grpc-address: 127.0.0.1:9090
mnemonic: "kiwi nuclear blast wet badge..."
chain-id: testnet-1
denom: uatom
prefix: cosmos
fee-amount: 0
amount-send: 1
memo: "Sent by økp4 faucet"
gas-limit: 200000Send tokens to a given address
Usage:
cosmos-faucet send <address> [flags]
Flags:
-h, --help help for send
Global Flags:
--amount-send int Amount send value (default 1)
--chain-id string The network chain ID (default "localnet-okp4-1")
--denom string Token denom (default "know")
--fee-amount int Fee amount
--gas-limit uint Gas limit (default 200000)
--grpc-address string The grpc okp4 server url (default "127.0.0.1:9090")
--memo string The memo description (default "Sent by økp4 faucet")
--mnemonic string
--no-tls No encryption with the GRPC endpoint
--prefix string Address prefix (default "okp4")
--tls-skip-verify Encryption with the GRPC endpoint but skip certificates verification
--tx-timeout duration Transaction timeout (default 5s)Start the GraphQL api
Usage:
cosmos-faucet start [flags]
Flags:
--address string graphql api address (default ":8080")
--batch-window duration Batch temporal window, can be seen a the minimum duration between too transactions. (default 8s)
--captcha enable captcha verification
--captcha-min-score float set Captcha min score (default 0.5)
--captcha-secret string set Captcha secret
--captcha-verify-url string set Captcha verify URL (default "https://www.google.com/recaptcha/api/siteverify")
--health enable health endpoint
-h, --help help for start
--metrics enable metrics endpoint
Global Flags:
--amount-send int Amount send value (default 1)
--chain-id string The network chain ID (default "localnet-okp4-1")
--denom string Token denom (default "know")
--fee-amount int Fee amount
--gas-limit uint Gas limit (default 200000)
--grpc-address string The grpc okp4 server url (default "127.0.0.1:9090")
--memo string The memo description (default "Sent by økp4 faucet")
--mnemonic string
--no-tls No encryption with the GRPC endpoint
--prefix string Address prefix (default "okp4")
--tls-skip-verify Encryption with the GRPC endpoint but skip certificates verification
--tx-timeout duration Transaction timeout (default 5s)Start GraphQL server with captcha verification for the send token mutation and subscription.
cosmos-faucet start --captcha --captcha-secret $CAPCTHA_SECRETAccess on playground and documentation at the root of server.
The project comes with a convenient Makefile which depends on Docker. Please verify that Docker is properly installed and if not, follow the instructions:
- for macOS: https://docs.docker.com/docker-for-mac/install/
- for Windows: https://docs.docker.com/docker-for-windows/install/
- for Linux: https://docs.docker.com/engine/install/
To build the app, invoke the following goal build of the Makefile:
make buildThe app will be generated under the folder target/dist.
A simple star in this repository is enough to make us happy!
But you're also welcome to contribute! We appreciate any help you're willing to give. Don't hesitate to open issues and/or submit pull requests.
Remember that this is the Cosmos Token Faucet we use at OKP4. This is why we may have to refuse change requests simply because they do not comply with our internal requirements, and not because they are not relevant.