ef24a7b834
All checks were successful
Skills must be in skills/ (project root) for Hermes to load them via skill_view(). Previous move to docs/skills/ broke skill loading.
89 lines
2.7 KiB
Markdown
89 lines
2.7 KiB
Markdown
---
|
|
name: aitbc-basic-operations
|
|
description: Basic AITBC operations including CLI validation, wallet operations, blockchain status, service health checks, and system verification
|
|
category: operations
|
|
---
|
|
|
|
# AITBC Basic Operations Skill
|
|
|
|
## Trigger Conditions
|
|
Activate when user requests basic AITBC operations: CLI validation, wallet operations, blockchain status, service health checks, or system verification.
|
|
|
|
## Purpose
|
|
Test and validate AITBC basic CLI functionality, core blockchain operations, wallet operations, and service connectivity.
|
|
|
|
## Prerequisites
|
|
- AITBC CLI accessible at `/opt/aitbc/aitbc-cli`
|
|
- Python venv activated for CLI operations
|
|
- Services running on ports 8011 (coordinator), 8001 (exchange), 8006 (blockchain RPC)
|
|
- Working directory: `/opt/aitbc`
|
|
- Default test wallet: "genesis" with password from `/var/lib/aitbc/keystore/.genesis_password`
|
|
|
|
## Operations
|
|
|
|
### CLI Validation
|
|
```bash
|
|
# Check CLI version
|
|
./aitbc-cli --version
|
|
|
|
# Check CLI help
|
|
./aitbc-cli --help
|
|
```
|
|
|
|
### Wallet Operations
|
|
```bash
|
|
# List wallets
|
|
./aitbc-cli list
|
|
|
|
# Check wallet balance
|
|
./aitbc-cli balance --name genesis
|
|
|
|
# Create test wallet
|
|
./aitbc-cli create --name test-wallet --password "test123"
|
|
```
|
|
|
|
### Blockchain Operations
|
|
```bash
|
|
# Get blockchain info
|
|
./aitbc-cli chain
|
|
|
|
# Get network status
|
|
./aitbc-cli network
|
|
|
|
# Get analytics
|
|
./aitbc-cli analytics --type blocks --limit 10
|
|
```
|
|
|
|
### Service Health Checks
|
|
```bash
|
|
# Check coordinator API (port 8011)
|
|
curl http://localhost:8011/health
|
|
|
|
# Check exchange API (port 8001)
|
|
curl http://localhost:8001/health
|
|
|
|
# Check blockchain RPC (port 8006)
|
|
curl http://localhost:8006/health
|
|
```
|
|
|
|
## Common Pitfalls
|
|
|
|
1. **CLI Not Found:** Ensure `/opt/aitbc/aitbc-cli` exists and is executable
|
|
2. **Wallet Not Found:** Check wallet name spelling, verify keystore directory at `/var/lib/aitbc/keystore/`
|
|
3. **Service Unreachable:** Verify services are running: `systemctl status aitbc-*`
|
|
4. **Port Mismatch:** Coordinator API is on port 8011 (not 8000)
|
|
5. **Password Required:** Use password from `/var/lib/aitbc/keystore/.genesis_password` for genesis wallet
|
|
|
|
## Verification Checklist
|
|
- [ ] CLI responds to `--version` and `--help`
|
|
- [ ] Wallet list shows available wallets
|
|
- [ ] Balance check returns valid AIT amount
|
|
- [ ] Blockchain info shows current height and hash
|
|
- [ ] Network status shows peer connections
|
|
- [ ] All three services (coordinator, exchange, blockchain) return healthy status
|
|
|
|
## CLI Tool Preference
|
|
- **Primary CLI:** `/opt/aitbc/aitbc-cli` is the single CLI entry point
|
|
- **Module:** `cli/unified_cli.py` is a module within the CLI tool for marketplace and messaging operations
|
|
- **Note:** For marketplace operations, prefer `python3 cli/unified_cli.py` (verified working with 7 bugs fixed)
|