litcoin-miner

LITCOIN マイナー

Python SDK を使用して、Base（チェーン 8453）で $LITCOIN をマイニングします。マイニング方法は 2 種類あります。理解マイニング（LLM 不要）とリサーチマイニング（LLM が最適化されたコードを生成し、サンドボックスでテストしたうえで、オンチェーンで検証されます）。

要件： Python 3.9 以降、bankr.bot/api で取得したエージェントの書き込みアクセスが有効な Bankr API キー、ガス代用の少額の ETH（Base 上）。

インストール

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

クイックスタート — 理解マイニング

LLM や AI キーは不要です。SDK の決定論的ソルバーは、LLM を呼び出さずにドキュメントを解析します。

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 キーが必要です。LLM が実験コードを生成し、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 キーを LLM 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 = 最先端 AI の出力トークン 1,000 個）。 LITCOIN Vault：ティアに応じた比率（150～250％）、発行手数料 0.5％。 USDC Vault：固定比率 105％、発行手数料 0.25％、上限 500K LITCREDIT。ステーキングは不要です。

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

計算マーケットプレイス

リレーマイナーが提供する AI 推論に LITCREDIT を使用します。

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

TCG インテリジェンス

Pokemon、Magic、Yu-Gi-Oh、One Piece、Greed Island のカードカタログを検索できます。80 万枚以上のカードが登録されており、価格とコミュニティの評判をリアルタイムで確認できます。

# 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 を取得（1 回限り）
• balance() — LITCOIN と LITCREDIT の残高

リサーチマイニング

• research_mine(task_type, task_id) — リサーチサイクルを 1 回実行
• research_loop(task_type, task_id, rounds, delay) — 1 つのタスクを繰り返し実行
• 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) — 担保を追加（トークンタイプを自動判定）
• close_vault(vault_id) — Vault を閉じる
• vault_ids() — 自分の Vault を一覧表示
• vault_health(vault_id) — 担保比率

計算

• deposit_escrow(amount) - LITCREDIT を預け入れ
• compute(prompt) - リレーネットワーク経由の AI 推論

TCG インテリジェンス

• tcg_stats() - 5つすべてのゲームのカタログ統計
• tcg_search(game, query, set_code, rarity, sort, limit, offset) - カードを検索（並べ替え：name、number、rarity、price-desc、price-asc、recent）
• 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) を呼び出してください
1日の上限に到達しました	お待ちください。マイニング報酬は毎日リセットされます
ミント可能な最大量を超えています	ミント量を減らしてください
ボールトに負債があります	閉じる前に repay_debt() を呼び出してください
レート制限に達しました	DeFi 操作の間隔を30秒空けてください

重要情報

• チェーン：Base メインネット（8453）
• トークン：0x316ffb9c875f900AdCF04889E415cC86b564EBa3
• SDK：PyPI 上の v4.10.0
• MCP サーバー：npx litcoin-mcp（62ツール）
• 発行量：1日あたり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