---
name: litcoin-miner
description: "Mine LITCOIN — a proof-of-comprehension and proof-of-research cryptocurrency on Base. Use when the user wants to mine crypto with AI, earn tokens through reading comprehension or solving optimization problems, stake LITCOIN, open vaults, mint LITCREDIT (compute-pegged stablecoin), manage mining guilds, run autonomous research experiments, deploy agents, or interact with the LITCOIN DeFi protocol. Also use when the user asks about proof-of-comprehension mining, proof-of-research, AI agent DeFi, or compute-pegged stablecoins."
---

# LITCOIN Miner Skill

Mine $LITCOIN by solving reading comprehension challenges OR real optimization problems on Base. Full DeFi protocol access: mine, research, claim, stake, vault, mint LITCREDIT, compute, guilds, launchpad.

## Install the SDK

```bash
pip install litcoin
```

## Quick Start — Comprehension Mining

```python
from litcoin import Agent

agent = Agent(
    bankr_key="bk_YOUR_KEY",        # Required — get at bankr.bot/api
    ai_key="sk-YOUR_KEY",           # Optional — enables relay + research mining
    ai_url="https://api.venice.ai/api/v1",
    model="llama-3.3-70b",
)

# Mine (relay auto-starts if ai_key set)
agent.mine(rounds=10)

# Claim rewards on-chain
agent.claim()
```

## Quick Start — Research Mining

```python
# Single research cycle — solve a real optimization problem
result = agent.research_mine(task_type="code_optimization")

# Iterate on one task (Karpathy-style — this is where breakthroughs happen)
agent.research_loop(task_id="sort-benchmark-001", rounds=50, delay=30)

# View your iteration history
history = agent.research_history(task_id="sort-benchmark-001")

# List available tasks
tasks = agent.research_tasks()
```

Research mining requires `ai_key` — the LLM generates experiment code, tests locally, submits if it beats the baseline. The coordinator verifies every submission by re-running the code.

The user needs a Bankr API key from https://bankr.bot/api and some ETH on Base for gas. New wallets with zero balance can use the faucet: `agent.faucet()` gives 5M LITCOIN free (one-time).

## What This Skill Covers

When the user asks to mine LITCOIN, walk them through setup:

1. **Install**: `pip install litcoin`
2. **Get keys**: Bankr API key from bankr.bot/api. AI provider key (Venice, OpenAI, Groq) for relay + research mining.
3. **Run**: Create an Agent and call `agent.mine()` for comprehension or `agent.research_loop()` for research
4. **Claim**: Call `agent.claim()` to get tokens on-chain

## Full Protocol Methods

### Mining & Relay
- `agent.mine(rounds=0)` — Comprehension mine forever (0) or N rounds
- `agent.claim()` — Claim rewards on-chain
- `agent.status()` — Check earnings
- `agent.faucet()` — Bootstrap 5M LITCOIN (one-time)

### Research Mining (Proof-of-Research)
- `agent.research_mine(task_type=None, task_id=None)` — Single research cycle
- `agent.research_loop(task_type=None, task_id=None, rounds=10, delay=30)` — Iterate on one task
- `agent.research_tasks(task_type=None)` — List available research tasks
- `agent.research_leaderboard(task_id=None)` — Top researchers by reward
- `agent.research_stats()` — Global research statistics
- `agent.research_history(task_id=None)` — Your iteration history per task

Task types: code_optimization, algorithm, ml_training, prompt_engineering, data_science

### Staking (4 tiers: Spark/Circuit/Core/Architect)
- `agent.stake(tier)` — Stake into tier 1-4 (auto-approves tokens)
- `agent.unstake()` — Unstake after lock expires
- `agent.upgrade_tier(new_tier)` — Upgrade to higher tier
- `agent.stake_info()` — Current tier, amount, lock status

### Vaults (MakerDAO-style CDPs)
- `agent.open_vault(collateral)` — Open vault with LITCOIN collateral
- `agent.mint_litcredit(vault_id, amount)` — Mint LITCREDIT stablecoin
- `agent.repay_debt(vault_id, amount)` — Repay debt
- `agent.add_collateral(vault_id, amount)` — Add more collateral
- `agent.withdraw_collateral(vault_id, amount)` — Withdraw collateral
- `agent.close_vault(vault_id)` — Close vault
- `agent.vault_ids()` — List your vaults
- `agent.vault_health(vault_id)` — Check collateral ratio

### Compute Marketplace
- `agent.deposit_escrow(amount)` — Deposit LITCREDIT for AI compute
- `agent.compute(prompt)` — Use AI inference via relay network

### Use as AI Provider (OpenAI-Compatible)
LITCOIN relays work as a drop-in OpenAI replacement. Base URL: `https://api.litcoiin.xyz/v1`
- `POST /v1/chat/completions` — Standard chat format (streaming, tools, multi-turn)
- `GET /v1/models` — Available models from online relays
- Auth: API key (`lk_`), wallet + LITCREDIT, or free tier (5 req/hr)
- Provider selection: pass `"provider": "0xabc..."` to target a specific relay
- Works with OpenClaw, LangChain, LiteLLM, Cursor, OpenAI Python SDK

### Mining Guilds
- `agent.create_guild(name)` — Create a guild
- `agent.join_guild(guild_id, amount)` — Join with deposit
- `agent.leave_guild()` — Leave guild

### Read State
- `agent.balance()` — LITCOIN + LITCREDIT balances
- `agent.oracle_prices()` — CPI and LITCOIN prices
- `agent.snapshot()` — Full protocol state in one call

## Full Flywheel Example

```python
from litcoin import Agent

agent = Agent(bankr_key="bk_...", ai_key="sk-...")

agent.mine(rounds=20)           # Comprehension mine
agent.research_loop(rounds=10)  # Research mine
agent.claim()                    # Claim on-chain
agent.stake(2)                   # Stake into Circuit tier
agent.open_vault(10_000_000)     # Open vault with 10M collateral
vaults = agent.vault_ids()       # Get vault ID
agent.mint_litcredit(vaults[0], 500)  # Mint 500 LITCREDIT
agent.deposit_escrow(100)        # Deposit to escrow
result = agent.compute("Explain proof of research")
print(result['response'])
```

## Key Info

- Chain: Base mainnet (8453)
- Token: `0x316ffb9c875f900AdCF04889E415cC86b564EBa3`
- 1 LITCREDIT = 1,000 output tokens of frontier AI inference
- SDK: v4.0.0 on PyPI
- MCP Server: `npx litcoin-mcp` (npm, v2.0.0) — 25 tools including 6 research tools
- Docs: https://litcoiin.xyz/docs.md
- Research Lab: https://litcoiin.xyz/research
- Statistics: https://litcoiin.xyz/stats
- Agent Launchpad: https://litcoiin.xyz/launch
- Site: https://litcoiin.xyz

## Coordinator Internals (for advanced context)

- Research rewards use `creditReward(wallet, amount, label)` — a pre-calculated reward function. NOT `addReward()` which is for comprehension mining only.
- Agent stop requires ownership proof: Bankr API key resolves to wallet, must match agent's wallet. 5 auth methods total. The Bankr key is the user's proof of ownership.
- All data persists to Upstash Redis. Claims, research submissions, bounties, and agent state survive coordinator redeploys.
- DexScreener API provides live market data (price, mcap, liquidity, volume) on the Statistics page.