Join our community of builders on Discord!

Governance & Protocol Parameters

The Lightchain AI Mainnet is governed on-chain through LightChainGovernor and a TimelockController. Protocol-level constants are stored in AIConfig and can be updated through the Governor.
[!NOTE] The values below reflect the genesis configuration. Changes proposed and executed through the Governor will not be reflected here automatically — read the relevant contract on-chain for the current value.

Governance Configuration

ParameterValue
TIMELOCK_DELAY172,800 s (48 hours)
VOTING_DELAY14,400 blocks (~24 hours @ 6s slots)
VOTING_PERIOD100,800 blocks (~7 days @ 6s slots)
PROPOSAL_THRESHOLD140,000 LCAI
QUORUM_PERCENT3% of total supply (= 298,989,450 LCAI)

Roles

RoleHolder
PROPOSER_ROLE (on Timelock)LightChainGovernor
CANCELLER_ROLE (on Timelock)LightChainGovernor
EXECUTOR_ROLE (on Timelock)Open — address(0) — anyone may execute a queued proposal once the Timelock delay elapses
[!TIP] The open EXECUTOR_ROLE means the 48-hour Timelock delay is the only barrier between a passed proposal and its execution. Off-chain monitoring of queued proposals is strongly recommended.

AIConfig — Protocol Parameters

These constants are read by the Job and Worker subsystems. They can be updated through governance proposals.

Worker Economics

ParameterValueMeaning
minWorkerStake50,000 LCAIRequired to register as a worker
suspensionThreshold3 strikesStrikes before automatic suspension
suspensionCooldown7 daysCooldown after a suspension

Fee Distribution

RecipientShare
Worker80%
Treasury15%
FeePool5%

Slashing

TriggerSlashing rate
Timeout2%
Completion failure5%
Dispute loss15%
Per-rate governance cap (maxSlashBps)50%
Slash amount is (minWorkerStake × bps) / 10_000. After 3 offenses (suspensionThreshold), a worker is suspended for 7 days (suspensionCooldown) and must call WorkerRegistry.reinstate() to recover. Full mechanics and the recovery runbook: Slashing & Rehabilitation.

Worker SLAs

ParameterValueMeaning
ackTimeout90 sWorker must acknowledge a job within
completionTimeout120 sWorker must complete a job within

Output Verification

ParameterValueMeaning
similarityThreshold60%Minimum similarity for output match
canarySimilarityThreshold60%Minimum similarity for canary match
samplingRateBps5%Fraction of jobs canary-sampled by the Disputer

Disputes

ParameterValueMeaning
disputeWindow24 hWindow in which a dispute can be raised
resolutionTimeout48 hWindow in which a dispute must be resolved
disputeBondMultiplierBond required to raise a dispute (relative to job fee)

Jobs & Data Availability

ParameterValueMeaning
maxReassignments3Job reassignments before terminal failure
blobRetentionPeriod18 daysEIP-4844 blob retention window


Last updated: May 2026