litcoin-miner

Original：🇺🇸 English

Translated

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.

2installs

Sourcetekkaadan/litcoin-skill

Added on2026-03-09

NPX Install

npx skill4agent add tekkaadan/litcoin-skill litcoin-miner

SKILL.md Content

View Translation Comparison →

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:

Install:
```
pip install litcoin
```
Get keys: Bankr API key from bankr.bot/api. AI provider key (Venice, OpenAI, Groq) for relay + research mining.
Run: Create an Agent and call
```
agent.mine()
```
for comprehension or
```
agent.research_loop()
```
for research
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

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
Agent Launchpad: https://litcoiin.xyz/launch
Site: https://litcoiin.xyz

litcoin-miner

NPX Install

Tags

SKILL.md Content

LITCOIN Miner Skill

Install the SDK

Quick Start — Comprehension Mining

Quick Start — Research Mining

What This Skill Covers

Full Protocol Methods

Mining & Relay

Research Mining (Proof-of-Research)

Staking (4 tiers: Spark/Circuit/Core/Architect)

Vaults (MakerDAO-style CDPs)

Compute Marketplace

Mining Guilds

Read State

Full Flywheel Example

Key Info