Subgraph Overview

Query Kleros protocol data using The Graph subgraphs

Subgraph & Data

Kleros V2 uses The Graph for indexing on-chain data. The subgraph package in the kleros-v2 monorepo indexes KlerosCore, SortitionModule, DisputeKitClassic, and related contracts on Arbitrum.

For V1 products (Curate, PoH, Escrow, Linguo), separate subgraphs exist on Ethereum and Gnosis Chain.

---

When to Use Subgraphs

• Fetching dispute data (status, rulings, evidence, rounds)
• Querying court statistics (stakes, juror counts, parameters)
• Listing Curate registry items with field data
• Checking PoH registration status
• Building dashboards or analytics tools
• Displaying dispute history in your frontend

---

V2 Subgraph (Arbitrum)

The V2 core subgraph indexes all court activity on Arbitrum One. It is maintained in the kleros-v2 monorepo.

Source code: kleros-v2/subgraph

Local Development

To run the V2 subgraph locally:

# Start a local Hardhat node with contracts deployed
yarn workspace @kleros/kleros-v2-contracts start-local

# Start a local Graph Node (requires Docker)
yarn workspace @kleros/kleros-v2-subgraph start-local-indexer

# Deploy the subgraph to the local Graph Node
yarn workspace @kleros/kleros-v2-subgraph rebuild-deploy:local

The local GraphQL endpoint will be available at:

http://localhost:8000/subgraphs/name/kleros/kleros-v2-core-local

---

Key Entities (V2)

Entity	Description
Court	Court parameters, stake totals, dispute counts
Dispute	Dispute status, court, ruling, rounds, template
Round	Per-round data: juror draws, votes, appeal funding
Draw	Individual juror draw records
TokenAndETHShift	Reward/penalty records per juror per round
JurorTokensPerCourt	Staked PNK per juror per court
DisputeKit	Registered dispute kit contracts

---

Further Reading

Subgraph Endpoints

Full list of subgraph URLs for V1 and V2

Query Examples

Common GraphQL queries for disputes, courts, and registries