Sanitized Portfolio Report

RentLock: Smart Contract Rental Escrow dApp

A public-safe case study of a decentralized rental deposit workflow with escrow states, verifier escalation, and frontend-contract integration.

Domain: Web3 Applications Focus: Escrow Design Year: 2026 Status: Paraphrased Summary

Fast Scan

What this report proves

A recruiter-readable summary of the Web3 product signal, contract workflow, evidence, and public-data boundary.

Signal

Smart-contract product architecture for rental deposit escrow, settlement, dispute escalation, and verifier-mediated resolution.

Methods

Escrow state modelling, ERC-20 deposit logic, MetaMask-style wallet flows, evidence boundaries, verifier escalation, and frontend-contract integration.

Evidence

Sanitized sequence diagram, state-transition logic, product-risk notes, and design trade-offs for dispute handling.

Boundary

No wallet screenshots, account identifiers, personal names, raw submission pages, or private demo artifacts are published.

PII-Safe Publication Note

This page paraphrases the original project report for portfolio use. It omits personal names, academic identifiers, wallet screenshots, private account details, raw submission pages, and any metadata that is not necessary to understand the product and engineering design.

Executive Summary

RentLock explored how a smart-contract escrow workflow could reduce rental deposit disputes. Instead of one party holding the deposit off-chain, funds are locked in a transparent contract with predefined settlement paths. The prototype focused on lease lifecycle design, tokenized deposits, mutual agreement, dispute escalation, and a verifier mechanism for unresolved cases.

The project is strongest as a systems-design artifact. It shows how product incentives, contract state, frontend UX, and abuse prevention need to be designed together. A smart contract alone is not enough; the surrounding workflow determines whether users can safely understand and act on the contract's rules.

Field Note

The most interesting part was not the escrow contract itself, but the product surface around it: evidence, disagreement, and user comprehension. A transparent rule is only useful when both sides can understand the state they are entering.

Portfolio Signal Snapshot

This project is framed as a full-stack Web3 product design case study: smart-contract state design, frontend-contract integration, evidence handling, and incentive-aware dispute resolution.

Role Signal Smart-contract workflow designer for rental deposit escrow
Core Stack Solidity-style contracts, ERC-20 tokens, MetaMask, IPFS concepts
Engineering Depth State transitions, verifier escalation, evidence boundaries
Business Value Turns deposit custody into transparent rules and auditable settlement
Smart Contracts Solidity ERC-20 Escrow Logic dApp Architecture MetaMask IPFS Dispute Resolution Mechanism Design Product Risk

Problem Context

Rental deposits create an imbalance when one party controls the funds while the other party has limited visibility into settlement rules. Common pain points include unclear deductions, slow refund timelines, poor evidence handling, and a lack of neutral escalation.

Custody Risk

Funds held by one side can create distrust even when both parties behave reasonably.

Process Ambiguity

Deposits are difficult to resolve when refund conditions, evidence, and timelines are not explicit.

Escalation Gap

A dispute mechanism needs incentives, evidence rules, and protection against frivolous claims.

Product Objectives

Sanitized Escrow Sequence

The source report described a simple lease sequence involving the tenant, landlord, frontend, and escrow contract. The recreated portfolio diagram keeps the workflow but omits private wallet screenshots, account identifiers, and raw demo artifacts.

No-Dispute Lease Lifecycle

1. Lease Setup Landlord creates lease terms and deposit details through the frontend.
2. Deposit Funding Tenant approves the token transfer and funds the escrow contract.
3. Active Lease Escrow holds the deposit while off-chain evidence can be anchored for later review.
4. Release Proposal Landlord proposes a refund or deduction when the lease ends.
5. Tenant Acceptance Tenant accepts the proposed release when both parties agree.
6. Settlement The contract transfers tokens according to the accepted release and closes the escrow.

Curated Figure Gallery

These selected visuals are more intuitive than a text-only writeup because they show the smart-contract workflow and product surface. The architecture is shown as a light-background recreation, and the AI-evaluation screenshot is cropped to remove the wallet/account header before publishing it.

Light-background RentLock dApp system architecture diagram
System architecture. Shows the React frontend, MetaMask connection, escrow manager state machine, test-token deposit, IPFS evidence references, and verifier path.
Cropped RentLock AI evaluation engine interface
Cropped product screenshot. Demonstrates the AI-assisted move-in versus move-out evidence comparison without publishing wallet or account details.

System Design

1. Tokenized Deposit

The prototype uses a test token to simulate stable-value deposit handling. This allows contract logic to be tested without relying on real funds or exposing private wallet activity in the public writeup.

2. Escrow Manager Contract

The escrow contract manages lease creation, deposit funding, state transitions, refund requests, deductions, settlement, and dispute escalation. The contract state gives both parties a shared view of what actions are currently valid.

3. Role-Based Workflow

The product separates tenant, landlord, and verifier actions. Each role has a different interface and different permissions, which reduces accidental misuse and makes the workflow easier to explain.

4. Evidence Boundary

Evidence such as images or supporting documents should not be stored directly on-chain. A safer pattern is to store evidence off-chain and anchor hashes or references, with encryption and retention policies as future work.

5. Verifier Escalation

If the parties cannot settle, a verifier flow can review the dispute and trigger the appropriate outcome. This mechanism requires careful incentive design so reviewers are compensated without encouraging low-quality participation.

Implementation Lessons

Technical Notes From Source Report

IPFS Evidence Handling The report noted gateway inconsistency and upload reliability issues, so the public version frames off-chain evidence as a future-hardening area rather than a solved production feature.
Raw CID Storage The intended safer pattern is to store content identifiers rather than gateway-specific URLs in contract state.
Image Compression Browser-side compression was used to reduce large move-in and move-out photos before upload so evidence handling remains usable on slower connections.
Selective Disclosure A future reputation design should prove good standing without exposing full rental dispute histories, settlement amounts, or private lease details on-chain.

Decision Framework

The design challenge was to decide what belongs on-chain, what should stay off-chain, and where human or verifier judgment is required. The strongest version of the product uses blockchain for settlement integrity, not as a dumping ground for private evidence.

Decision Area Option Considered Selected Approach Reasoning
Deposit custody Landlord-held off-chain deposit Escrow contract with explicit release paths Improves transparency and gives both parties the same settlement rules.
Evidence storage Store photos or documents on-chain Off-chain evidence with references or hashes Avoids exposing sensitive tenancy data while preserving an audit trail.
Dispute resolution Force bilateral agreement only Escalation path with verifier review Prevents deadlock when parties disagree about deductions or damage evidence.
Reputation Public dispute history Selective disclosure as future direction Supports trust without publishing private settlement histories.

Qualitative Product Priority Chart

Custody Transparency Critical
Privacy Protection Critical
Dispute Fairness High
On-Chain Minimalism High
Verifier Incentives Open Risk
What I optimized for Transparent settlement states and a user workflow that makes contract actions understandable.
What I avoided Overclaiming legal readiness or exposing private lease evidence in a public portfolio artifact.
What I would harden next Contract tests, encrypted evidence storage, verifier reputation, and formal state-machine documentation.

Risk and Abuse Considerations

False Claims

Dispute flows should discourage frivolous claims through deposits, review fees, or reputation mechanisms.

Evidence Privacy

Inspection photos and tenancy documents can expose private information, so storage design matters.

Contract Trust

Users need clear explanations of what the contract can and cannot guarantee before they commit.

Limitations

Recommended Next Improvements

Source Trail

The RentLock source report did not include a formal academic bibliography. For the portfolio, the safest presentation is therefore to include technical notes derived from the report and avoid inventing a research-paper citation list that was not actually in the submitted material.

Concepts referenced in the source report: escrow state design, ERC-20-style test tokens, verifier escalation, IPFS-style evidence anchoring, browser image compression, and selective disclosure.
Public portfolio boundary: no wallet screenshots, private account identifiers, raw evidence photos, or unredacted report pages are published.

Recruiter Signal

RentLock demonstrates smart-contract product thinking rather than narrow token experimentation. The project covers workflow modelling, escrow states, incentive design, frontend integration, and practical privacy boundaries for public communication.

Smart Contracts ERC-20 Escrow Logic Frontend Integration Mechanism Design Product Risk

Sanitized report prepared for portfolio publication. Raw academic materials and private data are not published.