oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 6 Packages Projects Releases Wiki Activity
Files
a477681c4b3a29c93207a8fe72f4093e8cdaf2b1
aitbc/apps/coordinator-api
History
oib a477681c4b feat(developer-ecosystem): implement bounty and staking system with ZK-proof integration 
Phase 1 Implementation Complete:
- AgentBounty.sol: Automated bounty board with ZK-proof verification
- AgentStaking.sol: Reputation-based yield farming with dynamic APY
- BountyIntegration.sol: Cross-contract event handling and auto-verification
- Database models: Complete bounty, staking, and ecosystem metrics schemas
- REST APIs: Full bounty and staking management endpoints
- Services: Business logic for bounty creation, verification, and staking operations
- Ecosystem dashboard: Analytics and metrics tracking system

Key Features:
- Multi-tier bounty system (Bronze, Silver, Gold, Platinum)
- Performance-based APY calculation with reputation multipliers
- ZK-proof integration with PerformanceVerifier.sol
- Automatic bounty completion detection
- Comprehensive analytics dashboard
- Risk assessment and leaderboards
- Real-time metrics and predictions

Security Features:
- Reentrancy protection on all contracts
- Role-based access control
- Dispute resolution mechanism
- Early unbonding penalties
- Platform fee collection

Economic Model:
- Creation fees: 0.5%
- Success fees: 2%
- Platform fees: 1%
- Staking APY: 5-20% based on performance
- Dispute fees: 0.1%
2026-02-27 17:51:23 +01:00
..
aitbc
feat: add transaction hash search to blockchain explorer and cleanup settlement storage
2026-02-17 14:34:12 +01:00
alembic/versions
feat: add marketplace metrics, privacy features, and service registry endpoints
2025-12-22 10:33:23 +01:00
migrations
```
2026-01-29 12:28:43 +01:00
scripts
Update Python version requirements and fix compatibility issues
2026-02-24 18:41:08 +01:00
src/app
feat(developer-ecosystem): implement bounty and staking system with ZK-proof integration
2026-02-27 17:51:23 +01:00
systemd
Update database paths and fix foreign key references across coordinator API
2026-02-26 19:32:06 +01:00
tests
Update database paths and fix foreign key references across coordinator API
2026-02-26 19:32:06 +01:00
.env.example
refactor(coordinator): standardize database path to follow blockchain-node pattern
2026-02-27 17:32:00 +01:00
check_services.sh
Update Python version requirements and fix compatibility issues
2026-02-24 18:41:08 +01:00
demo_client_miner_workflow.py
Update Python version requirements and fix compatibility issues
2026-02-24 18:41:08 +01:00
deploy_services.sh
Update Python version requirements and fix compatibility issues
2026-02-24 18:41:08 +01:00
manage_services.sh
Update Python version requirements and fix compatibility issues
2026-02-24 18:41:08 +01:00
pyproject.toml
Update Python version requirements and fix compatibility issues
2026-02-24 18:41:08 +01:00
QUICK_WINS_SUMMARY.md
Update Python version requirements and fix compatibility issues
2026-02-24 18:41:08 +01:00
README.md
Based on the repository's commit message style and the changes in the diff, here's an appropriate commit message:
2025-12-22 07:55:09 +01:00
requirements.txt
Update Python version requirements and fix compatibility issues
2026-02-24 18:41:08 +01:00
test_client_miner.py
Update Python version requirements and fix compatibility issues
2026-02-24 18:41:08 +01:00
test_health_endpoints.py
Update Python version requirements and fix compatibility issues
2026-02-24 18:41:08 +01:00

README.md

Coordinator API

Purpose & Scope

FastAPI service that accepts client compute jobs, matches miners, and tracks job lifecycle for the AITBC network.

Marketplace Extensions

Stage 2 introduces public marketplace endpoints exposed under /v1/marketplace:

  • GET /v1/marketplace/offers – list available provider offers (filterable by status).
  • GET /v1/marketplace/stats – aggregated supply/demand metrics surfaced in the marketplace web dashboard.
  • POST /v1/marketplace/bids – accept bid submissions for matching (mock-friendly; returns 202 Accepted).

These endpoints serve the apps/marketplace-web/ dashboard via VITE_MARKETPLACE_DATA_MODE=live.

Explorer Endpoints

The coordinator now exposes read-only explorer data under /v1/explorer for apps/explorer-web/ live mode:

  • GET /v1/explorer/blocks – block summaries derived from recent job activity.
  • GET /v1/explorer/transactions – transaction-like records for coordinator jobs.
  • GET /v1/explorer/addresses – aggregated address activity and balances.
  • GET /v1/explorer/receipts – latest job receipts (filterable by job_id).

Set VITE_DATA_MODE=live and VITE_COORDINATOR_API in the explorer web app to consume these APIs.

Development Setup

  1. Create a virtual environment in apps/coordinator-api/.venv.
  2. Install dependencies listed in pyproject.toml once added.
  3. Run the FastAPI app via uvicorn app.main:app --reload.

Configuration

Expects environment variables defined in .env (see docs/bootstrap/coordinator_api.md).

Signed receipts (optional)

  • Generate an Ed25519 key: 
    python - <<'PY'
from nacl.signing import SigningKey
sk = SigningKey.generate()
print(sk.encode().hex())
PY
  • Set RECEIPT_SIGNING_KEY_HEX in the .env file to the printed hex string to enable signed receipts returned by /v1/miners/{job_id}/result and retrievable via /v1/jobs/{job_id}/receipt.
  • Receipt history is available at /v1/jobs/{job_id}/receipts (requires client API key) and returns all stored signed payloads.
  • To enable coordinator attestations, set RECEIPT_ATTESTATION_KEY_HEX to a separate Ed25519 private key; responses include an attestations array alongside the miner signature.
  • Clients can verify signature objects using the aitbc_crypto package (see protocols/receipts/spec.md).

Systemd

Service name: aitbc-coordinator-api (to be defined under configs/systemd/).