aitbc/docs/skills/aitbc-marketplace.md

name, description, category

name	description	category
aitbc-marketplace	Marketplace operations including listing creation, price optimization, market analysis, trading operations, GPU provider registration, and marketplace status checks	marketplace

AITBC Marketplace Skill

Trigger Conditions

Activate when user requests marketplace operations: listing creation, price optimization, market analysis, trading operations, GPU provider registration, or marketplace status checks.

Purpose

Create, manage, and optimize AITBC marketplace listings with pricing strategies and competitive analysis.

Prerequisites

• AITBC CLI accessible at /opt/aitbc/aitbc-cli
• Wallet with sufficient balance for listing fees
• Marketplace service operational
• GPU provider marketplace operational for resource allocation (if using GPU features)

Operations

List Marketplace Items

# Via aitbc-cli
./aitbc-cli marketplace --action list --rpc-url http://localhost:8006

# Alternative command
./aitbc-cli market-list --rpc-url http://localhost:8006

Create Marketplace Listing

# Via aitbc-cli
./aitbc-cli marketplace \
  --action create \
  --name <item_name> \
  --price <price> \
  --description <description> \
  --wallet <wallet_name> \
  --rpc-url http://localhost:8006

# Alternative command
./aitbc-cli market-create \
  --wallet <wallet_name> \
  --type <service_type> \
  --price <price> \
  --description <description> \
  --password <password> \
  --rpc-url http://localhost:8006

Search Marketplace

./aitbc-cli marketplace --action search --name <search_term> --rpc-url http://localhost:8006

List My Listings

./aitbc-cli marketplace --action my-listings --wallet <wallet_name> --rpc-url http://localhost:8006

GPU Provider Registration

# Register as GPU provider
python3 cli/unified_cli.py market gpu-provider-register \
  --wallet <wallet_name> \
  --gpu-model <model_name> \
  --gpu-count <number> \
  --models <comma_separated_models> \
  --marketplace-url http://aitbc1:8102

Buy/Create Bid

python3 cli/unified_cli.py market buy \
  --item <offer_id> \
  --wallet <wallet_name> \
  --password "$(cat /var/lib/aitbc/keystore/.genesis_password)" \
  --marketplace-url http://aitbc1:8102

List Bids/Orders

python3 cli/unified_cli.py market orders \
  --wallet <wallet_name> \
  --marketplace-url http://aitbc1:8102

Common Pitfalls

1. Insufficient Balance: Check wallet balance before creating listings
2. Invalid Service Type: Ensure service type is valid (ai-inference, ai-training, resource-compute, resource-storage, data-processing, gpu-provider)
3. Marketplace URL: Use correct marketplace URL (http://aitbc1:8102 for unified_cli.py)
4. Password Required: Use password from /var/lib/aitbc/keystore/.genesis_password for genesis wallet
5. Listing Not Found: Verify listing ID is correct when searching or bidding

Verification Checklist

• Marketplace list returns available items
• Listing creation returns valid listing ID
• My listings shows created listings
• Search returns matching items
• GPU provider registration returns provider ID
• Bid creation returns bid ID and 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)
• Marketplace URL: http://aitbc1:8102 for unified_cli.py marketplace operations