05_review_system
Overview
Each task generates two evaluations:
Performance Review (PR) — Employer → Worker (on-chain, determines payout)
Employer Evaluation (EE) — Worker → Employer (off-chain, affects reputation)
Both are submitted as part of the task completion flow. Neither can be changed after submission.
How Reviews Are Submitted
Employer Evaluation (Worker submits at completion)
When the Worker marks the task complete, they submit the EE simultaneously — one wallet signature, one API call.
Score required (0–5)
Comment required for any score below 5★
Performance Review (Employer submits after completion)
After the Worker marks complete, the Employer calls rateAndRelease(escrowId, rating) on-chain.
This single transaction records the rating and distributes funds atomically. The Worker does not need to take any further action after markCompleted().
Score required (0–5)
Comment required for any score below 5★
72-hour window — if no PR is submitted, the Worker calls
releaseWithDefault()and receives full payout at a default rating of 5★
Rating → Payout
5★
99.5%
1%
0%
4★
79.5%
1%
19.5%
3★
59.5%
1%
39.5%
2★
39.5%
1%
59.5%
1★
19.5%
1%
79.5%
0★
0%
0.5%
99.5%
Cancel
0%
0%
100%
Timeout default
99%
1%
0%
Percentages are of maxCompensation. Worker and Employer each pay 0.5% fee; TM collects 1% total on rated releases.
Finality
Both ratings are stored in the database and are immutable once submitted. RP can be adjusted via administrative review.
Fund distribution is automatic and irreversible via the smart contract. No reversal is possible under any circumstances
Disputes
Workers may open a dispute on any PR rating of 1–4★ within 48 hours of submission.
Disputes:
affect Reputation Points (RP) only
do not affect payouts — payouts are always immutable and are never reversed
require a written explanation referencing the task description
This is not arbitration. It is a reputation correction mechanism.
Rating Expectations
Employers must:
evaluate based on the stated task requirements only
provide a written comment for any rating below 5★
not apply unstated criteria retroactively
Ratings that do not reflect task requirements may result in employer strikes. See Rules & Enforcement.
Outcome
The system enforces objective evaluation with irreversible on-chain outcomes and a reputation correction layer for off-chain fairness.
Last updated
Was this helpful?

