Core Engagement Flow
The core engagement flow describes how users, brands, and the bonuz protocol interact end-to-end — from onboarding through engagement to redemption. Every step is designed to feel simple for users while building verifiable, on-chain value for all participants.
Step 1 — User Onboarding
A new user downloads the bonuz Lifestyle Wallet (bonuz.xyz) or encounters bonuz through a brand touchpoint — scanning a QR code at a venue, tapping an NFC tag, or clicking a campaign link.
They sign up via email or social login (Google, Apple, etc.). Behind the scenes, a self-custodial smart account is created using ERC-4337 account abstraction. No seed phrases, no gas configuration, no wallet extensions. The user is live in under 45 seconds.
Optionally, the user activates their bonuz ID — a portable on-chain identity with verified social handles, links, and attestations. This step is not required but unlocks richer experiences across the ecosystem.
Step 2 — Brand Creates a Campaign
On the other side, a brand or partner sets up a campaign through the Brand Dashboard. Using templates (Events, F&B, Retail, Entertainment, etc.), they configure:
DNFT type — Pass, voucher, loyalty punchcard, membership, ticket, certificate, or Proof-of-Visit/Participation
Rules — What actions are required (check-in, social share, quest completion, purchase, etc.)
Rewards — What the user receives upon completion
Parameters — Expiry, supply limits, usage rules, location triggers
Distribution method — QR codes, NFC tags, direct links, or in-app discovery
The campaign goes live. DNFTs are ready to be claimed.
Step 3 — Engagement
The user encounters the campaign in the real world or digitally:
At a venue: Scans a QR code or taps an NFC tag at a restaurant, event, retail store, or any physical location
Online: Clicks a campaign link, completes a social action, or discovers the campaign through the bonuz app
At an event: Checks in, attends sessions, visits specific zones, or completes event-specific quests
The bonuz app validates the action and the user claims their DNFT. Gas is sponsored on this interaction — the user doesn't think about blockchain mechanics at all.
Step 4 — DNFT State Changes
Once claimed, the DNFT is active in the user's wallet. Depending on the campaign type, the DNFT can evolve:
A loyalty punchcard tracks progress — each visit or purchase increments the count. When complete, it can auto-mint a reward voucher.
A pass grants ongoing access — valid until expiry or revocation.
A voucher is single-use — once redeemed at the point of sale (via QR/NFC scan by staff), its state changes to redeemed.
A membership can upgrade or downgrade based on user activity over time.
A Proof-of-Visit / Proof-of-Participation is a permanent attestation recorded to the user's bonuz ID.
The DNFT state machine: issued → active → redeemed / expired → archived (with upgrades/downgrades possible for tier-based assets).
Step 5 — Redemption
When a user redeems a DNFT (e.g., presenting a voucher at a restaurant), the flow is:
User opens the DNFT in their wallet and presents the QR code
The redeemer (staff, merchant, event organizer) scans the code
The app validates the user's rights and signs the transaction
The DNFT state updates on-chain (e.g., active → redeemed)
Anti-fraud protections verify: signature-gated redemption, single-use enforcement, server-verified state updates
No double-spending, no screenshot fraud, no expired-voucher tricks. The redemption is cryptographically verified.
Step 6 — Attestation & Graph Growth
After redemption or engagement, an attestation is recorded to the user's bonuz ID (if activated): a Proof-of-Visit, a quest completion, a loyalty milestone, or a reputation marker.
This attestation becomes part of the bonuz graph — the shared network of identities, connections, and engagement history. Over time, the user builds a portable reputation that travels with them across the entire bonuz ecosystem. Brands see richer customer profiles (within granted permission scopes). The graph becomes more valuable with every interaction.
The Flywheel
The engagement flow creates a self-reinforcing cycle:
Brands create campaigns → Users engage and earn DNFTs → Attestations grow the bonuz graph → Richer data makes campaigns more effective → More brands join → More users onboard
Every campaign, every scan, every redemption adds value to the shared ecosystem. This is the compounding network effect at the heart of bonuz.
Last updated