Skip to content

feat: implement protocol stats service, hook, and market overview das… - #904

Merged
Chucks1093 merged 5 commits into
accesslayerorg:devfrom
extolkom:feat/843-homepage-market-overview
Sep 5, 2026
Merged

feat: implement protocol stats service, hook, and market overview das…#904
Chucks1093 merged 5 commits into
accesslayerorg:devfrom
extolkom:feat/843-homepage-market-overview

Conversation

@extolkom

@extolkom extolkom commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Summary

Closes #843

Adds a market overview section to the homepage showing total protocol volume,
active creator keys, total unique holders, and 24h trades, giving new users an
immediate sense of protocol scale and activity.

Changes

  • New useProtocolStats React Query hook fetching GET /protocol/stats, with
    a 5-minute staleTime and explicit refetch behavior so data actually refreshes
    automatically rather than just going stale
  • Four stat cards: Total Volume (XLM, human-readable formatting), Active Keys,
    Total Holders, 24h Trades
  • 24h change indicator (green up / red down) on Total Volume and 24h Trades —
    driven by [FILL IN: exact API field name, e.g. volumeChange24h], with
    exactly 0% change rendered as neutral rather than red
  • Per-card loading skeletons sized to match the rendered cards, avoiding layout
    shift on data arrival
  • Error state fallback for failed stats fetches (no silent blank/crash)
  • Confirmed the section renders for logged-out users — no auth gating

Verification (all clean — see table)

Check Result
Full test suite 49 files / 315 tests passing
Type-check (pnpm tsc -b) 0 errors
Lint (pnpm lint) 0 errors, 0 warnings
Build (pnpm build) Clean production build
Format check (pnpm format:check) Clean
CI alignment Locally replicated the exact steps in .github/workflows/ci.yml

Acceptance criteria

  • All four stat cards rendered with correct values
  • 24h change indicators shown with correct direction and colour
  • Loading skeletons shown during fetch
  • Data refreshes automatically after 5 minutes
  • Stats section visible without authentication

Scope

Homepage component, useProtocolStats hook, new stat-card component(s), and
their tests. No unrelated files or global QueryClient defaults touched.

@drips-wave

drips-wave Bot commented Sep 2, 2026

Copy link
Copy Markdown

@extolkom 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

@extolkom
extolkom force-pushed the feat/843-homepage-market-overview branch from 2b6a9ee to 492a296 Compare September 2, 2026 01:12
@Chucks1093

Copy link
Copy Markdown
Member

Merge Conflict

@Chucks1093

Copy link
Copy Markdown
Member

CI is green but this PR has a merge conflict with dev and cannot be auto-merged. Pull the latest dev into your branch with git fetch origin && git checkout your-branch && git merge origin/dev, resolve any conflicts, then run npm run build and npm run lint to confirm everything is clean before pushing.

@Chucks1093
Chucks1093 merged commit af6996c into accesslayerorg:dev Sep 5, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add a market overview section on the homepage showing total protocol volume, active keys, and total holders

2 participants