🧾 Escrow Smart Contract

A secure, milestone-based Escrow system between a Client, Freelancer, and Admin, written in Solidity. It ensures safe payments, dispute resolution, and automated refunds — ideal for freelance or gig-based work.

⚙️ Features

🪙 Milestone-based payments — funds released only after approval

🔒 Reentrancy protection and role-based access

🕒 Auto-refund after deadline if work isn’t completed

⚖️ Admin dispute resolution with a configurable fee

🧾 Progress tracking via milestones and completion %

🔄 State Transition Diagram

           ┌────────────┐
           │  CREATED   │
           └──────┬─────┘
                  │
                  │ addMilestones() + deposit()
                  ▼
           ┌────────────┐
           │   FUNDED   │
           └──────┬─────┘
                  │
                  │ startWork()
                  ▼
           ┌────────────────┐
           │  IN_PROGRESS   │
           └──────┬────┬────┘
                  │    │
                  │    └────────── raiseDispute() ──────────────┐
                  │                                              │
                  ▼                                              │
        ┌──────────────────────┐                                 │
        │  AWAITING_APPROVAL   │                                 │
        └──────────┬───────────┘                                 │
                   │ approveMilestone()                          │
                   ▼                                              │
           ┌────────────┐                             ┌────────────┐
           │ COMPLETED  │◄────────── resolveDispute() │ DISPUTED   │
           └────────────┘                             └────────────┘
                  ▲
                  │ triggerAutoRefund()
                  │
           ┌────────────┐
           │  REFUNDED  │
           └────────────┘

Other transitions:

• cancel() → CANCELLED
• resolveDispute() decides between COMPLETED or REFUNDED

🚀 Basic Flow

Client deploys contract with freelancer, admin, fee %, and duration

Client adds milestones → addMilestone()

Client deposits total → deposit()

Freelancer starts and completes milestones → completeMilestone(id)

Client approves → approveMilestone(id) → payment auto-released

If dispute → raiseDispute() → admin resolves with resolveDispute()

If deadline passes → triggerAutoRefund()

🔧 Deployment (Remix)

Compiler: Solidity ^0.8.0 Deploy with:

constructor(address _freelancer, address _admin, uint _adminFeePercent, uint _durationDays)

📜 License SPDX-License-Identifier: MIT