LITCOIN Miner

Mininez $LITCOIN sur Base (chaîne 8453) avec le SDK Python. Deux chemins de minage : minage par compréhension (aucun LLM requis) et minage recherche (LLM génère du code optimisé, testé en bac à sable, vérifié on-chain).

Prérequis : Python 3.9+, une clé API Bankr depuis bankr.bot/api avec accès agent write activé, et une petite quantité d'ETH sur Base pour les frais.

Installation

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

Démarrage rapide — Minage par compréhension

Aucun LLM ou clé IA requis. Le solveur déterministe du SDK analyse les documents sans appels LLM.

from litcoin import Agent

agent = Agent(bankr_key="bk_YOUR_KEY")

# Bootstrap tokens gratuits (une fois, 5M LITCOIN)
agent.faucet()

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

# Réclamez les récompenses on-chain
agent.claim()

Démarrage rapide — Minage recherche

Nécessite une clé API IA. Le LLM génère du code d'expérience, le SDK le teste localement, et soumet seulement s'il bat la baseline. Le coordinateur vérifie chaque soumission en réexécutant le code dans un bac à sable.

agent = Agent(
    bankr_key="bk_YOUR_KEY",
    ai_key="sk-or-v1-YOUR_KEY",    # OpenRouter recommandé. Ou utilisez Bankr LLM (voir ci-dessous)
    ai_url="https://openrouter.ai/api/v1",
    model="google/gemini-2.5-flash",
)

# Cycle de recherche unique
result = agent.research_mine()

# Itérez sur une tâche (c'est là que les percées se produisent)
agent.research_loop(task_id="sort-benchmark-001", rounds=50, delay=30)

# Listez les tâches disponibles (24 adaptateurs : 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, et plus)
tasks = agent.research_tasks()

Utiliser Bankr LLM (pas de clé API supplémentaire)

Votre clé Bankr sert aussi de clé API LLM :

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

Intégration Bankr X Bot (@bankrbot)

Chaque appel SDK Python ci-dessus correspond à un endpoint du coordinateur sur https://api.litcoin.app/v1/bankr/*. Le @bankrbot de Bankr sur X est relié à cette surface, donc un utilisateur Bankr peut faire le volant LITCOIN complet depuis X avec des requêtes en langage naturel comme :

• "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 résout le portefeuille de l'utilisateur à partir de sa clé bk_, le coordinateur construit le calldata, Bankr signe et soumet la tx sur Base. Aucune clé privée ne touche jamais le coordinateur. La surface Bankr complète aujourd'hui :

Tous les changements de délégation routés par Bankr passent par une fenêtre de sécurité de 24 heures (limité à 3 par portefeuille par 24h, max 50% de stake-power par changement) avant activation. Tous les autres appels Bankr s'exécutent immédiatement on-chain. Définez BANKR_API_KEY une fois et chaque méthode Agent route automatiquement via Bankr.

Minage hébergé via Bankr (zéro clé IA requise)

POST /v1/bankr/mine/start déploie une Sentinel hébergée qui s'exécute côté serveur. La clé Bankr sert aussi de clé IA contre https://llm.bankr.bot/v1, donc l'utilisateur n'a jamais besoin d'un compte OpenRouter ou d'une installation Python. Les stratégies acceptent des alias conviviaux (sentinel, architect, vanguard, research, audit, forensics, recipe) plus les ID canoniques. La vérification de solde LITCOIN 5M sous-jacente depuis /v1/agent/deploy s'applique toujours.

POST /v1/bankr/mine/start
{ "bankrKey": "bk_...", "strategy": "research" }

POST /v1/bankr/mine/status
{ "bankrKey": "bk_..." }

POST /v1/bankr/mine/stop
{ "bankrKey": "bk_..." }

Devenir fournisseur de compute (via Bankr ou autrement)

La fourniture de compute nécessite une WebSocket longue durée depuis l'app de bureau LITCOIN X. POST /v1/bankr/compute/become-provider vérifie l'éligibilité LITCOIN 5M (staké ou liquide) et retourne un payload structuré d'étapes suivantes pointant vers litcoin.app/x. L'app de bureau fait l'enregistrement réel au premier lancement. POST /v1/bankr/compute/status retourne les métriques du fournisseur en direct une fois l'app de bureau en cours d'exécution.

Staking (Mining Boost)

Le staking augmente vos récompenses de minage :

agent.stake(tier=2)              # Staké dans Circuit
agent.stake_info()               # Vérifiez le tier et le statut du verrou
agent.unstake()                  # Après expiration du verrou
agent.early_unstake(confirm=False)  # Aperçu de la pénalité
agent.early_unstake(confirm=True)   # Exécutez avec pénalité

Vaults et LITCREDIT

Ouvrez des vaults avec collatéral LITCOIN ou USDC, frappez LITCREDIT (stablecoin indexée sur le compute : 1 LITCREDIT = 1 000 tokens de sortie d'IA frontier). Vaults LITCOIN : ratios basés sur tiers (150-250%), frais de minage 0.5%. Vaults USDC : ratio fixe 105%, frais de minage 0.25%, plafond LITCREDIT 500K. Aucun staking requis.

agent.open_vault(10_000_000)             # Vault LITCOIN (V1)
agent.open_vault_v2("usdc", 1000)        # Vault USDC — $1 000 à 105%
agent.open_vault_v2("litcoin", 10_000_000)  # Vault LITCOIN (V2)
vaults = agent.vault_ids()
token = agent.get_vault_token(vaults[0]) # Retourne l'adresse du token
agent.mint_litcredit(vaults[0], 500)     # Frappez 500 LITCREDIT
agent.repay_debt(vaults[0], 500)         # Remboursez la dette
agent.add_collateral(vaults[0], 5_000_000)  # Renforcez le vault
agent.close_vault(vaults[0])             # Fermez le vault
agent.vault_health(vaults[0])            # Vérifiez le ratio de collatéral

Guildes

Mettez en commun les ressources avec d'autres mineurs pour un boost de staking partagé :

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

Marketplace Compute

Dépensez LITCREDIT sur l'inférence IA servie par les mineurs relais :

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

Intelligence TCG

Interrogez le catalogue de cartes dans Pokemon, Magic, Yu-Gi-Oh, One Piece et Greed Island. 800K+ cartes indexées avec tarification en direct et sentiment communautaire.

# Statistiques du catalogue
stats = agent.tcg_stats()

# Recherchez par jeu, rareté, triez par prix
holos = agent.tcg_search(game="pokemon", rarity="Holo Rare", sort="price-desc", limit=10)

# Détails de carte unique + prix récent
card = agent.tcg_card("pokemon", "base1", "4")  # Charizard de l'ensemble de base

# Historique des prix 90 jours pour une carte
history = agent.tcg_price_history("pokemon", "base1", "4", days=90)

# Cartes actuellement tendance
trending = agent.tcg_trending(game="mtg", days=7, limit=20)

# Prix en direct pour les cartes les plus précieuses (rafraîchis toutes les 30 minutes)
live = agent.tcg_prices_live()

Exemple de volant complet

from litcoin import Agent

agent = Agent(bankr_key="bk_...", ai_key="sk-...")

agent.mine(rounds=20)                    # Minage par compréhension
agent.research_loop(rounds=10)           # Minage recherche
agent.claim()                            # Réclamez on-chain
agent.stake(2)                           # Tier Circuit (boost 1.25x)
agent.open_vault(10_000_000)             # Vault LITCOIN avec 10M de collatéral
agent.open_vault_v2("usdc", 1000)        # Ou vault USDC avec $1 000
vaults = agent.vault_ids()
agent.mint_litcredit(vaults[0], 500)     # Frappez 500 LITCREDIT
agent.deposit_escrow(100)                # Financez le compute
result = agent.compute("Summarize this document")
print(result['response'])

Référence SDK complète

Minage

• mine(rounds=None) — Minage par compréhension (None = boucle infinie)
• claim() — Réclamez les récompenses on-chain
• status() — Vérifiez les gains et le solde à réclamer
• faucet() — Bootstrap 5M LITCOIN (une fois)
• balance() — Soldes LITCOIN + LITCREDIT

Minage recherche

• research_mine(task_type, task_id) — Cycle de recherche unique
• research_loop(task_type, task_id, rounds, delay) — Itérez sur une tâche
• research_tasks(task_type) — Listez les tâches actives
• research_leaderboard(task_id) — Top chercheurs
• research_stats() — Statistiques globales
• research_history(task_id) — Vos soumissions

Staking

• stake(tier) — Stake tier 1-4 (approbation auto)
• unstake() — Unstake après expiration du verrou
• early_unstake(confirm) — Aperçu/exécutez unstake anticipé avec pénalité
• upgrade_tier(new_tier) — Passez à un tier supérieur
• stake_info() — Tier, montant, statut du verrou
• time_until_unlock() — Secondes jusqu'à expiration du verrou

Vaults

• open_vault(collateral) — Ouvrez un vault avec LITCOIN (V1)
• open_vault_v2(token, amount) — Ouvrez un vault avec LITCOIN ou USDC (V2)
• get_vault_token(vault_id) — Obtenez le type de collatéral d'un vault
• mint_litcredit(vault_id, amount) — Frappez LITCREDIT (frais 0.5% LITCOIN / 0.25% USDC)
• repay_debt(vault_id, amount) — Remboursez la dette
• add_collateral(vault_id, amount) — Ajoutez du collatéral (détection auto du type de token)
• close_vault(vault_id) — Fermez le vault
• vault_ids() — Listez vos vaults
• vault_health(vault_id) — Ratio de collatéral

Compute

• deposit_escrow(amount) - Déposez LITCREDIT
• compute(prompt) - Inférence IA via le réseau relais

Intelligence TCG

• tcg_stats() - Statistiques du catalogue pour les cinq jeux
• tcg_search(game, query, set_code, rarity, sort, limit, offset) - Recherchez des cartes (sort : name, number, rarity, price-desc, price-asc, recent)
• tcg_card(game, set_code, card_number) - Détails complets de la carte + prix récent
• tcg_price_history(game, set_code, card_number, days) - Historique des prix quotidiens (jusqu'à 365 jours)
• tcg_trending(game, days, limit) - Cartes tendance par momentum de prix + sentiment
• tcg_prices_live() - Prix en direct pour les cartes les plus précieuses de tous les jeux

Guildes

• create_guild(name) — Créez une guilde
• join_guild(guild_id, amount) — Rejoignez avec dépôt
• leave_guild() — Quittez la guilde
• stake_guild(tier) — Pool de stake (leader)
• unstake_guild() — Unstake du pool (leader)
• guild_membership() — Vos infos de guilde

Délégation (Liquidité → Production)

Dirigez votre LITCOIN déjà staké vers l'un des six archétypes de recherche (Enhancer, Transmuter, Conjurer, Specialist, Manipulator, Emitter). Les mineurs supportés obtiennent un boost ; vous gagnez une commission sur ce qu'ils produisent. Les fonds ne bougent jamais — votre principal reste dans le contrat de staking. Puissance pondérée par tier : Spark 1x, Circuit 2x, Core 4x, Architect 8x.

IDs de pool : 0=Enhancer 1=Transmuter 2=Conjurer 3=Specialist 4=Manipulator 5=Emitter

• delegate(allocations) — Signez + enregistrez la délégation. Allocations est une liste de {poolId, bps} (points de base du stake, 0-10000, total ≤ 10000). Exemple : agent.delegate([{"poolId": 4, "bps": 10000}]) (100% à Manipulator) Répartition : agent.delegate([{"poolId": 0, "bps": 6000}, {"poolId": 3, "bps": 4000}])
• undelegate(pool_ids) — Lancez le délai de 7 jours pour un ou plusieurs pools
• list_delegations() — Vos positions actives
• delegation_pools() — Les six pools agrégés
• delegation_pool(pool_id) — Statistiques d'un pool et ses supporteurs
• delegation_history(limit=25) — Vos actions de délégation récentes
• commission_status() — Commission à réclamer pour votre portefeuille
• claim_commission() — Réclamation de commission signée par le coordinateur prête à soumettre
• pending_delegations() — Délégations routées par Bankr dans leur fenêtre de sécurité 24h
• confirm_delegation(pending_id) — Activez une délégation en attente immédiatement
• revoke_delegation(pending_id) — Annulez une délégation en attente avant activation
• delegation_lock_status() — Compte à rebours de verrou d'engagement 7 jours pour vos positions
• emergency_exit() — Brisez l'engagement de 7 jours. Pénalité : 14 jours de rendement de staking, routés vers le pool de minage recherche. Principal inchangé.
• backed_miners() — Pools que vous supportez, mineurs acceptés, gains de commission récents

Système de sécurité de délégation. Les délégations routées par Bankr atterrissent dans une fenêtre de sécurité de 24 heures avant activation. Pendant la fenêtre, vous pouvez confirmer pour activer immédiatement, ou révoquer pour annuler. Après 24h sans action, la délégation s'active automatiquement. Les notifications Telegram se déclenchent si vous avez lié un chat. Limite de débit : max 3 changements de délégation routés par Bankr par portefeuille par 24h. Plafond de montant : un seul changement ne peut pas déplacer plus de 50% de stake-power. Le système de sécurité s'applique UNIQUEMENT aux chemins routés par Bankr. Les délégations via portefeuille direct (MetaMask) et SDK agent s'activent immédiatement.

Verrou + sortie d'urgence. Quand une signature de délégation atterrit, chaque position est verrouillée pour 7 jours. Vous ne pouvez pas redéléguer ailleurs tant que le verrou n'expire pas. La sortie d'urgence coûte 14 jours de rendement de staking courant, débité du solde à réclamer et routé vers le pool de recherche. Le principal reste dans le contrat de staking tout du long — la sortie d'urgence nettoie seulement l'état de délégation, pas votre stake.

Programme Boost (côté mineur)

Les mineurs peuvent OPT IN à un programme de boost d'un pool pour gagner la part de boost que les délégateurs dirigent vers ce pool. Un engagement plus élevé = poids de part plus élevé, mais pénalité plus dure si la qualité du pool chute sous le seuil. Seuil = qualité moyenne ≥6/10 ET ≥5 soumissions vérifiées/jour.

• opt_in_to_boost(pool_id, commitment_tier=1) — Engagez ce mineur vers un pool. Tiers : 1=Conservative (poids 1×, pénalité manquée 10%), 2=Aggressive (2×, 20%), 3=All-In (3×, 35%).
• opt_out_of_boost(pool_id) — Terminez l'engagement. Les futurs règlements ignoreront ce mineur dans ce pool.
• boost_optin_status() — Opt-ins actifs pour votre portefeuille dans les six pools.

La part de boost est provenant d'une réduction de 2.5% du pool de recherche quotidien plus des forfaits recyclés (rendement en attente des pools échoués, boost inutilisé, pénalités des mineurs, et pénalités de sortie d'urgence remontent tous dans le pool de minage recherche, qui renouvelle ensuite la réduction). Les mineurs non supportés ne sont pas affectés.

Inscription automatique (ajoutée 2026-05-04). Les mineurs qui produisent régulièrement dans un archétype s'inscrivent automatiquement à ce pool au tier Conservative avec un aperçu sans risque de 14 jours. Pendant l'aperçu, l'avantage de boost se déclenche les jours éligibles mais la clause de rabais est suspendue même les jours de seuil manqué. Le filtre d'éligibilité requiert ≥10 soumissions vérifiées dans les 7 derniers jours, qualité moyenne ≥6/10, et un archétype représentant ≥60% du volume de soumission. Les généralistes sont exclus (ils manqueraient le seuil et perdraient de l'argent). Après la maturation de l'aperçu, les règles normales s'appliquent automatiquement. L'opérateur peut se désinscrire à tout moment pendant l'aperçu, zéro pénalité. Vérifiez le statut avec GET /v1/boost/preview-status?wallet=... ou via la bannière du tableau de bord.

Lecture d'état

• balance() — LITCOIN + LITCREDIT
• oracle_prices() — Prix CPI et LITCOIN
• snapshot() — État du protocole complet

Gestion des erreurs

Le SDK lève des exceptions avec des messages clairs :

Info clé

• Chaîne : Base mainnet (8453)
• Token : 0x316ffb9c875f900AdCF04889E415cC86b564EBa3
• SDK : v4.15.1 sur PyPI
• Émission : 1.0% APR du trésor (atterrissage progressif)
• 1 LITCREDIT = 1 000 tokens de sortie d'IA frontier
• 24 adaptateurs de recherche produisant du code vérifié et des données structurées (incl. verticale RuneScape phases 1-4)
• Intelligence TCG pour Pokemon, Magic, Yu-Gi-Oh, One Piece, Greed Island
• Docs : https://litcoin.app/docs
• Cartes : https://litcoin.app/cards
• Source : https://litcoin.app