feat(gateways): add gateway stats widgets and new gateway pages #410

rickstaa · 2025-11-22T12:19:55Z

This pull request introduces new gateway widgets and pages to display stats for active gateways that have distributed fees in the last 90 days. Adds a gateways widget to the main page, a dedicated gateway tab, and a gateway account page for detailed gateway stats and activity.

Warning

Needs upstream pull request livepeer/subgraph#168 to be merged and deployed for this to work!
Please remove the patch in codegen.yaml before merging.=!

vercel · 2025-11-22T12:20:00Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
explorer-arbitrum-one	Ready	Preview, Comment	Jan 9, 2026 2:55pm

Introduce new gateway widgets and pages to display stats for active gateways that have distributed fees in the last 90 days. Adds a gateways widget to the main page, a dedicated gateway tab, and a gateway account page for detailed gateway stats and activity.

Ensure that paid tickets also show up on the GatewayHistory.

Ensure the orchestrators button has the right background when the `/orchestrators` page is selected and the user is logged out.

Ensure that the gateways tab is highlighted when on a gateway profile and the orchestrator tab when on a orchestrator profile.

Ensure we include gateways that were activated in the last year or did send tickets in the last 90D. Also improve the UI to make this behavoir more visible.

Ensure gateway tab is shown before the delegator tab if an entity is both a orchestrator and gateway.

rickstaa · 2025-12-29T14:13:31Z

@ECWireless, when you have time, could you review this after livepeer/subgraph#168 is merged and deployed upstream? This would be a great feature for the community. Please check the warning section above before merging.

You can merge #469 and #468 first and then rebase.

Make scrollbuffer a constant to improve code readability. Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com

Ensure that the container scrolls to the active page when clicked.

Recalculate overflow effects when child elements change to ensure consistent fading. Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Fixes a bug in the gateway filtering which caused it to not adhere to our filtering condition. Also applied some small code improvements.

rickstaa · 2026-01-09T14:54:04Z

lib/api/ssr.ts

+  const currentTimestamp = Math.floor(Date.now() / 1000);
+  const minActiveDay = Math.max(currentTimestamp - 365 * 86400, 0); // include activated last 12 months
+
+  // TODO: paginate gateways; currently under the 1000 entity cap.


@ECWireless this is ready for your teams review. Keep in mind I did not implement pagination since we have less than 100 gateways right now and the maximum entitry cap is 1000. You can decide if you want to be proactive and already add pagniation or create an issue to tackle it later. Thanks. 🙏🏻

Copilot

Pull request overview

This pull request adds comprehensive gateway (broadcaster) statistics and management features to the Livepeer Explorer. The implementation introduces new pages, components, and queries to display gateway activity, including fees distributed, deposit/reserve balances, and self-redemption detection.

Key changes:

New gateway list page and component with sortable statistics
Gateway account page with broadcasting stats and self-redeem indicator
Enhanced transaction history to distinguish between incoming, outgoing, and self-redeemed winning tickets
Navigation updates to include gateway-specific routes and tabs

Reviewed changes

Copilot reviewed 16 out of 16 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
queries/transactions.graphql	Added sender/recipient fields to WinningTicketRedeemedEvent for directional tracking
queries/gateways.graphql	New query to fetch active gateways with volume and activity metrics
queries/gatewaySelfRedeem.graphql	Query to detect self-redemption behavior for gateways
queries/account.graphql	Added gateway (broadcaster) data to account queries
pages/index.tsx	Integrated gateway list widget on home page with top 10 gateways
pages/gateways.tsx	New dedicated page listing all active gateways
pages/accounts/[account]/broadcasting.tsx	New broadcasting tab for gateway account pages
lib/api/ssr.ts	Added getGateways function to fetch gateway data server-side
layouts/main.tsx	Added gateway navigation item and highlight logic
layouts/account.tsx	Added broadcasting tab and conditional display logic
hooks/useGatewaySelfRedeemStatus.ts	Hook to detect self-redemption within a time window
hooks/index.tsx	Exported new gateway hook
components/HistoryView/index.tsx	Enhanced to show directional indicators for winning tickets
components/GatewayList/index.tsx	New table component displaying gateway statistics
components/BroadcastingView/index.tsx	Gateway stats view with self-redeem warnings
apollo/subgraph.ts	Generated TypeScript types for new gateway-related fields

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-01-09T15:00:55Z

components/BroadcastingView/index.tsx

+const formatEth = (value?: string | number | null) => {
+  const amount = Number(value ?? 0) || 0;
+  return `${numbro(amount).format(
+    amount > 0 && amount < 0.01
+      ? { mantissa: 4, trimMantissa: true }
+      : { mantissa: 2, average: true, lowPrecision: false }
+  )} ETH`;


Code duplication: The formatEth function is duplicated in both BroadcastingView and GatewayList components with identical implementation. The TODOs in both files acknowledge this should be replaced with a common formatting utility. Consider extracting this to a shared utility module to follow DRY principles and ensure consistent formatting across the application.

Suggested change

const formatEth = (value?: string | number | null) => {

const amount = Number(value ?? 0) || 0;

return `${numbro(amount).format(

amount > 0 && amount < 0.01

? { mantissa: 4, trimMantissa: true }

: { mantissa: 2, average: true, lowPrecision: false }

)} ETH`;

const SMALL_ETH_FORMAT = { mantissa: 4, trimMantissa: true } as const;

const DEFAULT_ETH_FORMAT = {

mantissa: 2,

average: true,

lowPrecision: false,

} as const;

const formatEth = (value?: string | number | null) => {

const raw = value == null ? 0 : Number(value);

const amount = Number.isFinite(raw) && !Number.isNaN(raw) ? raw : 0;

const formatOptions =

amount > 0 && amount < 0.01 ? SMALL_ETH_FORMAT : DEFAULT_ETH_FORMAT;

return `${numbro(amount).format(formatOptions)} ETH`;

Copilot · 2026-01-09T15:00:55Z

pages/gateways.tsx

+      <Head>
+        <title>Livepeer Explorer - Gateways</title>
+      </Head>
+      <Container css={{ maxWidth: "", width: "100%" }}>


Empty maxWidth value in Container CSS. Setting maxWidth to an empty string is unusual and likely unintentional. This should either be removed (to use the default) or set to a specific value. Review whether this matches the intended design specification.

Suggested change

<Container css={{ maxWidth: "", width: "100%" }}>

<Container css={{ width: "100%" }}>

Copilot · 2026-01-09T15:00:55Z

components/HistoryView/index.tsx

+    return tickets
+      .filter((e) => (e?.transaction?.timestamp ?? 0) > lastEventTimestamp)
+      .map((e) => ({
+        ...e,
+        direction:
+          e?.sender?.id?.toLowerCase() === accountLower &&
+          e?.recipient?.id?.toLowerCase() === accountLower
+            ? ("self" as const)
+            : e?.sender?.id?.toLowerCase() === accountLower
+            ? ("out" as const)
+            : ("in" as const),
+      }));


Duplicate filtering in ticketEvents computation. The tickets are filtered twice with the same condition (timestamp > lastEventTimestamp) - once when creating the tickets array and again in the subsequent filter operation. Remove the redundant second filter.

Suggested change

return tickets

.filter((e) => (e?.transaction?.timestamp ?? 0) > lastEventTimestamp)

.map((e) => ({

...e,

direction:

e?.sender?.id?.toLowerCase() === accountLower &&

e?.recipient?.id?.toLowerCase() === accountLower

? ("self" as const)

: e?.sender?.id?.toLowerCase() === accountLower

? ("out" as const)

: ("in" as const),

}));

return tickets.map((e) => ({

...e,

direction:

e?.sender?.id?.toLowerCase() === accountLower &&

e?.recipient?.id?.toLowerCase() === accountLower

? ("self" as const)

: e?.sender?.id?.toLowerCase() === accountLower

? ("out" as const)

: ("in" as const),

}));

Copilot · 2026-01-09T15:00:56Z

components/GatewayList/index.tsx

+  return `${numbro(amount).format(
+    amount > 0 && amount < 0.01
+      ? { mantissa: 4, trimMantissa: true }
+      : { mantissa: 2, average: true, lowPrecision: false }
+  )} ETH`;


Code duplication: The formatEth function is duplicated in both GatewayList and BroadcastingView components with identical implementation. The TODOs in both files acknowledge this should be replaced with a common formatting utility. Consider extracting this to a shared utility module to follow DRY principles and ensure consistent formatting across the application.

Suggested change

return `${numbro(amount).format(

amount > 0 && amount < 0.01

? { mantissa: 4, trimMantissa: true }

: { mantissa: 2, average: true, lowPrecision: false }

)} ETH`;

const formatOptions =

amount > 0 && amount < 0.01

? { mantissa: 4, trimMantissa: true }

: { mantissa: 2, average: true, lowPrecision: false };

return `${numbro(amount).format(formatOptions)} ETH`;

Copilot · 2026-01-09T15:00:56Z

components/GatewayList/index.tsx

+              onPointerEnterCapture={undefined}
+              onPointerLeaveCapture={undefined}
+              placeholder={undefined}


Unnecessary properties passed to PopoverContent. The properties onPointerEnterCapture, onPointerLeaveCapture, and placeholder are set to undefined, which serves no functional purpose. These should be removed unless they are required for TypeScript compatibility reasons (in which case this indicates a type definition issue that should be addressed).

Suggested change

onPointerEnterCapture={undefined}

onPointerLeaveCapture={undefined}

placeholder={undefined}

Copilot · 2026-01-09T15:00:56Z

pages/index.tsx

    const { orchestrators } = await getOrchestrators(client);
    const { events } = await getEvents(client);
    const protocol = await getProtocol(client);
+    const { gateways } = await getGateways();


Inconsistent Apollo client usage. The getGateways function is called without passing the client parameter, which means it creates its own Apollo client instance via getApollo(). Meanwhile, getOrchestrators and getProtocol are explicitly passed the client. This inconsistency could lead to multiple client instances and potential caching issues. Pass the client to getGateways for consistency.

Suggested change

const { gateways } = await getGateways();

const { gateways } = await getGateways(client);

Copilot · 2026-01-09T15:00:57Z

components/GatewayList/index.tsx

+                  Profile
+                </PopoverLink>
+                <PopoverLink
+                  href={`/accounts/${row.values.id}/broadcasting?tab=history`}


Invalid query parameter for navigation. The link uses ?tab=history but the routing system doesn't appear to handle a 'tab' query parameter. The account pages use path-based routing (e.g., /accounts/{address}/history) rather than query-based navigation. This link should be /accounts/${row.values.id}/history instead.

Suggested change

href={`/accounts/${row.values.id}/broadcasting?tab=history`}

href={`/accounts/${row.values.id}/history`}

rickstaa · 2026-01-09T15:41:14Z

@ECWireless can your team handle the co-pilot comments as I'm out of office thanks. 🙏🏻

Also keep in mind that its best to wait till the subgraph is fully indexed before merging this. You can see the status of v1.3.0 here.

rickstaa · 2026-01-09T23:15:49Z

@ECWireless something seems to be wrong with https://explorer-arbitrum-one-git-feat-add-g-10dba1-livepeer-foundation.vercel.app/accounts/0x173173b30b5d3c8f09ee78816da8a6402d6b16e1/broadcasting for the 90d fees will have to check subgraph logic which does return 0 while total and the days data is correct.

rickstaa · 2026-01-09T23:32:18Z

@ECWireless something seems to be wrong with https://explorer-arbitrum-one-git-feat-add-g-10dba1-livepeer-foundation.vercel.app/accounts/0x173173b30b5d3c8f09ee78816da8a6402d6b16e1/broadcasting for the 90d fees will have to check subgraph logic which does return 0 while total and the days data is correct.

Found the issue will create path tomorrow.

rickstaa · 2026-01-10T09:39:23Z

@ECWireless created a fix on the subgraph here. Will wait for it to fully sync test it, ask for review and then publish v1.3.1. After that is done you can review and merge when you seem fit.

rickstaa · 2026-01-13T20:57:32Z

Hey @mehrdadmms, I fixed the upstream data inaccuracy in livepeer/subgraph#202. It’s currently syncing in the CI deployment on the Graph Studio portal.

I’m now fully out of office and won’t be able to support moving this forward. This PR is not a deliverable for the Transformation spec, so there’s no urgency.

If you’d like to proceed before I’m back, please ask BuildersDAO to review the PR, then have Yondon or yourself verify the deployment in Studio, and finally merge and tag a new release.

rickstaa requested a review from ECWireless as a code owner November 22, 2025 12:19

vercel bot had a problem deploying to Preview November 22, 2025 12:20 Failure

rickstaa force-pushed the feat/add-gateway-dashboard branch from 1130056 to f0795f7 Compare November 22, 2025 12:26

vercel bot deployed to Preview November 22, 2025 12:28 View deployment

vercel bot deployed to Preview November 22, 2025 13:55 View deployment

vercel bot deployed to Preview November 22, 2025 14:15 View deployment

rickstaa mentioned this pull request Nov 22, 2025

Add the number of active gateways to usage graphs #412

Open

rickstaa marked this pull request as draft November 22, 2025 16:28

rickstaa added 4 commits November 27, 2025 15:01

feat: add paid tickets to gateway history

8d4699a

Ensure that paid tickets also show up on the GatewayHistory.

fix: hide delegating tab when account is not delegator

cbf8c87

fix: correct gateway nav highlight when logged out

50655d3

Ensure the orchestrators button has the right background when the `/orchestrators` page is selected and the user is logged out.

rickstaa force-pushed the feat/add-gateway-dashboard branch from 5e54fca to 50655d3 Compare November 27, 2025 14:03

vercel bot had a problem deploying to Preview November 27, 2025 14:04 Failure

Merge branch 'main' into feat/add-gateway-dashboard

7f877ef

vercel bot deployed to Preview December 28, 2025 10:23 View deployment

fix: fix merge conflict

3adb176

rickstaa force-pushed the feat/add-gateway-dashboard branch from 3a6d1a3 to 3adb176 Compare December 28, 2025 10:31

rickstaa added 2 commits December 28, 2025 11:32

Merge branch 'main' into feat/add-gateway-dashboard

35c94c3

chore: remove duplicate env variable from template

b74acd7

vercel bot deployed to Preview December 28, 2025 10:36 View deployment

refactor: apply code improvements

cc3cffe

vercel bot deployed to Preview December 28, 2025 10:54 View deployment

refactor: ensure correct tab highlight behavoir

d0edde7

Ensure that the gateways tab is highlighted when on a gateway profile and the orchestrator tab when on a orchestrator profile.

vercel bot deployed to Preview December 28, 2025 11:50 View deployment

refactor: improve gateway inclusion criteria and UI

f622b78

Ensure we include gateways that were activated in the last year or did send tickets in the last 90D. Also improve the UI to make this behavoir more visible.

vercel bot deployed to Preview December 28, 2025 12:21 View deployment

refactor: improve profile tab order

c5da583

Ensure gateway tab is shown before the delegator tab if an entity is both a orchestrator and gateway.

vercel bot deployed to Preview December 28, 2025 12:27 View deployment

vercel bot deployed to Preview December 29, 2025 14:12 View deployment

rickstaa and others added 4 commits December 30, 2025 12:34

refactor: add scrollBuffer constant

be56b20

Make scrollbuffer a constant to improve code readability. Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

refactor: add accessibility labels to horizontalScrollContainer

6ae32ab

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com

refactor: improve horizontalScrollContainer scroll behaviour

2bf8b2c

Ensure that the container scrolls to the active page when clicked.

refactor: stabilize horizontalScrollContainer fade behavior

4db10d5

Recalculate overflow effects when child elements change to ensure consistent fading. Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

vercel bot deployed to Preview December 30, 2025 11:37 View deployment

Merge branch 'main' into feat/add-gateway-dashboard

5f1c432

vercel bot deployed to Preview January 7, 2026 08:57 View deployment

refactor: small formatting fix introduce during merge

bbc039e

rickstaa force-pushed the feat/add-gateway-dashboard branch from de99f84 to bbc039e Compare January 7, 2026 08:59

vercel bot deployed to Preview January 7, 2026 09:01 View deployment

Merge branch 'main' into feat/add-gateway-dashboard

d59f8ec

vercel bot deployed to Preview January 8, 2026 16:10 View deployment

fix: ensure gateway filtering is correct

76c9886

Fixes a bug in the gateway filtering which caused it to not adhere to our filtering condition. Also applied some small code improvements.

vercel bot deployed to Preview January 8, 2026 18:07 View deployment

chore: add gateway pagination comment

babb95a

rickstaa marked this pull request as ready for review January 9, 2026 14:52

Copilot AI review requested due to automatic review settings January 9, 2026 14:52

Copilot started reviewing on behalf of rickstaa January 9, 2026 14:53 View session

rickstaa commented Jan 9, 2026

View reviewed changes

vercel bot deployed to Preview January 9, 2026 14:55 View deployment

Copilot AI reviewed Jan 9, 2026

View reviewed changes

rickstaa mentioned this pull request Jan 9, 2026

Problem in active gateway tracking livepeer/subgraph#201

Open

rickstaa marked this pull request as draft January 13, 2026 20:57

	<Container css={{ maxWidth: "", width: "100%" }}>
	<Container css={{ width: "100%" }}>

	onPointerEnterCapture={undefined}
	onPointerLeaveCapture={undefined}
	placeholder={undefined}

	const { gateways } = await getGateways();
	const { gateways } = await getGateways(client);

	href={`/accounts/${row.values.id}/broadcasting?tab=history`}
	href={`/accounts/${row.values.id}/history`}

feat(gateways): add gateway stats widgets and new gateway pages #410

Are you sure you want to change the base?

feat(gateways): add gateway stats widgets and new gateway pages #410

Uh oh!

Conversation

rickstaa commented Nov 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vercel bot commented Nov 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

rickstaa commented Dec 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

rickstaa Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

rickstaa commented Jan 9, 2026

Uh oh!

rickstaa commented Jan 9, 2026

Uh oh!

rickstaa commented Jan 9, 2026

Uh oh!

rickstaa commented Jan 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

rickstaa commented Jan 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

rickstaa commented Nov 22, 2025 •

edited

Loading

vercel bot commented Nov 22, 2025 •

edited

Loading

rickstaa commented Dec 29, 2025 •

edited

Loading

rickstaa commented Jan 10, 2026 •

edited

Loading

rickstaa commented Jan 13, 2026 •

edited

Loading