refactor: split OpenClaw AITBC skill into focused modules
BREAKING CHANGE: Split monolithic skill into domain-specific modules New Skills Created: - openclaw-management.md: Pure OpenClaw agent operations, coordination, workflows - aitbc-blockchain.md: Pure AITBC blockchain operations, AI jobs, marketplace Legacy Changes: - openclaw-aitbc.md: Deprecated, now redirects to split skills - Added comprehensive migration guide and quick reference Benefits: - Clearer separation of concerns (agent vs blockchain operations) - Better documentation organization and maintainability - Improved reusability across different systems - Enhanced searchability and domain-specific troubleshooting - Modular combination possible for integrated workflows Migration: - All existing functionality preserved in split skills - Clear migration path with before/after examples - Legacy skill maintained for backward compatibility - Quick reference links to new focused skills Files: - New: openclaw-management.md (agent coordination focus) - New: aitbc-blockchain.md (blockchain operations focus) - Updated: openclaw-aitbc.md (legacy with migration guide) - Preserved: All supporting files in openclaw-aitbc/ directory
This commit is contained in:
490
.windsurf/skills/aitbc-blockchain.md
Normal file
490
.windsurf/skills/aitbc-blockchain.md
Normal file
@@ -0,0 +1,490 @@
|
||||
---
|
||||
description: Complete AITBC blockchain operations and integration
|
||||
title: AITBC Blockchain Operations Skill
|
||||
version: 1.0
|
||||
---
|
||||
|
||||
# AITBC Blockchain Operations Skill
|
||||
|
||||
This skill provides comprehensive AITBC blockchain operations including wallet management, transactions, AI operations, marketplace participation, and node coordination.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- AITBC multi-node blockchain operational (aitbc genesis, aitbc1 follower)
|
||||
- AITBC CLI accessible: `/opt/aitbc/aitbc-cli`
|
||||
- SSH access between nodes for cross-node operations
|
||||
- Systemd services: `aitbc-blockchain-node.service`, `aitbc-blockchain-rpc.service`
|
||||
- Poetry 2.3.3+ for Python package management
|
||||
- Wallet passwords known (default: 123 for new wallets)
|
||||
|
||||
## Critical: Correct CLI Syntax
|
||||
|
||||
### AITBC CLI Commands
|
||||
```bash
|
||||
# All commands run from /opt/aitbc with venv active
|
||||
cd /opt/aitbc && source venv/bin/activate
|
||||
|
||||
# Basic Operations
|
||||
./aitbc-cli create --name wallet-name # Create wallet
|
||||
./aitbc-cli list # List wallets
|
||||
./aitbc-cli balance --name wallet-name # Check balance
|
||||
./aitbc-cli send --from w1 --to addr --amount 100 --password pass
|
||||
./aitbc-cli chain # Blockchain info
|
||||
./aitbc-cli network # Network status
|
||||
./aitbc-cli analytics # Analytics data
|
||||
```
|
||||
|
||||
### Cross-Node Operations
|
||||
```bash
|
||||
# Always activate venv on remote nodes
|
||||
ssh aitbc1 'cd /opt/aitbc && source venv/bin/activate && ./aitbc-cli list'
|
||||
|
||||
# Cross-node transaction
|
||||
./aitbc-cli send --from genesis-ops --to ait141b3bae6eea3a74273ef3961861ee58e12b6d855 --amount 100 --password 123
|
||||
```
|
||||
|
||||
## Wallet Management
|
||||
|
||||
### Creating Wallets
|
||||
```bash
|
||||
# Create new wallet with password
|
||||
./aitbc-cli create --name my-wallet --password 123
|
||||
|
||||
# List all wallets
|
||||
./aitbc-cli list
|
||||
|
||||
# Check wallet balance
|
||||
./aitbc-cli balance --name my-wallet
|
||||
```
|
||||
|
||||
### Wallet Operations
|
||||
```bash
|
||||
# Send transaction
|
||||
./aitbc-cli send --from wallet1 --to wallet2 --amount 100 --password 123
|
||||
|
||||
# Check transaction history
|
||||
./aitbc-cli transactions --name my-wallet
|
||||
|
||||
# Import wallet from keystore
|
||||
./aitbc-cli import --keystore /path/to/keystore.json --password 123
|
||||
```
|
||||
|
||||
### Standard Wallet Addresses
|
||||
```bash
|
||||
# Genesis operations wallet
|
||||
./aitbc-cli balance --name genesis-ops
|
||||
# Address: ait158ec7a0713f30ccfb1aac6bfbab71f36271c5871
|
||||
|
||||
# Follower operations wallet
|
||||
./aitbc-cli balance --name follower-ops
|
||||
# Address: ait141b3bae6eea3a74273ef3961861ee58e12b6d855
|
||||
```
|
||||
|
||||
## Blockchain Operations
|
||||
|
||||
### Chain Information
|
||||
```bash
|
||||
# Get blockchain status
|
||||
./aitbc-cli chain
|
||||
|
||||
# Get network status
|
||||
./aitbc-cli network
|
||||
|
||||
# Get analytics data
|
||||
./aitbc-cli analytics
|
||||
|
||||
# Check block height
|
||||
curl -s http://localhost:8006/rpc/head | jq .height
|
||||
```
|
||||
|
||||
### Node Status
|
||||
```bash
|
||||
# Check health endpoint
|
||||
curl -s http://localhost:8006/health | jq .
|
||||
|
||||
# Check both nodes
|
||||
curl -s http://localhost:8006/health | jq .
|
||||
ssh aitbc1 'curl -s http://localhost:8006/health | jq .'
|
||||
|
||||
# Check services
|
||||
systemctl is-active aitbc-blockchain-node.service aitbc-blockchain-rpc.service
|
||||
ssh aitbc1 'systemctl is-active aitbc-blockchain-node.service aitbc-blockchain-rpc.service'
|
||||
```
|
||||
|
||||
### Synchronization Monitoring
|
||||
```bash
|
||||
# Check height difference
|
||||
GENESIS_HEIGHT=$(curl -s http://localhost:8006/rpc/head | jq .height)
|
||||
FOLLOWER_HEIGHT=$(ssh aitbc1 'curl -s http://localhost:8006/rpc/head | jq .height')
|
||||
echo "Height diff: $((FOLLOWER_HEIGHT - GENESIS_HEIGHT))"
|
||||
|
||||
# Comprehensive health check
|
||||
python3 /tmp/aitbc1_heartbeat.py
|
||||
```
|
||||
|
||||
## Agent Operations
|
||||
|
||||
### Creating Agents
|
||||
```bash
|
||||
# Create basic agent
|
||||
./aitbc-cli agent create --name agent-name --description "Agent description"
|
||||
|
||||
# Create agent with full verification
|
||||
./aitbc-cli agent create --name agent-name --description "Agent description" --verification full
|
||||
|
||||
# Create AI-specific agent
|
||||
./aitbc-cli agent create --name ai-agent --description "AI processing agent" --verification full
|
||||
```
|
||||
|
||||
### Managing Agents
|
||||
```bash
|
||||
# Execute agent
|
||||
./aitbc-cli agent execute --name agent-name --wallet wallet --priority high
|
||||
|
||||
# Check agent status
|
||||
./aitbc-cli agent status --name agent-name
|
||||
|
||||
# List all agents
|
||||
./aitbc-cli agent list
|
||||
```
|
||||
|
||||
## AI Operations
|
||||
|
||||
### AI Job Submission
|
||||
```bash
|
||||
# Inference job
|
||||
./aitbc-cli ai-submit --wallet genesis-ops --type inference --prompt "Generate image" --payment 100
|
||||
|
||||
# Training job
|
||||
./aitbc-cli ai-submit --wallet genesis-ops --type training --model "gpt-3.5" --dataset "data.json" --payment 500
|
||||
|
||||
# Multimodal job
|
||||
./aitbc-cli ai-submit --wallet genesis-ops --type multimodal --prompt "Analyze image" --image-path "/path/to/img.jpg" --payment 200
|
||||
```
|
||||
|
||||
### AI Job Types
|
||||
- **inference**: Image generation, text analysis, predictions
|
||||
- **training**: Model training on datasets
|
||||
- **processing**: Data transformation and analysis
|
||||
- **multimodal**: Combined text, image, audio processing
|
||||
|
||||
### AI Job Monitoring
|
||||
```bash
|
||||
# Check job status
|
||||
./aitbc-cli ai-status --job-id job_123
|
||||
|
||||
# Check job history
|
||||
./aitbc-cli ai-history --wallet genesis-ops --limit 10
|
||||
|
||||
# Estimate job cost
|
||||
./aitbc-cli ai-estimate --type inference --prompt-length 100 --resolution 512
|
||||
```
|
||||
|
||||
## Resource Management
|
||||
|
||||
### Resource Allocation
|
||||
```bash
|
||||
# Allocate GPU resources
|
||||
./aitbc-cli resource allocate --agent-id ai-agent --gpu 1 --memory 8192 --duration 3600
|
||||
|
||||
# Allocate CPU resources
|
||||
./aitbc-cli resource allocate --agent-id data-processor --cpu 4 --memory 4096 --duration 1800
|
||||
|
||||
# Check resource status
|
||||
./aitbc-cli resource status
|
||||
|
||||
# List allocated resources
|
||||
./aitbc-cli resource list
|
||||
```
|
||||
|
||||
### Resource Types
|
||||
- **gpu**: GPU units for AI inference
|
||||
- **cpu**: CPU cores for processing
|
||||
- **memory**: RAM in megabytes
|
||||
- **duration**: Reservation time in seconds
|
||||
|
||||
## Marketplace Operations
|
||||
|
||||
### Creating Services
|
||||
```bash
|
||||
# Create AI service
|
||||
./aitbc-cli marketplace --action create --name "AI Image Generation" --type ai-inference --price 50 --wallet genesis-ops --description "Generate high-quality images"
|
||||
|
||||
# Create training service
|
||||
./aitbc-cli marketplace --action create --name "Model Training" --type ai-training --price 200 --wallet genesis-ops --description "Train custom models"
|
||||
|
||||
# Create data processing service
|
||||
./aitbc-cli marketplace --action create --name "Data Analysis" --type ai-processing --price 75 --wallet genesis-ops --description "Analyze datasets"
|
||||
```
|
||||
|
||||
### Marketplace Interaction
|
||||
```bash
|
||||
# List available services
|
||||
./aitbc-cli marketplace --action list
|
||||
|
||||
# Search for services
|
||||
./aitbc-cli marketplace --action search --query "AI"
|
||||
|
||||
# Bid on service
|
||||
./aitbc-cli marketplace --action bid --service-id service_123 --amount 60 --wallet genesis-ops
|
||||
|
||||
# Execute purchased service
|
||||
./aitbc-cli marketplace --action execute --service-id service_123 --job-data "prompt:Generate landscape image"
|
||||
|
||||
# Check my listings
|
||||
./aitbc-cli marketplace --action my-listings --wallet genesis-ops
|
||||
```
|
||||
|
||||
## Mining Operations
|
||||
|
||||
### Mining Control
|
||||
```bash
|
||||
# Start mining
|
||||
./aitbc-cli mine-start --wallet genesis-ops
|
||||
|
||||
# Stop mining
|
||||
./aitbc-cli mine-stop
|
||||
|
||||
# Check mining status
|
||||
./aitbc-cli mine-status
|
||||
```
|
||||
|
||||
## Smart Contract Messaging
|
||||
|
||||
### Topic Management
|
||||
```bash
|
||||
# Create coordination topic
|
||||
curl -X POST http://localhost:8006/rpc/messaging/topics/create \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"agent_id": "agent", "agent_address": "address", "title": "Topic", "description": "Description", "tags": ["coordination"]}'
|
||||
|
||||
# List topics
|
||||
curl -s http://localhost:8006/rpc/messaging/topics
|
||||
|
||||
# Get topic messages
|
||||
curl -s http://localhost:8006/rpc/messaging/topics/topic_id/messages
|
||||
```
|
||||
|
||||
### Message Operations
|
||||
```bash
|
||||
# Post message to topic
|
||||
curl -X POST http://localhost:8006/rpc/messaging/messages/post \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"agent_id": "agent", "agent_address": "address", "topic_id": "topic_id", "content": "Message content"}'
|
||||
|
||||
# Vote on message
|
||||
curl -X POST http://localhost:8006/rpc/messaging/messages/message_id/vote \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"agent_id": "agent", "agent_address": "address", "vote_type": "upvote"}'
|
||||
|
||||
# Check agent reputation
|
||||
curl -s http://localhost:8006/rpc/messaging/agents/agent_id/reputation
|
||||
```
|
||||
|
||||
## Cross-Node Coordination
|
||||
|
||||
### Cross-Node Transactions
|
||||
```bash
|
||||
# Send from genesis to follower
|
||||
./aitbc-cli send --from genesis-ops --to ait141b3bae6eea3a74273ef3961861ee58e12b6d855 --amount 100 --password 123
|
||||
|
||||
# Send from follower to genesis
|
||||
ssh aitbc1 'cd /opt/aitbc && source venv/bin/activate && ./aitbc-cli send --from follower-ops --to ait158ec7a0713f30ccfb1aac6bfbab71f36271c5871 --amount 50 --password 123'
|
||||
```
|
||||
|
||||
### Cross-Node AI Operations
|
||||
```bash
|
||||
# Submit AI job to specific node
|
||||
./aitbc-cli ai-submit --wallet genesis-ops --type inference --prompt "Generate image" --target-node "aitbc1" --payment 100
|
||||
|
||||
# Distribute training across nodes
|
||||
./aitbc-cli ai-submit --wallet genesis-ops --type training --model "distributed-model" --nodes "aitbc,aitbc1" --payment 500
|
||||
```
|
||||
|
||||
## Configuration Management
|
||||
|
||||
### Environment Configuration
|
||||
```bash
|
||||
# Check current configuration
|
||||
cat /etc/aitbc/.env
|
||||
|
||||
# Key configuration parameters
|
||||
chain_id=ait-mainnet
|
||||
proposer_id=ait158ec7a0713f30ccfb1aac6bfbab71f36271c5871
|
||||
enable_block_production=true
|
||||
mempool_backend=database
|
||||
gossip_backend=redis
|
||||
gossip_broadcast_url=redis://10.1.223.40:6379
|
||||
```
|
||||
|
||||
### Service Management
|
||||
```bash
|
||||
# Restart services
|
||||
sudo systemctl restart aitbc-blockchain-node.service aitbc-blockchain-rpc.service
|
||||
|
||||
# Check service logs
|
||||
sudo journalctl -u aitbc-blockchain-node.service -f
|
||||
sudo journalctl -u aitbc-blockchain-rpc.service -f
|
||||
|
||||
# Cross-node service restart
|
||||
ssh aitbc1 'sudo systemctl restart aitbc-blockchain-node.service aitbc-blockchain-rpc.service'
|
||||
```
|
||||
|
||||
## Data Management
|
||||
|
||||
### Database Operations
|
||||
```bash
|
||||
# Check database files
|
||||
ls -la /var/lib/aitbc/data/ait-mainnet/
|
||||
|
||||
# Backup database
|
||||
sudo cp /var/lib/aitbc/data/ait-mainnet/chain.db /var/lib/aitbc/data/ait-mainnet/chain.db.backup.$(date +%s)
|
||||
|
||||
# Reset blockchain (genesis creation)
|
||||
sudo systemctl stop aitbc-blockchain-node.service aitbc-blockchain-rpc.service
|
||||
sudo mv /var/lib/aitbc/data/ait-mainnet/chain.db /var/lib/aitbc/data/ait-mainnet/chain.db.backup.$(date +%s)
|
||||
sudo systemctl start aitbc-blockchain-node.service aitbc-blockchain-rpc.service
|
||||
```
|
||||
|
||||
### Genesis Configuration
|
||||
```bash
|
||||
# Create genesis.json with allocations
|
||||
cat << 'EOF' | sudo tee /var/lib/aitbc/data/ait-mainnet/genesis.json
|
||||
{
|
||||
"allocations": [
|
||||
{
|
||||
"address": "ait158ec7a0713f30ccfb1aac6bfbab71f36271c5871",
|
||||
"balance": 1000000,
|
||||
"nonce": 0
|
||||
}
|
||||
],
|
||||
"authorities": [
|
||||
{
|
||||
"address": "ait158ec7a0713f30ccfb1aac6bfbab71f36271c5871",
|
||||
"weight": 1
|
||||
}
|
||||
]
|
||||
}
|
||||
EOF
|
||||
```
|
||||
|
||||
## Monitoring and Analytics
|
||||
|
||||
### Health Monitoring
|
||||
```bash
|
||||
# Comprehensive health check
|
||||
python3 /tmp/aitbc1_heartbeat.py
|
||||
|
||||
# Manual health checks
|
||||
curl -s http://localhost:8006/health | jq .
|
||||
ssh aitbc1 'curl -s http://localhost:8006/health | jq .'
|
||||
|
||||
# Check sync status
|
||||
./aitbc-cli chain
|
||||
./aitbc-cli network
|
||||
```
|
||||
|
||||
### Performance Metrics
|
||||
```bash
|
||||
# Check block production rate
|
||||
watch -n 10 './aitbc-cli chain | grep "Height:"'
|
||||
|
||||
# Monitor transaction throughput
|
||||
./aitbc-cli analytics
|
||||
|
||||
# Check resource utilization
|
||||
./aitbc-cli resource status
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Common Issues and Solutions
|
||||
|
||||
#### Transactions Not Mining
|
||||
```bash
|
||||
# Check proposer status
|
||||
curl -s http://localhost:8006/health | jq .proposer_id
|
||||
|
||||
# Check mempool status
|
||||
curl -s http://localhost:8006/rpc/mempool
|
||||
|
||||
# Verify mempool configuration
|
||||
grep mempool_backend /etc/aitbc/.env
|
||||
```
|
||||
|
||||
#### RPC Connection Issues
|
||||
```bash
|
||||
# Check RPC service
|
||||
systemctl status aitbc-blockchain-rpc.service
|
||||
|
||||
# Test RPC endpoint
|
||||
curl -s http://localhost:8006/health
|
||||
|
||||
# Check port availability
|
||||
netstat -tlnp | grep 8006
|
||||
```
|
||||
|
||||
#### Wallet Issues
|
||||
```bash
|
||||
# Check wallet exists
|
||||
./aitbc-cli list | grep wallet-name
|
||||
|
||||
# Test wallet password
|
||||
./aitbc-cli balance --name wallet-name --password 123
|
||||
|
||||
# Create new wallet if needed
|
||||
./aitbc-cli create --name new-wallet --password 123
|
||||
```
|
||||
|
||||
#### Sync Issues
|
||||
```bash
|
||||
# Check both nodes' heights
|
||||
curl -s http://localhost:8006/rpc/head | jq .height
|
||||
ssh aitbc1 'curl -s http://localhost:8006/rpc/head | jq .height'
|
||||
|
||||
# Check gossip connectivity
|
||||
grep gossip_broadcast_url /etc/aitbc/.env
|
||||
|
||||
# Restart services if needed
|
||||
sudo systemctl restart aitbc-blockchain-node.service
|
||||
```
|
||||
|
||||
## Standardized Paths
|
||||
|
||||
| Resource | Path |
|
||||
|---|---|
|
||||
| Blockchain data | `/var/lib/aitbc/data/ait-mainnet/` |
|
||||
| Keystore | `/var/lib/aitbc/keystore/` |
|
||||
| Environment config | `/etc/aitbc/.env` |
|
||||
| CLI tool | `/opt/aitbc/aitbc-cli` |
|
||||
| Scripts | `/opt/aitbc/scripts/` |
|
||||
| Logs | `/var/log/aitbc/` |
|
||||
| Services | `/etc/systemd/system/aitbc-*.service` |
|
||||
|
||||
## Best Practices
|
||||
|
||||
### Security
|
||||
- Use strong wallet passwords
|
||||
- Keep keystore files secure
|
||||
- Monitor transaction activity
|
||||
- Use proper authentication for RPC endpoints
|
||||
|
||||
### Performance
|
||||
- Monitor resource utilization
|
||||
- Optimize transaction batching
|
||||
- Use appropriate thinking levels for AI operations
|
||||
- Regular database maintenance
|
||||
|
||||
### Operations
|
||||
- Regular health checks
|
||||
- Backup critical data
|
||||
- Monitor cross-node synchronization
|
||||
- Keep documentation updated
|
||||
|
||||
### Development
|
||||
- Test on development network first
|
||||
- Use proper version control
|
||||
- Document all changes
|
||||
- Implement proper error handling
|
||||
|
||||
This AITBC Blockchain Operations skill provides comprehensive coverage of all blockchain operations, from basic wallet management to advanced AI operations and cross-node coordination.
|
||||
Reference in New Issue
Block a user