feat: RustChain Testnet Faucet

[MontaEllis8]

Summary

Implements a Flask-based testnet faucet for dispensing free test RTC tokens to developers.

Features

• Flask web application serving /faucet page and /faucet/drip API
• IP-based rate limiting (0.5 RTC per 24 hours per IP)
• SQLite backend for tracking drip requests
• Simple HTML UI with wallet address input
• REST API for programmatic access

Files

• faucet.py - Main Flask application (~250 lines)
• FAUCET.md - Documentation

Usage

python faucet.py
# Starts on http://0.0.0.0:8090/faucet

API

curl -X POST http://localhost:8090/faucet/drip \
  -H "Content-Type: application/json" \
  -d '{"wallet": "0x..."}'

Production Notes

For production deployment:

1. Connect to RustChain node admin API for actual token transfer
2. Use dedicated faucet wallet with test tokens
3. Add GitHub OAuth for increased rate limits (1-2 RTC)

Closes: rustchain-bounties#751

[Scottcjn]

Closing — PR #633 by @chenxizhu04050020-bit delivers a superior faucet implementation (with tests, app factory, GitHub auth tiers, actual RTC transfer) that covers both bounty #755 and #751.

Your faucet was a good start but is a mock (no actual transfer, no tests). Also, this PR and #628 share the same branch — please use separate branches for separate features.

If you want credit for the Chinese translation update, please:

1. Create a NEW branch with ONLY README.zh-CN.md changes
2. Fix the broken DOI link (10.5281 got corrupted to 10.存活1)
3. Submit as a fresh PR

That would be worth 5 RTC.

[Scottcjn]

Hey @MontaEllis8 — see the feedback on #653 for how to re-submit your Chinese translation cleanly (separate branch, fix the DOI link). That is worth 5 RTC.

Also — we are literally 1 star away from the GitHub Starstruck badge! Would you star Rustchain?

https://github.com/Scottcjn/Rustchain