atomic
← All projects
sBTC-Tools screenshot

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

TypeScriptNext.jsTailwind CSSBunTurborepoClack

Lessons Learned

Structuring shared packages early made it straightforward to keep the CLI and dashboard consistent as both grew independently.