Loyalty
Dashboard.
The retention layer for onchain products. Award points, run seasons, climb leaderboards, and pay out rewards on real behavior — not vanity metrics. One dashboard for your growth team, one SDK for your engineers, one identity per user.
Points. Leaderboards.
Payouts.
Run them as one connected loop, or compose only the layers you need. The identity layer underneath stays the same.
Points & tiers
Configurable points engine with rules, multipliers, and decay. Tiers unlock perks, gates, and reward multipliers automatically. Every points event is signed, timestamped, and audit-ready.
- Configurable rules + multipliers
- Tier-based perks and gates
- Seasons with reset or carry-over
- Signed event log per user
Leaderboards & seasons
Time-boxed seasons with live leaderboards. Daily, weekly, and lifetime rankings. Public or private. Embed on your app or host on your subdomain — branded end to end.
- Daily, weekly, season, lifetime ranks
- Public or token-gated viewing
- Embed widget + hosted page
- Snapshot endpoints for prize logic
Reward payouts
Distribute tokens, NFTs, allowlists, or off-chain perks based on points and tier. Manual approval, scheduled, or automated. Batched payouts to minimize gas, signed receipts to maximize trust.
- ERC-20, ERC-721, allowlists, off-chain perks
- Manual, scheduled, or auto distribution
- Gas-optimized batch payouts
- Per-recipient signed receipt
Award points
for real behavior.
Define rules in plain config — onchain events, social actions, app activity, referrals. Every rule fires server-side against verified data. No screenshot uploads. No trust-me metrics.
tx executed, balance held, NFT minted, contract called, bridge completed. Indexed across every chain you support.
X follow, repost, reply, Discord join + role, Telegram join, Farcaster cast. Verified via direct OAuth.
Custom events from your backend. Daily streaks, completed flows, content created. Signed webhook in, points out.
Boost points for tier, time, badge held, or referral source. Stack them. Decay them. Cap them per season.
import { Loyalty } from '@gizmolab/loyalty';
const loyalty = new Loyalty({ apiKey: 'sk_live_...' });
// Define a rule
await loyalty.rules.create({
trigger: 'wallet.tx',
match: { contract: '0x..', method: 'mint' },
points: 250,
multiplier: { tier: { gold: 2, silver: 1.5 } },
cap: { perUser: 3, perSeason: 5000 }
});Honest. Branded.
Composable.
Verified, not vanity
Every point fires from a verified event — onchain proof, OAuth check, or signed backend webhook. No screenshots, no checkboxes, no honor system. Marketing claims you can defend.
- Server-side verification on every rule
- Signed and timestamped event log
- Replayable audit trail per user
- Sybil flagging built in
Your loyalty, your brand
Dashboard, leaderboards, claim pages, emails — all white-labeled. Your subdomain, your design tokens, your copy. Hosted by us, owned by you.
- Custom subdomain + SSL
- Themeable widget + hosted pages
- Transactional email templating
- Self-serve operator portal
Plugs into the rest of growth
Shares identity with Growth Activation badges and quests. Carries referral graphs. Exports to your CRM and warehouse. One profile per user, every loop measurable.
- One user profile across products
- Referral graph and attribution
- Webhooks + CSV / S3 / Snowflake export
- Native API for any frontend
Seasons shipping
in production.
Mey Network
Mey ran a points-based referral season layered on top of social and onchain tasks. Leaderboards drove sustained daily engagement; the referral graph carried users from Twitter into Discord and onchain.
Black Mirror
A multi-tier loyalty season combining points, quests, and leaderboards. Tiered perks unlocked progressively, with weekly snapshots feeding reward payouts and a sustained retention curve well past launch week.
Everything growth ops
needs. None of the lock-in.
The tools your growth, community, and engineering teams expect — backed by an event log they can actually audit.
Operator Console
One dashboard for rules, seasons, leaderboards, users, payouts, and audit log. Real-time funnel and cohort views. Built for growth ops, not engineers.
Referral Graph
Every user gets a tracked invite link. Credit flows up the tree. Multi-level attribution, configurable splits, exportable graph data.
Webhook Stream
Signed webhooks on every event — points awarded, tier changed, leaderboard snapshot, reward distributed. Build your own automations on top.
Sybil Resistance
Device fingerprinting, social-graph clustering, optional human-uniqueness checks. Layer what fits — every flagged action is reviewable.
Warehouse Export
Stream events to S3, Snowflake, or BigQuery. Self-serve CSV pulls from the console. Bring your numbers into your existing data stack.
Payout Engine
Distribute tokens, NFTs, allowlists, or off-chain perks. Manual, scheduled, or automated. Gas-optimized batching with signed receipts.
Four steps.
One season live.
From sandbox to first leaderboard — most teams ship their opening season in a few days.
Define rules
Pick triggers, points, multipliers, and caps from the dashboard or as code. Test in sandbox, ship to prod.
Open the season
Launch a leaderboard with start and end dates. Embed on your site, host on your subdomain.
Users earn and climb
Every verified action accrues points. Tiers unlock perks. Users compete on a live leaderboard.
Pay out and report
Run payouts manually, on schedule, or automatically. Webhook into your CRM and warehouse.
What you leave behind
when you switch.
Built to plug into the rest of the stack.
Reward the
behavior you want.
Points, leaderboards, payouts — measurable, branded, and built for sustained retention. Tell us your loop and we'll have a season live in days.