Beatoz Faucet

Solo-built faucet monorepo (contract + API + UI) for testnet token distribution with abuse controls and async processing.

Role: Solo builder · architecture, implementation, and operational tooling
Period: 2025.09
Context: Beatoz Labs

01 / Executive summary

Solo-built faucet monorepo (contract + API + UI) for testnet token distribution with abuse controls and async processing.

DECISION / ASystem challenge

What made the system difficult.

Needed to throttle abuse and confirm on-chain transactions reliably under concurrent requests, while keeping claim status observable in the UI.

DECISION / BEngineering response

How boundaries and flows answered it.

Implemented contract-side cooldown/blacklist rules, reCAPTCHA + Redis rate limit/cooldown, and Bull queue processors for claim execution with confirmation polling/retry. Shipped a claim UI with address validation and transaction status checks.

03 / Technology field

01NestJS02React03Vite04Radix UI05Bull06Redis07Tailwind CSS

04 / Detailed record

Overview

Solo-built faucet service (contract + API + UI) for developer token distribution.

Key Components

Contract-side abuse controls (cooldown/blacklist patterns)
Backend async processing via Bull/Redis for broadcast + confirmation tracking
reCAPTCHA + Redis rate limiting for request throttling

05 / Factual evidence

ACTUAL PROJECT ASSET / NOT GENERATED