GitPedia

Faucet

The official Fuel faucet

From FuelLabs·Updated September 11, 2025·View on GitHub·

A simple faucet app for dispensing tokens on a fuel network. It uses Google captcha for spam resistance without requiring any social media based identification. The project is written primarily in Rust, first published in 2022. Key topics include: faucet, fuel, network.

Latest release: v0.7.6
October 28, 2024View Changelog →

Faucet App

build
discord

A simple faucet app for dispensing tokens on a fuel network. It uses Google captcha for spam resistance
without requiring any social media based identification.

Configuration

The faucet makes use of environment variables for configuration.

Environment VariableDescription
RUST_LOGEnvFilter configuration for adjusting logging granularity.
HUMAN_LOGGINGIf false, logs will be output as machine readable JSON.
CAPTCHA_SECRETThe secret key used for enabling Google captcha authentication.
CAPTCHA_KEYThe website key used for enabling Google captcha authentication.
WALLET_SECRET_KEYA hex formatted string of the wallet private key that owns some tokens.
FUEL_NODE_URLThe GraphQL endpoint for connecting to fuel-core.
PUBLIC_FUEL_NODE_URLThe public GraphQL endpoint for connecting to fuel-core. Ex.: https://node.fuel.network/graphql
SERVICE_PORTThe port the service will listen for http connections on.
DISPENSE_AMOUNTDispense amount on each faucet
MIN_GAS_PRICEThe minimum gas price to use in each transfer

Build and Run

To run locally, assuming environment variables have already been set:

sh
cargo run

Query Params

When integrating the faucet you can use the following query params to enhance the user experience:

NameTypeDescription
addressAddressAuto-fill the address field using the provided value
redirectUrlStringIf provided with a valid url, once the faucet is complete, the user will be redirected back to the url with tx_id as a query param
autoCloseStringIf provided empty or true will close automatically the window after the transaction is finished

Example - Redirect

  • http://localhost:3000/?address=fuel134ddh9pfsspar086htdldwxq2jsr3yvqtj5w456kkrz3s653la5q347kmc&redirectUrl=http://localhost:4000

Example - Auto Close

  • http://localhost:3000/?address=fuel134ddh9pfsspar086htdldwxq2jsr3yvqtj5w456kkrz3s653la5q347kmc&autoClose

Contributors

Showing top 12 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from FuelLabs/faucet via the GitHub API.Last fetched: 6/27/2026