Reference
What it does
The review module records reviews between lease counterparties: tenants review providers on delivery quality, and provider-side standing accumulates into a reputation that is portable across the whole marketplace and tamper-evident by construction — reviews are chain state tied to real leases.
Requiring an underlying lease ties reviews to marketplace activity and raises the cost of fabricated ratings. VEID may add an optional signal where a specific offer requests it, but no single control prevents review abuse.
Why it exists: Repeat-game trust is what makes marketplaces work, and centralized platforms hold that trust hostage — leave the platform, lose your reputation. On-chain reviews make track records a public good owned by the participant who earned them.
State
Primary objects
| Concept | Definition |
|---|---|
Lease-bound review | A review permitted only between actual counterparties of a real lease. |
Portable reputation | Track record held as chain state, not as a platform's private asset. |
Messages
Messages & queries
Message and query surfaces are documented at implementation level in the module docs ↗ and the source ↗. The objects above are the state those messages create and transition.
Connections
Module interactions
-
x/marketReviews attach to completed leases between real counterparties. -
x/veidOffer-specific VEID proofs may inform counterparty risk; lease-linked reviews remain the basis for marketplace feedback. -
x/marketplaceReputation signals inform offer presentation and choice.
Flows
Core flow
- Serve — A lease completes. Delivery happened between verifiable counterparties — the precondition for any review.
- Review — Both sides rate. Tenants review providers on delivery quality; providers review tenants on conduct.
- Record — Reviews become state. Tamper-evident, tied to the lease, and visible across the whole marketplace.
- Compound — Standing compounds. Accumulated reputation feeds offer presentation and tenant choice — portability included.
Questions
Asked about x/review
What is a lease-bound review?
A review permitted only between actual counterparties of a real lease — the constraint that anchors reputation to delivery.
Can reputation be faked?
Lease-linked reviews make feedback traceable to marketplace activity, but do not eliminate coordinated abuse. VEID is an optional signal for specific offers, not a universal anti-fraud guarantee.
What does portable reputation mean?
Your track record lives in chain state rather than a platform's database: switch interfaces or providers and your earned standing travels with you.
Related