Contribution Ledger
The contribution ledger records who completed work, who reviewed it, which contribution weight was assigned, and where settlement goes.
Ledger Facts
| Fact | Source | Role |
|---|---|---|
| Task | Project item or validation task | Defines work scope |
| Proof | submit proof / receipt | Provides verifiable result |
| Review | review proof | Creates acceptance decision |
| Reward | accepted proof | Creates pending contribution |
| Share Release | share release request | Issues virtual shares |
| Settlement Event | settlement module | Feeds revenue and entitlement views |
Reward Calculation
proof_submittercontributionWeight = 1.0
proof_reviewercontributionWeight = review_urgency_curve(waitHours)
settledAmountrewardPool * contributionWeight / totalContributionWeight
Validation modes:
| mode | Meaning |
|---|---|
ordinary | Standard review |
staked | Uses 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:
| Field | Description |
|---|---|
shareTotal | Total virtual shares |
shareMinted | Minted shares |
taskBudget | Task reward budget |
reserveBudget | Reserve budget |
initialBaseReward | Initial base task reward |
Audit Entry Points
ProjectValidationProtocolService#createValidationRewardsProjectValidationProtocolService#settleLaunchProjectSharePoolServiceGET /api/v1/projects/{projectNo}/rewardsGET /api/v1/projects/{projectNo}/commercialization