StarkBTC-Flow

Bridge Bitcoin trust with StarkNet speed

Comment

🌟 Inspiration

The crypto ecosystem is full of speed, but short on trust. Bitcoin offers unmatched credibility, while StarkNet delivers scalability. StarkBTC Flow was born from the need to bridge these worlds—securely, transparently, and cinematically. We wanted a tool that not only simulates swaps, but narrates them with clarity, fallback logic, and trust scoring. Built for founders, reviewers, and hackathon judges who value precision and emotional impact.

🚀 What it does

StarkBTC Flow is a modular CLI tool that:

  • Simulates Bitcoin-to-StarkNet swaps with fee breakdowns
  • Verifies wallet ownership using mock/testnet logic
  • Assigns trust scores and badge tiers (🥉 Bronze to 🏅 Gold)
  • Generates Markdown, HTML, and JSON reports automatically
  • Logs fallback triggers and error paths for debugging
  • Auto-opens cinematic dashboards for reviewer walkthroughs All commands are executed inside MSYS2 MinGW64, and reports are auto-generated based on CLI flags.

🧱 How we built it

  • C++17 with modular architecture across swap_simulator, wallet_verifier, and report_generator
  • Makefile pipeline for clean builds and CLI orchestration
  • Markdown + HTML + JSON logging using nlohmann/json and std::filesystem
  • Badge logic and fallback triggers wired to fee thresholds
  • MSYS2 MinGW64 shell for Windows compatibility
  • Demo video captured using terminal overlays and voiceover scripting on Canva

🧗 Challenges we ran into

  • Debugging Makefile tab issues and MSYS2 path quirks
  • Refactoring free functions into resilient class methods
  • Aligning header declarations with implementation to fix linker errors
  • Designing fallback logic that feels cinematic, not chaotic
  • Capturing CLI output in a way that’s demo-friendly and emotionally clear

Accomplishments that we're proud of

We built a fully modular CLI pipeline with clean builds and zero linker errors, auto-generating Markdown, HTML, and JSON reports with trust scoring and fallback logs. The demo video captures the entire flow—from swap simulation to wallet verification with cinematic clarity.

📚 What we learned

  • How to architect resilient C++ pipelines with emotional clarity
  • How to debug MSYS2 quirks and make the terminal behave
  • How to narrate technical flows with cinematic precision
  • How to treat fallback logs and wallet scoring as storytelling tools
  • That every CLI flag can be a portfolio milestone if designed with intention

🔮 What's next for StarkBTC-Flow

  • SDK for integrating swap simulation into other dApps
  • Mobile dashboard with fallback toggles and badge previews
  • ZK audit mode for privacy-first verification
  • StarkNet-native trust badge contract
  • .sh launcher for one-click Devpost demos
  • Cairo hash preview and contract parsing for deeper integration
Share this project:

Updates