Welcome to OFFER-HUB! This platform aims to revolutionize the freelance marketplace by leveraging blockchain technology, cryptocurrency payments, and smart contracts to create a secure and efficient environment for freelancers and clients worldwide.
Our mission is to remove intermediaries, reduce fees, and empower users with tools to collaborate seamlessly in areas like design, programming, writing, and consulting. 🚀
Please read carefully and follow our contribution guide step by step — this will allow everything to flow in the best way:
Before contributing, ensure your system meets these requirements:
- Node.js: v23.3.0
- npm: v10+
1️⃣ Fork this repository to your GitHub account.
2️⃣ Clone your forked repo locally:
git clone https://github.com/<your_user>/offer-hub3️⃣ Navigate into the project directory:
cd offer-hub4️⃣ Install frontend dependencies:
npm install --legacy-peer-deps5️⃣ Run the development server:
npm run dev6️⃣ Open the app in your browser at:
http://localhost:3000
The backend lives in the /backend folder and includes all APIs and database migration logic using Supabase.
👉 For full instructions, refer to the dedicated backend guide:
/backend/README.md
The Offer Hub platform is powered by a comprehensive suite of Soroban smart contracts. Each contract serves a specific purpose in creating a secure, decentralized freelance marketplace.
- Contracts Overview - Complete system architecture and contract interactions
- User Registry Contract - User verification and access control system
- Emergency Contract - Platform safety and crisis management
- Escrow Contract - Secure payment management with milestone support
- Escrow Factory - Standardized deployment and batch management
- Fee Manager Contract - Centralized fee calculation and collection
- Dispute Resolution Contract - Two-tier mediation and arbitration system
- Publication Contract - On-chain registry for services and projects
- Rating System Integration - User rating and feedback system
- Reputation NFT Contract - Achievement-based NFT rewards
The contracts work together to create a seamless platform experience:
User Registration → Service/Project Publication → Escrow Creation →
Payment Processing → Work Completion → Rating & Reputation → NFT Rewards
For disputes: Escrow → Dispute Resolution → Mediation/Arbitration → Resolution
- Freelancer Profile Implementation - Frontend profile system
- Contributors Guidelines - Development standards and practices
If you get stuck or want to discuss implementation ideas, open an issue or start a discussion in the repo. Let's build something amazing together 💫