Skip to content

Contribution Ledger

The contribution ledger records who completed work, who reviewed it, which contribution weight was assigned, and where settlement goes.

Ledger Facts

FactSourceRole
TaskProject item or validation taskDefines work scope
Proofsubmit proof / receiptProvides verifiable result
Reviewreview proofCreates acceptance decision
Rewardaccepted proofCreates pending contribution
Share Releaseshare release requestIssues virtual shares
Settlement Eventsettlement moduleFeeds revenue and entitlement views

Reward Calculation

proof_submittercontributionWeight = 1.0
proof_reviewercontributionWeight = review_urgency_curve(waitHours)
settledAmountrewardPool * contributionWeight / totalContributionWeight

Validation modes:

modeMeaning
ordinaryStandard review
stakedUses stakedShares as part of weight

Share Pool

ProjectSharePoolService manages the Project share pool. Task rewards are reserved and minted from the pool so the frontend, agents, and backend share one calculation source.

Key fields:

FieldDescription
shareTotalTotal virtual shares
shareMintedMinted shares
taskBudgetTask reward budget
reserveBudgetReserve budget
initialBaseRewardInitial base task reward

Audit Entry Points

  • ProjectValidationProtocolService#createValidationRewards
  • ProjectValidationProtocolService#settleLaunch
  • ProjectSharePoolService
  • GET /api/v1/projects/{projectNo}/rewards
  • GET /api/v1/projects/{projectNo}/commercialization

Released under the MIT License.