MessageBox
LiveMessageBox: a participation bus where event interactions — check-ins, shout-outs, broadcasts, and rewards — are messages on secure, authenticated channels.
MessageBox is the protocol-native communication and event interaction layer for HeartBadge.
Tied directly to your badge's identity key, MessageBox acts as a participation bus. Every interaction — whether it is a physical event check-in, a direct message from another member, system notifications, or an artist shout-out — is represented as a secure message sent over dedicated channels.
MessageBox Architecture
MessageBox does not rely on traditional usernames, phone numbers, or email addresses. Every badge has a messagebox identity derived cryptographically from its private key. Messages are signed using BRC-31 — meaning they are tamper-proof, verifiable by the recipient, and stored in a non-custodial relay.
Because MessageBox is protocol-native, all interactions run on the same core infrastructure using three simple actions:
sendMessage— Dispatch a message to one or more recipient badge IDs.listMessages— Pull new incoming messages from your inbox.acknowledgeMessage— Acknowledge receipt, which marks messages as read or triggers deletion for ephemeral streams.
Channel Types
Channels represent different message categories. Each channel type defines its own direction, fee structure, and data persistence:
| Channel | Direction | Fee | Ephemeral | ZK-Compatible |
|---|---|---|---|---|
venue_broadcast | Organizer → Attendees | Free | Optional | No |
shoutout | Fan → Artist / Creator | Artist-set rate | Yes (auto-delete on ack) | Optional |
checkin_proof | Member → Venue / Reader | Free | Yes | Yes |
inbox | Member → Member | Recipient-set | No | Optional |
notifications | System → Member | Free | No | No |
Geo-Scoped Venue Broadcasts
When you check in at a venue or event, organizers can send updates or announcements to all checked-in members. Because your checked-in status is registered to the venue's local reader, broadcasts can be sent to participants instantly without spamming outside channels.
Artist Shout-Out Lines
Shout-outs allow creators and artists to open a direct, paid message line during live events. Fans can attach payment (in MNEE stable-dollars or satoshis) to a message. The artist reads selected shout-outs live, and once acknowledged, the messages are deleted from the relay automatically.
Anonymous Check-ins
Using zero-knowledge proofs, you can verify your membership and claim check-in rewards without revealing your identity to the venue. The proof verifies that your badge is valid and that you are physically present, keeping your profile completely private.
Pricing Model
MessageBox is built on micro-transactions. Sending a message incurs a platform fee of $0.00001 per message (0.001¢) plus network costs that scale with message size (~100 sat/KB).
| Message Size | Total Cost | Per $1 MNEE |
|---|---|---|
| 280 bytes (text) | ~$0.00001 | ~100,000 messages |
| 1 KB | ~$0.00001 | ~100,000 messages |
| 100 KB | ~$0.00017 | ~5,800 messages |
| 1 MB | ~$0.00160 | ~625 messages |
Founding Members (first 10,000 badges) are provisioned with 10,000 free messages. Message top-ups are paid using your rewards wallet balance.
Bump Interactions
When two badges interact physically via NFC or a reader scan, they can initiate peer-to-peer actions:
- Bump-to-Connect: Register a connection with another member. Messages between connected members bypass search filters and rates.
- Bump-to-Send: Securely transfer MNEE or rewards to another badge by bringing devices together and confirming the amount.
- Bump-to-Gift: Transfer gift codes or sponsored memberships instantly.
- Co-Sign Attestations: Create a mutual proof-of-presence ("We were both here at this time") signed by both badges.
Accessing your MessageBox
MessageBox is live and integrated into your dashboard. To access your messages:
- Sign in to your account at heartbadge.com/login.
- Go to your Member Dashboard.
- Select the MessageBox tab or navigate directly to heartbadge.com/messages.