dda703de10
✅ 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
170 lines
3.7 KiB
Markdown
170 lines
3.7 KiB
Markdown
# AITBC SDK
|
|
|
|
Python client SDK for interacting with AITBC coordinator services, blockchain nodes, and marketplace components.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
pip install aitbc-sdk
|
|
```
|
|
|
|
## Requirements
|
|
|
|
- **Python**: 3.13.5 or later
|
|
- **Dependencies**: httpx, pydantic, aitbc-crypto
|
|
|
|
## Compatibility & Stability
|
|
|
|
### Python Version Support
|
|
- **Minimum Version**: Python 3.13.5+
|
|
- **Recommended**: Python 3.13.5 or 3.14
|
|
- **Guarantee**: All APIs maintain backward compatibility within Python 3.13.5+
|
|
- **Security**: Cryptographic operations maintain security properties across versions
|
|
|
|
### API Stability
|
|
- **Major Version**: 0.x (pre-1.0, APIs may change with notice)
|
|
- **Deprecation Policy**: Deprecated features marked with warnings for 2+ releases
|
|
- **Breaking Changes**: Announced in release notes with migration guides
|
|
- **Semantic Versioning**: Follows semver.org specifications
|
|
|
|
## Quick Start
|
|
|
|
```python
|
|
import asyncio
|
|
from aitbc_sdk import AITBCClient
|
|
|
|
async def main():
|
|
# Initialize client
|
|
client = AITBCClient(base_url="https://aitbc.bubuit.net")
|
|
|
|
# Submit a job
|
|
job = await client.submit_job({
|
|
"service_type": "llm_inference",
|
|
"model": "llama3.2",
|
|
"prompt": "Hello, world!"
|
|
})
|
|
|
|
# Check job status
|
|
status = await client.get_job_status(job.id)
|
|
print(f"Job status: {status.status}")
|
|
|
|
# Get results when complete
|
|
if status.status == "completed":
|
|
result = await client.get_job_result(job.id)
|
|
print(f"Result: {result.output}")
|
|
|
|
if __name__ == "__main__":
|
|
asyncio.run(main())
|
|
```
|
|
|
|
## Features
|
|
|
|
- **Job Management**: Submit, monitor, and retrieve computation jobs
|
|
- **Receipt Verification**: Cryptographically verify job completion receipts
|
|
- **Marketplace Integration**: Browse and participate in GPU marketplace
|
|
- **Blockchain Integration**: Interact with AITBC blockchain for settlement
|
|
- **Zero-Knowledge Support**: Private computation with ZK proof verification
|
|
|
|
## API Reference
|
|
|
|
### Client Initialization
|
|
|
|
```python
|
|
from aitbc_sdk import AITBCClient
|
|
|
|
client = AITBCClient(
|
|
base_url="https://aitbc.bubuit.net",
|
|
api_key="your-api-key",
|
|
timeout=30
|
|
)
|
|
```
|
|
|
|
### Job Operations
|
|
|
|
```python
|
|
# Submit a job
|
|
job = await client.submit_job({
|
|
"service_type": "llm_inference",
|
|
"model": "llama3.2",
|
|
"parameters": {
|
|
"prompt": "Explain quantum computing",
|
|
"max_tokens": 500
|
|
}
|
|
})
|
|
|
|
# Get job status
|
|
status = await client.get_job_status(job.id)
|
|
|
|
# Get job result
|
|
result = await client.get_job_result(job.id)
|
|
|
|
# Cancel a job
|
|
await client.cancel_job(job.id)
|
|
```
|
|
|
|
### Receipt Operations
|
|
|
|
```python
|
|
# Get job receipts
|
|
receipts = await client.get_job_receipts(job.id)
|
|
|
|
# Verify receipt authenticity
|
|
is_valid = await client.verify_receipt(receipt)
|
|
```
|
|
|
|
### Marketplace Operations
|
|
|
|
```python
|
|
# List available services
|
|
services = await client.list_services()
|
|
|
|
# Get service details
|
|
service = await client.get_service(service_id)
|
|
|
|
# Place bid for computation
|
|
bid = await client.place_bid({
|
|
"service_id": service_id,
|
|
"max_price": 0.1,
|
|
"requirements": {
|
|
"gpu_memory": "8GB",
|
|
"compute_capability": "7.5"
|
|
}
|
|
})
|
|
```
|
|
|
|
## Configuration
|
|
|
|
The SDK can be configured via environment variables:
|
|
|
|
```bash
|
|
export AITBC_BASE_URL="https://aitbc.bubuit.net"
|
|
export AITBC_API_KEY="your-api-key"
|
|
export AITBC_TIMEOUT=30
|
|
```
|
|
|
|
## Development
|
|
|
|
Install in development mode:
|
|
|
|
```bash
|
|
git clone https://github.com/oib/AITBC.git
|
|
cd AITBC/packages/py/aitbc-sdk
|
|
pip install -e ".[dev]"
|
|
```
|
|
|
|
Run tests:
|
|
|
|
```bash
|
|
pytest
|
|
```
|
|
|
|
## License
|
|
|
|
MIT License - see LICENSE file for details.
|
|
|
|
## Support
|
|
|
|
- **Documentation**: https://aitbc.bubuit.net/docs/
|
|
- **Issues**: https://github.com/oib/AITBC/issues
|
|
- **Discussions**: https://github.com/oib/AITBC/discussions
|