Complete specification of the KlerosCore contract, the central arbitrator of Kleros V2.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.
Dispute Lifecycle
Period Transitions
Disputes progress through periods. Each period has a configurable duration set per court:- Evidence: Parties submit evidence. All jurors must be drawn before advancing.
- Commit: Jurors submit vote commitments (hidden vote courts only).
- Vote: Jurors reveal votes / cast direct votes.
- Appeal: Anyone can fund an appeal. If funded, a new round begins.
- Execution: Ruling is finalized and enforced.
Appeal Mechanics
- Appeals increase the juror count (typically doubling + 1)
- When juror count exceeds
jurorsForCourtJump, the dispute moves to the parent court - If the parent court doesn’t support the current dispute kit, it switches to a compatible one
- Appeal funding uses an asymmetric model: losers pay 2× and have half the time
Reward Distribution
After execution:- Coherent jurors (voted with the final ruling) receive PNK from incoherent jurors and their share of arbitration fees
- Incoherent jurors lose a portion of their staked PNK (proportional to
alpha) - Distribution is calculated per round
Emergency Controls
- Guardian can pause (blocks staking and rewards)
- Governor can unpause and modify parameters
- Core dispute resolution (voting, appeals) continues when paused