Kleros provides a general-purpose dispute resolution protocol. Any smart contract can use it as an arbitrator when a disagreement occurs, the contract sends a dispute to Kleros, jurors vote on the outcome, and the ruling is enforced automatically. This page explains the core mechanism and why it produces reliable outcomes.Documentation Index
Fetch the complete documentation index at: https://kleros-mintlify-changelog-2026-05-12-1778458371.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
The Core Idea
Kleros is built on a concept from game theory called a Schelling point (or focal point). When people are asked to coordinate on an answer without communicating, they tend to converge on the most obvious or “natural” answer. Kleros exploits this by:- Drawing a random set of jurors who cannot communicate with each other
- Asking them to independently evaluate evidence and vote on the outcome
- Rewarding jurors who vote with the majority and penalizing those who don’t
Arbitrator and Arbitrable
Kleros uses a two-contract architecture: The Arbitrable is any smart contract that might need dispute resolution an escrow, a marketplace, a registry. It creates disputes and implements a callback function to receive rulings. The Arbitrator is Kleros Court. It handles juror selection, voting, appeals, and ruling delivery. The arbitrable contract never needs to understand the internal mechanics of how jurors are selected or how votes are counted. This separation means any existing application can plug into Kleros by implementing a simple interface.Why It Works
Three properties make decentralized dispute resolution viable:1. Economic Alignment
Jurors stake PNK tokens to participate. Incoherent jurors (those who vote against the final majority) lose a portion of their stake, which is redistributed to coherent jurors. This creates a direct financial incentive to seek the truth rather than vote randomly or dishonestly.2. Independent Judgment
Jurors are drawn randomly and vote independently. In V2, hidden votes (commit-reveal) prevent jurors from seeing others’ votes before committing their own, eliminating bandwagon effects.3. Escalation Through Appeals
If anyone believes a ruling is wrong, they can fund an appeal. Each appeal round draws more jurors (roughly doubling), making it exponentially more expensive for an attacker to sustain a dishonest majority through repeated rounds. The appeals system is Kleros’s ultimate guarantee: as long as honest participants are willing to fund appeals, the system self-corrects.What Disputes Can Kleros Resolve?
Kleros works best for disputes that are adjudicable, meaning a reasonable person, given sufficient evidence, can determine the correct outcome. Examples:- “Did the freelancer deliver the work described in the contract?” Yes, with evidence
- “Does this token logo match the submission guidelines?” Yes, with policy criteria
- “Is this address tag accurate?” Yes, with on-chain verification
The Dispute Lifecycle
For a detailed walkthrough of every phase, see How It Works. Here’s the high-level flow:Further Reading
Game Theory
The incentive mechanics behind honest voting
Sortition
How jurors are randomly selected
Kleros Yellow Paper
Full formal treatment of the protocol