Skip to main content

Faucet

While Giraffe strives to be money-free, there still needs to be a currency in order for the protocol to function. Obtaining testnet tokens is generally done through a "faucet".

There are many approaches to faucet implementation, and most of them involve a centralized backend to keep track of deposits and impose rate limiting.

Giraffe is trying something different. Anyone with a GitHub account can use the faucet by following these steps:

  1. Get your address
  2. Click the ⭐ Star button on the Giraffe repository
  3. Create a new public Gist
    • Gist description...: Leave empty
    • Filename including extension...: {address}.giraffe_faucet
      • Don't include the curly braces {}
      • Example: a_86eTia5YDjNxE6fc917aJB6VsttYzepbve8TJghkuZPE.giraffe_faucet
    • Contents: Anything
    • Example
  4. Done! Periodically, the faucet will run in the background and deposit funds at your address.

Implementation

Everything runs through GitHub.

  • View the workflow status here.
  • View the code here.