Pumpfun Scope Data Plan - Executive Summary

pumpfun-scope-executive-gist.md

Pumpfun Data on Scope: Executive Summary

What We Are Building

We want Scope cards to show richer Pumpfun context directly on the token card:

• Agent coin status
• Mayhem mode status and countdown
• Creator rewards / fee sharing
• Charity coin details
• Offchain-created coin indicator
• Fee claims, payouts, buybacks, and related chart/tradefeed labels

The goal is that a trader can quickly understand why a token is special, who receives fees, whether the token is an agent/charity/mayhem coin, and what activity has happened so far.

What Needs To Happen

1. Collect the missing data at the source.

   We need to index more Pumpfun events: creator fee claims, fee sharing updates, charity configs, agent payments, agent buybacks, withdrawals, and Mayhem trades.

2. Turn raw events into clean token summaries.

   Backend services will aggregate raw events into useful numbers like total fees, claimed fees, unclaimed fees, agent revenue, buybacks, and current payment authority.

3. Send normalized data to Talos.

   Talos will become the source of truth for the Scope page. It will serve clean fields like isAgent, isCharity, creatorRewards, agentActivity, and mayhemStatus.

4. Render it on Scope.

   Once Talos provides the data, Scope can add the icons, hover cards, filters, countdown timers, and chart/tradefeed markers.

What The User Will See

Creator Rewards Hover

Shows:

• Total fees
• Fee authority
• Locked/unlocked status
• Fee share recipients
• Recipient percentages
• Amounts claimed or earned

Agent Activity Hover

Shows:

• Agent rate
• Payment authority
• Revenue
• Buybacks
• Claimed amount
• Unclaimed amount

Charity Hover

Shows:

• Charity name
• Charity logo
• Allocation split
• Config/source information

Mayhem Hover

Shows:

• Active or finished
• Time left during the 24-hour window
• Mayhem bot activity tagged on chart/tradefeed

How We Track The Numbers

• Total creator fees come from trade events.
• Claimed fees come from claim/payout events.
• Fee shares come from Pumpfun fee sharing config.
• Charity names and icons come from donate.gg.
• Agent revenue comes from agent payment events.
• Agent buybacks come from agent buyback/distribution events.
• Agent claimed/unclaimed comes from withdrawals and remaining balances.

Why This Is More Than UI

The designs are achievable, but the UI is the last step.

Most of the work is data plumbing:

• New indexed events
• New Redpanda topics
• New backend rollups
• Postgres and ClickHouse migrations
• Talos contract changes
• Scope UI changes

Once the backend data is reliable, the frontend work is straightforward.

Suggested Delivery Order

1. Add indexing for missing Pumpfun fee and agent events.
2. Publish new event streams.
3. Aggregate token-level rollups in metadata-service.
4. Expose final data through Talos.
5. Add Scope icons, hovers, filters, and chart/tradefeed labels.

Open Decisions

• What exactly counts as "locked"?
• Should unclaimed values come from event math or live account balances?
• Should agent buybacks show allocated buyback amount or completed buyback amount?
• Does Mayhem always end exactly 24 hours after launch?