feat(routes-f): weekly and all-time leaderboard endpoint

[davedumto]

Overview

Implement app/api/routes-f/leaderboard/weekly/route.ts for time-windowed creator and viewer leaderboards.

Scope

• GET /api/routes-f/leaderboard/weekly — top creators/viewers for the current week
• Query params: ?type=earnings|tips_sent|watch_time|new_followers&limit=20&period=weekly|monthly|alltime

Acceptance Criteria

• earnings leaderboard shows USDC earned (creators only)
• tips_sent shows top tippers (viewer-facing)
• Results cached for 10 minutes
• Each entry includes rank, username, avatar_url, value
• Route lives exclusively in app/api/routes-f/leaderboard/weekly/

Notes

Standalone — no dependency on other open issues.

[Wilfred007]

@Wilfred007 has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

Can I work on this task?

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Wilfred007 to this issue.

[Jay-Peter-Egemasi]

@Jay-Peter-Egemasi has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

Hey I am Jerome, and I would like to take this issue head on.

ETA: before deadline

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Jay-Peter-Egemasi to this issue.

[drips-wave]

Congratulations, @Jay-Peter-Egemasi! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on March 30, 2026.

🧑‍💻 @Jay-Peter-Egemasi: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been marked as completed by a Drips Wave moderator for @Jay-Peter-Egemasi as part of the Stellar Wave Program's 3rd Wave 🥳

Moderator's reason: [Auto-assessed] The contributor, who is assigned to the issue, implemented the requested weekly leaderboard endpoint and provided corresponding unit tests in PR #544. Although the PR contains a large number of files due to formatting updates and other features, it directly addresses the issue requirements and has been open for more than 24 hours without maintainer objections.

😎 @Jay-Peter-Egemasi: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.

ℹ️ Note: This issue was marked complete via moderation. Points were issued even though the GitHub issue remains open.