Documentatie — Geshardde multi-bot pusher/receiver-architectuur (Loxley AI)
Eén merk, vele bot-instanties, nul verloren berichten.
Hoe Loxley AI één branded trading bot schaalt naar duizenden gebruikers: coördinator- en workerprocessen, meerdere Telegram-bot-tokens (tot 7), pusher/receiver-sharding, gedeelde state en patronen voor veerkracht op Robinhood Chain.
Telegram legt elk bot-token rate-limits op. Een bot met één token die een paar duizend actieve traders bedient, laat uiteindelijk berichten vallen precies wanneer het er het meest toe doet — tijdens een hete launch, wanneer elke member tegelijk wil kopen. Loxley AI lost dit op met een geshardde multi-bot-architectuur: de bot van jouw merk is niet één proces, maar een gecoördineerde vloot.
Topologie
- Coördinator: het brein. Hij is eigenaar van pair-detectie, de veiligheidspipeline, positietracking, de sell-engine en de fee-administratie. Hij beslist; hij praat niet met members.
- Receivers (workers): een set bot-tokenprocessen (een operator kan tot 7 bot-tokens configureren) die member-commando's ontvangen: buy-menu's, het aanmaken van wallets, sell-verzoeken, instellingen. Receivers zijn stateless frontends — ze vertalen Telegram-interacties naar jobs voor de coördinator en renderen diens antwoorden.
- Pushers: broadcast-lanes van de vloot die alerts (nieuwe pairs, oordelen, notificaties) parallel over members verspreiden. Alerts worden over tokens geshard, zodat een golf van duizenden berichten over meerdere Telegram-quota wordt verdeeld in plaats van achter één quotum in de wachtrij te gaan staan.
- Gedeelde state: een snelle in-memory datalaag plus een duurzame database bevatten posities, member-instellingen en caches van oordelen, zodat elke receiver elke member kan beantwoorden en de coördinator één waarheid ziet.
Wat sharding in de praktijk oplevert
- Doorvoer: de fan-out voor alerts schaalt lineair mee met het aantal tokens. Een launch-alert die 5,000 members bereikt, is een geshardde burst, geen seriële druppel over minuten heen.
- Veerkracht: als één token wordt rate-limited of een workerproces herstart, nemen de overige lanes zijn members over. De coördinator is nooit afhankelijk van één enkel frontendproces.
- Merkconsistentie: alle tokens zijn geconfigureerd onder de merkidentiteit van de operator. Members ervaren "de bot"; de vloot is onzichtbaar.
- Lane-isolatie: lanes voor geautomatiseerde strategieën, auto-buy-lanes en notificatie-lanes zijn gescheiden, zodat een drukke alertstorm de orderexecutie niet kan uithongeren, en shadowing-regels voorkomen dat twee automatiseringsmodi allebei in dezelfde lane kopen.
Wallets op vlootschaal
Elke member krijgt een embedded wallet die in de chat wordt aangemaakt. Materiaal van private keys wordt versleuteld opgeslagen met envelope encryption; receivers loggen het nooit, operators kunnen het niet lezen, en alleen de coördinator gebruikt het op het moment van tekenen binnen de executiepipeline. Het schalen van de vloot vermenigvuldigt de blootstelling van sleutels nooit, omdat sleutels bij de coördinatorlaag leven — één custody-grens, ongeacht hoeveel tokens berichten pushen.
Operations
Kill-switches bestaan op elk niveau: automatisering kan per lane worden stilgelegd, een receiver kan worden leeggedraaid en verwijderd, en globale auto-buy kan worden uitgeschakeld zonder herdeployment. Rollouts over de vloot verlopen canary-first: wijzigingen rijden eerst mee op één worker vóór de rest van de vloot. Operators zien de gezondheid van de vloot via hun dashboard; members zien niets dan een bot die antwoordt.
Volgende: fee-engine voor operators → Alle docs
Built for operators, not slippage goblins. Talk to us →