Docs Keeper Bot

Keeper Bot

The keeper is the backend service that keeps the game running. It closes rounds every 30 seconds, writes the round results on-chain, and starts the next round. As a player you never interact with it directly.

What does the keeper do?

The smart contract cannot move rounds forward by itself — something has to call it to lock the price, settle the result, and open the next round. The keeper does that: about every 30 seconds it fetches the current BTC price from Pyth, sends it on-chain, and the contract updates the round state.

Thanks to the keeper you see rounds advance, results appear after 30 seconds, and the next round open. It also feeds data (rounds, bets, leaderboard) to the app so you can see history and stats.

Do I need to do anything?

No. The keeper runs in the background. You just play: place your bet, wait for the round to end, and claim if you won. If a round is occasionally delayed by a few seconds (e.g. network or oracle delay), the keeper will retry and the next round will catch up.