Reputation & Gamification
Reputation in ToldYa currently spans multiple layers: user/profile stats, client-side slot tiers, streak services, badge/achievement routes, and leaderboard aggregates.
Credibility in Current APIs#
Core profile responses (/api/v1/users/:pubkey) include commit/reveal/follow stats and reveal-rate style metrics used across web UI surfaces.
Additional category-level credibility routes exist behind the IDENTITY feature flag (see /api/v1/users/:pubkey/credibility and related endpoints).
Client-Side Tier Mapping & Slots#
The web client currently computes slot limits from @toldya/core tier definitions:
| Tier | Score Range | Slots |
|---|---|---|
| Newcomer | 0-19 | 5 |
| Bronze | 20-39 | 5 |
| Silver | 40-59 | 7 |
| Gold | 60-79 | 10 |
| Diamond | 80-94 | 15 |
| Legendary | 95-100 | 20 |
Streaks (Core Route Module)#
Streak endpoints are enabled by default:
GET /api/v1/streaks/meGET /api/v1/users/:pubkey/streak
Milestone discounts in service code are currently modeled at 4/12/26/52 week thresholds with 10%/15%/20%/25% discount levels.
Badges & Achievements (Core Route Modules)#
Badge and achievement APIs are enabled by default, including:
/api/v1/badges,/badges/me,/users/:pubkey/badges/api/v1/achievements,/achievements/me,/users/:pubkey/achievements
Leaderboards (Core Route Module)#
The leaderboard system currently supports these metric types:
earningsunlocksrevealsfollowersstreaksharesrising
Time windows are daily, weekly, monthly, and all_time.
Weekly prize snapshots are also exposed at GET /api/v1/weekly-prizes through a currently default-enabled module.
Feature-Flagged Reputation Extensions#
Additional reputation modules exist but are disabled by default unless flags are enabled:
- IDENTITY — category credibility and persona-linked identity routes.
- ENGAGEMENT — rituals, scarcity, slow-feeds, and wellness/anti-dopamine endpoints (including
/api/v1/wellness/*). - MEMORY — milestone and retrospective style long-range history features.
For route-level and auth details, see Developer API.