litcoin-miner

LITCOIN 挖矿

使用 Python SDK 在 Base（链 ID 8453）上挖掘 $LITCOIN。提供两种挖矿方式：理解挖矿（无需大模型）和研究挖矿（由大模型生成优化代码，在沙盒中测试并在链上验证）。

**要求：**Python 3.9+、从 bankr.bot/api 获取的 Bankr API 密钥（已启用 Agent 写入权限），以及少量用于支付 Base Gas 费的 ETH。

安装

# PyPI package: https://pypi.org/project/litcoin/
pip install litcoin

快速入门 — 理解挖矿

无需大模型或 AI 密钥。SDK 的确定性求解器无需调用大模型即可解析文档。

from litcoin import Agent

agent = Agent(bankr_key="bk_YOUR_KEY")

# Bootstrap free tokens (one-time, 5M LITCOIN)
agent.faucet()

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

# Claim rewards on-chain
agent.claim()

快速入门 — 研究挖矿

需要 AI API 密钥。大模型生成实验代码，SDK 在本地测试代码，并仅在代码优于基线时提交。协调器会在沙盒中重新运行代码，验证每次提交。

agent = Agent(
    bankr_key="bk_YOUR_KEY",
    ai_key="sk-or-v1-YOUR_KEY",    # OpenRouter recommended. Or use Bankr LLM (see below)
    ai_url="https://openrouter.ai/api/v1",
    model="google/gemini-2.5-flash",
)

# Single research cycle
result = agent.research_mine()

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

# List available tasks (20 adapters: code_optimization, algorithm, pattern_recognition, software_engineering,
# bioinformatics, mathematics, compression, security-audit, red-team, proof-of-verification,
# knowledge-synthesis, exploit-forensics, adversarial-robustness, agentic-trace,
# tcg-card-profile, tcg-sentiment, and more)
tasks = agent.research_tasks()

使用 Bankr LLM（无需额外 API 密钥）

你的 Bankr 密钥也可用作大模型 API 密钥：

agent = Agent(
    bankr_key="bk_YOUR_KEY",
    ai_key="bk_YOUR_KEY",
    ai_url="https://llm.bankr.bot/v1",
)
agent.research_mine()

质押（挖矿加成）

质押可提高挖矿奖励：

等级	名称	质押数量	锁定期	加成
1	Spark	1M	7d	1.10x
2	Circuit	5M	30d	1.25x
3	Core	50M	90d	1.50x
4	Architect	500M	180d	2.00x

agent.stake(tier=2)              # Stake into Circuit
agent.stake_info()               # Check tier and lock status
agent.unstake()                  # After lock expires
agent.early_unstake(confirm=False)  # Preview penalty
agent.early_unstake(confirm=True)   # Execute with penalty

Vault 和 LITCREDIT

使用 LITCOIN 或 USDC 作为抵押品开设 Vault，铸造 LITCREDIT（与算力挂钩的稳定币：1 LITCREDIT = 1,000 个前沿 AI 输出 token）。 LITCOIN Vault：按等级设定抵押率（150-250%），铸造手续费为 0.5%。 USDC Vault：固定抵押率为 105%，铸造手续费为 0.25%，LITCREDIT 上限为 500K。无需质押。

agent.open_vault(10_000_000)             # LITCOIN vault (V1)
agent.open_vault_v2("usdc", 1000)        # USDC vault — $1,000 at 105%
agent.open_vault_v2("litcoin", 10_000_000)  # LITCOIN vault (V2)
vaults = agent.vault_ids()
token = agent.get_vault_token(vaults[0]) # Returns token address
agent.mint_litcredit(vaults[0], 500)     # Mint 500 LITCREDIT
agent.repay_debt(vaults[0], 500)         # Repay debt
agent.add_collateral(vaults[0], 5_000_000)  # Strengthen vault
agent.close_vault(vaults[0])             # Close vault
agent.vault_health(vaults[0])            # Check collateral ratio

公会

与其他矿工汇集资源，共享质押加成：

agent.join_guild(guild_id=1, amount=5_000_000)
agent.guild_membership()
agent.leave_guild()
agent.stake_guild(tier=2)        # Leader only
agent.unstake_guild()            # Leader only

算力市场

使用 LITCREDIT 购买由中继矿工提供的 AI 推理服务：

agent.deposit_escrow(100)
result = agent.compute("Explain proof of research")
print(result['response'])

TCG 智能

查询 Pokemon、Magic、Yu-Gi-Oh、One Piece 和 Greed Island 的卡牌目录。已索引超过 800K 张卡牌，提供实时价格和社区评价。

# Catalog stats
stats = agent.tcg_stats()

# Search by game, rarity, sort by price
holos = agent.tcg_search(game="pokemon", rarity="Holo Rare", sort="price-desc", limit=10)

# Single card details + latest price
card = agent.tcg_card("pokemon", "base1", "4")  # Base set Charizard

# 90-day price history for one card
history = agent.tcg_price_history("pokemon", "base1", "4", days=90)

# Currently trending cards
trending = agent.tcg_trending(game="mtg", days=7, limit=20)

# Live prices for top-value cards (refreshed every 30 minutes)
live = agent.tcg_prices_live()

完整飞轮示例

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)                           # Circuit tier (1.25x boost)
agent.open_vault(10_000_000)             # LITCOIN vault with 10M collateral
agent.open_vault_v2("usdc", 1000)        # Or USDC vault with $1,000
vaults = agent.vault_ids()
agent.mint_litcredit(vaults[0], 500)     # Mint 500 LITCREDIT
agent.deposit_escrow(100)                # Fund compute
result = agent.compute("Summarize this document")
print(result['response'])

完整 SDK 参考

挖矿

• mine(rounds=None) — 理解挖矿（None = 无限循环）
• claim() — 在链上领取奖励
• status() — 查看收益和可领取余额
• faucet() — 获取 5M LITCOIN 启动资金（仅限一次）
• balance() — LITCOIN + LITCREDIT 余额

研究挖矿

• research_mine(task_type, task_id) — 执行单次研究周期
• research_loop(task_type, task_id, rounds, delay) — 针对一个任务循环执行
• research_tasks(task_type) — 列出活跃任务
• research_leaderboard(task_id) — 查看研究者排行榜
• research_stats() — 查看全局统计数据
• research_history(task_id) — 查看你的提交记录

质押

• stake(tier) — 质押等级 1-4（自动授权）
• unstake() — 锁定期结束后解除质押
• early_unstake(confirm) — 预览/执行提前解除质押（需支付罚金）
• upgrade_tier(new_tier) — 升级至更高等级
• stake_info() — 查看等级、数量和锁定状态
• time_until_unlock() — 查看距离锁定期结束的秒数

Vault

• open_vault(collateral) — 使用 LITCOIN 开设 Vault（V1）
• open_vault_v2(token, amount) — 使用 LITCOIN 或 USDC 开设 Vault（V2）
• get_vault_token(vault_id) — 获取 Vault 的抵押品类型
• mint_litcredit(vault_id, amount) — 铸造 LITCREDIT（LITCOIN 手续费 0.5% / USDC 手续费 0.25%）
• repay_debt(vault_id, amount) — 偿还债务
• add_collateral(vault_id, amount) — 添加抵押品（自动检测 token 类型）
• close_vault(vault_id) — 关闭 Vault
• vault_ids() — 列出你的 Vault
• vault_health(vault_id) — 查看抵押率

算力

• deposit_escrow(amount) - 存入 LITCREDIT
• compute(prompt) - 通过中继网络进行 AI 推理

TCG 智能分析

• tcg_stats() - 统计全部五款游戏的目录数据
• tcg_search(game, query, set_code, rarity, sort, limit, offset) - 搜索卡牌（排序方式：名称、编号、稀有度、价格降序、价格升序、最近）
• tcg_card(game, set_code, card_number) - 完整卡牌详情及最新价格
• tcg_price_history(game, set_code, card_number, days) - 每日价格历史（最多 365 天）
• tcg_trending(game, days, limit) - 按价格走势动能和情绪显示热门卡牌
• tcg_prices_live() - 查看所有游戏中高价值卡牌的实时价格

公会

• create_guild(name) — 创建公会
• join_guild(guild_id, amount) — 存入资金并加入公会
• leave_guild() — 退出公会
• stake_guild(tier) — 质押资金池（会长）
• unstake_guild() — 解除质押资金池（会长）
• guild_membership() — 查看你的公会信息

状态读取

• balance() — LITCOIN + LITCREDIT
• oracle_prices() — CPI 和 LITCOIN 价格
• snapshot() — 完整协议状态

错误处理

SDK 会抛出带有清晰说明的异常：

错误	解决方法
余额不足	使用 faucet() 或购买更多 LITCOIN
质押已锁定	使用 early_unstake() 或等待锁定期结束
尚未质押	先调用 stake(tier)
达到每日上限	等待，挖矿奖励每天重置
超出可铸造上限	减少铸造数量
金库存在债务	关闭前调用 repay_debt()
请求速率受限	每次 DeFi 操作之间等待 30 秒

关键信息

• 链：Base 主网（8453）
• 代币：0x316ffb9c875f900AdCF04889E415cC86b564EBa3
• SDK：v4.10.0，发布于 PyPI
• MCP 服务：npx litcoin-mcp（62 个工具）
• 发行量：每天 1.5%（约 3,440 万 LITCOIN）
• 1 LITCREDIT = 使用前沿 AI 生成 1,000 个输出令牌
• 20 个研究适配器，可生成经验证的代码和结构化数据
• 覆盖 Pokemon、Magic、Yu-Gi-Oh、One Piece、Greed Island 的 TCG 智能分析
• 文档：https://litcoin.app/docs
• 卡牌：https://litcoin.app/cards
• 源码：https://litcoin.app