litcoin-miner

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

LITCOIN Miner Skill

LITCOIN 挖矿技能

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.

通过在Base链上解决阅读理解挑战或实际优化问题来挖掘$LITCOIN。完整的DeFi协议访问能力：挖矿、研究、申领、质押、金库、铸造LITCREDIT、算力、公会、启动板。

Install the SDK

安装SDK

bash

pip install litcoin

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",
)

python

from litcoin import Agent

agent = Agent(
    bankr_key="bk_YOUR_KEY",        # 必填 —— 从bankr.bot/api获取
    ai_key="sk-YOUR_KEY",           # 选填 —— 启用中继+研究证明挖矿
    ai_url="https://api.venice.ai/api/v1",
    model="llama-3.3-70b",
)

Mine (relay auto-starts if ai_key set)

挖矿（如果设置了ai_key会自动启动中继）

agent.mine(rounds=10)

Claim rewards on-chain

链上申领奖励

agent.claim()

undefined

agent.claim()

undefined

Quick Start — Research Mining

快速入门——研究证明挖矿

python

undefined

python

undefined

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)

针对单个任务迭代（Karpathy模式 —— 突破性成果通常出自这个环节）

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).

tasks = agent.research_tasks()


研究证明挖矿需要`ai_key`——LLM会生成实验代码，在本地测试，如果结果优于基准线就提交。协调器会重新运行代码来验证每一次提交。

用户需要从https://bankr.bot/api获取Bankr API密钥，还需要Base链上的少量ETH作为gas费。余额为0的新钱包可以使用水龙头：`agent.faucet()`可免费领取500万LITCOIN（仅限一次）。

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

当用户要求挖掘LITCOIN时，引导他们完成以下设置：

安装：执行
```
pip install litcoin
```
获取密钥：从bankr.bot/api获取Bankr API密钥，若要使用中继和研究证明挖矿还需要AI服务商密钥（Venice、OpenAI、Groq）
运行：创建Agent实例，调用
```
agent.mine()
```
进行理解证明挖矿，或调用
```
agent.research_loop()
```
进行研究证明挖矿
申领：调用
```
agent.claim()
```
将代币提取到链上

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)

```
agent.mine(rounds=0)
```
—— 无限期（参数为0时）或进行N轮理解证明挖矿
```
agent.claim()
```
—— 链上申领奖励
```
agent.status()
```
—— 查看收益情况
```
agent.faucet()
```
—— 领取初始500万LITCOIN（仅限一次）

Research Mining (Proof-of-Research)

研究证明挖矿（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

agent.research_mine(task_type=None, task_id=None)

—— 单轮研究周期

agent.research_loop(task_type=None, task_id=None, rounds=10, delay=30)

—— 针对单个任务迭代

```
agent.research_tasks(task_type=None)
```
—— 列出可用研究任务
```
agent.research_leaderboard(task_id=None)
```
—— 按奖励排名的顶尖研究者榜单
```
agent.research_stats()
```
—— 全局研究统计数据
```
agent.research_history(task_id=None)
```
—— 你在单个任务下的迭代历史

任务类型：code_optimization（代码优化）、algorithm（算法）、ml_training（机器学习训练）、prompt_engineering（提示词工程）、data_science（数据科学）

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

质押（4个等级：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

```
agent.stake(tier)
```
—— 质押到1-4级（自动授权代币）
```
agent.unstake()
```
—— 锁定期结束后解除质押
```
agent.upgrade_tier(new_tier)
```
—— 升级到更高等级
```
agent.stake_info()
```
—— 当前等级、质押金额、锁定状态

Vaults (MakerDAO-style CDPs)

金库（MakerDAO风格的CDP）

```
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

```
agent.open_vault(collateral)
```
—— 用LITCOIN作为抵押品开设金库
```
agent.mint_litcredit(vault_id, amount)
```
—— 铸造LITCREDIT稳定币
```
agent.repay_debt(vault_id, amount)
```
—— 偿还债务
```
agent.add_collateral(vault_id, amount)
```
—— 追加抵押品

agent.withdraw_collateral(vault_id, amount)

—— 提取抵押品

```
agent.close_vault(vault_id)
```
—— 关闭金库
```
agent.vault_ids()
```
—— 列出你的所有金库ID
```
agent.vault_health(vault_id)
```
—— 查看抵押率

Compute Marketplace

算力市场

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

```
agent.deposit_escrow(amount)
```
—— 存入LITCOIN用于支付AI算力费用
```
agent.compute(prompt)
```
—— 通过中继网络调用AI推理服务

Mining Guilds

挖矿公会

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

```
agent.create_guild(name)
```
—— 创建公会
```
agent.join_guild(guild_id, amount)
```
—— 存入指定金额加入公会
```
agent.leave_guild()
```
—— 退出公会

Read State

状态查询

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

```
agent.balance()
```
—— LITCOIN + LITCREDIT余额
```
agent.oracle_prices()
```
—— CPI和LITCOIN价格
```
agent.snapshot()
```
—— 单次调用获取完整协议状态

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'])

python

from litcoin import Agent

agent = Agent(bankr_key="bk_...", ai_key="sk_...")

agent.mine(rounds=20)           # 理解证明挖矿
agent.research_loop(rounds=10)  # 研究证明挖矿
agent.claim()                    # 链上申领奖励
agent.stake(2)                   # 质押到Circuit等级
agent.open_vault(10_000_000)     # 用1000万LITCOIN作为抵押开设金库
vaults = agent.vault_ids()       # 获取金库ID
agent.mint_litcredit(vaults[0], 500)  # 铸造500 LITCREDIT
agent.deposit_escrow(100)        # 存入托管账户
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

链：Base主网（链ID 8453）

代币合约地址：

0x316ffb9c875f900AdCF04889E415cC86b564EBa3

1 LITCREDIT = 1000个前沿AI模型推理输出token
SDK版本：PyPI上的v4.0.0
MCP服务器：
```
npx litcoin-mcp
```
（npm包，v2.0.0）—— 包含25个工具，其中6个是研究工具
文档：https://litcoiin.xyz/docs.md
研究实验室：https://litcoiin.xyz/research
Agent启动板：https://litcoiin.xyz/launch
官网：https://litcoiin.xyz