
sBTC-Tools
A monorepo suite of developer tools for sBTC on the Stacks blockchain, built for the Hiro Hacks hackathon. Includes a CLI for transferring STX and querying balances, plus a real-time analytics dashboard tracking sBTC supply, holders, and transfers.
Role
Solo Engineer
Duration
April 2025 – May 2025 (Hiro Hacks hackathon)
Problem
Working with sBTC on Stacks meant piecing together manual contract calls and queries — there was no single tool to transfer STX, check balances, or visualize sBTC activity in one place.
Solution
Built a monorepo containing three apps: a CLI for common sBTC/STX operations, an analytics dashboard visualizing supply, holders, transfers, and price history, and a landing page tying the tools together, sharing common UI and utility packages across all three.
Key Engineering Decisions
Structured the project as a monorepo with shared packages (config, utils, UI components) rather than separate repos, so the CLI and dashboard could share logic and stay consistent as the toolset grew.
Architecture
Monorepo structure with apps/ (web, cli, analytics) and packages/ (shared config, utils, UI components), using Bun as the package manager and runtime.
Engineering Highlights
- Built a CLI for transferring STX and querying sBTC balances
- Built a real-time analytics dashboard tracking sBTC supply, active holders, transfers, and price history
- Structured as a monorepo with shared UI and utility packages across three apps
Tech Stack
Lessons Learned
Structuring shared packages early made it straightforward to keep the CLI and dashboard consistent as both grew independently.