Skip to content

Showcase orchestrator voting activity in the UI #310

Description

@rickstaa

Problem

Governance participation by orchestrators is currently difficult for stakeholders to assess. Voting data exists on-chain, but it is not surfaced in a way that makes individual orchestrator engagement or proposal-level voting trends easy to understand.

Goal

Improve governance transparency by clearly exposing how orchestrators vote over time and how votes are distributed on each proposal.

Proposed Solution

1. Orchestrator History Page

Add governance vote events to the orchestrator history page.

Each vote should appear as a single history entry, consistent with existing activity items, and include:

  • Action: “Voted on proposal”
  • Proposal: Proposal ID (with link to proposal page)
  • Vote: For / Against / Abstain (visually emphasized)
  • Date: Timestamp

Behavior:

  • Display governance votes as standard History items, consistent with existing style and ordering (most recent first).
  • Keep entries compact and scannable, without introducing new layouts or long titles.
  • Allow navigation to the associated proposal via link or click.
  • Do not change existing History behavior beyond adding this event type.

2. Orchestrator Profile Page

Add a lightweight governance participation stat to the orchestrator overview.

Include:

  • Governance Participation: Number of proposals voted on relative to the number of proposals the orchestrator was eligible for while active (e.g. 17 / 20 proposals voted)
  • (Optional) Last Vote: Most recent proposal voted on

This should be presented as a compact summary and link to the History tab for full voting details.

3. Governance Proposal (Treasury) Page

Add an “Orchestrator Votes” section to governance proposal pages to surface how orchestrators voted on each proposal.

Include:

  • A list of orchestrators that have voted on the proposal
  • For each orchestrator:
    • Vote (For / Against / Abstain)
    • Voting power used
    • Link to orchestrator profile
      Behavior:
  • Displayed as a secondary section near the bottom of the proposal page, below the proposal details.
  • Sorted and paginated as needed.
  • Provide transparency without impacting the primary proposal or voting UI.
  • Optionally include a lightweight call-to-action in the voting widget (e.g. “View orchestrator votes”) that scrolls to this section.

Design & Review Process

The UI patterns described in this proposal are intended as guidance to achieve the stated goals.
Implementers may propose alternative designs if they better meet usability, clarity, or maintainability requirements.

Any material design changes should be reviewed with UX/UI representatives from the Livepeer Foundation
and relevant advisory boards prior to final merge. @mehrdadmms can guide this process.

Dependency

This work depends on merging [subgraph#175](livepeer/subgraph#175), which exposes the required governance voting data.
Although a Graph Studio deployment is available for development, this PR must be merged before UI changes can be merged into main.

Activity

  1. added
    enhancementIncremental improvement to existing functionality.
    on Sep 11, 2025
  2. rickstaa commented on Sep 11, 2025

    @rickstaa
    MemberAuthor
  3. added
    UIFront-end components and styling
    on Sep 11, 2025
  4. added theissue type on Sep 11, 2025
  5. removed
    enhancementIncremental improvement to existing functionality.
    on Sep 11, 2025
  6. ECWireless commented on Oct 31, 2025

    @ECWireless
    Collaborator

    Forwarding details from #345

    Completes this PR: #300


    • Implement governance vote indexing via The Graph (current PR is using an RPC).
      • Finish any incomplete frontend components.
      • UI/UX adjustments for clarity and responsiveness.
  7. moved this from Backlog to Todo in Explorer Revampon Nov 11, 2025
  8. 5 remaining items

  9. ECWireless commented on Dec 17, 2025

    @ECWireless
    Collaborator

    Action Plan

    Important Links

    Tasks

    For @Jipperism - Due December 24th

    • since initial work on this has gone stale, and that work is in forked repos, start a fresh branch and cherry pick from those PRs: 310-showcase-orchestrator-voting-activity-in-the-ui
    • Cherry-pick from this repo in order to get functional voting history section on treasury proposal page
    • Cherry-pick from this repo in order to get functional voting history tab on account page working

    Note: do not worry about styling this beyond what the original authors of these features did. Better styling will be done later. Also, if you are blocked because of missing subgraph data, just note it and use an RPC for now.

    For @thebeyondr - Due January 9th

  10. removed their assignment
    on Dec 18, 2025
  11. Jipperism commented on Dec 22, 2025

    @Jipperism
    Collaborator

    @ECWireless draft PR with cherry-picked functionality available here #457.

  12. Jipperism commented on Dec 23, 2025

    @Jipperism
    Collaborator

    @ECWireless seems like functionality for both PR's works in the merged version. I think @thebeyondr can start working on it, I'll do another pass to ensure code standards are up to the desired quality.

  13. Jipperism commented on Jan 9, 2026

    @Jipperism
    Collaborator

    @thebeyondr I updated the PR so voting on both treasury votes and polls are displayed on the account page in the history tab.

  14. Jipperism commented on Jan 9, 2026

    @Jipperism
    Collaborator

    @rickstaa @thebeyondr from what I remember from our discussions, we won't use this component in the end. It's a leftover from one of the PR's earlier created, that were combined in this PR.

    Image

    EDIT: Asking as I'd like to get rid of the cube querying in totality to keep the codebase simple, but would like to know if I need to rewrite this component instead of just binning it.

  15. Jipperism commented on Jan 9, 2026

    @Jipperism
    Collaborator

    CC @ECWireless @rickstaa

    Outcome of quick sync today to wrap this up. Remaining tasks:

    @jip will

    • Remove voting tab on /orchestrators
    • Rewire voting participation component on profile page to fetch data from graphql instead of cube (should only include treasury votes)
    • Rewire voting table on treasury proposal page to fetch data from graphql instead of cube
    • Remove cube integration altogether

    @the Beyondr will

    • Standardize UI for voting in all components in PR
    • Standardize UI for VotingWidget.tsx and TreasuryVotingWidget.tsx
    • Standardize and improve UI for Voting table at bottom of /treasury/[id] and /voting/[id]
    • Make standardized formatting for treasury votes ("for" | "against" | "abstain") and poll votes ("0" | "1" where "0" means yes) in /lib/api/types/votes.ts
  16. rickstaa commented on Jan 9, 2026

    @rickstaa
    MemberAuthor

    @rickstaa @thebeyondr from what I remember from our discussions, we won't use this component in the end. It's a leftover from one of the PR's earlier created, that were combined in this PR.

    Image EDIT: Asking as I'd like to get rid of the cube querying in totality to keep the codebase simple, but would like to know if I need to rewrite this component instead of just binning it.

    I wasn’t a fan of the formatting, as it didn’t fit our existing UI and felt unnecessarily complex and not at the right placement. As a result I removed it from the spec. I however do see a value in seeing this for all the orchestrators but maybe on the treasury page. That said, it’s best to rely on @adamsoffer’s and @hthillman’s judgment, given their greater stronger product experience.

    @mehrdadmms can coordinate.

  17. rickstaa commented on Jan 9, 2026

    @rickstaa
    MemberAuthor

    @ECWireless not part of the RFP but as we also have several governance votes lined up (LIPs), in the next phase I would be nice to extend to the governance page https://explorer.livepeer.org/voting/0xf1b0d0fb7bf3cf0603a0ec66cb31fa004fd5f2de. I think the graph already supports this but might need some small changes. Could you create an issue to track this as a follow up item. 🙏

  18. ECWireless commented on Jan 9, 2026

    @ECWireless
    Collaborator

    @ECWireless not part of the RFP but as we also have several governance votes lined up (LIPs), in the next phase I would be nice to extend to the governance page https://explorer.livepeer.org/voting/0xf1b0d0fb7bf3cf0603a0ec66cb31fa004fd5f2de. I think the graph already supports this but might need some small changes. Could you create an issue to track this as a follow up item. 🙏

    @rickstaa Do we want to include Governance polls in the "Governance Participation" card that's being rendered to the account page (as in summing together the number of both Governance Polls and Treasury Proposals to say they participated in __ out of __ proposals)? Or should we only render Treasury Proposal participation there?

  19. rickstaa commented on Jan 9, 2026

    @rickstaa
    MemberAuthor

    @ECWireless not part of the RFP but as we also have several governance votes lined up (LIPs), in the next phase I would be nice to extend to the governance page https://explorer.livepeer.org/voting/0xf1b0d0fb7bf3cf0603a0ec66cb31fa004fd5f2de. I think the graph already supports this but might need some small changes. Could you create an issue to track this as a follow up item. 🙏

    @rickstaa Do we want to include Governance polls in the "Governance Participation" card that's being rendered to the account page (as in summing together the number of both Governance Polls and Treasury Proposals to say they participated in __ out of __ proposals)? Or should we only render Treasury Proposal participation there?

    If you decide to take this one I would:

    • Add it to the history since its a on-chain action people want to see.
    • Add an overview on the goverance proposal similar to the treasury one.
    • If @mehrdadmms, @hthillman thing it adds value also create a seperate orch wide overview table or combine with the orch one.
  20. moved this from In Progress to In Review in Explorer Revampon Jan 13, 2026
  21. moved this from In Review to Done in Explorer Revampon Feb 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

UIFront-end components and styling

Projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions