Inspiration

A significant portion of Bitcoin is permanently lost due to forgotten wallets, lost private keys, or the passing of holders without backup plans. Heartbit was born from the idea that users should have a secure, decentralized way to ensure their assets live on. Our goal is to give people peace of mind by automating inheritance on-chain.

What it does

Heartbit is an on-chain Bitcoin inheritance protocol built on Stacks. Users define a custom inactivity period (e.g., 30 or 90 days) and assign recipient wallets along with specific percentage allocations. If the user doesn't check in with a "heartbeat" transaction before the deadline, the contract automatically redistributes their funds to the selected recipients.

What makes Heartbit unique is that the core functionality is fully implemented in a smart contract. This means any wallet provider or platform can integrate the inheritance logic into their own apps. As an open-source project, Heartbit is designed for transparency, extensibility, and community collaboration.

How we built it

  • Frontend: Next.js (TypeScript), Tailwind CSS, shadcn/ui
  • Smart Contract: Clarity (Stacks)
  • Wallet Integration: stacks.js + Hiro Wallet
  • Timer Logic: On-chain inactivity tracking using block height
  • Testing & Simulation: Clarinet for local contract development

Challenges we ran into

  • Sparse and scattered documentation for Stacks/Clarity, especially for timing-related use cases
  • Implementing precise and secure percentage-based fund distribution
  • Ensuring smooth wallet integration across environments and testnets

Accomplishments that we're proud of

  • Developed a functional on-chain inheritance contract from scratch
  • Enabled flexible recipient allocation with customizable inactivity timers
  • Designed a user-friendly and intuitive frontend with clear flows and warnings

What we learned

  • Deep understanding of Clarity smart contract development
  • Using block height as a proxy for time on-chain
  • Integrating stacks.js to connect frontend logic with blockchain state

What's next for Heartbit

We strongly believe Heartbit’s core idea—secure, programmable inheritance—can and should be implemented across the Web3 ecosystem. Heartbit demonstrates what it means to build transparently and fully on-chain.

Upcoming improvements we're excited to add:

  • A robust reminder system (email, push notifications, dApp alerts)
  • Support for multi-token inheritance (beyond STX)
  • Analytics and dashboards to track heartbeat status and claim eligibility

Built With

  • clarinet
  • nextjs
  • sbtc
  • stacksjs
Share this project:

Updates