Files
aitbc/skills/aitbc-basic-operations.md
aitbc1 ef24a7b834
All checks were successful
Deploy to Testnet / deploy-testnet (push) Successful in 1m5s
Node Failover Simulation / failover-test (push) Successful in 15s
Multi-Node Stress Testing / stress-test (push) Successful in 7s
Cross-Node Transaction Testing / transaction-test (push) Successful in 6s
fix: move skills back to project root for Hermes loading
Skills must be in skills/ (project root) for Hermes to load them via skill_view().
Previous move to docs/skills/ broke skill loading.
2026-05-08 22:33:14 +02:00

2.7 KiB

name, description, category
name description category
aitbc-basic-operations Basic AITBC operations including CLI validation, wallet operations, blockchain status, service health checks, and system verification 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

# Check CLI version
./aitbc-cli --version

# Check CLI help
./aitbc-cli --help

Wallet Operations

# 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

# Get blockchain info
./aitbc-cli chain

# Get network status
./aitbc-cli network

# Get analytics
./aitbc-cli analytics --type blocks --limit 10

Service Health Checks

# 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)