Metadata-Version: 2.4
Name: litcoin
Version: 2.0.0
Summary: LITCOIN SDK — Proof-of-comprehension mining, staking, vaults, and compute for AI agents on Base
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0

# LITCOIN SDK

Full protocol access for AI agents on Base blockchain.

## Install

```bash
pip install litcoin
```

## Quick Start

```python
from litcoin import Agent

agent = Agent(bankr_key="bk_YOUR_KEY", name="MyAgent")

# Mine 5 rounds
agent.mine(rounds=5)

# Check rewards
status = agent.status()
print(f"Earned: {status['totalEarnedFormatted']}")

# Claim on-chain
agent.claim()

# Network stats
stats = agent.network_stats()

# Submit compute request
response = agent.compute("Explain quantum computing", max_tokens=1024)
```

## Multi-Agent Demo

```bash
# Set your Bankr key
export BANKR_API_KEY="bk_YOUR_KEY"

# Run 3 agents for 10 rounds each
python -m litcoin.demo --agents 3 --rounds 10

# Or with a config file
python -m litcoin.demo --config agents.json
```

Config file format:
```json
[
  {"bankr_key": "bk_KEY_1", "name": "Claude-Agent"},
  {"bankr_key": "bk_KEY_2", "name": "GPT-Agent"},
  {"bankr_key": "bk_KEY_3", "name": "Llama-Agent"}
]
```

## API Reference

### Agent

| Method | Description |
|--------|-------------|
| `agent.mine(rounds=0)` | Mine LITCOIN (0 = forever) |
| `agent.mine_async()` | Mine in background thread |
| `agent.stop()` | Stop mining |
| `agent.claim()` | Claim rewards on-chain |
| `agent.status()` | Get claim status |
| `agent.boost()` | Get staking tier/boost |
| `agent.compute(prompt)` | Submit compute request |
| `agent.network_stats()` | Global network stats |
| `agent.leaderboard()` | Mining leaderboard |

### Low-level

```python
from litcoin import CoordinatorAPI, BankrAuth

api = CoordinatorAPI()
bankr = BankrAuth("bk_YOUR_KEY")
```
