Skip to content

README.md

Latest commit

 

History

History
239 lines (172 loc) · 9.87 KB

README.md

File metadata and controls

239 lines (172 loc) · 9.87 KB
Code3 Logo

Turn your idle Claude Code quota into earnings, or hire someone else's for $0.02/task

🎥 Demo Video • Use Cases • Features • Documentation

简体中文

Ethereum Sepolia TypeScript Solidity License

🎯 Vision

Code3 is a decentralized bounty marketplace built on Ethereum, where non-subscribers can pay $0.02 per task instead of $20/month subscriptions, and subscribers can monetize their idle AI coding agent quotas.

Core Values:

  • 💸 Pay-Per-Task: Pay $0.02 per task, not $20/month — eliminate subscription waste
  • 🔄 Quota Sharing: Subscribers monetize idle quotas (refreshes every 5 hours)
  • 🤖 AI Agent First: MCP toolchain designed for Claude Code and other AI coding agents
  • 🔗 On-Chain Authority: All state changes recorded on Ethereum Sepolia testnet

💡 Use Cases

Scenario 1: Non-Subscribers - Pay-Per-Task Instead of Monthly Subscription

Problem: You need Claude Code to help with a specific task, but don't have a subscription. Upgrading to a $20/month subscription for just one task doesn't make sense.

Code3 Solution: Publish a bounty, let Workers with subscriptions help you complete it

sequenceDiagram
    participant R as 👤 Requester<br/>(No Subscription)
    participant C3 as 🏛️ Code3 Platform
    participant W as 🤖 Worker<br/>(Has Claude Code)
    participant CC as 💬 Claude Code

    Note over R: Need: User Auth System<br/>No Claude Code subscription

    R->>C3: Publish bounty<br/>💰 $0.02
    Note over C3: Task available

    Note over W: Idle time detected<br/>(Quota unused)
    W->>C3: Accept bounty
    C3->>W: Task spec

    W->>CC: specify() → spec.md
    W->>CC: plan() → plan.md
    W->>CC: implement() → code + tests
    W->>CC: analyze() → quality check

    W->>C3: Submit deliverable
    C3->>R: Complete project<br/>📦 Code + Tests + Docs
    R->>C3: Confirm & Pay
    C3->>W: Receive payment

    Note over R,W: Requester: $0.02 paid<br/>Worker: Monetized idle quota<br/>Win-Win! ✅
Loading

Cost Comparison:

Your Need Claude Code Subscription Code3 Bounty
1 task/month $20/month (wasteful) $0.02/task ✅
5 tasks/month $20/month $0.10 total
20+ tasks/month $20/month (makes sense) $0.40 total

Why This Works:

  • ✅ For you (Requester): Pay only for what you need ($0.02 per task vs $20-200/month subscription)
  • ✅ For Workers: Claude Code subscriptions have quotas that refresh every 5 hours. When they have idle time, they can monetize unused quotas by accepting tasks
  • ✅ Win-Win: You get tasks done at lower cost, Workers monetize their idle computing resources

Scenario 2: Subscribers - Avoid Waiting or Upgrading When Quota Runs Out

Problem: You're a $20/month Claude Code subscriber, but you've used up your quota in 1-3 hours. You still have tasks to complete, but now you face two bad options:

  • ⏰ Wait: Until quota refreshes (maybe 7pm or 12am) - wasted time
  • 💸 Upgrade: To $200/month plan - expensive and wasteful if you don't need it regularly

Code3 Solution: Publish your remaining tasks as bounties instead

flowchart TD
    Start["⏰ 3pm: Quota Used Up<br/>📋 3 tasks remaining<br/>⏳ Refresh at 7pm (4 hours)"]

    Start --> Choice{What to do?}

    Choice -->|Option 1| Wait["⏰ Wait 4 hours<br/>💰 Cost: $0<br/>⏱️ Time: 4 hours"]
    Choice -->|Option 2| Upgrade["💸 Upgrade to $200/month<br/>💰 Cost: +$180/month<br/>⏱️ Time: Immediate"]
    Choice -->|Option 3| Bounty["🏛️ Publish 3 bounties on Code3<br/>💰 Cost: $0.06 total<br/>⏱️ Time: Immediate"]

    Wait --> WaitResult["❌ Wasted time<br/>✅ No extra cost<br/>⚠️ Only if not urgent"]
    Upgrade --> UpgradeResult["❌ Expensive for occasional use<br/>✅ High quota daily<br/>⚠️ Only if heavy user"]
    Bounty --> BountyResult["✅ Immediate results<br/>✅ Cost-effective ($0.06 vs $180)<br/>✅ Pay only when needed<br/>🎯 Best for occasional bursts!"]

    style BountyResult fill:#90EE90
    style WaitResult fill:#FFB6C1
    style UpgradeResult fill:#FFB6C1
    style Bounty fill:#87CEEB
Loading

Real Example:

🕒 3pm - Your situation:
├─ Claude Code quota: 0% remaining (used up in 2 hours)
├─ Tasks completed: 8 tasks ✅
├─ Tasks remaining: 3 tasks ⏳
└─ Quota refresh: 7pm (4 hours away)

💡 Your choice: Publish 3 bounties on Code3
├─ Cost: $0.02 × 3 = $0.06 total
├─ Time: Results in ~30 minutes (Workers accept & complete)
└─ Result: All 11 tasks done by 3:30pm! 🎉

📊 Cost comparison:
├─ Wait 4 hours: $0 (but time wasted)
├─ Upgrade to $200/month: $180 extra (wasteful if occasional)
└─ Code3 bounties: $0.06 (optimal for occasional bursts) ✅

Cost Comparison:

Option Cost Time When It Makes Sense
⏰ Wait for quota refresh $0 4-8 hours Not urgent tasks
💸 Upgrade to $200/month +$180/month Immediate Need high quota daily
🏛️ Publish bounties $0.06 (3 tasks) Immediate Occasional bursts ✅

Why This Works:

  • ✅ Immediate results: No waiting for quota refresh
  • ✅ Cost-effective: $0.06 for 3 tasks vs $180/month upgrade
  • ✅ Flexible: Pay only when you need extra capacity
  • ✅ Help other subscribers: Your bounties help other Workers monetize their idle quotas

Scenario 3: Future Expansion to Other AI Services

Current Focus: Coding tasks (easiest to review and validate)

Future Expansion (same economic model):

  • 📊 ChatGPT Deep Research: Need one-time deep research but don't have subscription
  • 🎨 Design Generation: Need UI design or image generation occasionally
  • 📝 Content Creation: Need article writing or translation once
  • 🔬 Data Analysis: Need one-time data processing or visualization

Core Philosophy: Transform idle AI subscription quotas into a shared resource marketplace where:

  • Non-subscribers: Pay per task instead of full subscription
  • Subscribers: Monetize unused quotas during idle time
  • Everyone wins: Better resource utilization, lower costs, faster results

✨ Features

🛠️ Three Major MCP Services

MCP Server Tool Count Core Functions
spec-kit-mcp 7 Requirement specification (specify), technical solution (plan), task breakdown (tasks), requirement clarification (clarify), quality detection (analyze), auto-implementation (implement)
spect-kit-adapter-mcp 6 Create bounty, accept bounty , submit bounty, confirm bounty, claim bounty, cancel bounty

🔐 Security Guarantees

  • ✅ On-Chain Authority: Core state stored in Ethereum smart contracts
  • ✅ Transparent & Verifiable: All bounty states recorded on-chain
  • ✅ Zero Key Storage: Dashboard doesn't save any private keys
  • ✅ Idempotency Guarantee: Based on taskHash, bountyId, submissionUrl idempotency keys

📚 Documentation

Complete documentation in Code3/docs/ directory:

Document Description
01-Data Model Core data structures, type mapping, state machine (single source of truth)
02-Interfaces MCP tools, contract functions, API endpoints
03-Architecture Tech stack, system layers, module responsibilities
04-Datastream Complete data flow from requirement publishing to bounty settlement
05-Package Structure Monorepo structure, build order, environment variables
06-Quick Start 5-minute local startup, contract deployment, end-to-end testing
07-UI/UX Design Dashboard interface, interaction flow, visual specifications
08-Workflow Guide Complete operation steps for Requester/Worker/Reviewer
09-Security Key management, permission boundaries, audit mechanisms
99-Glossary All technical terms and abbreviations

🤝 Contributing

Contributions welcome! See CLAUDE.md for development workflow specifications.

Modifying Data Structures

⭐ Mandatory: Any data structure modifications must first update docs/01-data-model.md, then update code.

Adding MCP Tools

  1. Define interface in docs/02-interfaces.md
  2. Implement in corresponding MCP package (spec-mcp/*)
  3. Update tool inventory in docs/03-architecture.md
  4. Update usage examples in docs/08-workflow.md

📄 License

MIT License - See LICENSE

🔗 Links

Built with ❤️ by the Code3 Team

Powered by Ethereum • Designed for AI Agents