oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 21 Packages Projects Releases Wiki Activity
Files
b3b263cf700db04c0fc09238144ee84779359f01
aitbc/docs/aitbc-basic-operations.md
aitbc 9e59d0c912
Some checks failed
Cross-Node Transaction Testing / transaction-test (push) Successful in 5s
Details
Deploy to Testnet / deploy-testnet (push) Has been cancelled
Details
Documentation Validation / validate-docs (push) Has started running
Details
Documentation Validation / validate-policies-strict (push) Has been cancelled
Details
Node Failover Simulation / failover-test (push) Has been cancelled
Details
Multi-Node Stress Testing / stress-test (push) Has been cancelled
Details
docs: update coordinator API port references from 8000 to 8011 
- Update infrastructure/SYSTEMD_SERVICES.md: coordinator API port 8000 → 8011
- Update reference/PORT_MAPPING_GUIDE.md: coordinator API port 8000 → 8011
- Update guides/getting-started/2_installation.md: health check and troubleshooting port 8000 → 8011
- Update guides/getting-started/3_cli.md: coordinator API URL and health check port 8000 → 8011
- Coordinator API is now on port 8011 (not 8000)
- More documentation files still need updates
2026-05-08 21:41:56 +02:00

2.5 KiB
Raw Blame History

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)