search

Keeper Service

The keeper is a background service that automates market lifecycle management.

hashtag
What It Does

hashtag
Market Creation

  • Creates a new BTC/USD 5-minute market at every clean 5-minute interval

  • Boundaries: :00, :05, :10, :15, :20, :25, :30, :35, :40, :45, :50, :55

  • Only creates a market if no open market currently exists (prevents overlapping markets)

  • Uses the deployer wallet to sign creation transactions

hashtag
Market Resolution

  • Polls for expired markets every 30 seconds

  • Resolves any market that has passed its expiry time

  • Fetches fresh Pyth price data for resolution

  • Skips empty markets (no bets placed)

  • Handles errors gracefully — a failed resolution doesn't crash the service

hashtag
Running the Keeper

hashtag
Development

hashtag
Production (systemd)

The keeper runs as a systemd user service:

hashtag
Configuration

The keeper uses the same .env.local configuration as the bot:

Variable
Used For

MARKET_FACTORY_ADDRESS

Which factory to create markets on

DEPLOYER_PRIVATE_KEY

Signing creation and resolution transactions

BSC_RPC_URL

Blockchain RPC endpoint

CHAIN_ID

Network selection

hashtag
Log Output

hashtag
Failure Handling

  • If market creation fails, it logs the error and retries at the next 5-minute boundary

  • If resolution fails for a specific market, it skips that market and continues checking others

  • The systemd service auto-restarts on crash (RestartSec=5)

  • Markets that aren't resolved within 24 hours are auto-cancelled by the smart contract

PreviousCommandsNextSecurity

Last updated