bb5363bebc
- Remove standalone explorer-web app (README, HTML, package files) - Add /web endpoint to blockchain-explorer for web interface access - Update .gitignore to exclude application backup archives (*.tar.gz, *.zip) - Add backup documentation files to .gitignore (BACKUP_INDEX.md, README.md) - Consolidate explorer functionality into main blockchain-explorer application
149 lines
2.8 KiB
Markdown
149 lines
2.8 KiB
Markdown
# CLI Workarounds Guide
|
|
|
|
## Current Working CLI Features
|
|
|
|
### ✅ Working Features (60%)
|
|
|
|
#### 1. Basic CLI Commands
|
|
```bash
|
|
# Check CLI version
|
|
aitbc --version
|
|
|
|
# Get help
|
|
aitbc --help
|
|
|
|
# Show configuration
|
|
aitbc config-show
|
|
|
|
# Test environment
|
|
aitbc test environment
|
|
```
|
|
|
|
#### 2. Wallet Management
|
|
```bash
|
|
# List wallets
|
|
aitbc wallet list
|
|
|
|
# Get wallet help
|
|
aitbc wallet --help
|
|
|
|
# Create new wallet (may fail)
|
|
aitbc wallet create --name test_wallet
|
|
```
|
|
|
|
#### 3. Configuration Management
|
|
```bash
|
|
# Show current config
|
|
aitbc config-show
|
|
|
|
# Use custom config file
|
|
aitbc --config-file /path/to/config.yaml config-show
|
|
```
|
|
|
|
### ❌ Non-Working Features (40%)
|
|
|
|
#### 1. API Integration
|
|
```bash
|
|
# This will fail with 404 error
|
|
aitbc test api
|
|
|
|
# Workaround: Use curl directly
|
|
curl -s https://aitbc.bubuit.net/api/health
|
|
```
|
|
|
|
#### 2. Marketplace Operations
|
|
```bash
|
|
# These will fail with network errors
|
|
aitbc marketplace gpu list
|
|
aitbc marketplace offers list
|
|
|
|
# Workaround: Use curl directly
|
|
curl -s https://aitbc.bubuit.net/api/v1/marketplace/gpus
|
|
```
|
|
|
|
#### 3. Agent Operations
|
|
```bash
|
|
# This will fail with network errors
|
|
aitbc agent list
|
|
|
|
# Workaround: Use curl directly
|
|
curl -s https://aitbc.bubuit.net/api/v1/agent/workflows
|
|
```
|
|
|
|
#### 4. Blockchain Operations
|
|
```bash
|
|
# This will fail with connection refused
|
|
aitbc blockchain status
|
|
|
|
# Workaround: Use curl directly
|
|
curl -s https://aitbc.bubuit.net/rpc/head
|
|
```
|
|
|
|
## Development Workarounds
|
|
|
|
### Use Mock Server for Testing
|
|
```bash
|
|
# Start mock server
|
|
python3 /home/oib/windsurf/aitbc/cli-dev/mock-cli-server.py &
|
|
|
|
# Use staging config
|
|
aitbc --config-file /home/oib/windsurf/aitbc/cli-dev/cli-staging-config.yaml marketplace gpu list
|
|
|
|
# Stop mock server
|
|
kill %1
|
|
```
|
|
|
|
### Use External API Directly
|
|
```bash
|
|
# Test API health
|
|
curl -s https://aitbc.bubuit.net/api/health
|
|
|
|
# Test marketplace
|
|
curl -s https://aitbc.bubuit.net/api/v1/marketplace/gpus
|
|
|
|
# Test blockchain
|
|
curl -s https://aitbc.bubuit.net/rpc/head
|
|
```
|
|
|
|
## Production Usage Guidelines
|
|
|
|
### Safe CLI Operations
|
|
- Use wallet management commands
|
|
- Use configuration commands
|
|
- Use help commands
|
|
- Use environment tests
|
|
|
|
### Avoid These Commands
|
|
- API integration commands
|
|
- Marketplace commands
|
|
- Agent commands
|
|
- Blockchain commands
|
|
|
|
### Alternative Approaches
|
|
- Use external API directly with curl
|
|
- Use web interface for marketplace
|
|
- Use web interface for blockchain
|
|
- Use web interface for agents
|
|
|
|
## Testing Commands
|
|
|
|
### Test Working Features
|
|
```bash
|
|
cd /home/oib/windsurf/aitbc/cli-dev
|
|
./test-cli-functionality.sh
|
|
```
|
|
|
|
### Test with Mock Server
|
|
```bash
|
|
cd /home/oib/windsurf/aitbc/cli-dev
|
|
./test-cli-staging.sh
|
|
```
|
|
|
|
## Summary
|
|
|
|
- **60% of CLI features work perfectly**
|
|
- **40% need workarounds**
|
|
- **External API provides full functionality**
|
|
- **Mock server enables safe testing**
|
|
- **Production operations remain 100% functional**
|