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

Subgraph Endpoints

Full list of subgraph URLs for V1 and V2

Query Examples

Common GraphQL queries for disputes, courts, and registries

Subgraph EndpointsGraphQL endpoints for Kleros V2 core, DRT, and V1 subgraphs on Arbitrum, Ethereum, and Gnosis, served via The Graph decentralized network and Goldsky.

⌘I

Getting Started

V2 Architecture

Arbitrable Apps

Products

Cross-chain

Examples

Subgraph & Data

Subgraph Overview

Subgraph & Data

When to Use Subgraphs

V2 Subgraph (Arbitrum)

Local Development

Key Entities (V2)

Further Reading

Subgraph Endpoints

Query Examples

​Subgraph & Data

​When to Use Subgraphs

​V2 Subgraph (Arbitrum)

​Local Development

​Key Entities (V2)

​Further Reading

Subgraph Endpoints

Query Examples

Subgraph & Data

When to Use Subgraphs

V2 Subgraph (Arbitrum)

Local Development

Key Entities (V2)

Further Reading