oib/aitbc

Files

oib 9b9c5beb23 ```

chore: enhance .gitignore and remove obsolete documentation files

- Reorganize .gitignore with categorized sections for better maintainability
- Add comprehensive ignore patterns for Python, Node.js, databases, logs, and build artifacts
- Add project-specific ignore rules for coordinator, explorer, and deployment files
- Remove outdated documentation: BITCOIN-WALLET-SETUP.md, LOCAL_ASSETS_SUMMARY.md, README-CONTAINER-DEPLOYMENT.md, README-DOMAIN-DEPLOYMENT.md
```

2026-01-24 14:44:51 +01:00

client

```

2026-01-24 14:44:51 +01:00

miner

```

2026-01-24 14:44:51 +01:00

client_get_result.py

```

2026-01-24 14:44:51 +01:00

client_send_job.py

```

2026-01-24 14:44:51 +01:00

enhanced_client.py

```

2026-01-24 14:44:51 +01:00

genesis_wallet.json

```

2026-01-24 14:44:51 +01:00

genesis.py

```

2026-01-24 14:44:51 +01:00

how_customer_gets_reply.py

```

2026-01-24 14:44:51 +01:00

quick_job.py

```

2026-01-24 14:44:51 +01:00

README.md

```

2026-01-24 14:44:51 +01:00

simple_job_flow.py

```

2026-01-24 14:44:51 +01:00

simulate.py

```

2026-01-24 14:44:51 +01:00

wallet.py

```

2026-01-24 14:44:51 +01:00

README.md

AITBC Local Simulation

Simulate client and GPU provider interactions with independent wallets and AITBC transactions.

Structure

home/
├── genesis.py          # Creates genesis block and distributes initial AITBC
├── client/            # Customer/client wallet
│   └── wallet.py      # Client wallet management
├── miner/             # GPU provider wallet
│   └── wallet.py      # Miner wallet management
└── simulate.py        # Complete workflow simulation

Quick Start

1. Initialize the Economy

cd /home/oib/windsurf/aitbc/home
python3 genesis.py

This creates:

Genesis wallet: 1,000,000 AITBC
Client wallet: 10,000 AITBC
Miner wallet: 1,000 AITBC

2. Check Wallets

# Client wallet
cd client && python3 wallet.py balance

# Miner wallet  
cd miner && python3 wallet.py balance

3. Run Complete Simulation

cd /home/oib/windsurf/aitbc/home
python3 simulate.py

Wallet Commands

Client Wallet

cd client

# Check balance
python3 wallet.py balance

# Show address
python3 wallet.py address

# Pay for services
python3 wallet.py send <amount> <address> <description>

# Transaction history
python3 wallet.py history

Miner Wallet

cd miner

# Check balance with stats
python3 wallet.py balance

# Add earnings from completed job
python3 wallet.py earn <amount> --job <job_id> --desc "Service description"

# Withdraw earnings
python3 wallet.py withdraw <amount> <address>

# Mining statistics
python3 wallet.py stats

Example Workflow

1. Client Submits Job

cd /home/oib/windsurf/aitbc/cli
python3 client.py submit inference --model llama-2-7b --prompt "What is AI?"

2. Miner Processes Job

# Miner polls and gets job
python3 miner.py poll

# Miner earns AITBC
cd /home/oib/windsurf/aitbc/home/miner
python3 wallet.py earn 50.0 --job abc123 --desc "Inference task"

3. Client Pays

cd /home/oib/windsurf/aitbc/home/client

# Get miner address
cd ../miner && python3 wallet.py address
# Returns: aitbc1721d5bf8c0005ded6704

# Send payment
cd ../client
python3 wallet.py send 50.0 aitbc1721d5bf8c0005ded6704 "Payment for inference"

Wallet Files

client/client_wallet.json - Client's wallet data
miner/miner_wallet.json - Miner's wallet data
genesis_wallet.json - Genesis wallet with remaining AITBC

Integration with CLI Tools

The home wallets integrate with the CLI tools:

Submit jobs using cli/client.py
Process jobs using cli/miner.py
Track payments using home/*/wallet.py

Tips

Each wallet has a unique address
All transactions are recorded with timestamps
Genesis wallet holds the remaining AITBC supply
Use simulate.py for a complete demo
Check wallet.py history to see all transactions