feat: add effective number staked jurors, subgraph, frontend

Author: kemuru

subgraph/core/schema.graphql

@@ -150,6 +150,7 @@ type Court @entity {
   numberVotes: BigInt!
   stakedJurors: [JurorTokensPerCourt!]! @derivedFrom(field: "court")
   numberStakedJurors: BigInt!
+  effectiveNumberStakedJurors: BigInt!
   stake: BigInt!
   effectiveStake: BigInt!
   delayedStake: BigInt!

subgraph/core/src/entities/Court.ts

@@ -32,6 +32,35 @@ export function updateEffectiveStake(courtID: string): void {
   }
 }
 
+// This function calculates the "effective" numberStakedJurors, which is the specific numberStakedJurors
+// of the current court + the specific numberStakedJurors of all of its children courts
+export function updateEffectiveNumberStakedJurors(courtID: string): void {
+  let court = Court.load(courtID);
+  if (!court) return;
+
+  while (court) {
+    let totalJurors = court.numberStakedJurors;
+
+    const childrenCourts = court.children.load();
+
+    for (let i = 0; i < childrenCourts.length; i++) {
+      const childCourt = Court.load(childrenCourts[i].id);
+      if (childCourt) {
+        totalJurors = totalJurors.plus(childCourt.effectiveNumberStakedJurors);
+      }
+    }
+
+    court.effectiveNumberStakedJurors = totalJurors;
+    court.save();
+
+    if (court.parent && court.parent !== null) {
+      court = Court.load(court.parent as string);
+    } else {
+      break;
+    }
+  }
+}
+
 export function createCourtFromEvent(event: CourtCreated): void {
   const court = new Court(event.params._courtID.toString());
   court.hiddenVotes = event.params._hiddenVotes;
@@ -48,6 +77,7 @@ export function createCourtFromEvent(event: CourtCreated): void {
   court.numberAppealingDisputes = ZERO;
   court.numberVotes = ZERO;
   court.numberStakedJurors = ZERO;
+  court.effectiveNumberStakedJurors = ZERO;
   court.stake = ZERO;
   court.effectiveStake = ZERO;
   court.delayedStake = ZERO;

subgraph/core/src/entities/JurorTokensPerCourt.ts

@@ -4,7 +4,7 @@ import { updateActiveJurors, getDelta, updateStakedPNK, updateCourtStateVariable
 import { ensureUser } from "./User";
 import { ONE, ZERO } from "../utils";
 import { SortitionModule } from "../../generated/SortitionModule/SortitionModule";
-import { updateEffectiveStake } from "./Court";
+import { updateEffectiveNumberStakedJurors, updateEffectiveStake } from "./Court";
 
 export function ensureJurorTokensPerCourt(jurorAddress: string, courtID: string): JurorTokensPerCourt {
   const id = `${jurorAddress}-${courtID}`;
@@ -93,6 +93,7 @@ export function updateJurorStake(
   juror.save();
   court.save();
   updateEffectiveStake(courtID);
+  updateEffectiveNumberStakedJurors(courtID);
   updateJurorEffectiveStake(jurorAddress, courtID);
   updateCourtStateVariable(courtID, court.effectiveStake, timestamp, "effectiveStake");
 }

subgraph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kleros/kleros-v2-subgraph",
-  "version": "0.15.0",
+  "version": "0.15.2",
   "drtVersion": "0.12.0",
   "license": "MIT",
   "scripts": {

web/src/hooks/queries/useCourtDetails.ts

@@ -17,6 +17,7 @@ const courtDetailsQuery = graphql(`
       numberClosedDisputes
       numberAppealingDisputes
       numberStakedJurors
+      effectiveNumberStakedJurors
       numberVotes
       stake
       effectiveStake

web/src/pages/Courts/CourtDetails/Stats/stats.ts

@@ -81,7 +81,7 @@ export const stats: IStat[] = [
   },
   {
     title: "Active Jurors",
-    getText: (data) => data?.numberStakedJurors,
+    getText: (data) => data?.effectiveNumberStakedJurors,
     color: "green",
     icon: StyledJurorIcon,
   },