Sortition Module

Juror selection via weighted random draws based on staked PNK

Manages juror selection through stake-weighted random drawing. Uses a sum tree data structure for efficient proportional selection.

Version: 0.9.0 | Proxy: UUPS Upgradeable

Phase System

The sortition module operates in phases:

1. Staking: Jurors can update stakes. No draws happening.
2. Generating: RNG is requested from the random number source.
3. Drawing: Jurors are drawn for disputes using the generated random number.

Stakes submitted during Generating or Drawing phases are queued and applied when Staking phase resumes.

Key Methods

createDisputeHook(uint256 _disputeID, uint256 _roundID)

Called by KlerosCore when a dispute is created. Prepares the drawing parameters.

draw(uint256 _disputeID, uint256 _roundID, uint256 _nonce) → address

Draws a juror for the dispute based on staked PNK weights and the random number.

setStake(address _account, uint96 _courtID, uint256 _newStake, bool _alreadyTransferred) → (uint256, uint256, uint256, bool)

Updates a juror’s stake in the sum tree.

Stake Tree

Uses a sortition sum tree where each leaf represents a juror’s stake in a court. Drawing probability is proportional to stake: a juror with 10% of total staked PNK in a court has a 10% chance of being drawn for each juror slot.

View Source