[devsimze]

Summary

Implements four REST/indexer issues in one set of read models and endpoints:

• Add co-creator roster indexer and role REST API #1139 GET /keys/:key_id/co-creators and /co-creators/:wallet — active co-creator roster with roles, share_bps and added_at. Indexed from CoCreatorSetEvent/CoCreatorRemovedEvent (co_set, cc_rm).
• Build key reserve balance REST endpoint for stability indicator #1140 GET /keys/:key_id/reserve — reserve balance, market cap (price snapshot × circulating supply), reserve ratio bps and low_reserve flag. Indexed from ReserveAccrued/ReserveDeployed.
• Build content gate access check REST endpoint for gated content control #1137 GET /keys/:key_id/content-access/:wallet — content-gate check { is_allowed, gate_type, requirement }. Contract-first via check_access simulation (injectable fetcher, same pattern as whitelist); off-chain fallback via get_min_hold_for_access/is_subscribed/get_key_balance + indexed KeyOwnership balance. 30s cache, invalidated on KEY_BOUGHT/KEY_SOLD.
• Add creator tipping indexer and tip history REST API #1132 GET /keys/:key_id/tips, /tips/total, /tips/:tipId/content — cursor-paginated tip history, cumulative totals, IPFS message content (Pinata gateway, cached 1h). Indexed from TipSent.

Guarantees

• Idempotent indexers: every event is first recorded in an append-only log with unique (txHash, eventIndex); a replay hits the constraint, its balance/total delta rolls back, and the cache is still invalidated. Order-safe watermark-style upserts on the aggregate tables.
• Atomic: log row + balance/total mutation share one Prisma transaction, so aggregates can never drift from their event log.
• DLQ on malformed events (CO_CREATOR, RESERVE, TIP_SENT job types); failures propagate so the dispatcher does not advance the ledger cursor and the batch is redelivered.
• Caches: 60s for rosters/totals/reserve, 30s for content-access; all invalidated per key by the indexer after every event (event-driven, not TTL-only).

Schema

Hand-written migration 20261020180000_add_key_cocreator_tip_reserve_tables adds key_cocreators, key_tips, key_tip_totals, key_reserves, key_reserve_events (migration replay is broken repo-wide; SQL applied directly).

Verification

• tsc --noEmit clean (only pre-existing price-stream/ws errors remain)
• ESLint clean on all changed files
• indexer-pipeline-dispatch.integration.test.ts + event-dedup-guard.unit.test.ts + whitelist.routes.test.ts: 38/38 passing

Closes #1132
Closes #1137
Closes #1139
Closes #1140

[drips-wave]

@devsimze Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits