Skip to content

jsarenik/bitcoin-faucet-shell

Repository files navigation

bitcoin-faucet-shell

Gitpod ready-to-code

This is a test network. Coins have no value.

alt.signetfaucet is intended for education purposes in controlled environment with free testing sats. The learned skills may be used with real Bitcoin main network.

A POSIX shell implementation of a Bitcoin faucet intended for use with Busybox.

Re-implementation. The original source of this faucet comes from https://github.com/kallewoof/bitcoin-faucet

The point is to have something that can run anywhere and has no dependencies other than Bitcoin Core and busybox (which can be statically compiled for Linux x86_64 into a binary smaller than 1MB).

It runs at https://signet25.bublina.eu.org (try to open it in the Tor Browser) and any feedback is welcome here in GitHub issues, or via email.

Documentation

See also git log, about.html and #4.

API

The original REST API is following:

https://signetfaucet.com/claim/addr/amount/captcha

API access is disabled as of 2025-08-19

Busybox is returning 404 error on non-existent directories so it has to be used with Caddy2 to get a backward-compatible API. See in-repo Caddyfile.txt for an example on how to set up the redirects properly.

See contrib/getcoins.sh for an example script using wget.

About

POSIX-shell bitcoin faucet

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published