oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 7 Packages Projects Releases Wiki Activity
Files
2694c078983f1df9f9f1656163f08b8bb940fb64
aitbc/docs/beginner/04_miners/7_api-miner.md
AITBC System dda703de10 feat: implement v0.2.0 release features - agent-first evolution 
✅ v0.2 Release Preparation:
- Update version to 0.2.0 in pyproject.toml
- Create release build script for CLI binaries
- Generate comprehensive release notes

✅ OpenClaw DAO Governance:
- Implement complete on-chain voting system
- Create DAO smart contract with Governor framework
- Add comprehensive CLI commands for DAO operations
- Support for multiple proposal types and voting mechanisms

✅ GPU Acceleration CI:
- Complete GPU benchmark CI workflow
- Comprehensive performance testing suite
- Automated benchmark reports and comparison
- GPU optimization monitoring and alerts

✅ Agent SDK Documentation:
- Complete SDK documentation with examples
- Computing agent and oracle agent examples
- Comprehensive API reference and guides
- Security best practices and deployment guides

✅ Production Security Audit:
- Comprehensive security audit framework
- Detailed security assessment (72.5/100 score)
- Critical issues identification and remediation
- Security roadmap and improvement plan

✅ Mobile Wallet & One-Click Miner:
- Complete mobile wallet architecture design
- One-click miner implementation plan
- Cross-platform integration strategy
- Security and user experience considerations

✅ Documentation Updates:
- Add roadmap badge to README
- Update project status and achievements
- Comprehensive feature documentation
- Production readiness indicators

🚀 Ready for v0.2.0 release with agent-first architecture
2026-03-18 20:17:23 +01:00

1.8 KiB
Raw Blame History

Miner API Reference

Complete API reference for miner operations.

Endpoints

Register Miner

POST /v1/miners

Request Body:

{
  "name": "my-miner",
  "gpu_type": "v100",
  "gpu_count": 1,
  "location": "us-east",
  "price_per_hour": 0.05,
  "max_concurrent": 4
}

Response:

{
  "miner_id": "miner_xyz789",
  "api_key": "key_abc123",
  "status": "pending"
}

Update Miner

PUT /v1/miners/{miner_id}

Heartbeat

POST /v1/miners/{miner_id}/heartbeat

Response:

{
  "status": "ok",
  "jobs_assigned": 0,
  "queue_length": 5
}

List Available Jobs

GET /v1/miners/{miner_id}/jobs/available

Response:

{
  "jobs": [
    {
      "job_id": "job_abc123",
      "model": "gpt2",
      "gpu_type": "v100",
      "gpu_count": 1,
      "estimated_time": 600,
      "price": 0.05
    }
  ]
}

Accept Job

POST /v1/miners/{miner_id}/jobs/{job_id}/accept

Complete Job

POST /v1/miners/{miner_id}/jobs/{job_id}/complete

Request Body:

{
  "result_hash": "sha256:abc123...",
  "metrics": {
    "execution_time_seconds": 600,
    "gpu_time_seconds": 600
  }
}

Get Miner Stats

GET /v1/miners/{miner_id}/stats

Response:

{
  "total_jobs": 100,
  "success_rate": 0.98,
  "average_completion_time": 600,
  "earnings": 50.5,
  "earnings_per_gpu_hour": 0.05
}

Error Codes

Code Description
400 Invalid request
401 Unauthorized
404 Miner/job not found
409 Job already assigned
422 Validation error

Rate Limits

  • 60 requests/minute
  • 10 job operations/minute

Next