Skip to main content

Governance

CrowdProof uses a DAO governance model where token holders vote on protocol changes. This ensures no single entity controls the scoring system.

Governance Scope

Token holders can vote on:

CategoryExamples
Scoring ParametersDecay rate (λ), category weights, confidence thresholds
Fee StructureAPI pricing tiers, rate limits, free tier allowance
Dispute ResolutionEscalated dispute outcomes, arbiter selection
Contract UpgradesProxy implementation changes, new contract deployments
Data SourcesAdding/removing supported chains or protocols

Governance Process

1. Proposal (requires 100,000 CROWD tokens to submit)


2. Discussion Period (3 days)


3. Voting Period (5 days)
• Quorum: 4% of total supply
• Approval: Simple majority (>50%)


4. Timelock (2 days)
• Allows users to exit if they disagree


5. Execution (automatic via timelock contract)

CROWD Token

PropertyValue
Token StandardERC-20 + ERC-20Votes
Total Supply100,000,000 CROWD
Decimals18
Voting Power1 CROWD = 1 vote

Delegation

Token holders must delegate their voting power before it becomes active:

// Self-delegate to activate your own voting power
governanceToken.delegate(msg.sender);

// Or delegate to another address
governanceToken.delegate(delegateAddress);

Delegation does not transfer tokens — only voting power.

Proposal Lifecycle

StateDescription
PendingSubmitted, awaiting discussion period
ActiveVoting is open
SucceededQuorum met, majority approved
DefeatedQuorum not met or majority rejected
QueuedIn timelock waiting period
ExecutedChanges applied on-chain
CanceledWithdrawn by proposer
ExpiredNot queued within 7 days of success

On-Chain Dispute Escalation

When off-chain dispute resolution fails, disputes can be escalated to governance:

  1. User calls POST /api/v1/dispute/{id}/escalate
  2. Dispute is flagged for GOVERNANCE_ROLE holders
  3. Token holders vote on the outcome
  4. If approved, the score is revised on-chain via ReputationOracle.updateScore()

Security Measures

  • Timelock — 2-day delay between vote success and execution
  • Quorum — Prevents low-participation attacks
  • Proposal Threshold — Prevents spam proposals (100,000 CROWD minimum)
  • Vote Snapshot — Voting power locked at proposal creation block (prevents flash loan attacks)