What started as a weekend project to put a UI on a raw Etherscan contract turned into something much bigger. YellowScout is a community-led portal for the Yellow protocol - a one-stop hub for developers and community members building on Yellow's Sepolia testnet.
The first feature is a YELLOW token faucet. But the vision is broader: TVL charts, governance tracking, leaderboard integration, and more. Let me walk you through what's live, how it works under the hood, and where it's headed.
Why YellowScout?
With Yellow's TGE approaching, developers need testnet YELLOW tokens to build and test applications. Until now, the only faucet was the raw smart contract on Etherscan - you had to connect your wallet, find the drip function, and call it manually.
That works for seasoned developers. But a growing ecosystem needs a friendlier entry point. And why stop at a faucet when the community needs a central hub for everything Yellow?
What's live today
YELLOW Token Faucet
Visit yellowscout.org/faucet, paste your wallet address, and receive YELLOW test tokens on Sepolia. The drip amount and cooldown period are read directly from the smart contract, so whatever the contract owner configures is exactly what you see in the UI - no hardcoded values.
The faucet calls dripTo(address) on a verified on-chain Faucet contract. On top of the contract-level cooldown, there's a layered off-chain defense stack:
- Cloudflare Turnstile CAPTCHA verification
- Per-IP rate limiting via Upstash Redis
- Device fingerprinting to prevent multi-browser abuse
- Per-wallet cooldown mirror in Redis for instant rejection
- Global rate limit as a safety net
The contract is the source of truth. The app-level checks prevent wasted gas on requests that would revert anyway.
One-click "Add to Wallet"
After receiving tokens, click "Add YELLOW to wallet" to register the token in MetaMask via EIP-747 (wallet_watchAsset). No manual contract address pasting required.
Live On-chain Stats
The landing page and faucet footer pull live data from the blockchain: contract balance, current drip amount, cooldown period, and system health. Everything updates dynamically - if the contract owner changes the drip from 1,000 to 5,000, the UI reflects it immediately.
Under the hood
- Next.js 15 (App Router) + TypeScript
- viem for blockchain interaction
- Upstash Redis for rate limiting, cooldown tracking, and metric aggregation
- Cloudflare Turnstile for bot protection
- Tailwind CSS + shadcn/ui component system
- Framer Motion for animations and page transitions
- PostHog + Vercel Analytics for observability
- Deployed on Vercel with custom domain at yellowscout.org
The server wallet only needs Sepolia ETH for gas. It doesn't hold YELLOW tokens. The faucet contract holds the supply and handles distribution. Sepolia RPCs can be unreliable, so transaction handling gracefully recovers from polling timeouts - if the RPC is slow to index a receipt, the user still sees success with a link to verify on Etherscan.
Roadmap
The faucet is the starting point. Here's what's planned:
- TVL Dashboard - snapshots, charts, and historical trends
- Governance - proposal tracking and voting status
- Leaderboard - integrated with Yellow's Scout rank system
- Airdrop tools - eligibility checks and claim tracking
- Grants & Proposals - community funding visibility
The architecture is modular. Each feature is a new route plugging into the same design system. Contributions are welcome.
Open source & community-driven
The code lives on GitHub under the yellow-scout organization. Bug reports, feature requests, and PRs are all welcome.
If you're building on Yellow and want to add a tool or integration to the portal, reach out. YellowScout is meant to be shaped by the community.
Get started
- Go to yellowscout.org/faucet
- Paste your Sepolia wallet address
- Complete the CAPTCHA
- Receive your YELLOW tokens
- Click "Add YELLOW to wallet" to track them in MetaMask
If you run into issues or have ideas, open an issue on the GitHub repo or find me on the Yellow community channels.
Built by Maharshi Mishra. YellowScout is a community initiative
Top comments (0)