Skip to content
HeartBadge docs

Badge Sequence

How each badge's sequence number is assigned within a collection and across the protocol.

Every badge has a sequence within its collection (deterministic from the derivation path) and a global HeartBadge ID (assigned at activation, determines cohort). These two numbers serve different purposes and should not be confused.

This page is being written.

The structure is fixed. The prose is being drafted from the source material and reviewed by HeartChain Labs before publication. If you need this information urgently, email docs@heartbadge.com .

What this page will cover

  • Collection-local sequence vs. global HeartBadge ID
  • Determinism: same derivation path always produces the same sequence
  • Cohort assignment from global ID
  • Handling sequence gaps from revoked badges
  • Why the two numbers exist