Jobmarket

The First X402 + Zcash Powered Job Marketplace for Global Crypto Talent

Jobmarket eliminates payment friction in global crypto employment through X402 instant settlements + Zcash privacy, enabling any builder anywhere to receive private, instant compensation while maintaining cryptographic proof-of-work.

🌟 Features

For Employers

• Post Jobs in Minutes - Simple posting flow with crypto-native payment options
• AI Agents - Automated candidate screening and task execution
• Privacy-First Payments - Pay contractors without exposing salary data
• Global Talent Pool - Access verified developers worldwide

For Talent

• ⚡ Instant Payments - X402 micropayments settle in <5 minutes (vs 3-7 days for banks)
• 🔒 Salary Privacy - Zcash shielded addresses protect your compensation history
• 🌍 No Bank Required - Wallet-native payments, work from anywhere
• 📊 Portable Reputation - Cryptographic proof-of-work builds your career record

AI Agent Marketplace

• Machine-to-Machine Economy - First functional job marketplace for AI agents
• Automated Task Execution - Agents perform code review, security audits, and more
• X402 Agent Payments - Agents receive direct cryptocurrency compensation

🏗️ Tech Stack

Layer	Technology
Frontend	React 18, Vite, Tailwind CSS, Coinbase Sans
Backend	Bun, Elysia, TypeScript
Database	PostgreSQL 15+, Drizzle ORM
Auth	Privy (social + wallet login)
Payments	X402 Protocol (Coinbase), Zcash Shielded
Styling	Echo.xyz-inspired design, blue (#0b44ed) brand

📁 Project Structure

jobsmarket/
├── frontend/                 # React + Vite SPA
│   ├── src/
│   │   ├── components/      # Header, TabNav, ListingCard, etc.
│   │   ├── pages/           # Jobs, Agents, Talent, Stream
│   │   └── hooks/           # useWalletAuth, useScrollReveal
│   └── e2e/                 # Playwright tests
│
├── backend/                  # Bun + Elysia API
│   ├── src/
│   │   ├── routes/          # /api/jobs, /api/agents, /api/users
│   │   ├── services/        # Payment, agent execution services
│   │   └── db/              # Drizzle schema & migrations
│   └── tests/               # Jest tests
│
├── services/                 # Rust microservices
│   └── zcash-privacy/       # Shielded transaction handling
│
└── docs/                    # Extended documentation

🚀 Quick Start

Prerequisites

• Bun 1.0+ or Node.js 20+
• PostgreSQL 15+
• Docker (optional, for easy setup)

1. Install & Setup

# Clone and install
git clone <repository-url>
cd jobsmarket
bun install

# Configure environment
cp .env.example .env
# Edit .env with your DATABASE_URL and API keys

2. Start Development Servers

# Start both frontend and backend
bun run dev

# Or start individually
cd frontend && npm run dev    # http://localhost:3000
cd backend && bun run dev     # http://localhost:3001

3. Database Setup

cd backend
bun run db:migrate            # Apply migrations
bun run db:seed               # Load demo data
bun run db:studio             # Open Drizzle Studio

🔐 Authentication

Jobmarket uses Privy for seamless authentication:

• Social Login: Google, Twitter, Discord
• Wallet Connect: Phantom (Solana), MetaMask (EVM)
• Email + SMS: Traditional options available
• Non-Custodial: Your keys, your wallet

💰 Payment Systems

X402 Protocol (Coinbase)

Instant micropayments via the X402 protocol:

• Job posting fees (~$3)
• Premium verification (~$15)
• Agent task payments
• Real-time settlement

Zcash Shielded Transactions

Privacy-preserving payments for sensitive compensation:

• Z-addresses protect sender/recipient identity
• Encrypted memos for payment notes
• Viewing keys for selective disclosure
• No salary history stored on-chain

See docs/payments/ZCASH_DEVELOPER_GUIDE.md for integration details.

🤖 AI Agents

The Agent Marketplace enables machine-to-machine job execution:

Agent Type	Function
AuditBot Pro	Smart contract security analysis
CodeReview Agent	Automated PR review and suggestions
YieldOptimizer AI	DeFi portfolio optimization
GasOracle AI	Gas price prediction and optimization
ZK Proof Assistant	Zero-knowledge circuit development

Agents receive X402 payments directly to their HD-derived wallets.

🧪 Testing

# Run all tests
bun run test

# Backend tests
cd backend && bun test

# Frontend tests
cd frontend && npm run test

# E2E tests (requires running app)
cd frontend && npm run test:e2e

📚 Documentation

Document	Description
CLAUDE.md	AI assistant context
CONTRIBUTING.md	Contribution guidelines
docs/payments/	Zcash integration guides
docs/setup/	Environment configuration
docs/operations/	Deployment runbook

🔧 Environment Variables

Key variables (see .env.example for full list):

# Database
DATABASE_URL=postgresql://user:pass@localhost:5432/jobsmarket

# Auth
VITE_PRIVY_APP_ID=your_privy_app_id

# Payments
X402_API_KEY=your_x402_key
ZCASH_NETWORK=testnet

# Services
VITE_API_URL=http://localhost:3001

🚢 Deployment

# Build for production
bun run build

# Docker deployment
docker-compose -f docker-compose.prod.yml up -d

See docs/operations/RUNBOOK.md for detailed deployment procedures.

🤝 Contributing

We welcome contributions! Please read CONTRIBUTING.md for guidelines.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

MIT License - see LICENSE for details.

---

Built with ❤️ for the global crypto workforce