aitbc/.windsurf/workflows/test-basic.md

description, title, version

description	title	version
Basic CLI functionality and core operations testing module	Basic Testing Module - CLI and Core Operations	1.0

Basic Testing Module - CLI and Core Operations

This module covers basic CLI functionality testing, core blockchain operations, wallet operations, and service connectivity validation.

Prerequisites

Required Setup

• Working directory: /opt/aitbc
• Virtual environment: /opt/aitbc/venv
• CLI wrapper: /opt/aitbc/aitbc-cli
• Services running on correct ports (8000, 8001, 8006)

Environment Setup

cd /opt/aitbc
source venv/bin/activate
./aitbc-cli --version

1. CLI Command Testing

Basic CLI Commands

# Test CLI version and help
./aitbc-cli --version
./aitbc-cli --help

# Test core commands
./aitbc-cli create --name test-wallet --password test123
./aitbc-cli list
./aitbc-cli balance --wallet test-wallet

# Test blockchain operations
./aitbc-cli chain
./aitbc-cli network

Expected Results

• CLI version should display without errors
• Help should show all available commands
• Wallet operations should complete successfully
• Blockchain operations should return current status

Troubleshooting CLI Issues

# Check CLI installation
which aitbc-cli
ls -la /opt/aitbc/aitbc-cli

# Check virtual environment
source venv/bin/activate
python --version
pip list | grep aitbc

# Fix CLI issues
cd /opt/aitbc/cli
source venv/bin/activate
pip install -e .

2. Service Connectivity Testing

Check Service Status

# Test Coordinator API (port 8000)
curl -sf http://localhost:8000/health || echo "Coordinator API not responding"

# Test Exchange API (port 8001)
curl -sf http://localhost:8001/health || echo "Exchange API not responding"

# Test Blockchain RPC (port 8006)
curl -sf http://localhost:8006/rpc/health || echo "Blockchain RPC not responding"

# Test Ollama (port 11434)
curl -sf http://localhost:11434/api/tags || echo "Ollama not responding"

Service Restart Commands

# Restart services if needed
sudo systemctl restart aitbc-coordinator
sudo systemctl restart aitbc-exchange  
sudo systemctl restart aitbc-blockchain
sudo systemctl restart aitbc-ollama

# Check service status
sudo systemctl status aitbc-coordinator
sudo systemctl status aitbc-exchange
sudo systemctl status aitbc-blockchain
sudo systemctl status aitbc-ollama

3. Wallet Operations Testing

Create and Test Wallets

# Create test wallet
./aitbc-cli create --name basic-test --password test123

# List wallets
./aitbc-cli list

# Check balance
./aitbc-cli balance --wallet basic-test

# Send test transaction (if funds available)
./aitbc-cli send --from basic-test --to $(./aitbc-cli list | jq -r '.[0].address') --amount 1 --fee 10 --password test123

Wallet Validation

# Verify wallet files exist
ls -la /var/lib/aitbc/keystore/

# Check wallet permissions
ls -la /var/lib/aitbc/keystore/basic-test*

# Test wallet encryption
./aitbc-cli balance --wallet basic-test --password wrong-password 2>/dev/null && echo "ERROR: Wrong password accepted" || echo "✅ Password validation working"

4. Blockchain Operations Testing

Basic Blockchain Tests

# Get blockchain info
./aitbc-cli chain

# Get network status
./aitbc-cli network

# Test transaction submission
./aitbc-cli send --from genesis-ops --to $(./aitbc-cli list | jq -r '.[0].address') --amount 0.1 --fee 1 --password 123

# Check transaction status
./aitbc-cli transactions --wallet genesis-ops --limit 5

Blockchain Validation

# Check blockchain height
HEIGHT=$(./aitbc-cli chain | jq -r '.height // 0')
echo "Current height: $HEIGHT"

# Verify network connectivity
NODES=$(./aitbc-cli network | jq -r '.active_nodes // 0')
echo "Active nodes: $NODES"

# Check consensus status
CONSENSUS=$(./aitbc-cli chain | jq -r '.consensus // "unknown"')
echo "Consensus: $CONSENSUS"

5. Resource Management Testing

Basic Resource Operations

# Check resource status
./aitbc-cli resource status

# Test resource allocation
./aitbc-cli resource allocate --agent-id test-agent --cpu 1 --memory 1024 --duration 1800

# Monitor resource usage
./aitbc-cli resource status

Resource Validation

# Check system resources
free -h
df -h
nvidia-smi 2>/dev/null || echo "NVIDIA GPU not available"

# Check process resources
ps aux | grep aitbc

6. Analytics Testing

Basic Analytics Operations

# Test analytics commands
./aitbc-cli analytics --action summary
./aitbc-cli analytics --action performance
./aitbc-cli analytics --action network-stats

Analytics Validation

# Check analytics data
./aitbc-cli analytics --action summary | jq .
./aitbc-cli analytics --action performance | jq .

7. Mining Operations Testing

Basic Mining Tests

# Check mining status
./aitbc-cli mine-status

# Start mining (if not running)
./aitbc-cli mine-start

# Stop mining
./aitbc-cli mine-stop

Mining Validation

# Check mining process
ps aux | grep miner

# Check mining rewards
./aitbc-cli balance --wallet genesis-ops

8. Test Automation Script

Automated Basic Tests

#!/bin/bash
# automated_basic_tests.sh

echo "=== Basic AITBC Tests ==="

# Test CLI
echo "Testing CLI..."
./aitbc-cli --version || exit 1
./aitbc-cli --help | grep -q "create" || exit 1

# Test Services
echo "Testing Services..."
curl -sf http://localhost:8000/health || exit 1
curl -sf http://localhost:8001/health || exit 1
curl -sf http://localhost:8006/rpc/health || exit 1

# Test Blockchain
echo "Testing Blockchain..."
./aitbc-cli chain | jq -r '.height' || exit 1

# Test Resources
echo "Testing Resources..."
./aitbc-cli resource status | jq -r '.cpu_utilization' || exit 1

echo "✅ All basic tests passed!"

9. Troubleshooting Guide

Common Issues and Solutions

CLI Not Found

# Problem: aitbc-cli command not found
# Solution: Check installation and PATH
which aitbc-cli
export PATH="/opt/aitbc:$PATH"

Service Not Responding

# Problem: Service not responding on port
# Solution: Check service status and restart
sudo systemctl status aitbc-coordinator
sudo systemctl restart aitbc-coordinator

Wallet Issues

# Problem: Wallet operations failing
# Solution: Check keystore permissions
sudo chown -R aitbc:aitbc /var/lib/aitbc/keystore/
sudo chmod 700 /var/lib/aitbc/keystore/

Blockchain Sync Issues

# Problem: Blockchain not syncing
# Solution: Check network connectivity
./aitbc-cli network
sudo systemctl restart aitbc-blockchain

10. Success Criteria

Pass/Fail Criteria

• ✅ CLI commands execute without errors
• ✅ All services respond to health checks
• ✅ Wallet operations complete successfully
• ✅ Blockchain operations return valid data
• ✅ Resource allocation works correctly
• ✅ Analytics data is accessible
• ✅ Mining operations can be controlled

Performance Benchmarks

• CLI response time: <2 seconds
• Service health check: <1 second
• Wallet creation: <5 seconds
• Transaction submission: <3 seconds
• Resource status: <1 second

---

Dependencies: None (base module)
Next Module: OpenClaw Agent Testing or AI Operations Testing