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

feat: implement v0.2.0 release features - agent-first evolution

Browse Source 
✅ 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
This commit is contained in:
AITBC System
2026-03-18 20:17:23 +01:00
parent 175a3165d2
commit dda703de10
272 changed files with 5152 additions and 190 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
docs/beginner/04_miners/0_readme.md Normal file
View File

@@ -0,0 +1,20 @@
# Miner Documentation
Provide GPU resources to the AITBC network and earn tokens.
## Reading Order
| # | File | What you learn |
|---|------|----------------|
| 1 | [1_quick-start.md](./1_quick-start.md) | Get mining in 5 minutes |
| 2 | [2_registration.md](./2_registration.md) | Register GPU with the network |
| 3 | [3_job-management.md](./3_job-management.md) | Accept and complete jobs |
| 4 | [4_earnings.md](./4_earnings.md) | Track and withdraw earnings |
| 5 | [5_gpu-setup.md](./5_gpu-setup.md) | GPU drivers, CUDA, optimization |
| 6 | [6_monitoring.md](./6_monitoring.md) | Dashboards, alerts, health checks |
| 7 | [7_api-miner.md](./7_api-miner.md) | REST API endpoints for integration |
## Related
- [CLI Guide](../0_getting_started/3_cli.md) — Command-line reference
- [Client Docs](../2_clients/0_readme.md) — If you also want to submit jobs

86
docs/beginner/04_miners/1_quick-start.md Normal file
View File

@@ -0,0 +1,86 @@
# Miner Quick Start
**5 minutes** — Register your GPU and start earning AITBC tokens with the enhanced CLI.
## Prerequisites
- NVIDIA GPU with 16GB+ VRAM (V100, A100, RTX 3090+)
- Python 3.10+, CUDA drivers installed
- 50GB+ storage, stable internet
## 1. Install & Configure
```bash
pip install -e . # from monorepo root
aitbc config set coordinator_url http://localhost:8000
export AITBC_API_KEY=your-key
# Verify installation
aitbc --version
aitbc --debug
```
## 2. Register & Start
```bash
# Enhanced miner registration
aitbc miner register \
--name my-gpu \
--gpu v100 \
--count 1 \
--region us-west \
--price-per-hour 0.05
# Start accepting jobs
aitbc miner poll
```
## 3. Verify & Monitor
```bash
# Enhanced monitoring
aitbc miner status # GPU status + earnings
aitbc wallet balance # check token balance
aitbc monitor dashboard # real-time monitoring
```
## 4. Advanced Features
```bash
# GPU optimization
aitbc optimize enable --agent-id my-gpu-agent \
--mode performance \
--auto-tune
# Earnings tracking
aitbc miner earnings --period daily
aitbc miner earnings --period weekly
# Marketplace integration
aitbc marketplace offer create \
--miner-id my-gpu \
--gpu-model "RTX-4090" \
--gpu-memory "24GB" \
--price-per-hour "0.05" \
--models "gpt2,llama" \
--endpoint "http://localhost:11434"
```
## 5. Configuration Management
```bash
# Configuration profiles
aitbc config profiles create mining
aitbc config profiles set mining gpu_count 4
aitbc config profiles use mining
# Performance monitoring
aitbc monitor metrics --component gpu
aitbc monitor alerts --type gpu_temperature
```
## Next
- [2_registration.md](./2_registration.md) — Advanced registration options
- [3_job-management.md](./3_job-management.md) — Job acceptance and completion
- [5_gpu-setup.md](./5_gpu-setup.md) — GPU driver and CUDA setup

80
docs/beginner/04_miners/2_registration.md Normal file
View File

@@ -0,0 +1,80 @@
# Miner Registration
Register your miner with the AITBC network.
## Requirements
### Hardware Requirements
| Resource | Minimum | Recommended |
|----------|---------|-------------|
| GPU VRAM | 8GB | 16GB+ |
| RAM | 16GB | 32GB+ |
| Storage | 50GB | 100GB+ |
| Bandwidth | 10 Mbps | 100 Mbps |
### Supported GPUs
- NVIDIA V100 (16GB/32GB)
- NVIDIA A100 (40GB/80GB)
- NVIDIA RTX 3090 (24GB)
- NVIDIA RTX 4090 (24GB)
## Registration
### Basic Registration
```bash
aitbc miner register --name my-miner --gpu v100 --count 1
```
### Advanced Registration
```bash
aitbc miner register \
--name my-miner \
--gpu a100 \
--count 4 \
--location us-east \
--price 0.10 \
--max-concurrent 4
```
### Flags Reference
| Flag | Description |
|------|-------------|
| `--name` | Miner name |
| `--gpu` | GPU type (v100, a100, rtx3090, rtx4090) |
| `--count` | Number of GPUs |
| `--location` | Geographic location |
| `--price` | Price per GPU/hour in AITBC |
| `--max-concurrent` | Maximum concurrent jobs |
## Verification
```bash
aitbc miner status
```
Shows:
- Registration status
- GPU availability
- Current jobs
## Update Registration
```bash
aitbc miner update --price 0.12 --max-concurrent 8
```
## De-register
```bash
aitbc miner deregister --confirm
```
## Next
- [Job Management](./3_job-management.md) — Job management
- [Earnings](./4_earnings.md) — Earnings tracking
- [GPU Setup](./5_gpu-setup.md) — GPU configuration

96
docs/beginner/04_miners/3_job-management.md Normal file
View File

@@ -0,0 +1,96 @@
# Job Management
Accept and complete jobs on the AITBC network.
## Overview
Jobs are assigned to miners based on GPU availability, price, and reputation.
## Accept Jobs
### Manual Acceptance
```bash
aitbc miner jobs --available
aitbc miner accept --job-id <JOB_ID>
```
### Auto-Accept
```bash
aitbc miner auto-accept enable --max-concurrent 4
```
### Auto-Accept Settings
```bash
# Set GPU requirements
aitbc miner auto-accept --gpu v100 --gpu-count 1-4
# Set price range
aitbc miner auto-accept --min-price 0.08 --max-price 0.12
```
## Job States
| State | Description |
|-------|-------------|
| assigned | Job assigned, waiting to start |
| starting | Preparing environment |
| running | Executing job |
| uploading | Uploading results |
| completed | Job finished successfully |
| failed | Job error occurred |
## Monitor Jobs
### Check Status
```bash
aitbc miner job-status --job-id <JOB_ID>
```
### Watch Progress
```bash
aitbc miner watch --job-id <JOB_ID>
```
### List Active Jobs
```bash
aitbc miner jobs --active
```
## Complete Jobs
### Manual Completion
```bash
aitbc miner complete --job-id <JOB_ID>
```
### Upload Results
```bash
aitbc miner upload --job-id <JOB_ID> --path ./results
```
## Handle Failures
### Retry Job
```bash
aitbc miner retry --job-id <JOB_ID>
```
### Report Issue
```bash
aitbc miner report --job-id <JOB_ID> --reason "gpu-error"
```
## Next
- [Earnings](./4_earnings.md) — Earnings tracking
- [GPU Setup](./5_gpu-setup.md) — GPU configuration
- [Monitoring](./6_monitoring.md) - Monitor your miner

66
docs/beginner/04_miners/4_earnings.md Normal file
View File

@@ -0,0 +1,66 @@
# Earnings & Payouts
Track and manage your mining earnings.
## Earnings Overview
```bash
aitbc miner earnings
```
Shows:
- Total earned
- Pending balance
- Last payout
## Earnings Breakdown
| Source | Description |
|--------|-------------|
| job_completion | Payment for completed jobs |
| bonus | Performance bonuses |
| referral | Referral rewards |
## Payout Schedule
| Plan | Schedule | Minimum |
|------|----------|---------|
| Automatic | Daily | 10 AITBC |
| Manual | On request | 1 AITBC |
## Request Payout
```bash
aitbc wallet withdraw --amount 100 --address <WALLET_ADDRESS>
```
## Earnings History
```bash
aitbc miner earnings --history --days 30
```
## Performance Metrics
```bash
aitbc miner stats
```
Shows:
- Success rate
- Average completion time
- Total jobs completed
- Earnings per GPU/hour
## Tax Reporting
```bash
aitbc miner earnings --export --year 2026
```
Export for tax purposes.
## Next
- [Job Management](./3_job-management.md) — Job management
- [Monitoring](./6_monitoring.md) - Monitor your miner
- [GPU Setup](./5_gpu-setup.md) — GPU configuration

111
docs/beginner/04_miners/5_gpu-setup.md Normal file
View File

@@ -0,0 +1,111 @@
# GPU Setup & Configuration
Configure and optimize your GPU setup for mining.
## Prerequisites
### Driver Installation
```bash
# Ubuntu/Debian
sudo apt install nvidia-driver-535
# Verify installation
nvidia-smi
```
### CUDA Installation
```bash
# Download CUDA from NVIDIA
wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2204/x86_64/cuda-keyring_1.1-1_all.deb
sudo dpkg -i cuda-keyring_1.1-1_all.deb
sudo apt-get update
sudo apt-get install cuda-toolkit-12-3
```
## Configuration
### Miner Config
Create `~/.aitbc/miner.yaml`:
```yaml
gpu:
type: v100
count: 1
cuda_devices: 0
performance:
max_memory_percent: 90
max_gpu_temp: 80
power_limit: 250
jobs:
max_concurrent: 4
timeout_grace: 300
```
### Environment Variables
```bash
export CUDA_VISIBLE_DEVICES=0
export NVIDIA_VISIBLE_DEVICES=all
export AITBC_GPU_MEMORY_LIMIT=0.9
```
## Optimization
### Memory Settings
```yaml
performance:
tensor_cores: true
fp16: true # Use half precision
max_memory_percent: 90
```
### Thermal Management
```yaml
thermal:
target_temp: 70
max_temp: 85
fan_curve:
- temp: 50
fan: 30
- temp: 70
fan: 60
- temp: 85
fan: 100
```
## Troubleshooting
### GPU Not Detected
```bash
# Check driver
nvidia-smi
# Check CUDA
nvcc --version
# Restart miner
aitbc miner restart
```
### Temperature Issues
```bash
# Monitor temperature
nvidia-smi -l 1
# Check cooling
ipmitool sdr list | grep Temp
```
## Next
- [Quick Start](./1_quick-start.md) — Get started
- [Monitoring](./6_monitoring.md) - Monitor your miner
- [Job Management](./3_job-management.md) — Job management

110
docs/beginner/04_miners/6_monitoring.md Normal file
View File

@@ -0,0 +1,110 @@
# Monitoring & Alerts
Monitor your miner performance and set up alerts.
## Real-time Monitoring
### Dashboard
```bash
aitbc miner dashboard
```
Shows:
- GPU utilization
- Memory usage
- Temperature
- Active jobs
- Earnings rate
### CLI Stats
```bash
aitbc miner stats
```
### Prometheus Metrics
```bash
# Enable metrics endpoint
aitbc miner metrics --port 9090
```
Available at: http://localhost:9090/metrics
## Alert Configuration
### Set Alerts
```bash
# GPU temperature alert
aitbc miner alert --metric temp --threshold 85 --action notify
# Memory usage alert
aitbc miner alert --metric memory --threshold 90 --action throttle
# Job failure alert
aitbc miner alert --metric failures --threshold 3 --action pause
```
### Alert Types
| Type | Description |
|------|-------------|
| temp | GPU temperature |
| memory | GPU memory usage |
| utilization | GPU utilization |
| jobs | Job success/failure rate |
| earnings | Earnings below threshold |
### Alert Actions
| Action | Description |
|--------|-------------|
| notify | Send notification |
| throttle | Reduce job acceptance |
| pause | Stop accepting jobs |
| restart | Restart miner |
## Log Management
### View Logs
```bash
# Recent logs
aitbc miner logs --tail 100
# Filter by level
aitbc miner logs --level error
# Filter by job
aitbc miner logs --job-id <JOB_ID>
```
### Log Rotation
```bash
# Configure log rotation
aitbc miner logs --rotate --max-size 100MB --keep 5
```
## Health Checks
```bash
# Run health check
aitbc miner health
# Detailed health report
aitbc miner health --detailed
```
Shows:
- GPU health
- Driver status
- Network connectivity
- Storage availability
## Next
- [Quick Start](./1_quick-start.md) — Get started
- [GPU Setup](./5_gpu-setup.md) — GPU configuration
- [Job Management](./3_job-management.md) — Job management

141
docs/beginner/04_miners/7_api-miner.md Normal file
View File

@@ -0,0 +1,141 @@
# Miner API Reference
Complete API reference for miner operations.
## Endpoints
### Register Miner
```
POST /v1/miners
```
**Request Body:**
```json
{
"name": "my-miner",
"gpu_type": "v100",
"gpu_count": 1,
"location": "us-east",
"price_per_hour": 0.05,
"max_concurrent": 4
}
```
**Response:**
```json
{
"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:**
```json
{
"status": "ok",
"jobs_assigned": 0,
"queue_length": 5
}
```
### List Available Jobs
```
GET /v1/miners/{miner_id}/jobs/available
```
**Response:**
```json
{
"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:**
```json
{
"result_hash": "sha256:abc123...",
"metrics": {
"execution_time_seconds": 600,
"gpu_time_seconds": 600
}
}
```
### Get Miner Stats
```
GET /v1/miners/{miner_id}/stats
```
**Response:**
```json
{
"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
- [Quick Start](./1_quick-start.md) — Get started
- [Job Management](./3_job-management.md) — Job management
- [Monitoring](./6_monitoring.md) - Monitor your miner