Skip to content
HeartBadge docs

Earning Status

Live

What counts as an action, how the 30-day window works, and how to keep your activity tier.

Your cohort is set at activation and doesn't change. Your activity tier is the lever you can pull. This page documents exactly what counts toward it, how the 30-day window works, and what to expect as tiers recompute.

What counts as an action

An action is any verified participation event your badge originates or co-signs. The protocol counts these one-for-one — there's no weighting, no partial credit, no bonus actions. Fifteen scans counts the same as fifteen bumps.

Action What it is
Event check-in Scanning your badge at a program-operated scanner
Quest step completion Completing a defined step in a program quest
Bump / co-sign A mutual proof-of-presence attestation with another badge
Peer-to-peer transfer sent Sending rewards to another member (the sender gets the action credit)
Gift purchased Buying a gift code or gift badge
Messagebox message sent Authenticated BRC-31 message from your badge identity
Referral activated A badge you referred completes its own activation

What does not count

  • Receiving a reward, gift, or message. Passive events don't count; the sender gets the action credit, not the recipient.
  • Time passing. Holding the badge without using it is not an action.
  • Purchasing a badge. Activation is not itself an action. Your first action is the first thing your badge does after activating.
  • Reading the docs. Much appreciated, still not an action.

The 30-day window

Your activity tier is recomputed on a fixed cadence tied to your badge — every 30 days from the moment of activation. At each recompute, the protocol counts actions logged in the preceding 30 days and assigns the tier whose minimum you met.

The window is fixed, not rolling within the period. Once a recompute happens, your new tier holds for the next 30 days regardless of what you do in that period — you can't lose the tier mid-cycle, and you can't advance mid-cycle either. Actions you log during the current period determine the next period's tier.

Drop-one-tier rule

If you don't meet the threshold for your current tier at a recompute, you drop exactly one tier — not to the tier matching your action count. This dampens cliff behavior. A Core member who has a slow month drops to Engaged, not to Dormant. A sustained pattern of missing the threshold walks you down one step at a time.

Dormant recovery

Dormant isn't a penalty state, it's just a tier. The moment you log one qualifying action, the next recompute will place you at Active (assuming you've crossed the 1-action threshold) and your multiplier returns to its full cohort-times-Active value.

Practical patterns

Staying at Core

Core requires 15+ actions per 30-day period — roughly one every other day. For a regular festival/meetup participant, that's easily hit. For someone who isn't going to events, it means working the other surfaces: bumps, messages, gifts, quests.

Staying at Engaged

Engaged requires 5 – 14 actions — roughly one or two a week. Most members who attend a monthly event and occasionally interact between events will sit here comfortably.

Staying at Active

Active requires 1 – 4 actions per period — one quick check-in a month holds it. This is the "casual member" tier, and the 1.0x multiplier means you earn the full face value of the cohort weight.

Handling travel or dry seasons

If you know you're going to miss a period — travel, life, the off-season between festivals — you'll drop one tier at the next recompute. You can re-climb one step per 30-day period after. There's no "grace period" mechanism; the protocol treats everyone's calendar the same way.

Tracking your progress

Your wallet shows:

  • Your current activity tier and the multiplier it contributes
  • Action count so far in the current 30-day window
  • Days remaining until the next recompute
  • The tier you're currently on pace to hold or land in
  • Action count needed to reach the next tier before the window closes

The math is deterministic. At any moment, you know exactly where you stand and exactly what it takes to move.