oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 6 Packages Projects Releases Wiki Activity
Files
55ced779280df07146a55cb316181562eceebd41
aitbc/docs/reference/components/miner.md
oib 55ced77928 ``` 
chore: remove obsolete files and add Solidity build artifacts to .gitignore

- Add ignore patterns for Solidity build artifacts (typechain-types, artifacts, cache)
- Remove unused exchange mock API server (api/exchange_mock_api.py)
- Remove obsolete client-web README placeholder
- Remove deprecated marketplace-ui HTML implementation
```
2026-01-24 15:46:23 +01:00

2.1 KiB
Raw Blame History

Miner (Host Ops) – Task Breakdown

Status (2025-12-22)

  • Stage 1: ✅ IMPLEMENTED - Infrastructure scripts and runtime behavior validated through apps/miner-node/ control loop; host installer/systemd automation implemented.

Stage 1 (MVP) - COMPLETED

  • Installer & Scripts

    • ✅ Finalize /root/scripts/aitbc-miner/install_miner.sh to install dependencies, create venv, deploy systemd unit.
    • ✅ Implement /root/scripts/aitbc-miner/miner.sh main loop (poll, run job, submit proof) as per bootstrap spec.
    • ✅ Ensure scripts detect GPU availability and switch between CUDA/CPU modes.

  • Configuration

    • ✅ Define /etc/aitbc/miner.conf with environment-style keys (COORD_URL, WALLET_ADDR, API_KEY, MINER_ID, WORK_DIR, intervals).
    • ✅ Document configuration editing steps and permission requirements.

  • Systemd & Logging

    • ✅ Install aitbc-miner.service unit with restart policy, log path, and hardening flags.
    • ✅ Provide optional logrotate config under configs/systemd/ or configs/security/.

  • Mock Coordinator Integration

    • ✅ Supply FastAPI mock coordinator (mock_coordinator.py) for local smoke testing.
    • ✅ Document curl or httpie commands to validate miner registration and proof submission.

  • Documentation

    • ✅ Update apps/miner-node/README.md (ops section) and create runbooks under docs/runbooks/ once available.
    • ✅ Add troubleshooting steps (GPU check, heartbeat failures, log locations).

Implementation Status

  • Location: /root/scripts/aitbc-miner/ and apps/miner-node/
  • Features: Installer scripts, systemd service, configuration management
  • Runtime: Poll, execute jobs, submit proofs with GPU/CPU detection
  • Integration: Mock coordinator for local testing
  • Deployment: Ready for host deployment with systemd automation

Stage 2+ - IN PROGRESS

  • 🔄 Harden systemd service with ProtectSystem, ProtectHome, NoNewPrivileges and consider non-root user.
  • 🔄 Add metrics integration (Prometheus exporters, GPU telemetry).
  • 🔄 Automate zero-downtime updates with rolling restart instructions.