Fhenix Escrow

Videos

Tech Stack

React

Web3

Ethers

Node

Solidity

Description

**What it is**  
A non-custodial, milestone-based escrow dApp where deal terms (total payment, per-milestone amounts) are stored encrypted on-chain using FHE. Both parties sign, the client funds escrow, the developer submits milestones, the client approves them, and the developer claims a single payout when all are approved. Disputes can be raised and resolved by an on-chain judge or arbitrator; timeout/refund and mutual cancellation are supported.

**Who it’s for**  
Freelancers, agencies, and clients who want Web3 escrow with private terms and on-chain enforcement—no need to expose payment amounts or milestone breakdowns to the public chain.

**Key features**  
- Client- or developer-initiated contracts; invite by address or shareable link  
- Encrypted total payment and milestone amounts (FHE via Fhenix cofhe-contracts)  
- Dual signing, escrow funding, milestone submit/approve workflow  
- Single payout when all milestones approved; dispute resolution and arbitrator support  
- Timeout/refund and mutual cancellation  

**Tech stack**  
- **Frontend:** Next.js 16, TypeScript, Tailwind CSS, Framer Motion, Three.js  
- **Web3:** ethers.js (wallet + contract calls)  
- **FHE:** fhenixjs (client-side encryption), cofhejs (CoFHE); contracts use @fhenixprotocol/cofhe-contracts  
- **Contracts:** Solidity (Foundry); PrivateEscrow + optional DisputeResolver  
- **Deploy:** Netlify (app); config via serverless `/api/config` so env vars stay server-only  

**Repo layout**  
- `app/` — Next.js app (landing, dashboard, create flow, contract detail)  
- `contracts/` — Foundry project (PrivateEscrow.sol, DisputeResolver.sol)

Progress During Hackathon

This project delivers a privacy-preserving escrow platform built with smart contracts and a full-stack web app. Smart Contracts: The system uses two main contracts. PrivateEscrow.sol manages the full escrow lifecycle, from drafting and signing to funding, milestone tracking, and payouts while keeping amounts private through Fhenix’s homomorphic encryption (FHE). It supports dual signing, milestone submissions and approvals, optional dispute resolution, timeout refunds, and mutual cancellations. DisputeResolver.sol enables arbitration by designated judges. Both contracts are deployed on Arbitrum Sepolia, with scripts and documentation provided. Web Application: The web app offers an intuitive interface for users to create, manage, and track escrow contracts as clients or developers. Contracts can be initiated from either side, shared via wallet address or link, and encrypted with CoFHE before on-chain commitment. Each contract page shows its full progress: signing, funding, milestones, payouts, disputes, or cancellations while the dashboard summarizes all active contracts. Wallet integration supports MetaMask and other providers, with automatic network switching and optional on-chain username registration. Configuration & Deployment: Sensitive data such as contract addresses and RPC URLs are securely handled server-side via the /api/config endpoint, ensuring nothing leaks to the client. The site loads configuration before rendering and shows setup guides if data is missing. Deployment is managed on Netlify at https://fhenixescrow.netlify.app, with custom build and environment scripts. UI Design: The dashboard features a dark theme with green, blue, and purple accents, a sidebar for navigation, metric cards showing total contracts and escrowed ETH, and grid-style contract cards with progress and status indicators.

Fundraising Status

Currently opened to fund raising.