litcoin-miner
Mine, stake, claim, and manage LITCOIN end-to-end through Bankr. Hosted mining via @bankrbot: 'start a research miner for me' deploys a server-side Sentinel that uses the Bankr key as the LLM key against llm.bankr.bot, so no other AI provider is needed.
Install / Use
npx skills add BankrBot/skills --skill litcoinInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AI & Machine LearningSupported Platforms
Tags
Our assessment of litcoin-miner
litcoin-miner scores 93/100 on our quality scale, 253rd of 947 AI & Machine Learning skills we index (top 27%).
Its SKILL.md is 18 KB long, well organised into 44 sections with 11 code examples: a thorough specification that gives an agent plenty to work with.
With 1,201 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so litcoin-miner is actively maintained.
- Our last check on 2026-10-26 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit β read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-07. Automated pattern scan on 2026-10-07. It catches known dangerous patterns, not every risk β read a skill before letting an agent act on it.
litcoin-miner compared with similar skills
All 4 of these similar skills score higher than litcoin-miner; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| litcoin-miner (this skill)by BankrBot | 93 | 1.2k | 54d ago | SKILL.md |
| claude-memby thedotmack | 100 | 117.6k | today | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 92.8k | 1d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install litcoin-miner?
- Run
npx skills add BankrBot/skills --skill litcoin-miner. The install tabs above show the steps for each supported agent. - Which AI agents does litcoin-miner work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is litcoin-miner safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is litcoin-miner still maintained?
- The repository was last updated about 2 months ago, so litcoin-miner is actively maintained.
Skill content
View source on GitHubname: litcoin-miner description: "Mine, stake, claim, and manage LITCOIN end-to-end through Bankr. Hosted mining via @bankrbot: 'start a research miner for me' deploys a server-side Sentinel that uses the Bankr key as the LLM key against llm.bankr.bot, so no other AI provider is needed. Stake at one of four tiers (Spark, Circuit, Conduit, Architect), claim accumulated rewards, delegate LITCOIN to one of six Nen archetype boost pools, opt into the miner boost program, open vaults, mint LITCREDIT, manage mining guilds, check or fund the compute escrow, become a LITCOIN X compute provider, or interact with the LITCOIN DeFi protocol on Base." license: MIT-0 compatibility: "Requires Python 3.9+ and pip. Network access to api.litcoin.app." metadata: author: tekkaadan version: "2.4.0" homepage: "https://litcoin.app" repository: "https://github.com/tekkaadan/litcoin-skill" tags: [crypto, mining, defi, ai-agent, base, research, staking, litcoin] hermes: tags: [crypto, mining, defi, ai-agent, base, research, staking] required_environment_variables: - name: BANKR_API_KEY prompt: "Paste your Bankr API key (starts with 'bk_'). Get one at https://bankr.bot/api-keys with agent write access enabled." help: "Controls the on-chain wallet used for mining, claims, staking, and vault operations." required_for: [mining, claims, staking, vaults, compute] openclaw: requires: env: ["BANKR_API_KEY"] primaryEnv: "BANKR_API_KEY" clawdbot: requires: env: ["BANKR_API_KEY"] primaryEnv: "BANKR_API_KEY"
LITCOIN Miner
Mine $LITCOIN on Base (chain 8453) using the Python SDK. Two mining paths: comprehension mining (no LLM needed) and research mining (LLM generates optimized code, tested in sandbox, verified on-chain).
Requirements: Python 3.9+, a Bankr API key from bankr.bot/api-keys with agent write access enabled, and a small amount of ETH on Base for gas.
Install
# PyPI package: https://pypi.org/project/litcoin/
pip install litcoin
Quick Start β Comprehension Mining
No LLM or AI key needed. The SDK's deterministic solver parses documents without LLM calls.
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()
Quick Start β Research Mining
Requires an AI API key. The LLM generates experiment code, the SDK tests it locally, and submits only if it beats the baseline. The coordinator verifies every submission by re-running the code in a sandbox.
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 (24 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, vault-comp, variant-pathogenicity,
# runescape-insight, runescape-ta, runescape-sentiment, runescape-update-impact, and more)
tasks = agent.research_tasks()
Using Bankr LLM (no extra API key)
Your Bankr key doubles as an LLM API key:
agent = Agent(
bankr_key="bk_YOUR_KEY",
ai_key="bk_YOUR_KEY",
ai_url="https://llm.bankr.bot/v1",
)
agent.research_mine()
Bankr X Bot (@bankrbot) Integration
Every Python SDK call above maps to a coordinator endpoint at https://api.litcoin.app/v1/bankr/*. Bankr's @bankrbot on X is wired into this surface, so a Bankr user can do the entire LITCOIN flywheel from X with plain-language requests like:
- "claim my litcoin rewards"
- "stake 5M litcoin into tier 2"
- "upgrade my stake to architect"
- "add 10M to my stake"
- "open a usdc vault with 1000"
- "mint 500 litcredit from vault 7"
- "delegate 100% of my stake to manipulator"
- "opt me into the conjurer boost pool"
- "join guild 1 with 5M"
- "deposit 100 litcredit into compute escrow"
Bankr resolves the user's wallet from their bk_ key, the coordinator builds the calldata, Bankr signs and submits the tx on Base. No private key ever touches the coordinator. The full Bankr surface today:
| Domain | Endpoints |
|---|---|
| Claims | /v1/bankr/claim-with-key |
| Staking | stake unstake early-unstake upgrade-tier add-to-stake stake/info |
| Vaults | vault/open vault/add-collateral vault/mint vault/repay vault/withdraw vault/close vault/details |
| Delegation | delegate undelegate boost/opt-in boost/opt-out |
| Guilds | guild/join guild/leave guild/unstake |
| Hosted mining | mine/start mine/stop mine/status |
| Compute | escrow/deposit compute/status compute/balance compute/become-provider |
| Read | balance |
| Buy | Bankr's native swap on Aerodrome handles this. DM @bankrbot "swap 100 usdc for litcoin" directly. No coordinator endpoint needed. |
All Bankr-routed delegation changes pass through a 24-hour safety window (rate-limited to 3 per wallet per 24h, max 50% of stake-power per change) before activating. All other Bankr calls execute immediately on-chain. Set BANKR_API_KEY once and every Agent method routes through Bankr automatically.
Hosted mining via Bankr (zero AI key required)
POST /v1/bankr/mine/start deploys a hosted Sentinel that runs server-side. The Bankr key doubles as the AI key against https://llm.bankr.bot/v1, so the user never needs an OpenRouter account or a Python install. Strategies accept human-friendly aliases (sentinel, architect, vanguard, research, audit, forensics, recipe) plus the canonical IDs. The underlying 5M LITCOIN balance check from /v1/agent/deploy still applies.
POST /v1/bankr/mine/start
{ "bankrKey": "bk_...", "strategy": "research" }
POST /v1/bankr/mine/status
{ "bankrKey": "bk_..." }
POST /v1/bankr/mine/stop
{ "bankrKey": "bk_..." }
Becoming a compute provider (via Bankr or otherwise)
Compute serving requires a long-lived WebSocket from the LITCOIN X desktop app. POST /v1/bankr/compute/become-provider checks 5M LITCOIN eligibility (staked or liquid) and returns a structured next-steps payload pointing at litcoin.app/x. The desktop app does the real registration on first launch. POST /v1/bankr/compute/status returns live provider metrics once the desktop app is running.
Staking (Mining Boost)
Staking increases your mining rewards:
| Tier | Name | Stake | Lock | Boost | |------|------|-------|------|-------| | 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
Vaults and LITCREDIT
Open vaults with LITCOIN or USDC collateral, mint LITCREDIT (compute-pegged stablecoin: 1 LITCREDIT = 1,000 output tokens of frontier AI). LITCOIN vaults: tier-based ratios (150-250%), 0.5% minting fee. USDC vaults: fixed 105% ratio, 0.25% minting fee, 500K LITCREDIT ceiling. No staking needed.
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 = agenβ¦[redacted](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
Guilds
Pool resources with other miners for shared staking boost:
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
Compute Marketplace
Spend LITCREDIT on AI inference served by relay miners:
agent.deposit_escrow(100)
result = agent.compute("Explain proof of research")
print(result['response'])
TCG Intelligence
Query the card catalog across Pokemon, Magic, Yu-Gi-Oh, One Piece, and Greed Island. 800K+ cards indexed with live pricing and community sentiment.
# 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()
Full Flywheel Example
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'])
Full SDK Reference
Mining
mine(rounds=None)β Comprehension mine (None = infinite loop)claim()β Claim rewards on-chainstatus()β Check earnings and claimable balancefaucet()β Bootstrap 5M LITCOIN (one-time)balance()β LITCOIN + LITCREDIT balances
Research Mining
research_mine(task_type, task_id)β Single research cycleresearch_loop(task_type, task_id, rounds, delay)β Iterate on one taskresearch_tasks(task_type)β List active tasksresearch_leaderboard(task_id)β Top researchersresearch_stats()β Global statsresearch_history(task_id)β Your submissions
Staking
stake(tier)β Stake tier 1-4 (auto-approves)unstake()β Unstake after lock expiresearly_unstake(confirm)β Preview/execute early unstake with penaltyupgrade_tier(new_tier)β Upgrade to higher tierstake_info()β Tier, amount, lock statustime_until_unlock()β Seconds until lock expires
Vaults
open_vault(collateral)β Open vault with LITCOIN (V1)open_vault_v2(token, amount)β Open vault with LITCOIN or USDC (V2)get_vault_token(vault_id)β Get collateral type for a vaultmint_litcredit(vault_id, amount)β Mint LITCREDIT (0.5% LITCOIN / 0.25% USDC fee)repay_debt(vault_id, amount)β Repay debtadd_collateral(vault_id, amount)β Add collateral (auto-detects token type)close_vault(vault_id)β Close vaultvault_ids()β List your vaultsvault_health(vault_id)β Collateral ratio
Compute
deposit_escrow(amount)- Deposit LITCREDITcompute(prompt)- AI inference via relay network
TCG Intelligence
tcg_stats()- Catalog stats across all five games- `tcg_search(game, query, set
Truncated for display β read the full file on GitHub.
Related Skills
claude-mem
117.6kPersistent Context Across Sessions for Every Agent β Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Understand-Anything
92.8kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit β see the Safety scan above for what the skill file itself contains.
