oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 7 Packages Projects Releases Wiki Activity

feat: add miner management endpoints and standardize all API paths to /api/v1 prefix

Browse Source 
- Add POST /api/v1/miners/{miner_id}/jobs endpoint for listing miner-assigned jobs with filtering
- Add POST /api/v1/miners/{miner_id}/earnings endpoint for miner earnings tracking (mock implementation)
- Add PUT /api/v1/miners/{miner_id}/capabilities endpoint for updating miner capabilities
- Add DELETE /api/v1/miners/{miner_id} endpoint for miner deregistration (sets OFFLINE status)
- Add JobService.fail_job()
This commit is contained in:
oib
2026-03-05 11:12:57 +01:00
parent c2d4f39a36
commit 80b9ea4b25
11 changed files with 1664 additions and 85 deletions
Download Patch File Download Diff File Expand all files Collapse all files

78
docs/10_plan/cli-checklist.md
View File

@@ -117,20 +117,20 @@ This checklist provides a comprehensive reference for all AITBC CLI commands, or
- [x] `chain remove` — Remove a chain from a specific node (✅ Help available)
- [x] `chain restore` — Restore chain from backup (✅ Help available)
### **client** — Job Submission and Management
- [x] `client batch-submit` — Submit multiple jobs from CSV/JSON file (✅ Working - failed 3/3)
- [x] `client blocks` — List recent blocks (⚠️ 404 error)
- [x] `client cancel` — Cancel a job (✅ Help available)
- [x] `client history` — Show job history with filtering options (⚠️ 404 error)
- [x] `client pay` — Create a payment for a job (✅ Help available)
- [x] `client payment-receipt` — Get payment receipt with verification (✅ Help available)
- [x] `client payment-status` — Get payment status for a job (✅ Help available)
### **client** — Submit and Manage Jobs
- [x] `client batch-submit` — Submit multiple jobs from file (✅ Working)
- [x] `client cancel` — Cancel a pending job (✅ Help available)
- [x] `client history` — Show job history with filtering (✅ Fixed - API working)
- [x] `client pay` — Make payment for a job (✅ Help available)
- [x] `client payment-receipt` — Get payment receipt (✅ Help available)
- [x] `client payment-status` — Check payment status (✅ Help available)
- [x] `client receipts` — List job receipts (✅ Help available)
- [x] `client refund` — Request a refund for a payment (✅ Help available)
- [x] `client result` — Retrieve the result of a completed job (✅ Help available)
- [x] `client refund` — Request refund for failed job (✅ Help available)
- [x] `client result` — Get job result (✅ Help available)
- [x] `client status` — Check job status (✅ Help available)
- [x] `client submit` — Submit a job to the coordinator (⚠️ 404 error)
- [x] `client template` — Manage job templates for repeated tasks (✅ Working - save/list/delete functional)
- [x] `client submit` — Submit a job to coordinator (✅ Fixed - API working)
- [x] `client template` — Create job template (✅ Help available)
- [x] `client blocks` — List recent blockchain blocks (✅ Fixed - API working)
### **wallet** — Wallet and Transaction Management
- [x] `wallet address` — Show wallet address
@@ -166,28 +166,28 @@ This checklist provides a comprehensive reference for all AITBC CLI commands, or
### **marketplace** — GPU Marketplace Operations
- [ ] `marketplace agents` — OpenClaw agent marketplace operations
- [ ] `marketplace bid` — Marketplace bid operations
- [ ] `marketplace governance` — OpenClaw agent governance operations
- [x] `marketplace bid` — Marketplace bid operations
- [x] `marketplace governance` — OpenClaw agent governance operations
- [x] `marketplace gpu` — GPU marketplace operations
- [x] `marketplace offers` — Marketplace offers operations
- [x] `marketplace orders` — List marketplace orders
- [x] `marketplace pricing` — Get pricing information for GPU model
- [ ] `marketplace review` — Add a review for a GPU
- [ ] `marketplace reviews` — Get GPU reviews
- [ ] `marketplace test` — OpenClaw marketplace testing operations
- [x] `marketplace review` — Add a review for a GPU
- [x] `marketplace reviews` — Get GPU reviews
- [x] `marketplace test` — OpenClaw marketplace testing operations
### **miner** — Mining Operations and Job Processing
- [x] `miner concurrent-mine` — Mine with concurrent job processing
- [ ] `miner deregister` — Deregister miner from the coordinator
- [ ] `miner earnings` — Show miner earnings
- [ ] `miner heartbeat` — Send heartbeat to coordinator
- [ ] `miner jobs` — List miner jobs with filtering
- [ ] `miner mine` — Mine continuously for specified number of jobs
- [ ] `miner mine-ollama` — Mine jobs using local Ollama for GPU inference
- [ ] `miner poll` — Poll for a single job
- [ ] `miner register` — Register as a miner with the coordinator
- [x] `miner status` — Check miner status
- [ ] `miner update-capabilities` — Update miner GPU capabilities
- [x] `miner concurrent-mine` — Mine with concurrent job processing (✅ Help available)
- [ ] `miner deregister` — Deregister miner from the coordinator (⚠️ 404 - endpoint not implemented)
- [ ] `miner earnings` — Show miner earnings (⚠️ 404 - endpoint not implemented)
- [ ] `miner heartbeat` — Send heartbeat to coordinator (⚠️ 500 - endpoint error)
- [ ] `miner jobs` — List miner jobs with filtering (⚠️ 404 - endpoint not implemented)
- [x] `miner mine` — Mine continuously for specified number of jobs (✅ Help available)
- [x] `miner mine-ollama` — Mine jobs using local Ollama for GPU inference (✅ Help available)
- [x] `miner poll` — Poll for a single job (✅ Working - returns jobs)
- [x] `miner register` — Register as a miner with the coordinator (✅ Working)
- [x] `miner status` — Check miner status (✅ Working)
- [ ] `miner update-capabilities` — Update miner GPU capabilities (⚠️ 404 - endpoint not implemented)
---
@@ -200,13 +200,13 @@ This checklist provides a comprehensive reference for all AITBC CLI commands, or
- [x] `governance vote` — Cast a vote on a proposal
### **deploy** — Production Deployment and Scaling
- [ ] `deploy auto-scale` — Trigger auto-scaling evaluation for deployment
- [ ] `deploy create` — Create a new deployment configuration
- [x] `deploy auto-scale` — Trigger auto-scaling evaluation for deployment
- [x] `deploy create` — Create a new deployment configuration
- [x] `deploy list-deployments` — List all deployments (✅ Working - none found)
- [ ] `deploy monitor` — Monitor deployment performance in real-time
- [x] `deploy monitor` — Monitor deployment performance in real-time
- [x] `deploy overview` — Get overview of all deployments (✅ Working)
- [ ] `deploy scale` — Scale a deployment to target instance count
- [ ] `deploy start` — Deploy the application to production
- [x] `deploy scale` — Scale a deployment to target instance count
- [x] `deploy start` — Deploy the application to production
- [x] `deploy status` — Get comprehensive deployment status (✅ Help available)
### **exchange** — Bitcoin Exchange Operations
@@ -650,7 +650,7 @@ aitbc wallet multisig-create --help
1. **Agent Creation Bug**: `name 'agent_id' is not defined` in agent command
2. **Swarm Network Error**: nginx returning 405 for swarm operations
3. **Analytics Data Issues**: No prediction/summary data available
4. **Client API 404 Errors**: submit, history, blocks endpoints return 404
4. **Missing Miner API Endpoints**: Several miner endpoints not implemented (earnings, jobs, deregister, update-capabilities)
5. **Missing Test Cases**: Some advanced features need integration testing
### ✅ Issues Resolved
@@ -658,18 +658,22 @@ aitbc wallet multisig-create --help
- **Blockchain Blocks Command**: Fixed to use local node instead of coordinator API
- **Blockchain Block Command**: Fixed to use local node with hash/height lookup
- **Blockchain Genesis/Transactions**: Commands working properly
- **Client Commands**: All 12 commands tested with comprehensive help systems
- **Client Batch Submit**: Working functionality (jobs failed but command works)
- **Blockchain Info/Supply/Validators**: Fixed missing RPC endpoints in blockchain node
- **Client API 404 Errors**: Fixed API paths from /v1/* to /api/v1/* for submit, history, blocks
- **Client Commands**: All 12 commands tested and working with proper API integration
- **Client Batch Submit**: Working functionality (jobs submitted successfully)
- **Chain Management Commands**: All help systems working with comprehensive options
- **Exchange Commands**: Fixed API paths from /exchange/* to /api/v1/exchange/*
- **Miner API Path Issues**: Fixed miner commands to use /api/v1/miners/* endpoints
- **Blockchain Info/Supply/Validators**: Fixed 404 errors by using local node endpoints
### 📈 Overall Progress: **97% Complete**
### 📈 Overall Progress: **98% Complete**
- **Core Commands**: ✅ 100% tested and working (admin scenarios complete)
- **Blockchain**: ✅ 100% functional with sync
- **Marketplace**: ✅ 100% tested
- **AI & Agents**: 🔄 88% (bug in agent creation, other commands available)
- **System & Config**: ✅ 100% tested (admin scenarios complete)
- **Client Operations**: ✅ 100% working (API integration fixed)
- **Testing & Dev**: 🔄 85% (monitoring and analytics working)
---

13
docs/1_project/3_infrastructure.md
View File

@@ -85,11 +85,13 @@ Internet → aitbc.bubuit.net (HTTPS :443)
| Service | Port | Process | Python Version | Purpose | Status |
|---------|------|---------|----------------|---------|--------|
| Mock Coordinator | 8090 | python3 | 3.13.5+ | Development/testing API endpoint | systemd: aitbc-mock-coordinator.service |
| Coordinator API | 8000 | python3 | 3.13.5+ | Production coordinator API | systemd: aitbc-coordinator-api.service |
| Mock Coordinator | 8020 | python3 | 3.13.5+ | Development/testing API endpoint | systemd: aitbc-mock-coordinator.service |
| Blockchain Node | N/A | python3 | 3.13.5+ | Local blockchain node | systemd: aitbc-blockchain-node.service |
| Blockchain Node RPC | 8003 | python3 | 3.13.5+ | RPC API for blockchain | systemd: aitbc-blockchain-rpc.service |
| Local Development Tools | Varies | python3 | 3.13.5+ | CLI tools, scripts, testing | Manual/venv |
| **Note**: GPU Miner Client removed - no miner service needed on aitbc server
| **Note**: GPU Miner Client removed - no miner service needed on aitbc server |
| **Port Logic**: Production services use 8000-8019, Mock/Testing services use 8020+ |
### Systemd Services (Host)
@@ -97,9 +99,10 @@ All services are configured as systemd units but currently inactive:
```bash
# Service files location: /etc/systemd/system/
aitbc-blockchain-node.service # Blockchain node main process
aitbc-blockchain-rpc.service # RPC API on port 8003
aitbc-mock-coordinator.service # Mock coordinator on port 8090
aitbc-coordinator-api.service # Production coordinator API on port 8000
aitbc-blockchain-node.service # Blockchain node main process
aitbc-blockchain-rpc.service # RPC API on port 8003
aitbc-mock-coordinator.service # Mock coordinator on port 8020
# Note: aitbc-gpu-miner.service removed - no miner service needed
```