How uzumakiodz/parallax works
Parallax is a decentralized AI-orchestrated microtask marketplace. A creator submits a brief for AI decomposition, reviews and funds subtasks on-chain; workers claim, bond, and submit deliverables; an AI verifier grades submissions and the contracts settle rewards or retain failed work for appeal. Verified outputs can be synthesized into a master deliverable. The graph combines the documented product workflow with sampled frontend routing and backend wiring; several UI-to-API links and contract internals are documented only at a high level, so those links use the README as evidence.
Main entry points: index.ts Backend API · worker.ts Verification worker · App.tsx Application routes · chain.ts Chain indexing
Components 22
Web application
- Application routes
frontend/src/App.tsx - Creator workspace
frontend/src/pages/CustomerDashboard.tsx - Subtask review
frontend/src/components/task/ReviewSubtasksModal.tsx - Worker marketplace
frontend/src/pages/WorkerTasks.tsx - Task workspace
frontend/src/pages/TaskDetail.tsx - Admin dashboard
frontend/src/pages/AdminDashboard.tsx - Wallet and contract client
frontend/src/contexts/Web3Context.tsx
Orchestration service
- Backend API
backend/src/index.ts - Brief decomposition
backend/src/routes/decompose.ts - Task operations
backend/src/routes/tasks.ts - Submission access
backend/src/routes/submissions.ts - Verification trigger
backend/src/routes/verify.ts - Verification worker
backend/src/lib/worker.ts - Chain indexing
backend/src/lib/chain.ts - Deployment registry
backend/src/lib/deployments.ts
On-chain marketplace
- Task and escrow contracts
AI and content services
- Gemini AI
backend/src/lib/gemini.ts - IPFS storage
backend/src/lib/ipfs.ts
Persistence and indexing
- PostgreSQL data
backend/src/db/client.ts
Other components
- Task creator
- Freelance worker
- Appeal administrator
Connections 36
- Application routes → Creator workspace: routes to
frontend/src/App.tsx - Application routes → Worker marketplace: routes to
frontend/src/App.tsx - Application routes → Task workspace: routes to
frontend/src/App.tsx - Application routes → Admin dashboard: routes to
frontend/src/App.tsx - Application routes → Wallet and contract client: provides context
frontend/src/App.tsx - Task creator → Creator workspace: creates projects
- Creator workspace → Subtask review: reviews subtasks
frontend/src/pages/CustomerDashboard.tsx - Subtask review → Wallet and contract client: reads currency
frontend/src/components/task/ReviewSubtasksModal.tsx - Creator workspace → Backend API: requests decomposition
- Backend API → Brief decomposition: routes requests
backend/src/index.ts - Brief decomposition → Gemini AI: generates subtasks
backend/src/routes/decompose.ts - Brief decomposition → IPFS storage: stores content
backend/src/routes/decompose.ts - Task creator → Task and escrow contracts: approves and funds
- Freelance worker → Worker marketplace: browses work
- Worker marketplace → Task and escrow contracts: claims with bond
- Freelance worker → Task and escrow contracts: submits proof
- Task workspace → Backend API: loads task data
- Task operations → IPFS storage: resolves content
backend/src/routes/tasks.ts - Task operations → PostgreSQL data: queries tasks
backend/src/routes/tasks.ts - Backend API → Task operations: routes requests
backend/src/index.ts - Backend API → Submission access: routes requests
backend/src/index.ts - Backend API → Verification trigger: routes requests
backend/src/index.ts - Backend API → Chain indexing: starts listeners
backend/src/index.ts - Backend API → Verification worker: starts worker
backend/src/index.ts - Verification worker → Gemini AI: grades submissions
backend/src/lib/worker.ts - Verification worker → IPFS storage: fetches deliverables
backend/src/lib/worker.ts - Verification worker → Task and escrow contracts: submits verification
- Verification worker → Chain indexing: syncs transaction
backend/src/lib/worker.ts - Verification trigger → Verification worker: invokes verification
backend/src/routes/verify.ts - Task and escrow contracts → Chain indexing: emits events
- Chain indexing → PostgreSQL data: indexes state
backend/src/lib/chain.ts - Chain indexing → Deployment registry: loads deployments
backend/src/lib/chain.ts - Appeal administrator → Admin dashboard: resolves appeals
- Admin dashboard → Backend API: requests dispute data
- Task and escrow contracts → Freelance worker: settles rewards
- Task and escrow contracts → Task creator: refunds on upheld appeal