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

Rating
Worker
TaskMaster
Employer

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?