Luchamon Bot

Un bot qui ne gaspille jamais une énergie

Luchamon Bot automatise les combats sur luchamon.com, un auto-battler 100 % on-chain sur la chaîne Base. Chaque Luchamon dispose de sept énergies par semaine ; le bot les dépense au meilleur coup, sans jamais en perdre une.

Il signe ses transactions avec le Fast Mode Wallet du jeu — le wallet principal reste à froid.

Choisir par simulation, pas par heuristique

Pour chaque combat, le jeu propose huit adversaires aléatoires. Plutôt que de deviner, le bot passe chacun des huit dans le propre moteur de combat du jeu, sur de nombreux seeds VRF, pour estimer une probabilité de victoire. Il joue alors le meilleur disponible — le « moins pire », puisque même le perdant gagne du $LUCHA, donc aucune énergie n'est gaspillée. L'objectif est réglable par Luchamon : safe vise la victoire la plus sûre, aggressive le plus fort adversaire encore sûr pour grimper au classement.

Ces simulations exigent des milliers de lectures on-chain. Un fork Anvil local sert le même bytecode environ 24× plus vite que le tier RPC gratuit — une calibration passe de ~40 min à moins d'une minute, cache chaud.

Un run est un drain

npm start est un run : il draine l'énergie disponible de la semaine, puis sort. Le process est le run — il ne boucle ni ne se planifie lui-même. Un service core always-on lit le reset hebdomadaire on-chain et lance le drain au bon moment, avec progression et débrief poussés sur Telegram.

Cockpit local

Un cockpit web (React + Vite, TypeScript strict) pilote le bot en local : lancer une analyse anti-meta, inspecter le roster, et appliquer un build en signant la transaction updateBuild avec son wallet principal dans Rabby ou MetaMask. Le service core ne détient jamais la clé principale — il prépare la calldata et journalise, c'est tout. En stack dockerisée, nginx sert le bundle et réinjecte le secret API côté serveur : le bundle JS ne le voit jamais.

Stack

Développé en TypeScript avec viem pour les interactions on-chain, déployable en Docker (core + Telegram + cockpit + Anvil) en un docker compose up. Les décisions structurantes sont consignées dans des ADR (vault privé) — 24 à ce jour.