How Worqen Works
Explore the complete lifecycle of jobs, hires, payments and more. Interactive diagrams show you exactly how every process works on the platform.
User Onboarding
How new users join the platform and set up their profiles.
Sign up with email, password, first name & last name. Your account is created instantly.
Every new account receives 60 Worqs — enough for ~30 platform actions.
A Solana wallet is created for you automatically — no seed phrase or browser extension needed — and you can connect your own non-custodial wallet (Phantom, Solflare). It holds USDC, USDT, EURC, and SOL.
Profile Sections
Dual Roles
Every user can act as both Employer and Employee — the role is contextual. Post a job and you're the Employer. Create a vacancy and you're the Employee.
Worqs Currency
Non-tradeable internal currency that gates participation and prevents spam.
Job and service owners choose how many Worqs an application or proposal to their listing costs — anywhere from 0 (free) up to 100.
Refunds
Withdrawing an application before it's accepted gives a full refund of the Worqs spent. Declined invitations are not refunded.
How It Works
Balance is checked before every action — if insufficient Worqs, the action is blocked. Worqs are deducted first, then the action is committed. Full transaction history is available.
Employer: Job Flow
A Job represents work that an Employer needs done. Create a draft, publish it, and manage its lifecycle.
Not visible. Fully editable. Can be published or cancelled.
Visible and accepting applications.
At least one hire exists. Work is ongoing.
Temporarily hidden from search. Can resume to Active.
All work finished, reviews done.
Employee: Vacancy Flow
A Vacancy represents services that an Employee offers. Create a draft, publish it, and manage visibility.
Draft
Not visible. Fully editable.
Active
Visible to employers. Tracks views, inquiries, invitations, hires.
Paused
Temporarily hidden. Can be resumed.
Closed
Soft-deleted, cannot be reopened.
Special Features
Discovery & Matching
How employers and employees find each other through search, filters, and map views.
- •Browse active vacancies with filters
- •Map view: geo-based employee search
- •Filter by category, city, rate, experience
- •View employee profile, portfolio, ratings
- •Browse active jobs with filters
- •Map view: geo-based job search
- •Filter by category, urgency, rate, duration
- •View job details, milestones, employer profile
PostGIS Geo Search
Both jobs and vacancies support location-based search using PostGIS. Find opportunities near you or search within a specific radius.
Three Paths to Hire
There are three ways an Employer and Employee can start working together.
Path A: Employee Applies
Employee finds a job, submits application. Employer reviews, accepts or rejects. Employee can withdraw before acceptance for a refund.
Path B: Employer Invites
Employer finds a vacancy, sends invitation. Employee accepts (Worqs waived) and submits application. Employer accepts to create hire.
Path C: Direct Hire
Employer directly creates a hire for a specific employee on a job. No application step needed.
A hire record is created (Active), a chat is automatically created for communication, the job status updates to InProgress, and the employee is notified.
Hire Lifecycle
The Hire is the central entity that connects an employer with an employee for a specific job.
Hire Contains
Work Logs
Work logs are used for hourly and daily payment types. Employee logs work, employer approves it.
Work Log Contains
Rules
- •Only for hourly/daily jobs
- •Cannot log future dates
- •Max 24 hours per day
- •One entry per date per hire
Milestone-Based Work
Milestones are used for fixed-price or deliverable-based work. Employer defines milestones, employee completes them.
Title & description
Amount ($ or %)
Due date
Acceptance criteria
Deliverable description
Sequence order
Revision Cycle
Employer can request revisions multiple times. Each revision increments a counter. Employee receives feedback and re-submits. No limit on revision rounds.
Invoicing
Invoices are the billing mechanism. Employee creates invoices, employer approves them, then payment happens via escrow.
Hourly Invoice
Based on approved work logs. Bundles work log hours into an invoice.
Milestone Invoice
Based on approved milestone. One invoice per approved milestone.
Final Invoice
Based on agreed rate. Single final invoice for entire job.
Platform Fee
Employees keep 100% of every invoice — there is no worker fee. The platform fee is paid by the employer: 5% per hire, or 3% with Prime. Example: on a $1,000 invoice the employee receives the full $1,000.
Escrow Payments
Secure, non-custodial payments on Solana. Funds are locked in an on-chain escrow smart contract — not even Worqen can redirect them — until both parties confirm completion. Escrows can hold USDC, USDT, EURC, or SOL.
Create Escrow
The hire amount is locked in the chosen currency (USDC, USDT, EURC, or SOL). The employer's platform fee — 5%, or 3% with Prime — is calculated. An on-chain escrow account (PDA) is generated.
Deposit On-Chain
Employer deposits the funds into the escrow vault. The platform verifies the transaction on-chain. The hire moves to In Progress.
Work Happens
Employee works (logs, milestones, invoices). Funds are safely locked.
Both Confirm
Employer and employee independently confirm completion. Status moves to PendingRelease.
Release Funds
Employer releases the funds. The payment is sent from the vault directly to the employee's wallet. Everyone is notified.
Disputes & Resolution
Either party can raise a dispute if there's a disagreement about the work or payment.
- •Provide reason for the dispute
- •Funds frozen in vault — no release possible
- •Other party notified immediately
- •Dedicated dispute chat opens
- •Admin reviews evidence and messages
- •Decides split: X% to employee, Y% to employer
- •Executes resolution on-chain
- •Both parties notified of their share
A dedicated message thread for the dispute with employer, employee, and platform admin. Supports text, evidence attachments, and system messages. Messages can only be edited within 15 minutes.
Completion & Reviews
How hires are completed and how the review system works.
- •Employee marks hire as complete (optionally with rating + review)
- •Employer marks hire as complete (optionally with rating + review)
- •When both have completed → Hire status: Completed
- •Rating 1–5 stars + text review
- •One review per party per hire
- •Reviews visible on public profiles
- •Notification sent when review is received
Only the employer can terminate a hire. Must provide a reason. Employee is notified. Only allowed when hire is Active.
Chat & Communication
Real-time messaging system with rich features for collaboration.
Auto-Created Chats
When a hire is created, a chat room is automatically created with both employer and employee as participants.
Features
Presence System
Notifications
Real-time notification system with WebSocket push delivery.
Persisted
Always available even if user is offline.
Real-time Push
Instant delivery via WebSocket.
Multi-Device
Supports simultaneous connections.
Notification Events
State Diagrams
All state machines in one place. Select a tab to view the interactive diagram.