"""The background worker process (ADR-55): runs the round lifecycle every few seconds and, on the simulated ledger, settles the confirmations that a real chain would bring (roadmap A4). The chain tasks of phase B plug into `tick` too. A step that fails is logged and retried at the next tick: the lifecycle keeps no state outside the database. """ import logging import signal import threading from django.core.management.base import BaseCommand logger = logging.getLogger(__name__) TICK_SECONDS = 5 _last_scan = 0.0 SCAN_SECONDS = 10 def scan_chain_deposits() -> None: """DEP-20: every few seconds, on a real ledger only.""" import time from django.conf import settings from apps.lottery import deposits from apps.lottery.electrum_chain import ElectrumChain global _last_scan if time.monotonic() - _last_scan < SCAN_SECONDS: return _last_scan = time.monotonic() chain = ElectrumChain(settings.ELECTRUM_ENDPOINTS, settings.PLM_PROFILE, settings.ELECTRUM_ALLOW_NO_QUORUM) done = deposits.scan_deposits(chain) if any(done.values()): logger.info("deposit scan: %s", done) def tick() -> None: """One pass over everything the worker is responsible for.""" from django.conf import settings from apps.lottery import console, lifecycle, simulation console.beat() # WEB-31: proof of life, before the work that might fail if settings.LEDGER_BACKEND == "simulated": simulation.settle() else: scan_chain_deposits() # B5 lifecycle.tick() class Command(BaseCommand): help = "Run the background worker (round scheduler and chain tasks)." def add_arguments(self, parser): parser.add_argument("--once", action="store_true", help="Run a single tick and exit.") def handle(self, *args, **options): stop = threading.Event() for signum in (signal.SIGTERM, signal.SIGINT): signal.signal(signum, lambda *_: stop.set()) logger.info("worker started") while not stop.is_set(): try: tick() except Exception: # a failed step leaves the round where it was; the next tick retries logger.exception("worker tick failed") if options["once"]: raise if options["once"]: break stop.wait(TICK_SECONDS) logger.info("worker stopped")